The connector's insert
fetch action can insert files (usually, e-mail messages) into Digital Safe. To use the insert
action, you must construct some XML that specifies the file to insert.
Use the file
element to specify the content to insert. There are several ways that you can do this, for example specifying the path to a file or providing the content base-64 encoded. For more information about how to specify the source file, refer to the documentation for the insert
action in the Digital Safe Connector Reference.
The following example would insert the file located at C:\files\file.eml
into Digital Safe.
<insertXML> <insert> <property name="DOMAINNAME" value="testdomain1"/> <property name="SERVICEURL" value="http://server/nexch/services/ZANTAZ_StoreAndRetrieveService"/> <metadata name="MAILFROM" value="..." /> <metadata name="RCPTTO" value="..." /> <file> <type>tempfile</type> <displayname>c:\files\file.eml</displayname> <content>c:\files\file.eml</content> </file> </insert> </insertXML>
The properties that you can set are described in the following table:
DOMAINNAME
|
(Optional) Set this property if you want to override the value of the DomainName parameter that is set in the connector's configuration file. |
SERVICEURL
|
(Optional) Set this property if you want to override the value of the StoreAndRetrieveServiceUrl parameter that is set in the connector's configuration file. |
The MAILFROM
and RCPTTO
metadata fields are optional but can be used to override the MailFrom
and RcptTo
parameters in the connector's configuration file.
Add this XML to the insert fetch action as the value of the insertXML
action parameter. The XML 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]
In the response to the insert action, the connector returns the DOMAINNAME
, SERVICEURL
, and ZDK
(a Digital Safe document identifier) for the inserted document(s).
For more information about using the insert
fetch action, refer to the Digital Safe Connector Reference.
|