Document roles

Document roles link specific people with specific documents and can give those people certain permissions for the document. The level of permissions given (for example, to read or edit) is determined by the role. The Document roles are part of a document's Properties.  

In addition to the two author roles, Contact Person and Author,  Archie includes several other Document roles that can be assigned to people in relation to reviews (for example, Contact Editor or Referee).

Document roles are assigned and edited under the People tab of the document’s Properties. Super Users can assign Document roles in Archie.

To assign a document role

1. Open the document's Properties and go to the People tab.

2. Click New. This will open the Document Role window.

3. Click to pick the person to assign the role to. See Choosing a person or date for details.

4. Use the Role pull-down list to choose the Document role you wish to assign. The available roles will depend on the document type.  

5. Click OK.

6. Tip: the Document Role window also includes a Notes tab, where you can record notes relevant to that particular document role. However, since these notes require you to open the individual role, you may find it easier to simply use the Notes tab on the documents Properties for all notes.

The Document Role window for reviews has an Address tab that lets you assign a different address than the person's default contact address for use in a particular review. See Contact details in reviews for instructions on this feature.

To edit a document role  

1. Open the document's Properties and go to the People tab.

2. Click the role you wish to modify.   

3. Click Edit. This will open the Document Role window.

4. Depending on whether you wish to change the person or the role, either

• click to choose a new person for the role (see Choosing a person or date for details), or

• use the Role pull-down list to choose the new Document role you wish to assign to the person.  

5. Click OK.

Review roles and permissions

The table below shows the permissions associated with the Document roles for reviews. The top row of the table show whether a role gives access in the Authoring or Editorial phase.

* Note:  'Editorial' roles are all the roles associated with the editorial phase, so this includes Referees. Since the Collaboration does not have policy that requires open refereeing, the this permission must be limited to the Contact editor Document role, and a few entity roles (e.g., ME).          

All users have the View permission which allows a user to see a document in Search Results or under Resources, and open its Properties to view author roles.

The remaining review permissions, such as Revert, Delete document or Publish, are assigned through Entity roles, see Entity role permissions.

Module roles and permissions

For Modules, the only available document role is Module editor which gives permission to Edit the module. The remaining permissions, such as Revert or Publish, are assigned through Entity roles, see Entity role permissions.

See also Permissions.