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>