Using the file manager [SP JC]

You can browse the folders shared with a Jira project, preview files, edit documents, and more on the file manager. 




About the file manager

The file manager is easily accessible from the sidebar, and it's the cornerstone for all that you can do with the SharePoint Connector app. When you attach files and folders to your issues, you'll also be using the file manager, and it works the same way.

On this page, you'll find everything about using the SharePoint Connector app. From what you can do with your files and folders to managing connected folders. Let's start with the latter since you always need at least one connected folder to use the app.



Managing connected folders

When you open the SharePoint Connector app, the first thing you'll see is a list of the connected folders that you can browse and use to collaborate with your team.

SP-JC-file-manager 1.png

 

SharePoint Connector app home screen:

List of the connected folders to the current Jira project.

  1. Refresh folders list button

  2. Connect folder button

  3. Sort connected folders button

  4. Folder tag button

  5. Folder permissions button

  6. Context menu button

  7. Disconnect folder option

  8. Rename folder option

  9. Open in original storage option

  10. Sign out


Refresh folders list

Use the "Refresh folders list" button to update the connected folders list and access folders your team shared with the latest permissions.


Connect additional folders

In the Getting started page, we covered how to connect your first folder. The empty screen makes it easy to see how to do it, but you can connect as many folders as you need.

 

Instructions:

  1. Click the "Connect folder" button.

  2. Select the storage place where the folder is, or connect a new one if needed.

  3. Navigate to where the folder you want to share with your team.

  4. Select the folders you want to connect by clicking the checkboxes.

  5. Optional: Click the "Permissions" tab to set advanced options. By default, your team will be able to see and edit any folder you connect. For more information, check the permissions page.

  6. Click the "Connect" button.

We recommend connecting a folder where you and your team store your documents, but you can start with a new one by clicking the "New folder" button.

SharePoint tip: If you can’t see the site where your folder is, you can use the “Find site” button and enter your SharePoint address. More info

All done. You can now use your new folder or add more using the same process. 


Sort connected folders

The connected folders are ordered alphabetically by default.

You can change this by clicking the "Sort by name" button and selecting a sort of option and the order you prefer. You can sort them by name or added date. The button will always reflect your selection.


Folder tag

You can add a tag to your connected folders to help you keep them organized and easily accessible.

Adding a tag

To add a tag:

  1. Click the tag button.

  2. Enter a name.

  3. Pick a color.

  4. Click Save.

Editing a tag

To edit the tag, click the tag button again. You can change the description and color. When you’re done, click Save.

Removing a tag

SP-JC-file-manager 2 remove tag.png

To altogether remove a tag:

  1. Click the tag button.

  2. Click the Remove tag button.

  3. Confirm the removal.


Folder permissions

You can set permissions for connected folders from the File Manager at any time by clicking the lock icon. For more information, check the permissions page.


Disconnect a folder

It's also possible to disconnect folders you no longer need. Before getting into how to do it, it's relevant to know that you're only breaking the link in the SharePoint Connector app to the original storage when you disconnect a folder. All your content is safe, but any files and folders you or your team attached to Jira issues from the disconnected folder also lose the link to the original storage and become unavailable.

 

Instructions:

  1. Click the context menu button (look for the ··· button) on the right side of the folder you want to disconnect.

  2. Click the "Disconnect" option.

  3. Confirm by clicking the "Disconnect" button.


Rename connected folder

Instructions:

  1. Click the context menu of the connected folder you want to rename.

  2. Click the "Rename" option.

  3. Enter the new name in the dialog window.

  4. Click the "Save" button. All done. 


Open in original storage

  1. Click the context menu of the connected folder you want to open.

  2. Click the “Open in [Storage]” option.

The folder opens in a few seconds on the original storage site.


Sign out

This option lets you sign out from a connected folder if the “Replicate storage permissions” setting is active. This is useful if you need to connect with a different account.



Managing connected places

While using the SharePoint Connector app, you can connect folders stored in SharePoint, OneDrive for Business, or OneDrive. You only need to authorize the app to access that storage place first. You're in control of your storage places: only you can see the places you allowed, and you, and only you, can disconnect them.

You can view your connected places when you connect a new folder or from the settings page.

Connect folder dialog:

List of your connected places.

  1. Connect place button

  2. Context menu button

  3. Rename place option

  4. Disconnect place option


Connect a place

Instructions:

  1. Click on the "Connect folder" button from the list of connected folders.

  2. If you have connected places before, they will appear on the list. Click the "Connect place" button (1). If you haven't, you'll see a list of all the places you can connect directly.

  3. Select the storage place you want to connect and authenticate.


Connecting a SharePoint folder

 


Connecting a OneDrive for Business

 


Connecting a OneDrive folder

 



Rename a place

You can connect several accounts from the same service, and by default, we add a number at the end when you do it to differentiate them. To help you keep things organized, you can rename your places to something more meaningful to you.

 

Instructions:

  1. Click on the "Connect folder" button from the list of connected folders.

  2. Click the context menu button on the right side of the place you want to rename.

  3. Click the "Rename" option.

  4. Enter the new name and click save.


Disconnect a place 

Before getting into how to do it, it's relevant to know that you're only breaking the SharePoint Connector app's link to the original storage when you disconnect a place. All your content is safe, but any folders you have connected from that place will also be disconnected. Consequently, files and folders you or your team attached to Jira issues from the disconnected folders also lose the original storage link and become unavailable.

 

Instructions:

  1. Click on the "Connect folder" button from the list of connected folders.

  2. Click the context menu button on the right side of the place you want to disconnect.

  3. Click the "Disconnect" option.

  4. Confirm by clicking the "Disconnect" button.



Using the connected folders

Now that we know how to connect folders, it's time to learn how to make the most of the SharePoint Connector app. This section will cover what you can do with files and folders and how to add content to your connected folder.


Navigating your folders

Click a connected folder to view its content. The navigation is at the top, your content is in the center, and extra options are to the right.

  1. Current folder name

  2. Path: you can click in any section to return there

  3. Back button: return to the previous folder

  4. Search field

  5. Content area

  6. New folder button

  7. Upload file button

  8. New document button

  9. Sort button

If your window is too narrow, the right section is hidden, but all the options are available in the context menu next to the navigation.


Using your files

  1. Preview click area

  2. Edit button

  3. Preview button

  4. Context menu

  5. Attach to issue

  6. Download file

  7. Rename file

  8. Open in [Storage]

  9. Delete file

Preview files

You can preview the content of your files by clicking the name of the file you want or the preview button. You can preview images, PDFs, Microsoft Office, and Google Docs files. For more details, check the preview and edit documents page.

Edit documents

You can edit Microsoft Office files from the file manager by clicking the Edit button. A new tab opens with the corresponding Microsoft Office 365 editor, and it's ready for edition. It supports real-time collaboration, so there are no file lockdowns. There's an autosave feature, so when you finish, just close the tab. 

For more details, check the Edit documents on Jira Cloud page.

Attach a file to an issue

In Jira, you can attach files and folders to your issues directly from the file manager.

 

Instructions:

  1. Open the context menu of the file to attach.

  2. Click the "Attach to issue" option.

  3. 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.

  4. Click the "Attach" button.

Download a file

 

  1. Click the context menu of the file you want to download.

  2. Click the "Download" option.

Your browser will open a new tab to download the file automatically. Depending on the browser you're using, the tab closes itself when the download starts, or it might ask you permission to download the file (noticeably Safari browser), requiring that you click the "Allow" button.

Depending on its size, the file will be available in your default download folder after a few moments.

 

Rename a file

  1. Click the context menu of the file you want to rename.

  2. Click the "Rename" option.

  3. Enter the new name in the dialog window.

  4. Click the "Save" button. All done. 

Open in original storage

  1. Click the context menu of the file you want to open.

  2. Click the “Open in [Storage]” option.

The file opens in a few seconds on the original storage site.

Delete a file

  1. Click the context menu of the file you want to delete.

  2. Click the "Delete" option.

  3. Click the "Delete" button in the confirmation dialog. All done. 

 

Upload a file

Via drag and drop

You can drag a file from a local folder and drop it in the folder you have open in the SharePoint Connector app to upload it there. Doing this will save the file in the storage place containing the connected folder, helping you build your single source of truth.

 

Via file picker

  1. Click the "Upload file" button on the right or at the bottom of the open folder.

  2. Look for the file you want to upload in the file picker.

  3. Select the file and confirm.

Depending on the file's size, your file can take a few moments to become available in the app.

 

Creating new documents

With the SharePoint Connector app, you can create documents where needed. They are always ready for real-time collaboration, with no file locks, and are saved back to the storage place containing the connected folder, avoiding duplicates.

For Microsoft Office Documents:

  1. Click the "New Document" button.

  2. Select the kind of document you want.

  3. Type a name for your document and click the "Create" button.

After a few moments, your document appears in the folder, and you can edit it.

 


Folder actions

  1. Preview click area

  2. Context menu

  3. Attach to issue

  4. Rename folder

  5. Open in [Storage]

  6. Delete folder

View the content of a folder

You can see the content of a folder by clicking on it. You can also click folders inside to view the content or click the back button to return to the previous one.

Attach a folder to an issue

In Jira, you can attach files and folders to your issues directly from the file manager.

 

Instructions:

  1. Open the context menu of the folder to attach.

  2. Click the "Attach to issue" option.

  3. 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.

  4. Click the "Attach" button.

 

Rename a folder

Instructions:

  1. Click the context menu of the folder you want to rename.

  2. Click the "Rename" option.

  3. Enter the new name in the dialog window.

  4. Click the "Save" button. All done. 

 

Open in original storage

  1. Click the context menu of the folder you want to open.

  2. Click the “Open in [Storage]” option.

The folder opens in a few seconds on the original storage site.

 

Delete a folder

Instructions:

  1. Click the context menu of the folder you want to delete.

  2. Click the "Delete" option.

  3. Click the "Delete" button in the confirmation dialog. All done. 

 

Create a folder

To help you keep things organized, you can create new folders whenever needed. 

Instructions:

  1. Click the "New Folder" button on the right side (or from the context menu in narrow views).

  2. Enter the name in the dialog window.

  3. Click the "Save" button.

After a few moments, the view reloads, and your new folder will be listed and ready to use.

Sort

The content of your folders is ordered alphabetically by default. 

You can change this by clicking the "Sort by name" button and selecting a sort of option and the order you prefer. You can sort content by name, type, modified date, and file size. The button will always reflect your selection.



Wrap up

Now you know all that you need to use the file manager. You can now learn more about previewing files, editing documents, or attaching files and folders to Jira Cloud issues.

If you still have questions about the topics covered on this page, visit our support portal and send them to us. Our team is always happy to help.