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: Be sure that your e-mail client sends the e-mail as plain text. If other formats are used, the e-mail will be sent as a multi-part MIME type and the event will not be recognized. 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.
    Important: The attached file must have the .xml file extension and contain only the event XML text.

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–2015 Serena Software, Inc. All rights reserved.