Message Designer APIs

XML Gateway has provided special purpose procedures and functions for use in the Message Designer to perform the following tasks:

  1. Set event details to raise a business event for inbound transactions

  2. Get event details using the event name maintained by the XML Gateway Execution Engine

  3. Perform string manipulations

  4. Get Trading Partner information using the sender's or receiver's Trading Partner ID maintained by the XML Gateway Execution Engine

  5. Get message envelope data for inbound message

  6. Get delivery data for outbound message

  7. Get document logging information for a business document

  8. Set message delivery status

  9. Get System Administrator e-mail address from ECX: System Administrator Email Address system profile

  10. Get sender logical ID from ECX_OAG_LOGICALID system profile

  11. Set Error Exit

Use the Message Designer, Procedure Call or Function Call actions to initiate the APIs.

Attention: With the exception of ECX_ERRORLOG.external_system, the procedures and functions in this appendix are meant for use in the Message Designer only and should not be used in any other context.

Most procedures include input and output arguments. You can map a source or target variable to the input arguments. The output arguments can be used in conjunction with the Send Error Message action for warnings or the ECX_ACTIONS.set_error_exit_program API for serious errors to send a notification. The notification may be sent to the Trading Partner contact, the system administrator (identified in the ECX: System Administrator Email Address system profile), or both.

If the successful completion of an API is critical to the success of your transaction, you may wish to use the Exit Program action to terminate the transaction if the API fails to process completely.

The following APIs are described in this section:

Package: ECX_STANDARD

setEventDetails

getEventDetails

getEventSystem

getReferenceID

Package: ECX_DOCUMENT

get_delivery_attribs

Package: ECX_CONDITIONS

getLengthForString

getPositionInString

getSubString

Package: ECX_TRADING_PARTNER_PVT

get_receivers_tp_info

get_senders_tp_info

get_sysadmin_email

getEnvelopeInformation

getOAGLOGICALID

Package: ECX_ERRORLOG

getDoclogDetails

external_system

Package: ECX_ACTIONS

set_error_exit_program

Package: ECX_ATTACHMENT

register_attachment

retrieve_attachment

reconfig_attachment

Package: ECX_ENG_UTILS

convert_to_cxml_date

convert_to_cxml_datetime

convert_from_cxml_datetime