Adding and granting access to attachment documents

A document library is a centralized document repository where a document manager can add and manage files. It acts as a common location to store multiple documents in the application.

The advantage of adding documents in the document library is that the documents are available in a single location and in the application itself. A centralized document library ensures that you have an easy access to documents. In the document library, you can manually ensure that you are using the latest revision of a document. The documents in the document library can be used in multiple cases and tasks. By using the document library, multiple users working on the same case and associated tasks use the same document that has been added in the document library.

For example, when you add a leave policy to the document library, case agents can attach this document to multiple cases and tasks.

Access and permissions required to manage documents

A document library is tenant specific. By default, every company under the tenant has a document manager who is a case business analyst.

As a document manager, you can add documents to the document library, and restrict the write access of the document to a particular owner group. Other than you, the following users can have write access to the documents:

• Only the members of the owner group having write access to the document can edit the document.
• The user who added the document can edit the document. 

 A user having write access to a document can provide read access of the document to multiple owner groups. You can restrict the ability to share a document with any external application other than BMC Helix Business Workflows while adding a document to the document library. You must be a document manager to get read access of a document. However, when you consume a document in a case, you can view the document even if you are not a document manager. The maximum file size of an attachment stored in a document is set in BMC Helix Innovation Studio. 

Document status

A document in the document library has one of the following statuses:

• Draft—When you add a document in the document library, by default it is in the Draft status. You can edit a document only if it is in the Draft status.
• Published—When you change the document status to Published, it is available for consumption in cases and tasks. 

To add a document to the document library

As a document manager, you can add documents in the document library and attach only one file per document. To add a document to the document library, perform the following steps:

1. Log in to BMC Helix Business Workflows.
2. Click Settings.
3. Navigate to Document Management > Document Library.
4. On the Document Library page, click Documents.
5. To attach a file, on the New Document page, click Attach and add the document.
6. Specify Title and select a combination of Company, Business Unit, Department, and Owner Group. 
   The members of the selected owner group get write access to the document.

7. Complete the additional details as explained in the following table:

   Field	Description
   Keywords	To make the document easily searchable, enter the keywords which describe the document.
   Share Externally	To share the document outside BMC Helix Business Workflows, click Share Externally .

8. Click Save.

You can edit or delete a document only if it is in the Draft status.

To update and grant access to a document in the document library

 After adding a document to the document library, you can provide read access of the document to multiple support groups. To update and grant access to a document in the document library, perform the following steps:

1. Log in to BMC Helix Business Workflows.
2. Click Settings.
3. Navigate to Document Management > Document Library.
4. On the Document Library page, click the required document.
5. To edit the details or delete a document, change the document status to Draft. 
   For this, on the Edit Document page, click Status and choose Draft from the list.
6. Update the details on the page, as required.
7. To provide read access, on the Read Access tab, perform the following steps:
   1. Select a combination of Add Company, Add Business Unit, and Add Support Department.

1. 1. Select a value from the Add Support Group list.
      Only support groups directly related to the selected combination of company, business unit, and department are listed.
      
2. Click Save.