Body
Overview
It is possible to access tickets, and other resources, within University of Alaska (UA) Enterprise Service Management (ESM) solution powered by TeamDynamix (TDX). The integration between the ESM and Microsoft Teams comes in the form of a messaging extension, which means it can be accessed any time you are creating a chat message in Teams, both individual/group chats, as well as posts directly to Team channels.
In this article:
What materials do I need?
- Access to UA ESM with Technician, or higher access
- Microsoft Teams
How do I use this technology?
Configure your Microsoft Teams client to use TDX
For each instance of Microsoft Teams where you plan to use the TDX app you will need to do the following one time to pin the messaging extension.
- Open Microsoft Teams.
- From the message box in a direct message, or team channel, click Actions and apps (+) button.
![Microsoft Teams Actions and apps button highlighted](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=d9cb4a86-cd8d-407a-8e3b-69d21c95c13b.png&beidInt=2)
- The Actions and apps dialog will display.
![Microsoft Teams chat Actions and apps dialog example](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=1233305f-91b8-4588-b512-670f5928b653.png&beidInt=2)
- If it doesn't show on the first page of results, search for TDX to find the TDX app, and click it.
![Microsoft Teams Chat Find an App TDX found](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=b86b0e30-3c29-4bdf-b75c-bee37f858632.png)
- Details about the TDX app will be displayed in the Messaging Extensions window, click Add.
![Microsoft Teams Add Messaging Extension dialog window showing TDX app](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=7d67ff98-e7d5-4f30-866b-eed932f46833.png)
- After you have successfully added the TDX messaging extension, the TDX bot will send you a hello chat reminding you to Sign In.
![Microsoft Teams TDX messaging extension welcome chat message](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=078977c1-645e-4474-bb6b-6c9bdb40f267.png)
- Once the app is installed, click the Actions and apps icon to use the messaging extension.
![Microsoft Teams Actions and apps button highlighted](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=d9cb4a86-cd8d-407a-8e3b-69d21c95c13b.png&beidInt=2)
- Click the TDX icon.
![Microsoft Teams Chat TDX plugin highlighted](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=5b1f0a42-d8c5-4d64-a277-14db97477344.png&beidInt=2)
- The app will require you to login the first time you use it.
- It will redirect you to the Microsoft 365 @ UA login screen. Enter your UA Email address, then click Next.
![Microsoft Teams TDX messaging extension login prompt](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=18e6fd97-4cf2-49c0-bddc-1b21fbf46680.png)
- When prompted, enter your password, then click Sign in.
![Microsoft Teams TDX messaging extension login password prompt](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=b55790a2-321c-4df0-b820-934b3522af23.png)
- When prompted to Stay signed in select Don't show this again and then click Yes.
Using the TDX messaging extension
Once you've enabled the TDX app you can search TDX for any of the following work items*:
- Tickets
- KB Articles
- Assets
- Configuration Items (CIs)
- Services
- Projects
- Issues
- Risks
- Project Tasks
* Note: some of these items have not yet been deployed in the UA ESM system; however, when they are deployed they will be searchable.
All of these searches will be done based on permissions in TDX, and will be filtered to show the most relevant types of items (e.g. tickets are filtered based on Status Class to only show New, In Process and On Hold tickets, but exclude Cancelled and Closed tickets). For individuals with access to multiple applications within the ESM, the messaging extension will search across all that you have access to.
- Click on the TDX button when you're composing a message to start a search.
- Select the desired category, it defaults to searching Tickets.
![Microsoft Teams TDX messaging extension search window](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=d4735e1c-439e-4b50-8a57-f04037d9b061.png)
- Enter the search criteria.
![Microsoft Teams TDX messaging extension ticket search example](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=f2cad369-dd5d-42d8-af3e-e26f9e913de9.png)
Once you find a work item that you want to discuss, click on it to add it to your message.
- You can add additional comments or @ mention someone in your comment to notify them via Teams.
![Microsoft Teams TDX ticket with additional text in chat.](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=7b3bd1ae-e9ff-44e0-b6e6-fd146a21a40f.png)
When your message is complete, click Send to send the information to the chat or channel.
- In Teams a card will display information from TeamDynamix.
![Microsoft Teams chat message with TDX ticket displayed](https://service.alaska.edu/TDPortal/Images/Viewer?fileName=439edd35-0211-4da0-a610-25eeab001ff8.png)
Within the card, you can click on the View button or linked details such as the Requestor or Location to view the details of the item in TeamDynamix. You can also click on the Comment button on most cards to add a comment directly to that item's Feed. Commenting in this way will record your comments in the Feed, and allow you to indicate if the comment should be marked as private; however, it will not let you notify others--to notify people or perform a full update, use the View button to view the full details in TeamDynamix.
Important
If the Comment button is used, the feedback will be posted to the item's feed; however, it will not be displayed within the Teams chat.
Use Cases
- Collaborating on a ticket in Teams: Use the TDX Teams integration to provide a summary of the ticket, and a link to the open the ticket in TDNext. This saves time for the collaborators having to search for the ticket in TDNext.
- Updating tickets from Teams: When working on a ticket and collaborating with team members, the TDX Teams integration would allow updating the ticket as part of the conversation in Teams, allowing for quicker updates.
Frequently Asked Questions
- Who can use the TDX integration for Teams?
The TDX integration for Teams is intended for individuals granted access to the ESM solution with technician, or higher access. Its searches happen within the context of the user who is logged in, and require you to have access as a technician.
- Who can see the TDX app in Teams?
Once you have installed the TDX app, all Teams users will be able to see it within the apps list. The TDX app uses each individual's permissions within TeamDynamix, and so individuals without access to TDNext won't be able to use the integration.
- When I post a TDX card in a channel or chat, who can see it?
When you post a work item card in a team channel or chat, everyone in that channel can see the card as part of your message. The links on the card will take the individual to their browser, where they'll be able to access the item only if they have access in TeamDynamix. Similarly, the comment button will check to see if they are able to post a comment so that individuals can't comment on things they don't have access to.
- Can I post a TDX card referencing a ticket from a ticketing app I do not have access to via TDNext?
No. You must have access to the app hosting the ticket via TDNext in order to post a TDX card referencing that ticket.
As referenced above, TDX searches are done based on your permissions within TDX, and will be filtered to show the most relevant types of items (e.g. tickets are filtered based on Status Class to only show New, In Process and On Hold tickets, but exclude Cancelled and Closed tickets). For individuals with access to multiple applications within the ESM, the messaging extension will search across all apps that you have TDNext access to. If you do not have access to the ticketing app, you can simply type the ticket number into the chat window like any other text.
- Can I copy/paste a TDX card from Teams?
When you generate a work item card in a Teams conversation, the card options menu allows you to Copy the card. If you paste that into another Teams conversation, it will include the same card details. If you paste it outside of Teams, it will paste the URL for the card, allowing you to open it in Teams.
- Can I use the Teams Integration in a Private Channel within Teams?
Not at this time. Microsoft currently does not support using messaging extensions like the TeamDynamix app integration within private channels.
Need additional help or have issues
For support, requests may be submitted anytime by Requesting Support for the Enterprise Service Management service. Support Requests are worked by Priority based on the Impact and Urgency of need as well as the order they are received by the IT Employees with the knowledge and permissions to assist with the request.
For immediate assistance please review the Contact Us page for ways to contact the appropriate support group.