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>