Collaborate

You can collaborate with other stakeholders through email, comments, or integrated chat tools.

In this topic:

Email

You can send emails directly from an item to other users. The email contains information about the item as well as a link to open the item.

To send an email from an item:

1. In the toolbar, click the Send by Email button .

2. Fill in the relevant fields:

   Field	Description
   To, CC, BCC	The workspace users, teams, and external emails to which the message will be sent. Click the field for a list of suggested recipients. The item's stakeholders, such as Owner and Author, are listed first to help you select likely recipients. For details on adding external users, see Add external email addresses.
   Send me a copy	Adds you as a recipient.
   Set as important	Adds a high importance flag to the email.
   Message	The message to send. Click within this area to access layout and font tools. Tip: To include links to related items, type the hash symbol, #, and use a prefix to search for text in the item's title. For example '#ftest' opens a list with all features that contain test in their title. Click on the hash symbol on the toolbar to view a list of supported prefixes.
   Include attachment	Adds the item's attachments as attachments to the email.
   Add email content as a new comment	Adds the email message contents as a comment to the item.

3. Click Send.

Back to top

Copy links

You can copy links to items, and paste them into any application.

To copy a link to an item, in the toolbar, click the Copy Link button .

You can also select multiple items in a grid and copy their links. The links are pasted on separate lines.

Back to top

Comment on items

Users can discuss items by leaving comments. Comment authors can edit their comments, and recipients can do a quick reply.

To comment on items:

1. Open an item.

2. Click the Comments tab to open the comments pane.

3. In the comments pane, enter your comment. You can use the buttons in the rich text editor toolbar to format your comment.

4. You can add the following items to your comment:

   Item	Steps
   User tag	Type "@" and start typing a user's name, or select the user from the list. Users mentioned in earlier comments and other stakeholders appear first in the list. The comment is added to the Comments tab in the tagged user's My Work area. The user also receives an alert. For details, see My Work.
   Link to other items	Type #, and add one of the following prefixes: w for work item s for user story q for quality story e for epic f for feature d for defect k for task t for test r for requirement b for BDD Start typing a word from an item's title. For example, #dtest searches for the string "test" in the existing defects.
   Image	Click in the comment box, and then paste or drag an image you want to add. Tip: To view an image, click the attached image to view it in full size. If a comment has a link to an image, click the link to open the image in a new browser tab. An image added to an item's comment is also added to the item's Attachments tab. For details, see Attachments.

Perform actions on comments

To edit, reply, or delete a comment, click the More options button , and then select the relevant action.

Action	Steps and behaviors
Edit	Edit your comment and click Save. You can only edit comments that you authored.
Reply/ Reply all	Click Reply to reply to the comment. The reply includes a preview of the original comment plus a mention of its author. Reply all does the same as Reply, in addition to mentioning all other users who were mentioned in the original comment. Click the Replied to line to jump to the original comment.
Delete	Click Delete to confirm the action.

Quick reply

If you are mentioned in a comment, you are sent an email notification that includes the comment's text. The notification includes a Quick Reply button. Quick reply is supported both on desktop and mobile devices.

To perform a quick reply to a comment in which you were tagged:

1. Click the Quick Reply button in the email.

2. If requested, provide your login details. A window opens with the item's name as a title, and a comment area.

3. In the comment area, add a reply to the comment in which you were mentioned, or to any other of the item's comments.

4. Click Reply. Your reply will be added to the item as a new comment.

Back to top

Add external email addresses

You can send emails directly from an item to recipient lists of external email addresses and individual recipients who are not members of the workspace.

For example, a process author might want to send an email manually or schedule a Send Email auto action to notify a PDL, Teams Channel, or any other external email about an important step in the process, such as the beginning of a new release.

To add email addresses of non-user recipients:

1. Prerequisites.

   • You must have the following permissions:

     • Send Emails. Granted by default to all roles.

     • Send External Emails. Granted by default to space admin only.

     For details, see Permission categories and types.

   • To activate this feature, your administrator must enter the allowed email domains as values for the ALLOWED_EXTERNAL_EMAIL_DOMAINS parameter. For details, see Configuration parameters.

     Note: If an allowed domain is removed from the list and a user has external emails with such domains, these emails are hidden but not deleted. If the administrator returns this domain to the list, the saved external emails become visible again.

2. To send an email to stakeholders who are not subscribed users of the workspace, add them manually in the To, CC, BCC text box. For details, see Email.

   Emails to non-user recipients can also be sent through the Send Email auto action in a release process. For details, see Auto actions.

Back to top

Chat with Slack users

To work with Slack, you administrator must set up a Slack integration for your workspace. The integration is enabled for backlog items and pipeline run failures. For details, see Set up a Slack integration.

To collaborate with Slack:

1. Click Chat w/ Slack to create a Slack channel for an item or to open an existing channel.

   • In a backlog item, click Chat w/ Slack in the Details tab.

   • In a pipeline run, click Chat w/ Slack in the Builds or Test Runs tabs.

2. Provide your authentication details and log in. This is only required the first time you open a chat with Slack. The Slack channel opens with the following users:

   • For a backlog item, the item's author and owner.

   • For a pipeline run, all users whose commits were included in the pipeline run.

3. Compose a message and send it. If the administrator approved publishing data on Slack channels, information is sent from the backlog item to the channel.

Back to top

Discuss on Microsoft Teams

The integration with Microsoft Teams allows you to collaborate with others within your organization, by sharing information about a specific entity.

This collaboration requires your administrator to set up a Microsoft Teams integration for your workspace. The integration applies to pipeline runs and all work items: epics, features, user stories, quality stories, and defects. For details, see To add Microsoft Teams as a collaboration tool:.

To send a comment to a channel:

1. Make sure that you are logged in to your Microsoft account within your organization.

2. Open an item and click the Discuss on Teams button . The Discuss on Teams dialog box opens.

   The Discuss on Teams button is enabled for the supported items.

3. If the item has already been discussed on Teams, the previous team and channel are selected by default.

   If this is the first time the item is being discussed on Teams, or you want to discuss the item in a different team and channel, select a team and channel. You can only select channels to which the logged-in user has access.

4. The Message box contains a link to the current entity and a reference to all Related users. Mention users that you want to address, using the @<name> notation that you use in comments. Discuss the item in the message box.
5. Select whether to add a comment to the item about the discussion on Teams. A link to the message in Teams will be added in the comment, along with the team and channel names.
6. Click Post to send the message to the channel, or Post and Open to send the message and open the selected channel in Microsoft Teams.

Back to top

Handle simultaneous changes

This product uses optimistic locking to prevent data loss when users make changes to the same entity concurrently. If your changes include a field that was modified by someone else before you saved, you are prompted to refresh the entity from the server and make your changes again. Click the Refresh and restore button to reload the entity from the server instead of just undoing your changes.

Back to top

See also:

• Follow items
• ChatOps integrations