How to setup Message Archiving

Message Archive in IFS Connect is a separate placeholder for archived messages. System administrators could use message archiving functionality to move processed and older application messages to Message Archive for future reference. This chapter will describe how to configure this.

Contents

• About Message Archiving
• How to create the Application Server task for the archiving
• How to setup the search parameters

How to create the Application Server task for the archiving

You can define an Application Server Task and schedule the archiving process.

• Create a new Application Server Task with Job Type Archiving, Interface ApplicationQueueUtilHandler and Operation ArchiveQueue.
• Set a recurrence pattern at which interval the archiving task should occur.
• Define Archive Conditions.

  
  

  
  Archiving condition specify the application message that should be archived.
  

  • Set the Queue in which application messages should be archived.
  • Set the State of application messages to be archived.
  • Set how many Hours Old application messages should be archived.
  • Set Max Messages that should be archived by the archiving task
• Define search parameters for the archiving messages by this application server task so that you can retrieve them easily after archiving. See how to setup the search parameters for more details.

See Application Server Tasks for more details.

How to setup the search parameters

Search parameters in an Archive type Application Server Task could be used to create an indexing entry for an archived Application Message. Then the search for archived messages could be done using the index with desired parameters specified.

Message Type and Message Function

If the message type and message function of application message matches the specified values, an index entry will be added pointing to the archived message.

Element Name

If the above condition is satisfied, element name of the index entry will be set with value specified here.

XPath String

The value specified for XPath is used to retrieve the value of element given in the 'Element Name' from the message body. This is used for xml type message bodies. This value is set to element value of the index entry.

For example, according to the above setting, two index entries will be created if the message type and message function matches with that archived application message. One entry will have element name set to COMPANY and element value set to the value retrieved from message body using the xapth //TEST_ORDER/COMPANY/text(). Similarly, element value of second entry is set from value retrieved using xpath //TEST_ORDER/CUSTOMER_ID/text()

Element Name and XPath String can be easily set using the XPath from XML dialog which is displayed once you click on empty cell of one of those two fields.

First load an xml file and double click on an element to set both element name and xpath string.