Follow

Configuration of Document Sets

Article published on the 20th of July 2020.

Contents

1. Introduction

Document sets are used for creating sets of documents which share common themes such as usage or subject.

Examples of document sets could be a set of contract documents including appendices or project documents with project descriptions and the like.

Documents from a document set are created from templates, which can be categorized to form the actual document set. This process will be described in the following sections.

2. Requirements

There are currently no license requirements associated with the use of document sets.

3. Configuration

As previously mentioned, document sets are based on templates. When creating documents using a document set, new documents are generated based on the templates which are either selected or required by the selected document set.

In the following image, a couple of document templates have been configured for a project management solution:

For information on how to create document templates and how to use them, please visit this article.

At the moment, these templates are not part of any Template sets. To do this, we need to set up a taxonomy system containing terms to categorize the templates. This can be done in the Term Store Management page:

anm0007 - My Projects - Google Chrome
  1. In the root site of your solution, click the "Settings" icon in the top right of the page.
  2. Click "Site information".
anm0007 - My Projects - Google Chrome
  1. Click "View all site settings".
Site Settings - Google Chrome
  1. In the Site Settings page, under "Site Administration", click "Term store management".
Term Store Management Tool - Google Chrome
  1. In the Term Store Management page, expand the Site collection taxonomy group.
  2. Right-click the "WorkPoint 365 template sets" term set
  3. Click "Create Term" to create a new term. This can be thought of as a category. An example could be document categories of "Company documents", "Project documents", and "Risk documents". These can have additional sub-terms. For example, "Project documents" could have a sub-term called "Project description" and "Project calculations".

In this example, we have set up a taxonomy system with the following terms:

Term Store Management Tool - Google Chrome

Once we have a taxonomy system, such as the one in the image above, we can use the terms as categories for templates in WorkPoint.

In the following image, we have attributed a category from the taxonomy system to each template in the template library of our WorkPoint solution:

anm0007 - Template Library - All Documents - Google Chrome
  1. Select the template to categorize in the template library. In this example, we select a template called "Description of materials".
anm0007 - Template Library - All Documents - Google Chrome
  1. In the top right of the page, click the "Details" icon.
anm0007 - Template Library - All Documents - Google Chrome
  1. Click the value field of "Template sets" in the details panel to add a category to the selected template.
anm0007 - Template Library - All Documents - Google Chrome
  1. Once the field is clicked, you can click the tag icon to get an overview of selectable categories:
anm0007 - Template Library - All Documents - Google Chrome
  1. In this example, we select the "Project descriptions" category for the template. Note that the available options are the terms created in the Term Store Management page. If you need more or other options than the ones shown here, you can add more and remove these in the Term Store Management page.
  2. To add the category, click the "Apply" button.
anm0007 - Template Library - All Documents - Google Chrome
  1. Close the details panel. The "Project descriptions" category should now have been added to the "Descriptions of materials" template. Along with the "Description of Materials" template, all the other templates in the template library have also been categorized using the terms from the taxonomy system:
anm0007 - Template Library - All Documents - Google Chrome

Note that some of the templates also have been categorized in the "Required in template sets" column. Terms can be added to this column in the exact same way as the category in was set for the "Template sets" column in the example in pt. 10-13.

When a template has been categorized in the "Required in template sets" column, document sets created using the taxonomy term must include that template. An example of this is given later in this article. Templates which are required in a document set are marked with a red asterisk (*), and cannot be removed from the document set.

4. End User Guide

Please visit this article for a user guide for Document Sets.

5. Troubleshooting

   5.1. Template groups not showing up after configuration

In some cases, after configuration, the template groups does not show up in the advanced document wizard.

In this case, you might want to try and update the template set terms cache by following these steps:

WorkPoint365 Administration - Google Chrome
  1. In the WorkPoint Administration, in the left side menu click "Template Library".
Template Library settings - Google Chrome
  1. In the Template Library settings page, click the "Update cache"  button in the Caching of template set terms section.

When the operation is complete, you will be returned to the Administration dashboard with a confirmation message:

WorkPoint365 Administration - Google Chrome

Please try and open re-open the advanced document wizard and check if the template groups now shows up.

Have more questions? Submit a request