Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt

Learn how to attach files and folders for your customers with the Team Files SharePoint Connector app.

Table of Contents
maxLevel2


About the

Team Files

SharePoint Connector app on Jira Service Management

The Team Files SharePoint Connector app on Jira Service Management projects works the same way as in the regular Jira projects, with some extra features. You can attach files and folders to share knowledge with your team, and now you can also do it for your customers.

On this page, we'll show you how to do just that, from the issue view and the file manager, while setting the appropriate permissions, helping you and your team to keep all the information updated and in one place. If you only want to attach for your team, check the https://teamfiles.atlassian.net/wiki/spaces/TFD/pages/383713328/Attaching+files+and+folders+to+issues page.


Attaching files and folders for customers from the issue view

It's straightforward to add the Team Files SharePoint Connector app to your issues, enabling you to attach files and folders for customers. 

Adding the

Team Files

SharePoint Connector app to the issue

By default, Jira hides installed apps. So the first step is to add the Team Files SharePoint Connector app to your issue. 

Instructions:

In the issue, click the "Attach items with Team FilesSharePoint Connector" button, or the Team Files SharePoint Connector icon, below the issue title.

Tip

And that's it. The app will load below the issue description and will now always appear when you return to that issue page (but it's possible to hide it again).

Keep in mind that you also need to add the app to the issue when you attach files and folders to issues from the file manager.

Selecting the files and folders to attach

With the app in place, you can now start attaching files and folders.

jira attach customer.mp4

Instructions:

  1. Click the "Attach for customer" button.

  2. Browse your connected folders in the

Team Files
  1. SharePoint Connector dialog. If you haven't connected any, you can do that so now. You can also connect more folders from the context menu as you would in the file manager.

  2. Select the files and folders you want to attach by clicking the checkbox. You'll see them appear on the live preview pane on the right side.

    Image Modified
  3. You can now click the "Customer Permissions" tab or click the "Attach" button if you don't need to grant any permissions.

Info

By default, customers can't download or edit files attached to the issue. 

Setting permissions

The attached files and folders for customers are always visible but only editable and downloadable if you allow it.

Instructions:

  1. In the

Team Files
  1. SharePoint Connector dialog, click the "Customer Permissions" tab.

  2. Click the toggle buttons to grant

the
  1. additional permissions to customers.

  2. If you have already selected all the files you

wanted
  1. want to attach, click the "Attach" button. Otherwise, click the "Attachments" tab to select more. The permissions you selected will also apply.

Tip

All done. Your attached files and folders are now visible on the issue page and the customer portal. 

Info

The attached files and folders for customers have a white background. In contrast, the files and folders shared with the team have a light yellow background to help you distinguish them the same way Jira differentiates messages for the customer and internal notes.


Attaching files and folders for customers from the file manager

In Jira Service Management, you can attach files and folders to your issues directly from the file manager, accessible from the sidebar, whether it's for your team or customers.

Selecting the files and folders to attach

jira fm attach customer.mp4

Instructions:

  1. In the file manager, navigate your connected folders until you can see the file or folder you want to attach to an issue. 

  2. Open the context menu of the file or folder to attach.

  3. Click the "Attach for Customer" option.

  4. Select the issue where you want to attach the file or folder. You can use the search field to look for a particular issue or even use the JQL search.

    Image Modified
  5. You can now click the "Customer Permissions" tab or click the "Attach" button if you don't need to grant any permissions.

Info

By default, customers can't download or edit files attached to the issue. 

Setting permissions

Instructions:

  1. In the

Team Files
  1. SharePoint Connector dialog, click the "Customer Permissions" tab.

  2. Click the toggle buttons to grant

the
  1. additional permissions to customers.

  2. If you already selected the issue, click the "Attach" button. Otherwise, click the "Issues" tab to choose one.

Tip

All done. Your attached file or folder is now visible on the customer portal. You can click the "View issue" button to jump to the issue page.

Info

The attached files and folders for customers have a white background. In contrast, the ones shared with the team have a light yellow background to help you distinguish them the same way Jira differentiates messages for the customer and internal notes.

You need to add the app to the issue page to view the attached files and folders from the file manager.


Removing attached files and folders for customers

At any moment, you You can remove specific files and folders attached to an issue at any moment.

Instructions:

  1. Click the "Manage" button.

  2. Click the "Unlink" button

of
  1. on the files and folders you want to remove.

    Image Modified
  2. Click the "Done" button.

Tip

All done. Your files and folders are safe and sound in your storage place but no longer connected to the issue.

Note

This action is undoable, but you can attach the files and folders again.


Hiding the app

You can also hide the entire app on the issue page while keeping all the files and folders attached. Files and folders attached for customers are always visible in the customer portal.

Instructions:

  1. Click the context menu on the top right corner.

  2. Click the "Hide

Team File
  1. SharePoint and OneDrive" option.

Tip

All done. Your files and folders are still attached to the issue but not visible. To show them again, add the app back.


Wrap up

Now you know how to attach files and folders for your customers. Don't forget you can attach files and folders just for your team

If you still have questions about attaching files and folders to your issues, visit our support portal and send us your questions. Our team is always happy to help.