Configuring input parameters in the dox42 Add'In

Prev Next

The dox42 SharePoint Online App needs an input parameter to generate your documents, which must be configured in the dox42 Add-In. You can find one sample template in your SharePoint App package folder SP_app_template.

Steps

  1. In Microsoft Word, Excel or PowerPoint, 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 Input Parameter.

  3. Configure an input parameter and give it a name (e.g. ItemID ).

    Input parameter settings for selecting an item with JSON default values displayed.

    Input Parameter window

  4. For testing your documents easier with the dox42 Word Add-In, enter a Default Value for example: [ {"id": "1"}, {"id":"2"}]

  5. Add a XML/JSON data source and call it JSON, for example. The JSON data source parses the ID, which is important for the SharePoint Online App:

    1. Select Insert Data Field and select your created input parameter: ItemID .

    2. In the Element text field, enter: ID.

      Configuration settings for JSON data source in a software application interface.

      Adding a new XML/JSON data source

    3. Go to the Initialisation & Fields tab.

      Configuration settings for XML/JSON data source initialization in SharePoint application.

      XML/JSON Data Source window

    4. In the Table from the Read dropdown, select the Content entry.

    5. In the Table, in the Data Field Name text field, enter Example ID.

  6. Add a SharePoint data source.

    SharePoint data source configuration with fields for name and site details.

    Adding a new SharePoint data source

  7. Go to the Select Fields tab.

  8. Select the Query button.

  9. Configure the Query for your SharePoint data source.

    SharePoint interface displaying query setup for filtering candidate data by ID.

    SharePoint Query configuration

  10. In the Filter Field, filter the ID with your previously created JSON.ID data field.

  11. Use the provided template to test if everything is set up correctly after you have entered your Entra ID information and the site links in the Excel connection file.

Result

You have created an input parameter and configured an XML/JSON data source as well as a SharePoint data source. You can now generate your documents directly from SharePoint Online.