With this special version of the prompts feature, you have the ability to select one or multiple related records while generating a document, rather than all records. This article covers step-by-step how to set up look-up prompts for relations in your templates with the DocumentsCorePack (DCP) Template Designer.
Step 1: Locating the look-up prompts
Unlike other prompts, look-up prompts are created with the relationship designer. To access it, complete the following:
❶ Navigate to the www.mscrm-addons.com tab.
❷ Select Insert MailMerge Fields to open the DCP Task Pane.
❸ Go to the Additional tab.
❹ Select Edit.
Within the Records to show section, you can find three options:
❶ Show all records
❷ Show a look-up window to select a single row
❸ Show a look-up window to select multiple rows
Step 2: Defining the look-up prompt
Before you can create the prompt, you must select the base behavior of the relation from the following options:
a. Show all records
By selecting this option, all related records will be displayed and there is no need for a prompt.
b. Show a look-up window to select a single row
Select just one row instead of displaying all related records.
c. Show a look-up window to select multiple rows
Select multiple rows instead of displaying all related records.
Step 3: Defining a Label
To define a label, click the ❶ Add/Update Labels button.
Each option requires at least one label. A label is a text that is displayed in the DocumentsCorePack dialog in front of the actual control.
If a label for the current user language in Dynamics 365 is set, this translation will be displayed. If there is no label that matches the current user’s language, the first one in the list is displayed.
After you have set up the label, you are able to use your template.
Step 4: Save your template
Before you can use or test your template, please save it. Use the Save template option in the www.mscrm-addons.com tab of Microsoft Word to publish the template to Dynamics 365.
Step 5: Generate the document
While generating the document, you will be prompted to select one or multiple related records.
Please note: Prompts do not work with the Template Designer, but by using the DCP dialog (accessed via the Create Document button in Dynamics 365).
Look-up prompts in Power Automate
Look-up prompts can be created in Power Automate as well. When creating a flow that generates a document through the DocumentsCorePack Connector, you can create a prompt via the Prompts parameter.
When defining the parameter, you will need to enter the name of the prompt alongside its value. Its name should match the name in your template, plus an added “_ovalue” to format it correctly. Its value should be the GUID of the record to be selected. Below is an example.
That’s it! We appreciate your feedback! Please share your thoughts by sending an email to support@mscrm-addons.com.