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>