How to configure a SharePoint list

This Advanced List type allows you to connect to a SharePoint list, search through its items, and use the retrieved values inside your workflow.

To ensure the list works correctly, all columns you want to use must be indexed. You can manage indexes by opening the SharePoint list settings and selecting Indexed columns.

This explanation will be displayed on the demonstration printer list.

image-20260108-201933.png

How to configure the column indexing

  1. Open the SharePoint list in the web interface and go to List settings.

  2. Under Columns, select Indexed columns.

  1. image-20260108-202047.png

    Check whether the required column is already indexed.

  2. image-20260108-202104.png

    If it is not listed, click Create a new index and select the column you want to index.


SharePoint list configuration in OptimiDoc Advanced lists

image-20260108-202023.png


  1. Name – Enter the name of the parameter.

  2. Description – Add a short explanation of what the parameter is used for.

  3. Type – Select Online list.

  4. Import format – Choose JSON.

  5. Import record path – Leave empty.

  6. Import value path / Import label path

    • To return the ID of a list item, enter: id

    • To return a column value, enter: fields.<column_name>
      (Replace <column_name> with the actual internal name of the SharePoint field.)

  7. Authentication type - choose From workflow - SharePoint

  8. Site path - The SharePoint site location containing the list.

  9. List name - The title of the list you want to use.

  10. Requested parameters