Skip to main content

Document permissions

Once a role is inserted into a document's Document Roles database table, the Document Roles table specifies what system-defined actions users and groups assigned to a Role are allowed to do as the document progresses through its lifecycle. The Document Roles table is determined by these custom metadata types: and Document State Role Permission custom metadata type records.

  • Permission (mvn__CM_Permission__mdt) - grants users or group of users system-defined actions at either the document or document version level.

  • Document State Role (mvn__CM_Document_State_Role__mdt) - connects the Document State and Role custom metadata types.

  • Document State Role Permission (mvn__CM_Document_State_Role_Permission__mdt) - connects the Document State Role and Permission custom metadata types and grants a Role for a given Document State a specific Permission.

On the Sharing tab of a document record, you can view the list of users and groups that have access to the document. You can also access the Role Permissions matrix for a role to see what permissions that role has for the document.

Permissions

ships with eleven predefined permissions, which can be found in the Permission (CM_Permission__mdt) custom metadata type. Each permission grants a user or group of users a system-defined action at either the document or document version level. Once granted, document-level permissions give users the ability to perform actions regardless of the document's state. Document version-level permissions are governed by the matrix model of state and permission.

Warning! Do not create, modify, or delete any permission records. Permission records are considered protected system metadata.

Document permissions
LabelDeveloperNameDescription
Deletemvn__CM_DeleteDelete the document and any document versions.
Manage Sharingmvn__CM_Manage_SharingManage the Document Roles table for the document.
Document version permissions
LabelDeveloperNameDescription
Change Statemvn__CM_Change_StateChange the status value of the document version record.
Create Draftmvn__CM_Create_DraftCreate a new document version in the document lifecycle's initial state.
Delete Versionmvn__CM_Delete_VersionDelete a document version.
Download Sourcemvn__CM_Download_SourceDownload the file associated to a document if the file is hosted in Salesforce. Visit Files.
Edit Documentmvn__CM_Edit_DocumentCheck the document in and out and upload a new version of the document, including in Microsoft 365. Visit Microsoft 365.
Edit Metadatamvn__CM_Edit_MetadataEdit document fields.
Edit Relationshipsmvn__CM_Edit_RelationshipsAdd, edit, or delete document relationships. Visit Relationships.
Start Workflowmvn__CM_Start_WorkflowStart a workflow for a document. Visit Workflows and tasks.
View Documentmvn__CM_View_DocumentRead access to the document, its associated file, and any metadata, including relationships.