Configuring the MEP settings for the email transport

You can configure the email transport for the message exchange pattern (MEP) in HCL DevOps Test Integrations and APIs (Test Integrations and APIs) and create tests for the application based on the MEP settings.

Before you begin

You must have defined a service component and an operation under a service component in the Logical View. See Creating a service component and Creating an operation.

About this task

When you create a test by using MEP in Test Integrations and APIs, the test can contain any of the following messaging actions:
  • Publish
  • Publish/Subscribe
  • Request/Reply
  • Subscribe
Depending on the messaging action that you want to test, you can select the action by using the settings on the Message Exchange Pattern tab.
Important: The MEP settings you configure are used in the messaging action in the tests you create in the Test Factory view. You can either use the same configuration or modify the settings before you run the tests.

You can configure the MEP settings of the operation that you created for the logical email resource from the Logical View.

Procedure

  1. Double-click the operation to open the Operation dialog.
  2. Click the Message Exchange Pattern tab, if it is not already open.
    The following options for the MEP are listed for selection in the Pattern field:
    • Request/Reply
    • Publish/Subscribe
    • Publish
    • Subscribe
  3. Select the messaging pattern that you want to use in your tests from the list in the Pattern field.
  4. Complete the following steps in the Schema panel:

    See the related links to find information about schema.

    1. Configure the schema settings for the messaging pattern that you selected.
    2. Click Browse to select the schema for each of the patterns by following the on-screen instructions.
      Note: The default schema is Text, if no schema is selected for the messaging pattern.
  5. Complete the following steps in the Bindings panel:
    1. Click Browse.
    2. Select the physical email resource as the required transport in the Select a Resource dialog.

      Refer to the following table for the options and the action you can take:

      Option Action
      No If you select No, you can select any transport in the project.
      Yes If you select Yes, you can select only transports that are referenced (directly or indirectly) by the operation that contains the test.
      Only Direct If you select Only Direct, you can select only transports that are referenced directly by the operation that contains the test.
    3. Click OK in the Select a Resource dialog box.
    4. Configure the email properties for the messaging pattern that you selected.

      The settings that you configure for the email properties are used in the tests you create that are based on MEP.

      Enter details of the email accounts for the MEP that you select based on the properties in the following table:
      MEP selected Email properties
      Request/Reply
      The email properties tab that is displayed as follows:
      Note: When Publish/Subscribe action is selected, the email properties are displayed for the Publish action.
      Image of the email properties tab.
      • Enter text as the subject for the email message.
      • Enter the email address of the recipients of the email message in the To field.
      • Enter the email address of the sender or publisher of the email message in the From field.
      • Enter the email address of the recipients to which a copy of the message is to be delivered in the CC field.
      • Enter the email address of the recipients to whom a reply message is to be sent in the Reply To field.
      Publish/Subscribe
      Publish
      Subscribe
      The email properties tab is displayed as follows:
      Note: When Publish/Subscribe action is selected, the email properties are displayed for the Subscribe action.
      Image of the email properties tab for the Subscribe action.
      • Select the email transport.
      • Enter the name of the folder from which the email messages are to be subscribed to in the Email Folder field.
        For example, you can add Inbox as the email folder.
        Note: The email folder you specify here overrides the folder that you configured for the physical transport.
      • Retain or clear the selections for the Unseen or Mark as Read options.
        Note: The Unseen and Mark as Read check boxes are displayed as the default selections and the following default actions are performed when you subscribe to messages in the email folder:
        • The messages that are not yet seen or read by the recipient are subscribed.
        • The subscribed messages are marked as read in that email folder.
    5. Add parameters that can be used in the messages from the Parameters tab.
      Note: The parameters that you can define in the Parameters tab are the parameters supported by the Apache Camel mail component.
      For example, if you are using the Subscribe messaging action as the MEP, and you want to remove the message from the email folder after you subscribe to the message, you can provide the parameter name as delete and value as true.

      You can add new properties for the parameters in the Parameters tab by clicking New and entering the Name and Value for each parameter.

  6. Click OK to save the MEP settings and exit from the Operation settings dialog.

Results

You have configured the MEP settings for the email resource.

What to do next

You can create tests in the Test Factory view that use the MEP settings for messages. See Supported messaging patterns for email resources.