This blog article outlines how to create a document for every contact of an account using the CreateMultiPartXMLbasedonFetchXML step. 

Please note: You have to make sure you first look into the basics of DocumentsCorePack workflow-steps, fetchXML and Dynamics 365 workflows before you start with this. It will make the progress a lot easier. 

In this case, we want to create a document for every contact of an account. To achieve this we need the CreateMultiPartXMLbasedonFetchXML step. 

1) Therefore create a new workflow based on  Account. Go to ❶ DCPWorkflowSandbox and select ❷ CreateMultiPartXMLbasedonFetchxml, like you can see below. 

Figure 1: Add new workflow step - CreateMultiPartXMLbasedonFetchxml

2) Next define the properties of your new workflow step by clicking the [Set Properties]-button, highlighted below. 

Figure 2: Set Properties for CreateMultiPartXMLbasedonFetchxml

 

3) In the properties of the CreateMultiPartXMLbasedonFetchxml step, we add the values displayed below: 

Figure 3: Set custom properties

   

❶ Template1: Our desired Contact Template

❷ Entity Record URL Base: The Record URL of our main entity Account 

❸ FetchXML: The XML we want to execute. (How to build such an XML will be explained later in this article)

❹ FechtSMLResultField: The ID-Field of the returned entities - ContactId in this case

❺ FetchXMLResultEntity: The name of the returned entity (contact in our case) 

 

4) Next, add a second step: Create Record - MSCRM-ADDONS.com AutoMergeWorkingItems.

Figure 4: MSCRM-ADDONS.com AutomergeWorkingItem

5) Then define the properties as follows:

Figure 5: Properties for AutoMergeWorkingItems

❶ Name: Choose a fitting name

❷ AutoMergeAction: Create Document

❸ PrimaryRecordURLFetchXML: The Record URL of the primary entity (in our example Account)

❹ SaveAs: Your desired output (in this example pdf)

❺ MultiDocumentXML: The XML output of the previous step 

How to create the Fetch XML

You can use 3^rd party tools like "XRMToolBox" to make the creation of the FechXML easier. 

Figure 6: FetchXML

1) Use the Dynamics 365 Advanced Find to get the base structure of the Fetch XML you want,  like you can see below. In this case, we wanted to merge all contacts of a particular Account. 

Figure 7: Download FetchXML

2) After building this verifying the result, download the FetchXML and paste it into your XML editor. Adjust the FetchXML so it can be executed correctly and has no syntax errors. 

Figure 8: XML Code - Record URL

3) Afterwards replace the Record URL, which is the primary record you start from, with the value QID, highlighted in yellow below. This is necessary to make the workflow dynamic. 

Figure 9: XML Code - QID

 

4) Then copy the finished XML and paste it into the CreateMultiPartXMLbasedonFetchXML step into the field FetchXML.

 

That’s it! We appreciate your feedback! Please share your thoughts by sending an email to support@mscrm-addons.com.