Briefcase Permissions

Overview

This how-to article will help Project Managers, Team Members and Stakeholders learn more about the Enterprise Service Management (ESM) project Briefcase using the TDWorkManagement interface. When working with projects, the Briefcase is an important component where project members and stakeholders are able to easily share files. The permissions can be applied to project folders or individual files and tailored so the appropriate project members can or cannot access them.

The briefcase permissions work differently from other parts of the ESM system. They are applied on the projects folders or individual files that are set in the Briefcase and are not based on security roles.

When visiting the standalone Briefcase application, all visible files and folders are for projects the user is a member of and has read permission for.

In this article:

• Configure Permissions
• Briefcase Actions
• External File Repository Integrations
• Viewing the Briefcase for Projects you are not a Member of
• Gotchas & Pitfalls

What materials do I need?

• Internet connectivity
• Web browser
• ESM TDWorkManagement access
• ESM Project team member, or Project Manager role on desired project

Configure Permissions

The Default User can be set up with permissions and any users subsequently added to the project will inherit the same set of permissions. If a project member is granted specific permissions, this will override the default.

The Cascade Added Permissions checkbox will apply any added permissions to all files and subfolders within this folder. If this is specified at the root-level of a project, then the entire project briefcase will have the same permissions enforced throughout. Cascade can be applied to any folder in the project Briefcase and the settings will affect all subfolders and files within that parent folder.

To configure user permissions for the entire project briefcase:

1. In TDWorkManagement, open the Projects application.
2. Click the appropriate Project in the left navigation.
3. From the left sub navigation, click Briefcase.
4. The Briefcase will open to Recent Files. Click Security in the toolbar.
5. In the Folder Security window, select the checkboxes for each permission type each project member should have.
6. Select the permissions for the Default user.
7. Click Save.

Permissions can be modified on any folder by following the above steps.

To configure user permissions for a single file:

1. In the Briefcase, locate the desired file.
2. Click the file name.
3. In the File Detail window, click the Security tab.
4. Using the checkboxes, configure the permissions for the file.
5. Click Save.

Briefcase Actions

When working in the Briefcase, there are a variety of actions that can be taken for both files and folders. Folders on the left hand side can be collapsed, expanded, and clicked to navigate the Briefcase structure. At any given point, the Briefcase application will display a list of all files that are located in the currently-selected folder. In addition, the top toolbar displays a list of icons representing all folder actions that are available to the user.

• Edit Security: The individual must have the Full permission for the current briefcase folder.
• Add a Folder: The individual must have the Modify permission for the current briefcase folder.
• Download a Folder: The individual must have the Read permission for the current briefcase folder. It should be noted that this will download a .zip of the current folder, but external files are excluded from the download.
• Delete a Folder: The individual must have the Delete permission for the current briefcase folder.
• Rename a Folder: The individual must have the Modify permission for the current briefcase folder.
• Refresh a Folder: The individual must have the Read permission for the current briefcase folder.
• Cut a Folder: The individual must have the Modify permission for the current briefcase folder.
• Paste a Folder: The individual must have the Modify permission for the current briefcase folder and has already performed a Cut Folder operation.
• Add Files: The individual must have the Modify permission for the current briefcase folder.
• Download a File: The individual must have the Read permission for the current briefcase folder and the file is not external.
• Open a File: The individual must have the Read permission for the current briefcase folder and the file is external.
• Forward a File: The individual must have the Read permission for the current briefcase folder.
• Delete a File: The individual must have the Delete permission for the current briefcase folder.
• Move a File: The individual must have the Full permission for the current briefcase folder.
• Rename a File: The individual must have the Full or Modify permission for the current briefcase folder.
• Move File across Projects: The individual must have the Full permission for the current briefcase folder. In addition, the user must have the Can Move Files Between Projects​ permission.
• Copy a File: The individual must have the Full permission for the current briefcase folder and the file is not external.

When performing folder actions at the project level (i.e. the root folder of the Briefcase), the user must have the Full or Modify permission. In addition, only the Edit Security and Add Folder actions are available at the Project level.

External File Repository Integrations

The ESM system has been integrated with both UA's Google Workspace and Microsoft 365 systems. This allows files to be added to ESM Briefcase from Google Drive, as well as OneDrive for Business.

Viewing the Briefcase for Projects you are not a Member of

Individuals who have access to the ESM Analysis application can view any project Briefcase in the system.

To view a Briefcase on a project you aren’t a member of:

1. In TDWorkManagement, open the Analysis application.
2. Click Project Searches in the left navigation.
3. Use the search to locate the desired project.
4. Click the project name.
5. In the Project Details window, click Briefcase in the left navigation.

Gotchas & Pitfalls

• You can only see a file in the Briefcase if you are a member of the project
• Due to the potential permissions a member might be limited as to the actions they can take on a given file within the folder e.g., having either Full, Ready, Modify or Delete access to a particular file.

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.