Template Editor

Template Editor

 

Info: For Template Editor usage for Office365 origins such as Sites/Planner/OneNote/Teams and channels, see: Configuring Teams, Planner, OneNote, Tab, and OneDrive through Template Editor

Configure Template Editor

Template List

The left-hand pane of the editor displays a tree view of all folder templates. In a new installation of CAM, by default the following templates are available:

  • Corporate

  • Government Contracts

  • Legislative

  • Litigation

  • Matter-Init

  • Patent Prosecution and Counseling

  • Personal Workspace

  • Regulatory

  • Tax and Wealth Planning

  • Trademark, Copyright & Licensing

Click the > button next to the template to expand and view the folders. Options for Templates and Folders can be configured in the right-hand side pane.

Adding a search folder dynamic user

Note: To add a user dynamically for an iManage folder, you can encase the user. There are two options to do this:

1- If you are wanting to use sessionuseremail to pull a user, you can do it like %sharon.says@email.com%

2- If you want to dynamically pull a user for a search folder to load in that template, use %USERID%.

Additional steps for setting the search folder dynamic %userid%:

  • The specified values should be entered in uppercase format.

  • These changes must then be applied to the relevant folder.

  • Once job completed, check in iManage the "View/Edit Search Criteria" option should be clicked for search folder.

  • The updated value is expected to appear in the search criteria.

  • A document search should then be performed using the updated criteria, the appropriate database—where the corresponding Workspace has been created—should be selected to complete the process.

Configuring Template/Folder Availability

Template Options

  1. Select the template from the Template Tree in the left pane. The Template availability options are displayed in the right pane.

Field Name

Description

Field Name

Description

Default

Sets whether the template is default or not in the system. You can only have one default. The default template will have a green checkbox button next to it in other pages.

Basic

Enter a custom name for the template.

Select the applicable external system from the Select System drop-down. This will ensure all the metadata from the selected external system is available to apply to the folders within the template.

Availability

Specifies from which CAM dialogs the template will be available for selection

Metadata Filters

Based on the filters specified here, the template will be available for selection in the Manage Folder dialog when the metadata of the selected workspace or folder matches the value added here.

  1. Click the Add Filter button. To assign metadata, either click the drop-down menu and select from the list or manually enter the value, which will auto-complete if it is assigned in Administration>Metadata.

  2. Set a default value for the metadata filter and click Save.

  3. To delete an added filter click the Remove button.

For iManage users adding metadata, note that iManage requires userid’s be encased in %%. Like %alexey.marcus%

You can also use %% around SessionUserEmail like %Test@email.com%.

Folder Options

The folders in this list are sorted alphabetically so it’s easier to find the one you’re looking for.

Field Name

Description

Field Name

Description

Basic

Enter a custom name for the folder.

  • Clicking on the name of the folder of the template allows to set the name to be displayed as a column(s). (NetDocuments allows this feature)

    • 1 column

    • 2 columns

  • Refresh the page to take effect.

Folder Type

Select the Folder type to be added under the Template. Read here for more details.

Note: The folder types are filtered based on the system the template is associated to.

Show as

Specifies the behavior of the check box that precedes a folder in the Manage Folder dialog. Additionally, folders marked as Required cannot be deleted by users.

  • Checked - Checked by default, but users are allowed to uncheck it.

  • Required - Checked by default, and users are not allowed to uncheck it

  • None - Unchecked by default, and users are allowed to check it.

Consider the following scenarios:

  • While adding a new folder, if the user selects: Show as None and Prefix/Suffix None then Availability is set to All

  • While adding a new folder, if the user selects: Show as None and Prefix/Suffix (Other than None) then Availability is set to On Demand Folder Creation.

To manually change the availability of a folder already created:

  • On the Basic screen, if the user selects: Show as None and Prefix/Suffix None then Availability is set to All => The user is able to change manually to Workspace Creation Only or On Demand Folder Creation.

  • On the Basic screen, if the user selects: Show as None and Prefix/Suffix (Other than None) then Availability is set to On Demand Folder Creation => The user is able to change manually to Workspace Creation Only or All.

Notes:

  • After creating a Folder, if a user changes the availability manually and selects: Show as None and Prefix/Suffix None then Availability will not change to All => It will not change until a user manually changes it.

  • After creating a Folder, if a user changes the availability manually and selects: Show as None and Prefix/Suffix (Other than None) then Availability will not change to On Demand Folder Creation => It will not change until a user manually changes it.

Prefix/Suffix

Specifies how users can customize the name of the folder.

  • Allow Prefix - Users can add custom text to the beginning of the folder name.

  • Allow Custom Name - Users can assign a custom name to the folder.

  • Allow Suffix - Users can add custom text to the end of the folder name.

  • None - Users cannot make changes to the folder name.

Default Security

Sets the default security for the folders on a template, to Public, View or Private. For iManage, this option will display by default. This is available for NetDocuments, iManage and Office365. This option is available in CSV too.

Note: When default security of folders/subfolder which has ACL attached, is changed from 'Public, Private, or View' to Inherit in the existing Template and applied to created folders, security is changed to Private with no change to attached ACL.

Security

Assign security to the folder to locks down the folder to specific users or groups. If access to a folder is denied here to a user/group, they cannot view the folder in the workspace.

  1. Click the Security tab in the right hand side panel.

  2. Click the New Member button. In the Add Member window, select the radio button to assign security to a User or Group.

Note: Template editor provides an option to specify external user email.

  1. Based on the selection, select the User or Group from the drop-down. To assign a user/group, either click the drop-down menu and select from the list, or manually enter the value by clicking the plus sign, which will auto-complete if the user is assigned in Administration>Users and Groups

  2. Select the radio button to allow or deny permission to the user/group.

  3. Select the Role to be assigned to the user.

  4. Click Submit.

Dynamic Security

Security can be set by using comma separated variables of the metadata to pull from to set security. For example @custom7@, workspace.@custom1@, or @groupid@ can be used to pull the object to apply the security to the workspace, folder, or document.

Note: Irrespective of the Role assigned to the user here, access to the NetDocuments cabinet is granted only if the user has default access to the cabinet, where the template is applied to create a workspace.

Order

Displays the order of which to set. This order is used by default.

When reapplying a template that tabs reordering will not be carried over at this time for existing tabs/channels.

Metadata

Folders defined in a template can be assigned metadata. The values of the folder metadata can be defined using variables that are replaced with the workspace's metadata upon creation of the folder. (For e.g. for folder description, CAM uses the metadata values of ClientId and MatterId as @ClientId@@MatterId@). The metadata value at run time is replaced with the actual workspace value. Metadata added to search folders are treated as search parameters.

Note: When creating a workspace with a template having on demand folders/sub-folders with metadata set as owner & value as @SessionUser@, the owner will be the user used to log in to CAM. If owner Metadata is not set on the folder with the placeholder @SessionUser@, the owner will be the user for which a token has been generated in CAM's external system configuration for the iManage server.

Do note iManage requires user IDs to be enclosed in %%. Like %alexey.marcus%.

Example, if you want to set a search folder to dynamically set the user on it, put the variable %userid% on the template.

 

  1. The Metadata tab here displays all the metadata assigned to the folder. Click the Edit button to update the metadata.

  2. Click the New Metadata button to add new metadata to the folder. Click the drop-down menu and select from the list or manually enter the value, which will auto-complete if it is assigned in Administration>Metadata.

  3. Set a default value for the metadata filter and click Save. The drop-down displays all value(s) assigned to the metadata in Administration>Metadata>Manage.

    4. Click the above sign to add a new metadata value. In the New Metadata Value dialog, enter the Metadata ID and the Description. Click Save.

If a metadata mapping was created with “Key only” multivalues, the metadata will be disabled, and only one key can be used.

To use multivalues, select “Key and Description”.

Read about Metadata Mapping here.

Metadata Use Cases

  • The user can add the same metadata values multiple times to one field. This will take the values as an OR statement. For example, ClientId= 'Apple' or 'Amazon' or 'Apple' would be adding values Apple and Amazon to the field Client.

  • An AND search includes all the parameters used on the template. For example, it can be ClientId=”Apple”, “Amazon”, and AppType=”Application.”

Note: The metadata available for selection here is determined by the external system selected for the template.

Availability

Specifies the folders levels at which the folder can be created.

  • All - Available for use at all folder levels, including workspace creation

  • Workspace Creation only - Available only during workspace creation

  • On Demand Folder Creation - Available only when using the Manage Folders at the level specified in the drop-down menu.

Info: If On Demand folder creation is selected, and Show as None is selected and a Prefix and/or Suffix is selected, the folder name will not be edited!

  1. Top Level Only - Top level of a workspace.

  2. Second level and below - All levels below the top level.

  3. Any level - All levels within a workspace.

Template (Hamburger) Menu

  1. Select the template in the left-hand pane and

  1. Click the above button in the row.

Action Menu Name

Description

Action Menu Name

Description

Config

Opens the Template Config panel.

Generate Template

Opens the Generate Template dialog in the left hand side pane.

Import Templates

Opens the Import Templates dialog. Importing templates allows users to import templates from CAM from another CAM system (as long as the metadata and systems are similarly connected).

Upload Templates

Opens the Upload Templates dialog. The Upload templates functionality allows firms that configured templates in Milan to upload the Milan folderTemplate.config xml file into CAM to recreate the templates in CAM. This way firms don't need to manually recreate all their Milan templates.

Once the upload is complete, the user should review the metadata on each folder to make sure the metadata is correct. They can also edit the foldertemplate.config file prior to uploading to remove any unnecessary folder level metadata such as @clientid@ and @matterid@.

Export Templates

Allows to export the templates.

Folder/Sub-Folder Menu

  1. In the left-hand pane, select the folder within the template.

  2. Click the  button in the row.

Action Menu Name

Description

Action Menu Name

Description

Add Folder

Opens the Add Folder dialog in the left hand side pane.

Add Metadata

Sub-folders within a folder can be assigned metadata. The values of the folder metadata can be defined using variables that are replaced with the workspace's metadata upon creation of the folder. (for e.g. for Matter metadata the value can be defined as @Matter@). The metadata value at run time is replaced with the actual workspace value. Metadata added to search folders are treated as search parameters.Variables are case insensitive so users can use @ClientId@ and @clientid@ equivalently without issue.

Note: When creating a workspace with a template having folders/sub-folders with metadata set as owner & value as @SessionUser@, the owner will be the user used to log in to CAM. If owner Metadata is not set on the folder with the placeholder @SessionUser@, the owner will be the user for which a token has been generated in CAM's external system configuration for the iManage server.

  1. Select the Add Metadata option from the drop-down.

  2. In the Add Metadata window, select the Metadata name. To assign metadata, either click the drop-down menu and select from the list or manually enter the value, which will auto-complete if it is assigned in Administration>Metadata.

  3. Set a default value for the metadata filter and click Save. The drop-down displays all value(s) assigned to the metadata in Administration>Metadata>Manage.

  4. Click the above sign to add a new metadata value.

  5. In the New Metadata Value dialog, enter the Metadata ID and the Description.

  6. Click Save.

The dialog displays the format and sample the new metadata needs to be entered.

Note: Parameters accepted format is parameter=@parameter@ Example clientid=@clientid@

Scenarios for Metadata:

  • The user can add the same metadata values multiple times. This will take the values as an OR statement. E.g. Metadata Client= 'Apple' or 'Amazon' or 'Apple'

  • The user can add different metadata values. The statement would be considered an AND statement. E.g. Metadata Department='Litigation' and 'Corporate'

Note: The metadata available for selection here is determined by the external system selected for the template.

When you configure multiple servers for iManage and multiple regions for NetDocuments, the following optional fields appear when you add metadata: Repository and database.

Metadata Scenarios with Multiple Servers and Regions:

  • If you do not specify a repository or a database, the values will be retrieved from the default repo and database.

  • If you choose a repository but do not choose a database, the values will be retrieved from the repository's default database.

  • If you select both the repository and the database, the values will be retrieved from the latter.

Note: The Metadata Scenarios with Multiple Servers and Regions are applicable only for iManage, NetDocuments, and M365.

Delete

Opens the Configure Template Editor dialog. Click the Delete button to delete the folder.

Move/Copy Folder

Opens the Move/Copy Folder dialog.

Save as new folder

Allows to save the folder as a new folder within the template.

Create New Template

Creating a new template can be done in 4 ways in CAM:

  1. Generate Template on the global actions menu to create a new template from a workspace

  2. Import templates in Template editor (from Milan or other CAM systems)

  3. Generate template from the Directory tab to create a new template from the workspace

  4. Manually creating a template in Template Editor

The following instructions are for manually designing a template from within Template Editor.

  1. Click the button for Create Template displayed in the Template List pane.

  2. In the Create New Template window enter a name for the template under Template Title.

  3. Click on Create. The new template is added and displayed in the left-hand pane.

  4. Once the template is created, the system will set the templateid as the template title which is by design.

Note: During the creation of workspace through CSV, specify TemplateID for selecting a specific template.

Keep the number of templates in check. When there are too many templates to work with, the Templete Editor may take longer to load resources or transition from screen to screen. As a general rule, it is recommended that users keep their templates in check to make sure each one has a purpose and that unused ones are deleted.

Edit Template

Allows users to edit/update the template name after the creation of the template.

  1. Select the template from the template list.

Fields

Description

Template ID

Displays template name, cannot edit/update.

Note: Unique template Identifier

Template Title

Allows to edit Template Title.

The title is displayed in the manage folder and job center.

Select System

Select system name from the drop down.

  1. Click Save.

Searching Templates

The Search bar is located at the top of the page. You can search by the Template Name or by the External System or by both.

  1. Enter the template name.

  2. Select the external system from the drop-down.

All the matching templates are auto-filtered and displayed in the Template list pane on the left-hand side of the page.

Template results are limited to the first top 50 templates based on the filter criteria in Template Editor of Commands that pull templates. Narrow down your search or limit the template number you are returning.

Add Folders to Templates

  1. Select the template and click the below button in the row.

  2. Click Add Folder.

  3. Click Save.

Adding Items to Document Folders

Add SubFolders to Folders

Tip: The folders in this list are sorted alphabetically so it’s easier to find the one you’re looking for.

  1. Select the folder within a template and click the  button in the row.

  2. Click Add Folder.

  3. Click Save.

Add Metadata

  1. Select the folder within a template.

  2. In the right-hand side Documents pane, click the Metadata tab.

  3. In the Add Metadata, select the metadata name from the Name drop-down menu.

  4. Either select a value from the Metadata value drop-down menu or enter a variable.

  5. Click Save.

Configure Folders Templates

Folder Types

The folder type options can be set in the Basic tab.

  1. Select a folder within a template or a sub-folder within a folder.

  2. In the right-hand side Documents pane>Basic tab, from the Folder Type drop-down, select the relevant folder type option. The folder types available in the drop-down are filtered based on the system the template is associated with. (see table below). Based on the folder type selected, the folder button is updated against the folder in the Template Tree.

The following screen displays the template tree structure where the user can see the folder button to identify the folder type.

The following folder type options are available:

Folder Type

button

Folders Available for Supported Systems

Folder Type

button

Folders Available for Supported Systems

Folder

iManage, NetDocuments, Office365 OneDrive Tab and OneNote

Tab

Let's Connect📌

☎ +1 630.598.1100
☎ ‪+44 20 3880 1550‬
📧 support@litera.com
💻 https://www.litera.com/support/

📝 Support is available:
4 am - 8 pm US Eastern
(9 am - 1 am GMT/BST
7 pm - 11 am AET) on normal business days (excluding holidays)

© 2024 Litera