Assign documents to users
The DITA CMS lets you quickly and easily assign documents to the people who will be responsible for them in the different phases of the document development cycle.
The number of people that you can assign to a given document varies according to the role. For example, there may be several Reviewers assigned to a topic, but there will typically be only one Author. The Assignments dialog displays the maximum number of people that can be assigned to the selected documents per role.
This function is available from all DITA CMS views.
- By project - restricts the display to people that are on the team of a specific project. The document being assigned does not need to be one of the project's deliverables; however, the project must have members listed as part of the team.
My projects only - further restricts
the display to projects where you are on the team.Note: Project coordinators are considered to be team members of any project they are currently managing, whether or not they are actually listed in the project.
- By group - restricts the display to the selected group. Group names are configurable, and the exact list will vary.
The list of approval systems and the default approval system (if any) for each role are set during system configuration. Some roles do not require or allow for an approval system, so you cannot set an approval system for those roles.
If the selected documents are part of a project, you cannot set a more stringent approval system than what was set at the project level. If there is a conflict between user-set approval systems, the more restrictive system always takes precedence.
For DITA CMS Web:
If you intend to use DITA CMS Web for users to contribute or review content, then you must set a Context Map when you assign the topic. A Context Map is the map in which the topic is contained. This map not only provides the user with context for the topic so they understand how the content fits in to the document as a whole, but it also provides the source from which to resolve any keys contained in the topic.
To assign documents to users:
- Log in to DITA CMS.
- Locate the documents that you want to assign; for example, you can perform a search.
- Right-click the required documents from a view.
Assign to from the menu.
The Assignments dialog appears with a left and a right pane. The left pane displays all the roles that are configured for the types of documents you selected.
If any of the check boxes are selected, this means that some of the documents you selected are already assigned to people.
If you want to filter the list of names displayed in the
Assignee pane, select as desired:
- To filter by project, select the By project checkbox and click the name of the project from the list. To further filter the choices of projects to those of which you are a team member, select the My projects only checkbox.
- To filter by group, select the By group checkbox and click the name of the group from the list.
In the Assignee pane, expand each role to see the list of people who are
available and select the required people from each role.
You can enter text in the Filter results on the first column's text... field to find certain people.
If you are assigning documents that are part of a project and
you want to use the project's default role assignments, right-click the role
name and select projectname
specifies the project whose role assignments you want to use).
(where If there are no available projects, this section will be disabled.The documents are assigned to the people who hold the default role assignments in the selected project.
Expand each person’s name to assign
selected documents to that person.
In the following diagram, two reviewers have been assigned topics.Figure 2. Example of reviewers being assigned to topics
In the right pane, set the due dates for the documents:
Note: If you need to clear the date from a document, right-click the document and click Clear Due Date.
Right-click a document and then select
Set Due Date from the
An interactive calendar appears. For example:
Select the required date, then click
The selected date appears in the Due Date column.
Repeat for each document or role, as required.
When these documents are assigned to specific people, the document names and their due dates will appear in their Todo Lists.
- Right-click a document and then select Set Due Date from the menu.
Add comments as desired:
Note: If you need to clear the comment from a document, right-click the document and click Clear Comment.
Right-click a document and click Edit Comment.
A Comment window opens. For example:
In the Comment dialog box, type a comment and click OK.
The comment appears in the Comment column.
- Repeat for each document, as required.
- Right-click a document and click Edit Comment.
Set the context map for topics
(required when using
DITA CMS Web):
- Right-click a topic and click Set Context Map.
Set a Context Map dialog box,
click the map in which the topic is contained. The associated map
provides assignees context for the topic within its parent map and is
also used to resolve the keys.
Important: The parent map must be open in the DITA Map view for it to be available as a Context Map in the Assignments dialog box.
- Click OK.
- Repeat for each topic, as required.
Set the approval system for the documents:
Note: If you need to clear the approval system from a document or from a role, right-click the document and click Clear Approval System.
- Right-click a document and click Set Approval System.
Click the approval system you want to use. The available selections are
based on your system configuration.
For example, you might have one of the following default approval systems included in DITA CMS:
- Unanimous: All users in this role must approve a document or image before it can pass to the next status.
- Simple majority: A majority of users must approve a document or image before it can pass to the next status. By default, this means that more than 50% of users must approve this document before it can pass to the next status.
- Single approval: A document or image can pass to the next status once any user in this role has approved it.
- Set approval systems for each document or role, as required.
Add a link to a web site to point the assignee to additional information; for example, provide a link to a wiki page or to a ticket in a bug tracking system.
Note: If you need to clear the external link from a document or from a role, right-click the document and click Clear external link.
- Right-click a document and click Set external link.
- In the External Link dialog box, type the HTTP or HTTPS-based URL to the web site.
- Click OK.
- Click OK.