Share Files or Folders

You can share files and folders with other users or teams to give them access to content so that they can benefit from the information or contribute to it.

Who does this apply to?

  • Users who are assigned a role with the appropriate permissions for the object type and file type (public or private), including the Read or Manage (only for the file type) permissions, and the Read permission for Users or Teams.
  • Users who are content owners or have the Share permission for any files or folders that are shared with them.

Setting Up Permissions in the Role

Note

The information in this section is for a system administrator. For more information, see Permissions and Create Roles.

For a user to be able to share files and folders, the system administrator must create custom roles that have the appropriate permissions for the following:

  • Object type (for example Content Link or Planning Model), including the Read permission

  • File type (Public Files or Private Files), including the Read or Manage permissions

    Note

    In most cases, the Read permission for Public Files or Private Files is enough to allow users to share files and folders. In cases where you want users to have elevated administrator-type permissions, select the Manage permission.

  • Users or Teams, including the Read permission

The system administrator then assigns the custom roles to users. It is up to you, the user sharing the file or folder, to choose whether to let other users share that file or folder. For example, the system administrator creates two custom roles:

  • Content creator role that has Create, Read, Update, and Delete permissions selected for Content Link.

  • Content viewer role that has Read permission selected for Content Link.

Both custom roles have Read selected for Public Files and Read selected for Users or Teams. The system administrator assigns the content creator role to you and the content viewer role to a different user. In the Public folder, you create a content link file. When you share the file with that user, you can choose to give them the Share permission so that they can also share the file.

Using Predefined Access Levels or Custom Access for Sharing

Note

The information in this section focuses on how you, the content owner or user with the Share permission, shares files and folders with others. It's assumed that the system administrator has set up all the roles to have all relevant permissions available to the users (as described in the previous section) and has assigned the roles to the users.

You can share files for data objects, such as stories, models, and analytic applications, and folders by giving users or teams a predefined access level (View, Edit, or Full Control) or by choosing Custom to give them custom access.

Predefined access levels are groups of permissions and can be given to users or teams. In many cases, the predefined access levels will meet your needs. They are also easier to manage than using custom access settings. For example, to allow some users to view a file but not edit it, you can give them the View access level.

Access Level Available Permissions
View Read, Copy, View Comment, Add Comment

If Copy is selected, Read is automatically selected.

Edit Includes all View access level permissions plus: Update, Create files*, Create folders*, Maintain

*applies only to folders

Full Control Includes all View and Edit access level permissions plus: Delete, Delete Comment, Share

Users with this access level can move files or folders between locations.

Note

The functionality for Execute is currently not available and reserved for future enhancements. You can ignore this option as selecting or clearing the checkbox has no effect on the functionality.

If the predefined access levels don’t suit your needs, select Custom and choose which permissions to give users and teams access to. For example, if you give a user Full Control access, that user automatically gets access to both Delete and Share content. But if you choose Custom, in the Set Custom Access dialog, you can give the user access to Delete content but not Share content.

Sharing a File

Context

You can share a file from the Files page or when you have it open.

Note
  • When sharing a file, for example a story, that depends on underlying objects, like models or datasets, you'll also need to share to those other objects with the same access level as the file. Furthermore, if the dependencies are from different workspaces, you must also request access to the workspaces and objects on behalf of those users.

  • If an object in your story uses a private version, the dimension member IDs of the private version might be exposed when you share the story with another user.

Procedure

  1. From the side navigation, choose Files, select one or more files, and select (Start of the navigation pathShare Next navigation step  ShareEnd of the navigation path) to open the Share dialog.

    Or if you have the file open (for example, a story or analytic application), select (Share).

  2. Under Add Users or Teams, select (Add usernames or teams) to open a dialog where you select the users or teams that you want to share the file with.

    If you know the user and team names, you can type them instead of using the dialog.

    Tip
    • When working within a workspace, you can share files only with other members of the workspace.

    • When working in the My Files view, you can select All Users to share with everyone. This option can be disabled by a system administrator setting when configuring the system settings. For more information, see Configure System Settings.

  3. Select the access level you want to assign for those users, or choose Custom to set custom access.
    Note
    • The Public Folder itself can't be deleted or copied, but system administrators can select Copy and Delete permissions on the folder so that items that are created in this folder will inherit the sharing settings by default.
    • For stories and analytic applications, users with only the Read permission are able to change the variables for the model in the story or analytic application. Changing the model variables updates all the charts and tables in the story or application unless they were overridden. Model variable settings set by the viewer are not saved.
  4. (Optional) For some types of files, for example, stories, analytic applications, and digital boardrooms, you can select Customize Link to customize the URL link:
    • For analytic applications, enter one or more URL parameters.
    • In the custom link field, enter meaningful key words for your custom link, to make it shorter and easier to remember.

  5. (Optional) To email people to let them know that you are sharing a file with them, select Email new recipients.

    The email is sent the first time the file is shared with someone. This option is cleared by default. If you choose to add all users, this option is not available. The users will still receive a notification in the system, but they won't receive an email.

    If you later change their access rights, they will receive a notification in the system, but they won't receive an email.

  6. (Optional) If the file you are sharing is a story that contains global bookmarks and you have it open in Edit mode, select Apply global bookmark default, and then select a bookmark to use

    For more information about bookmarks, see Bookmark and Share Story Views.

    If you're a system administrator and want users to share global bookmarks, ensure that the custom roles have the permissions set for the Global Bookmark object-type. For more information, see Permissions.

  7. Choose Share to share the file.

    You can review the changes and then close the dialog.

Results

After the file is shared, the Shared with list appears below the sharing settings. Expand the list to see all users and teams and their access level for the shared file. You can use the list to change the sharing settings for the file.

On the Files page, the icon appears beside the name of the shared file. You can select the icon to reopen the Share dialog and see or change the file's sharing settings.

Sharing a Folder

Context

The steps for sharing a folder are the same steps as sharing file with a couple of differences.

Procedure

  1. From the side navigation, choose Files, select one or more folders, and select (Start of the navigation pathShare Next navigation step  ShareEnd of the navigation path). to open the Share dialog.
  2. Under Add Users or Teams, select (Add usernames or teams) to open a dialog where you select the users or teams that you want to share with. Or if you know the name of the user or team, you can type it instead.
    Tip
    • When working within a workspace, you can share folders only with other members of the workspace.

    • When working in the My Files view, you can select All Users to share with everyone. This option can be disabled by a system administrator setting when configuring the system settings. For more information, see Configure System Settings.

  3. Select the access level you want to assign for those users, or choose Custom to set custom access.
  4. (Optional) If the folder has existing subfolders and files that you also want to share, select the Share existing subfolders and files checkbox.

    By default, the checkbox is cleared and must be set each time you share a folder. When the checkbox is cleared, the sharing settings are only applied to the selected folder. The sharing settings of its subfolders and files are not affected.

    For example, you share a folder and select Share existing subfolders and files. All existing subfolders and files will inherit the same sharing settings of the selected folder. However, if you don't select Share existing subfolders and files, the sharing settings of the selected folder won't be applied to any of its existing subfolders or files, and all subfolders and files will retain their original sharing settings. Also, regardless of the setting of the Share existing subfolders and files checkbox all new subfolders or files created in the selected folder will automatically inherit the sharing settings.

  5. (Optional) To email people to let them know that you are sharing a file with them, select Email new recipients.
  6. Choose Share.

    You can review the changes and then close the dialog.

Results

After the folder is shared, the Shared with list appears below the sharing settings. Expand the list to see all users and teams and their access level for the shared folder. You can use the list to change the sharing settings for the folder. For users and teams that have inherited sharing settings from the parent folder, the icon appears next to their names.

On the Files page, the icon appears beside the name of the shared folder. You can select the icon to reopen the Share dialog and see or change the folder's sharing settings.

Viewing the Shared with List

After a file or folder is shared, you can open the Share dialog. The lower half of the dialog has the Shared with list, which you can use to see who the item is shared with or to change the sharing settings.

  • When one file or folder is selected, the Shared with list shows all the users and teams who have shared access to the file or folder and their access level.

  • When multiple files or folders are selected, the Share with list shows all users and teams who have access to all the selected items. However, the access level for each user or team might not be obvious.

    • If a user or team has the same access level for all the selected items, the Access column shows the access level. For example, one folder and two files are selected. The user has Edit access for all items.

    • If a user or team has different access levels for each of the selected files or folders, the Access column shows Multiple. For example, one folder and two files are selected. The user has View access to the folder, Edit access for one file, and no access to the other file (because it’s not shared with them). The access level shows Multiple.

      Also, the list doesn’t show the details of which files or folders are shared with which users or teams and their access levels. For example, one folder and two files are selected. You won’t know which items a user has View access for. For detailed information, you need to open the Share dialog for the individual file or folder.

You can change the access level for a single user or team directly in the Access column, or you can use the toolbar options for changing the share settings for several users and teams:

Tool Description
(Search) Lets you search for a user or team.
(Unshare) Lets you unshare (or stop sharing) the selected files or folders with the selected users or teams.
Lets you change the sharing settings for files and folders.
  • Copy from parent: Applies the existing sharing settings from the parent folder to the selected files or folders. This option appears for folders and files that have a parent folder and is available when no users or teams have been selected.

  • Apply to subfolders: Applies the existing sharing settings from the selected folder to all its subfolders and files. This option appears only for folders and is available when no users or teams have been selected.

  • View, Edit, or Full Control access levels: Applies the new access level to the selected files and folders for all selected users and teams.

  • Custom: Applies only the permissions that you custom select to the selected files and folders for the selected users and teams.

Caution

Changes to the sharing settings for files and folders and access levels for users and teams are immediate and can’t be easily reversed.

For example, you choose to apply the sharing settings from the parent folder to the selected folder (Copy from parent). After the change is applied, users who previously didn’t have view or edit access to the files and folders will get that access. Or users who had view and edit access to the files or folders, will lose that access.

Inheriting Sharing Settings from the Parent

Context

If the file or folder you selected has a parent folder, you can use Copy from parent option to apply the sharing settings of that parent folder to the selected files or folders.

Procedure

  1. From the side navigation, choose Files, select one or more files or folders, and select (Start of the navigation pathShare Next navigation step  ShareEnd of the navigation path) to open the Share dialog.
  2. Expand the Shared with list, select , and select Copy from parent.

    If you use the option on files, the action is immediately applied. If you use the option on folders, a confirmation dialog appears.

  3. In the Confirmation dialog, select how you want to apply the access change and select Apply Changes.
    • Only to the selected folder: Removes the sharing settings of selected folder and replaces it with the sharing settings of the parent folder. If the selected folder has existing subfolders and files, those sharing settings are not changed.

    • Reset access to the folder. Only the selected users will have access to the folder, its subfolders, and files: Removes the sharing settings of selected folder and all its existing subfolders and files and replaces it with the sharing settings of the parent folder. The new sharing settings are also iteratively inherited to all subfolders and files.

Results

A message letting you know that the sharing settings have been updated appears and the Shared with list is updated to reflect the changes. Any new subfolders and files that you create will use the sharing settings from the parent folder.

Note

If you use the Copy from parent option for the Public folder, the Public folder's sharing settings are reset and restored to its original settings. Any modifications you made to the sharing settings on the Public folder will be lost. The settings on the Public folder are always applied to all users. However, system administrators can use the System view to change the sharing settings on the Public folder.

Changing Access Level for Files

Context

You can change the access level to shared files for a single user or team directly in the Access column or for several users or teams using the toolbar.

Procedure

  1. From the side navigation, choose Files, select the files, and select (Start of the navigation pathShare Next navigation step  ShareEnd of the navigation path) to open the Share dialog.
  2. Expand the Shared with list::
    • For one user or team, select a new access level directly in the Access column.

    • For several users or teams, select the users and teams, select , and then select the access level (View, Edit, or Full Control) or select Custom.

Results

A message letting you know that the sharing settings have been updated appears and the Shared with list is updated to reflect the changes. The new access levels for the selected users and teams are applied. The access levels for users and teams that are not selected don't change. Any new subfolders and files that you create will use the updated access levels.

Changing Access Level for Folders

Context

You can change the access level to shared folders for a single user or team directly in the Access column or for several users or teams using the toolbar.

Procedure

  1. From the side navigation, choose Files, select the folders, and select (Start of the navigation pathShare Next navigation step  ShareEnd of the navigation path) to open the Share dialog.
  2. Expand the Shared with list:
    • For one user or team, select a new access level directly in the Access column.

    • For several users or teams, select the users and teams, select , and then select the access level (View, Edit, or Full Control) or select Custom.

  3. In the Confirmation dialog, choose how to apply the access change to the selected folders and select Apply Changes:
    • Only to the selected folder: The new access level for the selected users and teams is applied to the selected folder only. If the selected folder has existing subfolders and files, the access levels for those users and teams don't change. Also, the access level for users and teams that are not selected don't change.

    • To the selected folder, its subfolders, and files: The new access level for the selected users and teams is applied to the selected folder and its existing subfolders and files. These changes are iteratively applied to all subfolders and files. The access level for users and teams that are not selected don't change.

    A third option, Reset access to the folder. Only the selected users will have access to the folder, its subfolders, and files, appears when the checkbox in the header of the Shared with list is selected. It should be used only by a system administrator. This option updates the access level to the selected folder and its existing subfolders and files for the selected users and teams and unshares that content with users and teams that are not selected. These new sharing settings are iteratively applied to all subfolders and files.

Results

A message letting you know that the sharing settings have been updated appears and the Shared with list is updated to reflect the changes based on the option you chose. Any new subfolders and files that you create will use the updated access levels.

Tip
You can use a combination of the toolbar actions to change the sharing settings of a selected folder and all its content. For example, to change access levels, remove users, and apply the changes to a selected folder and its content, do the following:
  1. Change the access level for several users and teams by using these steps.

  2. Remove users and teams by using (Unshare).

  3. Apply these changes to any subfolders and files by using the Apply to subfolders option.

Creating, Copying, Moving, or Restoring Files and Folders

Newly created files and folders inherit the same sharing settings as the parent folder they are created in. However, when you copy, move, or restore a file or folder, the sharing settings may change based on where you copy, move, or restore the file or folder.

  • Files or folders that are copied don't retain their own explicit sharing settings. The sharing settings of the copied files and folders are replaced and inherited from the new parent folder they are copied to.

  • Files or folders that are moved retain their own explicit sharing settings. However, any sharing settings inherited from their original parent folders are replaced with the new parent folder's sharing settings.

  • Files and folders that are restored automatically inherit the sharing settings of the parent folder they are restored to.

API for Sharing Analytic Applications

As an analytic application designer, you can allow analytic application users to open the application sharing dialog in runtime by using the following API:
Code Syntax
Application.openShareApplicationDialog() : void