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

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 Amazon S3 Connector Reference.

## Insert Objects

To insert an object into the Amazon S3 repository, you must set the following properties:

`BUCKET` | The name of the bucket to insert the object into.
`KEY` | The key to use to identify the object.

You must also specify a file to insert (metadata-only documents are not supported). For information about the ways in which you can specify a file, refer to the documentation for the insert fetch action in the Amazon S3 Connector Reference.

An example value for the `insertXML` parameter appears below:

    <InsertXML>
      <insert>
        <property name="BUCKET" value="mybucket"/>
        <property name="KEY" value="folder/file.txt"/>
        <file>
          <type>file</type>
          <content>C:\files\file.txt</content>
        </file>
        <insert_id>012345</insert_id>
      </insert>
    </InsertXML>

_FT_HTML5_bannerTitle.htm