Open topic with navigation

# Insert Messages into Exchange

The connector's `insert` fetch action can insert e-mail messages (`.MSG` and `.EML` files) into the Exchange repository or into a PST file on disk. To use the `insert` action, you must construct some XML that specifies where to add each message, and the information to insert. Add the XML to the action as the value of the `insertXML` action parameter.

To insert a message, set the following properties in the XML:

Property | Description | Required
--- | --- | ---
`PSTFILENAME` | The file name of a PST file (on disk) to insert the message into. The connector creates the PST file if it does not exist. | Set this or `STOREENTRYID`
`STOREENTRYID` | The entry ID for the message store (mailbox), when you want to insert messages into Exchange. | Set this or `PSTFILENAME`
`FOLDERENTRYID` | The entry ID for the folder in which to insert the message. The folder must already exist. | Set this or `FOLDERPATH`
`FOLDERPATH` | The path of the folder in which to insert the message. These folders are created if they do not exist. | Set this or `FOLDERENTRYID`

In the following example the message `forInsert.msg` is added to the folder "b", which is inside the folder "a", which is in the store specified by the `STOREENTRYID` property.

    <insertXML>
       <insert>
         <property name="STOREENTRYID" value="0000000038A1BB1...F6E6500"/>
         <property name="FOLDERPATH" value="a/b" />
         <file>
           <type>file</type>
           <content>c:\myFolder\forInsert.msg</content>
         </file>
       </insert>
     </insertXML>

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]

For more information about using the `insert` fetch action, refer to the Exchange Connector Reference.

© 2018 EntIT Software LLC, a Micro Focus company | Send documentation feedback to Micro Focus Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm