Create Document from Template

Prev Next
This content is currently unavailable in Spanish. You are viewing the default (English) version.

Definition


The Create Document from Template action is used to create documents in the Document Library using a template or existing file from the Document Library.

Instructions


To add the Create Document from Template action to the workflow diagram, drag and drop the action from the list on the left onto a "+" icon in the workflow diagram.

The Create Document from Template action added to the workflow designer
Properties


The properties of the action can be customized on the step properties panel on the right-hand side of the workflow designer.

Create Document from Template properties panel

Customize the Step Name and Step Description to add readability to the workflow action within the workflow designer.

This action has one configuration button, Configure.

Configure


Click Configure in the properties panel to begin configurations.

Configurations on this action include setting the required Target Folder Path and Document Search Conditions, and the optional Index Field Mappings.

Target Path

The first required configuration is setting the Target Path. This determines the location where the new document will be created. 

Target Path screen

Configure the Target Path tab by typing in the Enter Path textbox. The path can be a static value, or you can append workflow variables as tokens. Add tokens by using the Workflow variable dropdown and Append Token button, or by typing the workflow variable name in curly brackets {}.

Target Path configuration screen

Target Path Syntax

The syntax required for entering the target path can be found by clicking into the folder in the Document Library and observing how it appears at the top of the main panel.


Document Library with arrow pointing to the folder path /Finance/Pending

Click the Document Search Conditions tab to continue configurations for the action.

Document Search Conditions

The second configuration is setting the Document Search Conditions to determine which document(s) to move or copy. 

On the Document Search Conditions tab, begin by clicking the + New Condition button or Add Condition. 

Document Search Conditions tab

Searching for documents can be done by comparing a Data Source (either Document Field or Index Field) to either dynamic WF Variables or static Values

Any document can be updated if you can configure the appropriate search conditions. When document data events trigger a workflow, one common scenario is to copy or move the originating document. To search for the originating document, you can use the following search condition:

Document Field  |  Document Id |  =  |  WF Variable  |  DocID

Document Search Conditions with a search for the originating document.

Multiple Documents from Search Results

Document search conditions can return one or many documents. All documents returned by the search will be used as the template (i.e. multiple documents will be created).

You can click the Save button at this time to commit the change and return to the workflow designer. Alternatively, click the Map Workflow Variables to Index Fields tab to continue optional configurations.

Map Workflow Variables to Index Fields 

As a new document is created, there is also an option to map values onto the index fields of the document through the Map Workflow Variables to Index Fields tab. Index Fields can be updated with dynamic Workflow Variables or hard-coded Values

Begin by clicking the + New Mapping or Add Mapping button.

Map Workflow Variables to Index Fields tab

In the Index Field dropdown on the right, select what field is being updated. 

In the Data Source dropdown on the left, select either Value or WF Variable. For Values, type a static value in the Value field. For workflow variables, select a variable from the WF Variable dropdown list.

  • Additional mappings can be added on a new line by clicking the + Add Mapping button.

  • Lines can be deleted by checking the box on the left and then clicking Remove Mapping.

Click the Save button to commit the changes and return to the workflow designer.

Save button

Save button

The Save button will only be available once the Target Path and Document Search Conditions are valid. If the Save button is greyed out, check the configurations on these tabs.

Troubleshooting

The workflow designer will prevent you from publishing a workflow when configurations are incomplete. Here are common error messages and how to address them.

Publishing error message

Message

Fix

Create Document: 'destinationPath' must not be empty.

Target Path configurations are missing.