Setting up the RequestBody input parameter for the dox42 pop-up

Prev Next

Steps

  1. In Microsoft Word, go to the dox42 ribbon and select Data Map.

    Toolbar displaying various functions like Generate, Data Map, and Refresh Template options.

    dox42 ribbon

    The Data Map Designer window opens.
    Data Map Designer interface showing various data source options for integration.

  2. Select the Input Parameter button.
    The Input Parameter window opens.

  3. Enter RequestBody in the Input Parameter Name text field.

  4. From the Input Type menu select the Text entry.

  5. Select the D365 CE Request Body button.
    This loads the correct JSON structure for your RequestBody.

  6. Adjust the JSON to your needs and enter one sample entry with valid Id inputs here, to be able to properly test your template.

    Input parameter settings for data sources including JSON and Excel options.

    Input Parameter window

  7. Select the OK button.

  8. To resolve the JSON, add a new XML/JSON data source:

    1. In the Data Map Designer select the XML/JSON button to add a new XML/JSON data source.
      The XML/JSON window opens.

    2. Enter parameters in the Name text field.

    3. From the URL/XML/JSON menu select the GET entry.

    4. In the text field to the right of the URL/XML/JSON menu enter <%RequestBody%>.

    5. To load the correct structure for your JSON go to the Initialisation & Fields tab.

    6. Select the D365CE Request Body entry from the SharePoint/MultiValue Field/Apps menu.

      Data Map Designer interface showing XML/JSON data source initialization and fields configuration.

      New XML/JSON data source parameters

    7. Select the OK button.

  9. To resolve the complex type field for Ids add another XML/JSON data source to separate them into various id entries:

    1. In the Data Map Designer select the XML/JSON button to add a new XML/JSON data source.
      The XML/JSON window opens.

    2. Enter id in the Element text field.

    3. From the URL/XML/JSON menu select the GET entry.

    4. Select the Insert Data Field button to load your ID complex type field from your first XML/JSON data source.

    5. To load the correct structure for your JSON select the IDs from dox42 SharePoint/D354 CE App entry from the SharePoint/MultiValue Field/Apps dropdown.

      Data Map Designer interface showing XML/JSON initialization and field settings.

      New XML/JSON data source ids

    6. Select OK.

Result

You have set up RequestBody input parameters.You can use your two new XML/JSON data sources for anything you want.

For example, use the ids to filter your primary data source, add a text field to your template or define an additional query string in the dox42 Template Configuration in Dynamics with a dynamic format (see example below).

ReturnAction.Format=<%parameters.format%>&ReturnAction.Filename=Contract.<%parameters.format%>