Insert a List Item
To insert a list item, the insertXml must include the following properties.
TYPE
|
The type of item to insert. To insert a list item, specify LISTITEM. |
PATH
|
The path, including the list item name, of the list item relative to the root of the list. |
You must then specify either (LISTID, SITEID, and SITECOLLECTIONURL) or (INSERTFROMPATH, SITEURL, and LISTNAME).
INSERTFROMPATH
|
To insert a list item by path, set this to TRUE. |
LISTID
|
The GUID of the list to which you want to add the list item. |
LISTNAME
|
The name of the list to which you want to add the list item. |
SITECOLLECTIONURL
|
The absolute URL of the site collection to which you want to add the list item. |
SITEID
|
The GUID of the site to which you want to add the list item. |
SITEURL
|
The absolute URL of the site to which you want to add the list item. |
The following properties are optional:
FSObjType
|
An integer that determines how the list item is represented in the file system. If the list item represents a file, specify 0. If the list item represents a folder, specify 1. |
You can optionally add metadata to the list item.
[Prefix][FieldName]
|
Replace [Prefix] with the value of the ItemFieldNamePrefix parameter, as set in the configuration file. Replace [FieldName] with the name of the field that you want to add, and specify the value. |
For example, the value of your insertXML action parameter might look like this:
<insertXML>
<insert>
<reference>TEST_LIST_ITEM</reference>
<property name="TYPE" value="LISTITEM"/>
<property name="PATH" value="folder/subfolder/item1"/>
<property name="LISTID" value="26FFE115A45AF1F1"/>
<property name="SITEID" value="E11526FFA45AF1F1"/>
<property name="SITECOLLECTIONURL" value="http://sharepoint/SiteCollection/"/>
<property name="FSObjType" value="1"/>
<metadata name="MyPrefixMyIntegerField" value="123"/>
</insert>
</insertXML>
To insert a list item by path, your XML might look like this:
<insertXML>
<insert>
<reference>TEST_LIST_ITEM </reference>
<property name="TYPE" value="LISTITEM"/>
<property name="PATH" value="folder/subfolder/item1"/>
<property name="LISTNAME" value="MyList"/>
<property name="SITEURL" value="http://sharepoint/SiteCollection/Site/"/>
<property name="INSERTFROMPATH" value="TRUE"/>
<property name="FSObjType" value="1"/>
<metadata name="MyPrefixMyIntegerField" value="123"/>
</insert>
</insertXML>