# Insert Documents

The `insert` fetch action inserts information into the Documentum repository. To use the insert action, you must construct some XML that specifies where to add each item, and the information to insert. URL encode the XML and add it to the action as the value of the `insertXML` action parameter. For example:

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

The `insertXML` must include:

- The `file` element, to specify a file. For information about the ways in which you can specify a file, see the documentation for the `insert` fetch action in the Documentum Connector Reference.
- The `FOLDER` property, to specify the folder to add the file to.

You can optionally include:

- The `FORMAT` property, to specify the format of the file using format names recognized by the Documentum server. You can find the format names by querying the `dm_format` object in Documentum. The `FORMAT` property is optional. If you do not set this property, the default value of `unknown` is used.
- Metadata to assign to existing Documentum fields.

For example, the value of your `insertXML` action parameter might look like this:

    <InsertXML>
       <insert>
          <property name="FOLDER" value="documents/pdfs"/>
          <property name="FORMAT" value="pdf"/>
          <metadata name="keywords" value="things"/>
          <!-- ... -->
          <file>
             <type>file</type>
             <content>things.pdf</content>
          </file>
       </insert>
    </InsertXML>

© Copyright 2019 Micro Focus or one of its affiliates | Send documentation feedback Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a mail client, and then send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm