# Insert Information into the Repository

The connector's `insert` fetch action inserts information into the repository.

To use the `insert` action, you must construct some XML that specifies where to add each item, and the information to insert. You must add the XML to the action as the value of the `insertXML` action parameter. The exact structure of the XML depends on the type of item that you want to insert.

To insert an item into the CMIS repository, you must set the following properties:

`REPOSITORY_ID` | The ID of the repository to insert the item into.
`OBJECT_TYPE` | The type of object to insert.
`PARENT_OBJECT_ID` | The ID of an object that will be the parent of the inserted object.

You must also define whatever metadata is required by CMIS for the type of object that you are inserting. The metadata required by CMIS must be defined at the root level, and not as nested metadata fields.

Depending on the type of object you are inserting, you might need to specify a file. For information about the ways in which you can specify a file, refer to the documentation for the insert fetch action in the CMIS Connector Reference.

An example value for the `insertXML` parameter appears below. This example specifies a file as base64-encoded data:

    <insertXML>
        <insert>
            <property name="REPOSITORY_ID" value="-default-"/>
            <property name="OBJECT_TYPE" value="document"/>
            <property name="PARENT_OBJECT_ID" value="9bbfdf01-e065-4412-bf0c-31059f944cec"/>
            <metadata name="name" value="example.txt"/>
            <file>
                <type>content</type>
                <content>VGhpcyBpcyBteSBmaWxl</content>
            </file>
        </insert>
    </insertXML>

The XML contained in the `insertXml` parameter must be URL encoded before being used in the action command. For example:

    http://host:port/action=Fetch&FetchAction=Insert
                                 &ConfigSection=MyTask
                                 &InsertXML=[URL encoded XML]

For more information about using the `insert` fetch action, refer to the CMIS Connector Reference.

_FT_HTML5_bannerTitle.htm