SBM Orchestration Guide → Raising External Events → Raising an External Event through E-mail

Raising an External Event through E-mail

This section contains general instructions for raising external events through e-mail using the ExampleEventDefinitionSOAPMessage_forEmail.xml template, which is included in the Advanced Orchestration Package. For details on creating a sample e-mail event message, see Creating a Sample E-mail Event SOAP Message.

To raise an external event through e-mail, perform the following steps:

  1. Open the ExampleEventDefinitionSOAPMessage_forEmail.xml file in an XML editor. The template file is included in the Advanced Orchestration Package. (The contents of the template are shown in the next section.)
  2. Provide values for the following Body elements. The values in italics are based on the definitions in your event definition:
    • EventId
    • Timestamp
    • EventType
    • ObjectType
    • ObjectId
    • Product
    • ProductVersion
    • ProductInstance
  3. Define the data elements that you will send with the event in the Extension element.
  4. Provide your authentication credentials in one of the following ways:

    • Use the ns:ALFSecurity element.

      This method is shown in the template.

    • Use a WS-Security header.

  5. Specify the recipient's e-mail address in the wsa:To element.
  6. To send the event XML in the body of the e-mail, copy and paste the contents of the XML file into the body of the e-mail, and then send it to the address in the wsa:To element.
    Important: SBM can retrieve the ALF event from either a plain text body (single part e-mail message) or the last plain text part of a multi-part message. SBM does not process single part messages that contain only HTML text or multi-part messages that do not contain plain text with the ALF event.

    Some POP3 mail servers are able to convert single part HTML messages into multi-part messages that also contain plain text equivalent HTML. If you are using this type of POP3 mail server, you can send HTML-only messages as well. For details, see solution S141688. If plain text cannot be used, then send the event XML as an e-mail attachment (see the next step).

    Important: Be sure that your e-mail client does not insert extra characters, such as line endings, when you send the e-mail.
  7. To send the event XML as an e-mail attachment, attach the XML file to the e-mail, and then send it to the address in the wsa:To element. The text file attachment will be processed instead of the message body and treated as UTF-8 by default.

Related Topics

Creating a Sample E-mail Event SOAP Message

Accessing the Advanced Orchestration Package

Defining an Event Definition

Testing Events from an External Source

Copyright © 2007–2016 Serena Software, Inc. All rights reserved.