Working with comments¶
The Signavio Process Manager allows writing comments for diagrams and diagram elements. Those comments can contain hints about process optimization or modeling details.
Comments are accessible in the Collaboration Hub, the Explorer and the Editor.
When working on diagrams collaboratively, working with comments simplifies discussions about modeling details, process optimization or misunderstandings when collaborating with different departments, offices or companies or working on a process over long periods of time. Comments are usually created in the Collaboration Hub, as this is a functionality designed for presenting and discussing diagrams with every participant within the process. Comments may contain information about modeling mistakes or optimization points, or simply questions about diagram and process details. A modeler is informed about unread comments every time he enters the Explorer and can directly access and edit them in the Editor.
This chapter describes the comments handling in the Editor. Collaboration Hub users who are not modelers, can comment on doiagrams in the Collaboration Hub.
Hints: The Collaboration Hub allows access to a set of published diagrams. To restrict the reading and commenting access to only one diagram, it is recommended to work with the Comments view.
The Collaboration Hub is for systematically publishing your process landscape. If you would like to collaborate with colleagues during the construction of a process, it is recommended to invite people to comment instead of publishing the diagram as published diagrams can be changed and commented on by everyone with workspace access.
Identifying unread comments¶
The Explorer marks each diagram that was recently commented on with speech bubbles at the top right corner of the diagram icon:
Speech bubbles on a diagram in the Explorer indicate that unread comments exist.
The number next to the speech bubble indicates the number of unread comments.
Open the diagram in the Editor to read and, if required, adopt requested changes in the diagram. Each element in the diagram that was recently commented on will again be marked with a little speech bubble and the number of unread comments:
In the Editor, an unread comment sticks to a modeling element.
In the Editor, comments that concern the whole diagram will be displayed in the upper left corner:
A comment on the whole diagram
Important If a comment is marked as read it will be invisible. To find a comment again, you have to click the “Comments” button in the top toolbar in the Editor. Deleted comments cannot be retrieved this way.
Factoring in comments¶
Click a speech bubble to see the comments for a diagram element. An extended speech bubble shows all unread comments on the element:
Accept a comment.
In this example a colleague requests stakeholder-specific views on the diagram. As indicated by the red badge next to it, the comment has yet to be read.
The modeler could now accept the comment, if he plans to create the requested view.
To accept a comment, click the link Factor in right below it. Its badge will then get a green color:
This comment was already accepted.
Hint: To revert a status update, click the status again.
When you save the diagram again, the new status of the comments will be noted. The next time a collaborator views the diagram e.g. in the Collaboration Hub, they will be able to see that their comment was accepted. Also, the comment does now count as read and the comment count on the diagram will go to its former number.
Sometimes a suggestion in a comment cannot be integrated or a whole comment is rejected, which means it should neither be marked as accepted nor be deleted. In such cases the comments state can be set to ignored:
Reject a comment.
Comments that were ignored will be marked with a gray badge. After adjusting the comments state, save the diagram to make the new state accessible for your collaborators.
This comment was rejected.
To change the comment status, click Ignore again.
Unwanted comments can only be deleted in the Editor. Open the speech bubble containing the unwanted comment and click the link Delete below it:
Removing a comment.
Confirm the warning by clicking Yes. The comment will be removed permanently.
Viewing comments that were already read¶
Unlike the Collaboration Hub, the Editor only displays new comments by default. Comments that were already read and are archived as either accepted or ignored, thus invisible.
To display read comments in the Editor, use the “Comments”-Button in the Editor’s upper toolbar:
A speech bubble will then be attached to every diagram element:
Speech bubbles that contain unread comments are displayed thicker.
Click a speech bubble to extend it and display the comments attached to the element.
Besides reading or setting a comment-state, the Editor allows adding comments as well.
To write comments in the Editor. use the “Comments”-Button of the toolbar to see a speech bubble at the top right of every element. Click the speech bubble attached to the element you want to comment on to open a new text field.
The lower part of the bubble contains a text field:
Enter the comment into the textfield and click Submit:
Add a comment in the Editor.
The comment will immediately be created and will also be accessible for users in the Collaboration Hub, even without saving the diagram.