Discussions

Ribbon

Start > Collaborate > Discussions > Discuss

Context Menu

Browser window > Right-click on object > Collaborate > Discuss

On diagram > Right-click on element > Collaborate > Discuss

Keyboard Shortcuts

Ctrl+9 > Discuss

Create a discussion

The window displays the message Create new Discussion. Double-click on this message and type your posting as continuous text (no carriage returns). The text automatically wraps at the border of the Collaborate window. You can also paste copied text from the clipboard into the discussion item, by pressing Ctrl+V.

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

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

• An open expansion arrow and a icon display to the left of your text
• Your user ID and the time of posting display just underneath your text, followed by the text 0 Replies
• The message Post Reply displays below your text, and the message Create new Discussion displays above your text

You can also right-click on the window and select the 'Create new Discussion' menu option. All new discussions are added to the top of the 'Discuss' tab.

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 a user does not have an avatar image, a default 'head and shoulders' silhouette displays as the avatar.

Monitor Discussion

Once a discussion has been started on an element, you can set a flag to notify you whenever a response is posted to the thread. To set the flag, right-click on the element name in the Browser window or in a diagram and select the 'Collaborate > Monitor Discussions' option. The flag then operates for your user ID.

When a response is posted in a monitored discussion, the notification is a Msg button that displays at the right hand end of the application title bar. 

1. Click on the drop-down arrow; a list of the monitored elements that have unopened responses is displayed.
2. Click on the element to investigate; the Collaborate window displays, showing the 'Discuss' tab and the response to the discussion thread.

If you want to remove a discussion flag - or all discussion flags you have set - on the 'Discuss' tab of the Collaborate window click on the icon and select the 'Manage Monitored Discussions' option. The 'Manage Monitored Discussions' dialog displays, showing the monitored element names and their type, author and last-modified date.

• Click on a specific element, or Ctrl-click on multiple names, and click on the Delete button to stop monitoring the discussions on those elements, or
• Click on the Select All button and on the Delete button to clear all elements from your monitored discussion list
• If you have selected elements but do not want to remove all of them, click on the Clear All button and make a different selection

If you are spending time working in diagrams, there is also a convenient facility to monitor and access Discussions on elements within the diagram. See the Collaboration Support in Diagrams Help topic.

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 date and time of posting display above your text
• The message Post Reply displays above your response
• The Replies count is incremented underneath the original posting

You can also right-click on a post and select the 'Post Reply' menu option. All new replies are added underneath the discussion thread they are in response to, with the most recent reply at the end.

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 discussion text

If you want to re-use some or all of the text of a discussion item, you can copy it to the clipboard by selecting the text and pressing Ctrl+C before you save it. You can then paste the text into a new discussion item or into another document in Enterprise Architect.

Set discussion status

The icon against a new discussion indicates that the discussion has the status of 'Open'. To change the status, right-click on the discussion item and select either:

• 'Status | Awaiting Review' () or
• 'Status | Closed' ()

If the discussion already has one of these statuses, you can also select the 'Open' option to return the discussion to 'Open' status.

When you review the discussions in the Collaborate window, you might want to include discussions that have the status of 'Closed', or you might prefer to hide them. To toggle the inclusion of closed discussions, right-click on the body of the window and click on the 'Show Closed Topics' option.

Set discussion priority

As part of the discussion, 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 discussion 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 .

Delete a discussion or reply

Right-click on the discussion 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 discussion, all replies associated with that discussion will be deleted as well.

Review Discussion History

Either:

• Click on the object name bar at the top of the window, or
• Right-click within the body of the window, or
• Select the 'Start > Collaborate > Discussions' ribbon option

In each case, select the 'Discussion History' option.

The Collaborations window displays at the 'Discussions' tab, listing all existing discussion items on elements. You can right-click on the:

• Column header band and select options to display the 'Field Chooser' and add to or reduce the number of columns, or to display the Filter bar to filter the list for discussions having a specific property such as the user who posted the discussion items, or the person who created the elements (element Author)
• Body of the window and select to open a preview pane on the right or at the bottom of the window, to instantly see each discussion thread as you click on it in the list; you can also hide the preview pane if you do not need it
• Body of the window and on the 'Visible Timeframe' option, selecting to show discussions posted today, or during the 3, 7, 30 or 90 days prior to today; the 'Today +' option also enables you to show postings from today and the 20 most recent postings prior to today
• Body of the window and select to refresh the list to include any discussions that have been posted since you opened the discussion history
• Selected element and select to:
       -  Find the discussed element in the Browser window or diagrams
       -  Display the 'Properties' dialog for the discussed element
       -  Review and edit the discussion in the Collaborate window, opening the window if it is
          not currently available