Body
Overview
Attachments can be added to an Enterprise Service Management (ESM) ticket at any time to facilitate access to supporting documentation necessary to fulfill the requested work. These can be text, images, or other files as appropriate. Attachments can be added by customers, as well as department employees as they work the ticket.
Tip
This article's primary focus is for UA Employees with access to one or more ESM applications (i.e. TDNext). While some of the information here may be useful, a customer oriented
Add an Attachment to a Ticket KB article may be more applicable.
While directly attaching files is a great method for historical references, it does make it more difficult for individuals to collaborate on the the file(s). In order to accomplish this, a person would need to download the attachment, and then re-attach the revised version. The ESM attachments system supports both file uploads from a computer, or attaching external documents from other file hosting services. Creating a link to a file located within an online hosting service creates a much more effective method for multiple individuals to collaborate on active files. The ESM system currently supports the following hosting services:
- Google Workspace @ UA - Google Drive
- Microsoft 365 @ UA - OneDrive for Business
Warning
Physical Files
All attachments on Tickets are visible in the Service Portal by anyone that can see the Ticket. This is the Primary Contact (Requestor), and any Additional Contacts on the Ticket. They are also visible to all individuals with access to the department's ticketing application within TDNext.
External Files
All hosted attachments are visible within the ESM system; however, access to the file(s) is restricted based up on which Visibility Option is selected at the time the link was created to the source file. The ESM system only stores a pointer to the source file, and does not create a copy of the file(s) stored on the hosting service.
In this article:
What materials do I need?
- Web Browser
- Access to either the Service/Client Portal, or TDNext
How do I use this technology?
File Restrictions
There are a few restrictions for any files that are directly uploaded to the ESM system. These restrictions include both file size, and file type. File size is enforced to reduce the time it takes to upload file attachments, while type enforcement occurs to prevent dangerous files from being added as attachments.
File Size Restrictions
The default file size restriction for physical attachments is 4 MB. However, a number of components within the ESM system often support higher file size. In these cases, the limit will be increased accordingly. The following components have file size restrictions greater than 4 MB:
- Asset Contracts: 20 MB
- Project Requests: 50 MB
- Ticket Requests:
- 20 MB - This is the drag-and-drop feature for content being uploaded in a single session.
- 50 MB - When in a ticket, clicking the Add Attachment from my computer option in a single session.
- Knowledge Base Articles:
- 4 MB - This is the drag-and-drop feature for content being uploaded in a single session.
- 50 MB - When editing a KB article, clicking the Add Attachment from my computer option in a single session.
File Type Restrictions
The ESM system enforces the following file type restrictions for files submitted through email. This prevents certain dangerous file types (such as scripts) from being added to the system. The following file types are allowed:
- ai
- bmp
- csv
- doc / docx
- dotx
- eml
- gif
- htm / html
- ics
- jpg / jpeg
- log
- mdb
- mp3
- mp4
- mpg / mpeg
- mpp
- msg
- pdf
- png
- ppt / pptx
- psd
- rar
- rtf
- swf
- tdplan
- tif / tiff
- txt
- vcs
- vsd / vsdx
- wav
- wma
- wmv
- xls / xlsx
- xml
- zip
The ESM system does not enforce these restrictions for attachments added within the application's web interface.
Adding Attachments
Attachments can be added using one of the following methods, depending on where in the system you are.
Service Portal (Customer)
-
- Login to the Service Portal.
- Locate and open the desired ticket.
- Do one of the following:
- Drag and drop the desired attachment(s) into the Attachments box in the web browser.
- In the Attachments box click the Add Attachments button.
- An Add Attachments dialog window will open.
- Click the link associated with where your file is located (i.e. from your computer, from Google Drive, or from OneDrive for Business).
- If from your computer is select, do the following:
- Click Browse.
- Navigate to the location on your computer containing the desired file(s).
- Select the file(s).
- Click Upload.
- In the Add Attachments dialog, confirm that the correct file(s) have been selected.
- Click Upload.
- Wait while the file(s) are uploaded.
- After the upload successfully message is displayed, close the Add Attachments window.
- If from Google Drive is selected, do the following:
- Click Select from Google Drive.
- At the Sign in to continue to UA TeamDynamix Google Drive Integration prompt enter your UA Email address, then click Next.
- The screen will refresh to show UA's standard Google Workspace for Education logoin prompt. Login as normal.
- At the UA TeamDynamix Google Drive Integration wants access to your Google Account prompt, click Continue.
- In the Select Attachments window, click the desired file(s).
- Click Select.
- After the uploaded successfully message is displayed, close the Add Google Drive Attachments window.
- If from OneDrive for Business is selected, do the following:
- In the Add OneDrive for Business Attachments dialog select the desired Visibility Options from the drop-down menu.
- The Microsoft 365 visibility options determines the permissions which will be enforced for the link(s). Available options are:
- Organization Default
- Visible to Organization
- Editable by Organization
- Visible to Anyone
- Editable by Anyone
- Click Select from OneDrive for Business button.
- If this is the first time you've attempted to link a file from your OneDrive for Business account to ESM you may see the following Permissions requested prompt, click Accept.
- In the Pick files dialog click the desired file(s).
- Click Select.
- After the uploaded successfully message is displayed, close the Add OneDrive for Business Attachments window.
- Verify the desired file(s) have been attached/linked to the ticket.
TDNext (Department Employee)
- Login to the TDNext.
- Locate and open the desired ticket.
- Do one of the following:
- Drag and drop the desired attachment(s) into the Attachments box in the web browser.
- In the Attachments box click the Add Attachments button.
- An Add Attachments dialog window will open.
- Click the link associated with where your file is located (i.e. from your computer, from Google Drive, or from OneDrive for Business).
- If from your computer is select, do the following:
- Click Browse.
- Navigate to the location on your computer containing the desired file(s).
- Select the file(s).
- Click Upload.
- In the Add Attachments dialog, confirm that the correct file(s) have been selected.
- Click Upload.
- Wait while the file(s) are uploaded.
- After the upload successfully message is displayed, close the Add Attachments window.
- If from Google Drive is selected, do the following:
- Click Select from Google Drive.
- At the Sign in to continue to UA TeamDynamix Google Drive Integration prompt enter your UA Email address, then click Next.
- The screen will refresh to show UA's standard Google Workspace for Education logoin prompt. Login as normal.
- At the UA TeamDynamix Google Drive Integration wants access to your Google Account prompt, click Continue.
- In the Select Attachments window, click the desired file(s).
- Click Select.
- After the uploaded successfully message is displayed, close the Add Google Drive Attachments window.
- If from OneDrive for Business is selected, do the following:
- In the Add OneDrive for Business Attachments dialog select the desired Visibility Options from the drop-down menu.
- The Microsoft 365 visibility options determines the permissions which will be enforced for the link(s). Available options are:
- Organization Default
- Visible to Organization
- Editable by Organization
- Visible to Anyone
- Editable by Anyone
- Click Select from OneDrive for Business button.
- If this is the first time you've attempted to link a file from your OneDrive for Business account to ESM you may see the following Permissions requested prompt, click Accept.
- In the Pick files dialog click the desired file(s).
- Click Select.
- After the uploaded successfully message is displayed, close the Add OneDrive for Business Attachments window.
- Verify the desired file(s) have been attached/linked to the ticket.
Confidential Attachments
Important
Only files provided by the customer, additional contacts added to a ticket, or that are to be shared with the customer should be attached/uploaded to the ticket.
Departments needing to reference confidential material that should only be seen/accessed by a specific audience, such as department employees for internal work products, should not attach the file(s), even as an external file, to the ticket. Instead we recommend the following options.
Text Only Content
If the contents of a file is text only, with minimum "rich-text formatting", none of the meta-data associated with the file is relevant/import (e.g. file creation date, file modified date, etc.), and the overall text length is short, the contents of the file can be copy and pasted into the ticket as a private comment.
Before using this option, also consider how difficult the contents would be to read/comprehend as a comment since not all rich-text formatting maybe retained when adding a comment.
- Open the desired file.
- Select the desired content.
- Copy the content.
- Open ticket.
- Click Comment.
- Select Make comments private (only visible to <App Name> users).
- Paste text into comment field.
- Click Save.
All other Content
Department leadership should identify a single hosting service (i.e. Microsoft Teams, Google Shared Drive) that all confidential ticket material is stored within. Herein referred to as Confidential Repository.
Any content that does not qualify for the Text Only Content above should be archived as follows.
- Save the file to your desktop.
- Prepend the ticket number to the file name.
- For example a file with the name "Confidential Investigation Request.docx" would become "111111 - Confidential Investigation Request.docx"
- Open Department's confidential repository (e.g. MS Teams ESM UAA Example App)
- Navigate to appropriate location in the Confidential Repository (e.g. General channel -> Files -> Confidential ESM Attachments)
- If one does not already exist, create a new folder with a name of "<Ticket ID> - <Ticket Name>" (e.g. 123456 - Security Investigation).
If this is the first confidential file associated with the ticket, do the following:
- Follow the hosting service's process for retrieving a link (i.e. URL) to the newly created folder. If provided an option to determine access permissions the link will grant select People with existing access (or equivalent) whenever possible.
- In a web browser access the department's ESM ticketing app.
- Open the relevant ticket.
- Click Comment.
- Select Make comments private (only visible to <ESM Department Name> users).
- Add the following text: "Confidential files associated with this ticket can be accessed via the following url."
- Add a new line by pressing return.
- Paste the URL to the file uploaded into Confidential Repository into the comment field.
- Click Save.
- Click Comment.
- Select Make comments private (only visible to <ESM Department Name> users).
- Add the following text: "A new file has been added to the ticket's confidential repository."
- Add any helpful information about the file such as the file name, and the purpose of the file in regards to the ticket.
- Optional, paste the URL to the file uploaded into Confidential Repository into the comment field.
- Click Save.
- Delete the file from your desktop, and empty the trash.
Need additional help or have issues
For support, requests may be submitted anytime using the appropriate Enterprise Service Management form. Requests generate a Ticket which will be worked in order received and urgency by IT Employees with the knowledge and permissions to assist with the request.
For immediate assistance please review the Contact Us page for the appropriate support group.