Currently there are 6 delivery methods you can utilize in your process:
- FILE – message will be created in defined server folder
- FTP - message will be created in defined FTP folder
- SFTP - message will be created in defined SFTP folder
- JMS - message will be created and sent by Java Message Service
- MQS - message will be created and sent by Message Queuing Service
- EMAIL - message will be created and sent to defined emails list
In this page:
How to Set Delivery Methods
There are two ways to set delivery method for notification messages in an environment:
- Set the same delivery method for all notification message types by defining the W_DEF_DATA_DM variable in the config file or DeliveryMethod as a task parameter in the Control Message (CM).
- Set a separate delivery method for each notification message type by customizing a variable:
- W_DEF_ACK_DM (in config) / ACKDeliveryMethod (as task parameter) – define custom delivery method for ACK notification message types
- W_DEF_EXTRACT_DM / ExtractDeliveryMethod – for Extract notification message types
- W_DEF_ALERT_DM / AlertDeliveryMethod – for Alert notification message types
- W_DEF_REPLY_DM / ReplyDeliveryMethod – for Reply notification message types
Note
Note
An example of such combination is below:
The task parameters for CM below not only create ACK, Extract, Alert, Reply messages in the defined server folder, but also send a duplicate of the Reply message to defined emails as well:
<taskParameter> <name>DeliveryMethod</name> <dataType>S</dataType> <value>FILE</value> </taskParameter> <taskParameter> <name>ReplyDeliveryMethod</name> <dataType>S</dataType> <value>EMAIL</value> </taskParameter>
When no default delivery method is specified in the configuration files, the FILE delivery method option is used by default.
The FILE delivery method is special and is always used, regardless of whether another delivery method has been set.
For example, if the notification delivery method is set to EMAIL a notification message will be sent via email AND the same notification message will be generated in the defined server folder. If the notification delivery method is set to FILE, only one notification message will be generated in the defined server folder.
You can specify the default delivery method option and associated sub options by file type. The following table lists the delivery method options and sub options available for each file type.
Delivery Method | Option | Sub Options Available | Example of Use |
---|---|---|---|
FILE | :enumDMFILE: | FILE_IN_LOCATION | <COL TAG="FILE_IN_LOCATION" EXPRESSION="'../../../cmw/in/'" USERDESCRIPTION="FILE IN LOCATION"/> <COL TAG="FILE_EXTRACT_LOCATION" EXPRESSION="'../../../cmw/extracts/'" USERDESCRIPTION="FILE extracts location"/> <COL TAG="FILE_REPLY_LOCATION" EXPRESSION="'../../../cmw/reply/'" USERDESCRIPTION="FILE reply location"/> <COL TAG="FILE_ACK_LOCATION" EXPRESSION="'../../../cmw/ack/'" USERDESCRIPTION="FILE ack location"/> Note The expression for FILE method should contain full local path |
FTP | :enumDMFTP: | FTP_URL [we recommend setting this parameter as server ip] | <COL TAG="FTP_URL" EXPRESSION="'00.000.00.00'" USERDESCRIPTION="EA FTP URL"/> <COL TAG="FTP_USER" EXPRESSION="'USER'" USERDESCRIPTION="EA FTP USER"/> <COL TAG="FTP_PWD" EXPRESSION="'base64aes~abcdefgij+X8H+6N93cTok1='" USERDESCRIPTION="EA PASSWORD" ENCRYPTED="YES"/> <COL TAG="FTP_PWD_ISENCRYPTED" EXPRESSION="'YES'" USERDESCRIPTION="It is strongly recommended to encrypt the password above. Otherwise set this value to NO"/> <COL TAG="FTP_FILES_LOCATION" EXPRESSION="'CMW/inbound/'" USERDESCRIPTION="EA FTP LANDING ZONE LOCATION"/> <COL TAG="FTP_EXTRACT_LOCATION" EXPRESSION="'CMW/extracts/'" USERDESCRIPTION="EA extracts location"/> <COL TAG="FTP_REPLY_LOCATION" EXPRESSION="'CMW/outbound/'" USERDESCRIPTION="EA reply location"/> <COL TAG="FTP_ACK_LOCATION" EXPRESSION="'CMW/ack/'" USERDESCRIPTION="EA ack location"/> Note Folder path should be entered relative to the root folder to which you have FTP access. |
SFTP | :enumDMSFTP: | SFTP_URL [we recommend setting this parameter as server ip] | <COL TAG="SFTP_URL" EXPRESSION="'00.000.00.00'" USERDESCRIPTION="URL"/> <COL TAG="SFTP_USER" EXPRESSION="'USER'" USERDESCRIPTION="USER"/> <COL TAG="SFTP_PWD" EXPRESSION="'PASSWORD'" USERDESCRIPTION="PASSWORD"/> <COL TAG="SFTP_PWD_ISENCRYPTED" EXPRESSION="'NO'" USERDESCRIPTION="It is strongly recommended to encrypt the password above. Otherwise set this value to NO"/> <COL TAG="SFTP_FILES_LOCATION" EXPRESSION="'CMW/inbound/'" USERDESCRIPTION="SFTP LANDING ZONE LOCATION"/> <COL TAG="SFTP_EXTRACT_LOCATION" EXPRESSION="'CMW/extracts/'" USERDESCRIPTION="SFTP extracts location"/> <COL TAG="SFTP_REPLY_LOCATION" EXPRESSION="'CMW/outbound/'" USERDESCRIPTION="SFTP reply location"/> <COL TAG="SFTP_ACK_LOCATION" EXPRESSION="'CMW/ack/'" USERDESCRIPTION="SFTP ack location"/> Note Folder path should be entered relative to the root folder to which you have SFTP access. |
JMS | :enumDMJMS: | W_JMS_DEF_ACK_STREAM | <COL TAG="W_JMS_DEF_ACK_STREAM" EXPRESSION="'JMS_EJM_EAGLETIP_SEND'" USERDESCRIPTION="Default JMS ACK Delivery Stream"/> <COL TAG="W_JMS_DEF_REPLY_STREAM" EXPRESSION="'JMS_EJM_EAGLETIP_SEND'" USERDESCRIPTION="Default JMS REPLY Delivery Stream"/> <COL TAG="W_JMS_DEF_EXTRACT_STREAM" EXPRESSION="'JMS_EJM_EAGLETIP_SEND'" USERDESCRIPTION="Default JMS EXTRACT Delivery Stream"/> |
:enumDMEMAIL: | W_SMTPSERVERW_SMTPPORT | <COL TAG="W_SMTPSERVER" EXPRESSION="'000.000.0.00'"/> <COL TAG="W_SMTPPORT" EXPRESSION="'25'"/> <COL TAG="W_SENDMAILFROM" EXPRESSION="'a@b.com'"/> <COL TAG="W_SENDMAILTO" EXPRESSION="'x@y.com'"/>
Note In September 2016 EagleML release (and newer) we are going to move these parameters into w_config.inc, so that you will be getting the default values already set. You will not have to add them to w_config_custom.inc unless you want to use custom streams. <COL TAG="W_EMAIL_DEF_ACK_STREAM" EXPRESSION="'eagle_ml-2-0_default_cm_email_distribution'"/> <COL TAG="W_EMAIL_DEF_REPLY_STREAM" EXPRESSION="'eagle_ml-2-0_default_cm_email_distribution'"/> <COL TAG="W_EMAIL_DEF_EXTRACT_STREAM" EXPRESSION="'eagle_ml-2-0_default_cm_email_distribution'"/> <COL TAG="W_EMAIL_DEF_ALERT_STREAM" EXPRESSION="'eagle_ml-2-0_default_cm_email_distribution'"/> | |
MQ | :enumDMMQ: | W_MQS_DEF_ACK_STREAM | <COL TAG="W_MQS_DEF_ACK_STREAM" EXPRESSION="'MQS_EJM_SEND'" USERDESCRIPTION="Default MQ ACK Delivery Stream"/> <COL TAG="W_MQS_DEF_REPLY_STREAM" EXPRESSION="'MQS_EJM_SEND'" USERDESCRIPTION="Default MQ REPLY Delivery Stream"/> <COL TAG="W_MQS_DEF_EXTRACT_STREAM" EXPRESSION="'MQS_EJM_SEND'" USERDESCRIPTION="Default MQ EXTRACT Delivery Stream"/> |
Change Folders for FILE and FTP Delivery Methods in the Control Message
Note
FTP and JMS Delivery Setup
Note
Configure Control Message Delivery Over FTP
To make Eagle consume control messages from an FTP location, it is necessary to:
- Create a folder on your FTP site CMW/control.
- Create a stream* of FTP/Inbound/XML type based on the eagle_ml-2-0_cm\in\xml\control_messages.rsf ruleset file.
- Do NOT use eagle_ml-2-0* mask for the stream name or it will be deleted when you upgrade.
The control message file should be delivered in to the CMW/control folder.
Configure Control Message Delivery Over JMS
To make Eagle consume control messages from a JMS queue, it is necessary to:
- Create a separate JMS queue for Eagle to read control messages from.
- Create a stream* of JMSPTP/Inbound/XML type based on the eagle_ml-2-0_cm\in\xml\control_messages.rsf ruleset file.
- Do NOT use eagle_ml-2-0* mask for the stream name or it will be deleted when you upgrade.
Configure Data Delivery Over JMS
In order for Eagle to receive data for EJM Requests from a JMS queue, it is necessary to:
- Create a stream* of JMSPTP/Inbound/XML type based on the Eagle_ml-2-0_cm\queue\queueing.rsf ruleset file.
- Specify the data payload.
Configure Control Message Delivery Over FTP
To make Eagle consume control messages from an FTP location, it is necessary to:
- Create a folder on your FTP site CMW/control.
- Create a stream* of FTP/Inbound/XML type based on the eagle_ml-2-0_cm\in\xml\control_messages.rsf ruleset file.
- Do NOT use eagle_ml-2-0* mask for the stream name or it will be deleted when you upgrade.
The control message file should be delivered in to the CMW/control folder.
Configure Control Message Delivery Over JMS
To make Eagle consume control messages from a JMS queue, it is necessary to:
- Create a separate JMS queue for Eagle to read control messages from.
- Create a stream* of JMSPTP/Inbound/XML type based on the eagle_ml-2-0_cm\in\xml\control_messages.rsf ruleset file.
- Do NOT use eagle_ml-2-0* mask for the stream name or it will be deleted when you upgrade.
Configure Data Delivery Over JMS
In order for Eagle to receive data for EJM Requests from a JMS queue, it is necessary to:
- Create a stream* of JMSPTP/Inbound/XML type based on the Eagle_ml-2-0_cm\queue\queueing.rsf ruleset file.
- Specify the data payload.
Configure Email Distribution List
You can set email distribution list to define email addresses, on which notification messages will be sent IF delivery method is ":enumDMEMAIL:" / "EMAIL".
To customize the email distribution list in config file, use the W_SENDMAILTO variable. This setting will make notification messages sent to emails defined in this variable if the delivery method is ":enumDMEMAIL:" / "EMAIL"
Example: tst@mail.ru, tst2@mail.com .
You can also specify an email distribution list for each of notification message types using task parameters in CM:
- ACKEmailDistributionList – to define emails for ACK notification message type
- ExtractEmailDistributionList – to define emails for Extract notification message type
- AlertEmailDistributionList – to define emails for Alert notification message type
- ResponseEmailDistributionList – to define emails for Response notification message type
Important Note
| Config File Option | Control Message Task Parameter Option |
---|---|---|
Names | W_SENDMAILTO (apply to all messages types if set delivery method to EMAIL)
| ACKEmailDistributionList (ACK messages) ExtractEmailDistributionList (Extract messages) AlertEmailDistributionList (Alert messages) ResponseEmailDistributionList (Response messages) |
Values | Email addresses | |
Example | <COL TAG="W_SENDMAILTO" EXPRESSION="’tst@mail.ru, tst2@mail.com,tst3@mail.com’"/>
| <taskParameter> <name>ACKEmailDistributionList</name> <dataType>S</dataType> <value>tst@mail.ru, tst2@mail.com</value> </taskParameter> <taskParameter> <name>ExtractEmailDistributionList</name> <dataType>S</dataType> <value>tst3@mail.com</value> </taskParameter> <taskParameter> <name>AlertEmailDistributionList</name> <dataType>S</dataType> <value></value> </taskParameter> <taskParameter> <name>ResponseEmailDistributionList</name> <dataType>S</dataType> <value>tst@mail.ru, tst2@mail.com,tst3@mail.com</value> </taskParameter> |
Email Notification Setup
Follow the step-by-step instruction for email notification setup:
You will need to get SMTP server and port settings. If you already know them, skip to setting notification parameter.
Otherwise, do the following:
- Open Engine Manager application.
- Go to "All Web Servers">[Server Name in bold]>[THICK server]>EagleSTAR Config Files>Configuration Files->msgcenter->open msgservice.ini file
- Search on the left side parameters SMTP Server, SMTP Port and From email (if last is set):
- Note these values
- Next, you will need to set Send notification parameter
- Open Message Center Editor.
- Open /eagle_ml-2-0_custom_cm/w_config_custom.inc file:
- Find "W_SMTPSERVER", "W_SMTPPORT" ("W_SENDMAILFROM") parameters and set saved values to them using Message Center Editor:
Make sure you are setting the EXPRESSION attribute values in quotes, for example:
<COL TAG="W_SMTPSERVER" EXPRESSION="'10.10.10.10'"/> <COL TAG="W_SMTPPORT" EXPRESSION="'25'"/> <COL TAG="W_SENDMAILFROM" EXPRESSION="'my_from_email@eagleaccess.com'"/>
"W_SENDMAILFROM" parameter defines the email, which will be set in "From" field in notification letter.
For August 2016 EagleML release or older you should set default email delivery streams in w_config_custom.inc:
In September 2016 EagleML release (and newer) we are going to move these parameters into w_config.inc , so that you will be getting the default values already set. You will not have to add them to w_config_custom.inc unless you want to use custom streams.<COL TAG="W_EMAIL_DEF_ACK_STREAM" EXPRESSION="'eagle_ml-2-0_default_cm_email_distribution'" USERDESCRIPTION="Default EMAIL ACK Delivery Stream"/> <COL TAG="W_EMAIL_DEF_REPLY_STREAM" EXPRESSION="'eagle_ml-2-0_default_cm_email_distribution'" USERDESCRIPTION="Default EMAIL REPLY Delivery Stream"/> <COL TAG="W_EMAIL_DEF_EXTRACT_STREAM" EXPRESSION="'eagle_ml-2-0_default_cm_email_distribution'" USERDESCRIPTION="Default EMAIL EXTRACT Delivery Stream"/> <COL TAG="W_EMAIL_DEF_ALERT_STREAM" EXPRESSION="'eagle_ml-2-0_default_cm_email_distribution'" USERDESCRIPTION="Default EMAIL ALERT Delivery Stream"/>
For example:Set value to "W_SENDMAILTO" parameter. This parameter define email, on which notification letter will be send. For example:
<COL TAG="W_SENDMAILTO" EXPRESSION="'my_to_email@ eagleaccess.com''"/>
If you want to get notification only on EJM task fails then add to bottom of this config file next line:
<CODE> :w_default_send_notifications: :='ONFAILURE'; </CODE>
- Click Save button:
- Select Tools->re-initialize Message Center Cache menu item:
- Your email setup is now complete.
- You can run some EJM task to verify For example, drop a Control message to eagle_ml-2-0_default_cm_control_message stream to run a non-existent workflow.