List Item tab

Use this tab to specify the attributes of the list items that you want to add to a list of SharePoint Server.

List item is specified as a set of fields and their values. This may be useful, for example, for creating new announcement item in the Announcement list or issue item in the Issues list.

Option Description
Route Use this combo box to define whether the component will route list items to the server.

To activate routing list items, select Yes from the drop-down list in the combo box; select No to deactivate it.

Routing list items can be activated according to a condition. See more information about conditions in Conditional activation.

Note: If the activation is OFF, the component will not route any list items; this can be useful, for example, if you need to route documents only.
List Specify the list on the SharePoint server where the routed list item will be stored. If the specified list does not exist on the server, the configuration can be saved; however at run time an error will occur and the list item will be rejected.

You can enter the list name manually or click the browse button (...) to open the Select List dialog box that allows selection of one of the existing lists on the server.

It is mandatory to fill out this text box.

Folder path Specify the folder path where the routed list item will be stored.

You can enter the folder path manually or click the browse button (...) to open the Select Folder Path dialog box that allows selecting one of the existing folders in the displayed folder tree.

You can create a folder dynamically by entering a new name for the folder. You can also create a subfolder of the existing folder by entering the subfolder name after the folder name followed by the slash character '/'; for example, Folder1/New folder.

Overwrite If this check box is selected, the component will compare the existing items in the list with the one that is being added, and if they coincide, the old items will be replaced with the new one. Items are compared based on the values of certain key fields. Click the Search keys button to specify these fields. If this check box is not selected, new items will be added to the list without replacing old ones.
Search keys This button is enabled only when the Overwrite check box is selected. Click this button to specify the fields that will be used as a basis for item comparison. The Define Search Keys dialog box will open.
Note: If you use the Overwrite option and specify a particular list item field as key field, this field should be added to the Fields list for correct replacement.
Permissions Click this button to set the permissions, that is, access rights which users or groups will have for the routed list item. The Define Permissions dialog box will open.
Workflow Specify a workflow that will be assigned to the routed list item. The workflow is a sequence of operations configured on the SharePoint server. You can enter the workflow name manually or click the browse button (...) to open the Select Workflow dialog box that allows selection of one of the existing workflows.
Content type Specify a content type of the routed list item. A content type describes the set of properties of the list item and its behavior. The content types are defined on the SharePoint Server at the site level and can be applied to lists configured to manage them.

You can enter the content type manually or click the browse button (...) to open the Select Content Type dialog box to select a content type.

Note: You can set up the content type in two ways:
  1. Specify the content type in the Content type text box.
  2. Leave the Content type text box blank and specify the value of the Content Type field in the Fields list.

If you do not specify any content type and the specified list is configured to use content types, the list item will have the default "list item" content type.

Fields This group allows assigning properties or fields to the routed list item.
Note: Each list has its own specific set of fields. If this list requires a set of mandatory fields, these fields will be assigned to the list item anyway. The mandatory fields are marked with sign at configuration stage. If you have not specified the values of mandatory fields, they will be set to default values specific to the list.

The component verifies the correctness of the specified fields at the configuration stage. If you have specified an incorrect field, the component displays the sign before the field name. If you have specified the list item content type in the Content type combo box, the component will check if the fields configured in the Fields list belong to the specified content type. When the Content type combo box is blank, the component checks if the configured fields belong to the list of all possible fields of the list.

Ignore missing fields If this option is selected, the component will ignore fields that are specified in the configuration but absent on the SharePoint server. If this option is not selected and you specify fields that are absent on the server, routed documents will be rejected.
Verify values Check this box to verify the values in the fields. When this check box is selected, then the component prevents you from saving documents with invalid values.
Note: This option verifies the values only in the Choice and Lookup fields, if they have a restricted number of values, and the Number field with the "from" - "to" restriction.
Add Click this button to add a new field to the fields list. The Add Field dialog box will open.
Edit Click this button to edit properties of the selected field from the list. The Edit Field dialog box will open.
Remove Select one or several fields and click this button to remove the selected fields from the list.