This article explains how to configure a workflow with AutoMerge for Microsoft Dynamics CRM 2013 Online. The steps described below solely refer to AutoMerge for MS Dynamics CRM 2013 Online. For details about how to create a workflow with AutoMerge for MS Dynamics CRM On-Premise, please watch our demonstration videos on our Youtube channel. (Click here to watch the videos)
How to create a workflow with AutoMerge for Microsoft Dynamics CRM 2013 Online:
First of all, start in the settings of your CRM system and click on ’Processes’ in the Ribbon. (See screenshots below)
![image image]()
![image image]()
Following window appears:
![29 29]()
Screenshot: ‘Processes’-area in CRM settings. Click to enlarge.
...
Then click on ‘New’ to create a new workflow. A webpage dialog pops up (see screenshot below). Type in a name, determine an entity and choose ‘Workflow’ as the process category. Afterwards, click on ‘OK’. (See screenshot below)
![x x]()
Screenshot: Webpage dialog to create a new workflow/dialog. Click to enlarge.
After clicking on ‘OK’, you will see the following window. Start to define and add the steps you would like to have in your workflow. If you would like to e.g. create the document as a first step of your workflow, click on the ’Add Step’-drop-down menu and select ‘Create Record’. (See screenshot below)
![image image]()
Screenshot: window for workflow-configuration. Click to enlarge.
Now, the first step is added to your workflow. Type in a description of the step, e.g. create document. Afterwards, open the drop-down menu within this first step, select ‘MSCRM-ADDONS.com AutoMergeWorkingItems’ and click on ‘Set Properties’. (See screenshot below)
![image image]()
Screenshot: window for workflow configuration, creation of first workflow-step ‘CreateDocument’. Click to enlarge
The following window will open to configure the first step of your workflow. (See screenshot below) Type in a name and define the AutoMerge-action. In our example, we select the action ‘CreateDocument’.
![52 52]()
Screenshot: window for workflow-step configuration, definition of a name and of the AutoMergeAction ‘CreateDocument’. Click to enlarge
After that, choose the template to be used within the workflow (see screenshot ellipse 1) and the file format the document should be saved as (see screenshot ellipse 2).
Furthermore, it is very important to insert the ‘PrimaryRecordUrl’. For that, set the cursor in the ‘PrimaryRecordUrl’-field and go to the ‘Look for’-area within the form assistant on the right side. Select ‘Record URL(Dynamics)’ from the second drop-down-menu (see screenshot below, ellipse 3 and 4), click on ‘Add’ and then on ‘OK’. After that, the ‘PrimaryRecordUrl’-field is filled out automatically. (see screenshot below, colored in yellow) Click on ‘Save and Close’.
![Unbenannt Unbenannt]()
Screenshot: window for workflow-step configuration, definition of the template to be used in the workflow, the file format the document should be saved as and the PrimaryRecordUrl.
Click to enlarge.
![54 54]()
Screenshot: window for workflow-step configuration, configuration of first workflow-step finished. Click to enlarge.
The first step of your workflow is now added and fully configured. In case you want to stop your workflow at this point, you can click on ‘Save and Close’ and finish here. In case you want to add further steps to your workflow, define a condition to be fulfilled before adding further steps. For example, if you want to create a letter-activity with the previously generated document as an attachment, you need to make sure that the document creation is completed before attaching the document to the letter activity. To do so, open the ‘Add-Step’ drop-down menu again and select ‘Wait Condition’. (See screenshot below, blue elipse)
![Unbenannt Unbenannt]()
Screenshot: window for workflow configuration, ‘Wait condition’-step added. Click to enlarge.
The step is added to the workflow. Type in a step description and click on ‘<condition> (click to configure)’. (See screenshot below)
![56 56]()
Screenshot: window for workflow configuration, ‘Wait Condition’-step added. Click to enlarge.
After that, a window pops up. In this window, you can define the condition to be fulfilled for workflow proceeding. In our case, we select ‘Create document (MSCRM-ADDONS.com AutoMergeWorkingItems)’ from the first drop-down menu, ‘Status’ from the second drop-down menu, ‘Equals’ from the third drop-down menu and ‘Inactive’ from the fourth drop-down menu. (see screenshots below). Click on save and close. Now, you have determined that step 2 of your workflow (in our example to attach the created document to a letter-activity) will only be executed if the first step, namely the document generation, has finished successfully.
![Unbenannt Unbenannt]()
Screenshot: window to configure ‘Wait Condition’-step. Click to enlarge.
![58 58]()
Screenshot: window to configure ‘Wait Condition’-step. Click to enlarge.
Afterwards, your workflow configuration will look like in the following screenshot.
![59 59]()
Screenshot: window for workflow configuration, ‘Wait condition’-step added and configured
To add another step, e.g. to create a letter-activity, click on ‘Select this row and click Add Step’ (see screenshot ellipse 1) and afterwards on ‘Add Step’. (see screenshot, ellipse 2)
![Unbenannt Unbenannt]()
Screenshot: window for workflow configuration, add workflow-step 2 ‘letter’
Then, select ‘Create Record’ from the drop-down menu. The new step is now added to your workflow and ready for configuration. Type in a step description (e.g. Attach document to letter), open the drop-down menu within this second step and select ‘Letter’. (See screenshot below)
![Unbenannt Unbenannt]()
Screenshot: window for workflow configuration, workflow-step ‘letter’ added. Click to enlarge.
Afterwards, click on ‘Set Properties’ and a letter-activity-window will open. (see screenshot below) Within this window, define a sender, a subject and type in your letter-text. Then, set the cursor in the ‘Recipient’-field to define the recipient. To do so, go to the ‘Look for’-area within the form assistant on the right side. Select ‘Account’ in both drop-down-menus, click on ‘Add’ and then on ‘OK’. Now the ‘Recipient’-field is filled out correctly (see screenshot below, colored in yellow).
![62 62]()
Screenshot: window to configure letter-activity
Click on ‘Save and Close’. Now you are back in the general workflow-window again and you can see the added and completely configured letter-activity. In a next step, you have to define that the previously created document should be added to this letter-activity. For that, click on ‘Add Step’ and select ‘Create Record’ from the drop-down menu. (See screenshot below)
![Unbenannt Unbenannt]()
Screenshot: window for workflow configuration, add ‘AttachToLetter’-step. Click to enlarge.
Type in a step description and open the drop-down menu within this step. Select ‘MSCRM-ADDONS.com AutoMergeWorkingItems’. (See screenshot below) Then, click on ‘Set Properties’.
![Unbenannt Unbenannt]()
Screenshot: window for workflow configuration, add ‘AttachToLetter’-step. Click to enlarge.
A window will pop up to configure the ‘AttachToLetter’-workflow-step. Put a name and define the AutoMerge action (in this example choose ‘AttachToLetter’, see screenshot, ellipse 1) Within the ‘Attach to Letter’-section, determine the letter-activity to which the created document should be attached to (see screenshot ‘LetterToAttach-field, ellipse 2) and the document which should be attached (see screenshot ‘DocumentGUID_Letter’-field, ellipse 2).
![Unbenannt Unbenannt]()
Screenshot: window to configure workflow-step, configure ‘AttachToLetter’-step. Click to enlarge.
For determining the letter-activity the document should be attached to, set the cursor in the ‘LetterToAttach’-filed in the ‘Attach To Letter’-area (see screenshot, ellipse 1) and select the correct letter-activity from the drop-down menu in the ‘Look For’-area within the form assistant on the right side. (See screenshot, ellipse 2). After that, click on ‘Add’ and ‘OK’.
![Unbenannt Unbenannt]()
Screenshot: window to configure workflow-step, configure ‘AttachToLetter’-step. Click to enlarge.
To determine the document to be attached, set the cursor in the ‘DocumentGUID_Letter’-field (see screenshot, ellipse 1) and select the correct document from the drop-down box in the ‘Look For’-area within the form assistant on the right side. (See screenshot, ellipse 2) Click on ‘Add’ and ‘OK’.
![Unbenannt Unbenannt]()
Screenshot: window to configure workflow-step, configure ‘AttachToLetter’-step. Click to enlarge.
You have now completed the configuration of this step. Click on save and close. In case you want to stop your workflow at this point, you can click on ‘save and close’ within the general workflow-configuration-window and finish here. In case you want to add further steps to your workflow, you have to define a condition to be fulfilled before you add further workflow-steps. In that case, open the ‘Add-Step’ drop-down menu again and select ‘Wait Condition’. Click on ‘<condition> (click to configure)’ and a window will pop up. In this window, define which condition has to be fulfilled for further workflow proceeding. In our example, we want the workflow to proceed when the created document has been attached to the letter-activity. In our case, we select ‘Attach document to letter step 2 (MSCRM-ADDONS.com AutoMergeWorkingItems)’ from the first drop-down menu, ‘Status’ from the second drop-down menu, ‘Equals’ from the third drop-down menu and ‘Inactive’ from the fourth drop-down menu. (See screenshots below). Click on ‘Save and Close’.
![Unbenannt Unbenannt]()
Screenshot: window to configure ‘Wait Condition’-step. Click to enlarge.
Now you can add another workflow-step. In our example, we want the document to be deleted after it has been attached to the letter-activity. To do so, click on ‘Select this row and click’ and open the ’Add Step’-drop-down menu. Select ‘Create Record’. Afterwards, type in a step-description, choose ‘MSCRM-ADDONS.com AutoMergeWorkingItems’ from the drop-down box within the step and click on ‘Set Properties’. A window will pop up in which you can determine that the created document should be deleted after it has been attached to the letter-activity. For that, put a name and an AutoMerge activity (in our example ‘DeleteTempDocument’). Afterwards, click in the ‘DocumentGUID_Delete’-field within the ‘Delete Temp Document’-area (see screenshot, ellipse 1) and select the document to be deleted from the drop-down box in the ‘Look For’-area within the form assistant. (See screenshot, ellipse 2).
![Unbenannt Unbenannt]()
Screenshot: window to configure workflow-step, configure ‘Delete Temp Document’-step. Click to enlarge.
Click on ‘Save and Close’. After that, you have finished your workflow configuration and you can click on ‘Save and Close’.
![72 72]()
Screenshot: window to configure workflow, workflow-configuration finished.
Please do not hesitate to contact us, should you require further information or our assistance!