The Prepare Document toolbox item allows you to create a prepared document within the system. Details on how to configure document templates can be found here - Authoring documents using the word plugin.
The toolbox item creates a Prepare Document task which is usually linked to a pre-defined template.
Common Uses
Creating documents is a common part of many processes. Whether it is a legal process that includes drafting a lease, a project that requires a report to be generated or an insurance claim that requires a liability report. ShareDo offers rich document templating capabilities that allow data captured in the system to be inserted into documents. ShareDo also allows for document content to be smartly created based on the context of a piece of work.
The Prepare Document toolbox item is used to initiate the creation of a document using a pre-defined sharedo document template.
Pre-requisites
- Configure Template - if the Prepare Document task should link to a specific template, the template needs to be configured prior to the workflow being developed.
- Workitem ID - to use the notification toolbox item, you need to have captured the work item ID of the work item for which you want to create the document.
- Document parties - you need to have captured the ID of the organisation or team to which you wish to send the document and the ID of the user or team to whom the Prepare Document team should be assigned. The ID is placed into a variable of type ODS Entity Identifier. This can be populated using load ODS data, load work item data, or by using an allocation rule.
-
Variables - any of the fields on the configuration that show this icon
allows you to insert a variable into the text. Before you set these fields, you need to set up your variable on the data tab and retrieve and insert the information you want to use into the variable. - Step - to use this item from the toolbox, you need to have a step on your canvas to drag it into.
Configuring Prepare Document
- Click on the toolbox tab of your workflow canvas.
- Select the Prepare Document option and drag onto the step where you wish to place it.
- Click on the Prepare Document item you have dragged onto the canvas to add in the configuration.
- Enter the configuration for the toolbox item.
| Action Name | Give the action a meaning full name e.g. Lease. |
| Parent Work Item |
The ID of the work item to which you want to link this Prepare Document task. Note: This should also match the context of the document template. |
| Task Type |
Select the task type you wish to create. This will normally be Prepare Document unless you have a custom Prepare Document type. |
| Task Title | Enter the name of the task as it will appear in the user's worklist. You can use variables here to insert data if required. |
| Tag | Specify the tag that will be attached to the task. A common use of this is to group together common tasks in a worklist. |
| Due after how many days |
Indicates after how many calendar days the task will be due. Note: In the current tool, you are not able to set the due date as an offset of another date. To do this, you must create the prepare document task first and then use the update due date tool to set the due date. |
| Assign To |
Indicate the user or team to which the Prepare Document task should be assigned. It is good practice to use allocation rules to assign tasks as it ensures there is always a fallback position for the task. |
| Document Template | Select the document template name you wish to use in the workflow. |
| Recipient |
Indicate the ODS ID to whom the document should be assigned. Note: that if your template has a role specified against it, e.g client case handler, and there is only one of that party on the work item, then the document will auto-populate even if this is not set. |
| Regarding |
Indicate the person or organisation about whom the document is being sent. Note: this is not a mandatory field and is usually used in specialist circumstances. |
| Add action plan |
Add an action plan to the Prepare Document. |
| Phase Outlets |
Switching on a phase outlet means that when the task reaches that specific phase, you are able to link to another step in the workflow. A common example is that when the document is set to Issued (i.e. the document has been sent out), then the next step of the workflow will fire. |
Using a FormEvo template in a Visual Workflow Prepare Document step
As Legal Form Templates are considered Forms in ShareDo, they are not listed as a choice when selecting a document template in the Workflow Prepare Document step. To use a Legal Form template, you must first pass in the FormEvo template system name, either by typing it manually into the field or as a variable. Then, you must change the type to reflect the Legal Form work type in line with your configuration (core type is 'Prepare Document - Electronic Form').
A note on approvals
In many scenarios, documents need to be approved before they can be sent out. Although this can be configured with the workflow modeller, the best practice for this is to configure the Approval Workflow against the document template. For more information, see Working with Approvals.
