Take Part in a Review

Create a Review Topic

Below the element name, but above any existing review conversation, the message Create Review Topic displays. Note that an element under review can be locked against posting any further topics or responses, according to the element's status. In this case the message This Review is now <status triggering the lock> and cannot be updated displays instead.

Double-click on the Create Review Topic message and type your topic as continuous text (no carriage returns). The text automatically wraps at the border of the Discuss & Review window.

If you do need to break your text into paragraphs, press Ctrl+Enter at the break point.

When you have finished typing, click off the text or press the Enter key.

• An open expansion arrow and a icon display at the start of your text, and your user name, the time or date of posting and the number of replies (initially zero) display beneath your text
• The message Create Review Topic displays above your current discussion topic, and the message Post reply displays underneath the topic

If user security is enabled and you have selected to show avatars, the discussion icon is replaced by an image representing the user who contributed that item. If the user does not have a personal avatar image, a default 'head and shoulders' silhouette displays as the avatar.

Note that your text might contain words that are automatically underlined. These are terms for which a Glossary definition has been created, and positioning the cursor over one of these words will display the definition in a pop-up message box. If you do not want to indicate glossary terms, right-click on the message and click on the 'Highlight Glossary Terms' menu option. This will clear the automatic underlines across the system. Do this again if you want to restore the underlines.

Add a Response

Double-click on the 'Post Reply' message and type your response as continuous text.

When you have finished typing, click off the text or press the Enter key.

• A icon, your user ID and the time of posting display above your text
• The message Post Reply displays beneath your text

You can also right-click on a post and select the 'Post Reply' menu option. All new replies are added underneath the review thread they are in response to.

Edit Postings

Whilst you are typing a message, the editor automatically checks the spelling and underlines possible spelling errors in red. You can backspace or move the cursor to the errors to correct them. You can also move the cursor anywhere in the message body and add or delete text (press the Delete key).

Once you have posted a message, you can delete the whole message but you cannot edit it.

Copy Review Topic Text

If you want to re-use some or all of the text of a saved Review posting, you can open the text in a (read only) pop-up dialog, by pressing Ctrl+Space.  You can then select the text you want and press Ctrl+C to copy it to the clipboard.

The copied text can then be pasted into a new Review posting or into another document in Enterprise Architect.

Set Review Topic Status

A new review topic has the status of 'Open'. To change the status, right-click on the item and select 'Status' and:

• Alert
• Error
• Accept
• Reject, or
• Closed

If the review topic already has one of these statuses, you can also select the 'Status | Open' option to return the topic to 'Open' status, indicated by the icon.

Set Review Topic Priority

As part of the review, you might want to identify the priority of a point being raised. It might be very important to act on the point, or it might be agreed that the point discusses a 'nice to have' feature that could be addressed at a later date. To set the priority, right-click on the review topic and select one of the options:

• 'Priority | High' ()
• 'Priority | Medium' (), or
• 'Priority | Low' ()

Alternatively, if you decide that an item does not need to be prioritized, select the 'Priority | <none>' option. This leaves the item icon as .

Set Approval Status

Only the named Approver is able to change the status or priority of their Approver item. To set the status, the Approver right-clicks on their Approver item and can select the same options as for a reviewer. However, the final option in this case is 'Approved', which indicates that the selected element has completed review and all decisions and defined changes are approved.

If the Approver selects the 'Approved' option, the indicator then displays to the right of the item and the 0 out of <n> Approvals message is incremented to show that the element has received one of the required Approvals.

Delete a Review Topic or Reply

Right-click on the review topic or a reply, and select the 'Delete Selected' menu option. A prompt displays to confirm the deletion. Click on the Yes button.

If you delete a review topic, all replies associated with that topic will be deleted as well.