List Item tab

Use this tab to specify the attributes of the list items that you want to add to a list of SharePoint Cloud 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 must 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 fields under Appendices.

If the activation is OFF, the component does 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 Cloud server where the routed list item is stored. If the specified list does not exist on the server, the configuration can be saved; however at run time an error occurs and the list item is 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.

Overwrite

If this check box is selected, the component compares the existing items in the list with the one that is being added, and if they coincide, the old items are 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 are 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 to be used as a basis for item comparison. The Define Search Keys dialog box opens.

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.
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 Cloud 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.

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 receives the default "list item" content type.

Fields

This group allows assigning properties or fields to the routed list item.

Each list has its own specific set of fields. If this list requires a set of mandatory fields, these fields are 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 are 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 checks 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 ignores fields that are specified in the configuration but absent on the SharePoint Cloud server. If this option is not selected and you specify fields that are absent on the server, routed documents are rejected.

Verify values

Check this box to verify the values in the fields. When this check box is selected, the component prevents you from saving documents with invalid values.

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 opens.

Edit

Click this button to edit properties of the selected field from the list. The Edit Field dialog box opens.

Remove

Select the fields and click this button to remove them from the list.