Creating messages

You can create a message that contains requirements and drag that message onto an action in a test.

Procedure

  1. In the requirements tree, locate and select the folder, component, or operation in which you want to create a message.
  2. Click the Create a new Message icon at the top of the tree.
  3. When prompted, enter a name for the new message and click OK to proceed.
    Prompt for message name
  4. The new (empty) message is created and opened for editing in the work area to the right of the project tree.
    The empty message
  5. You can now build the message that can be used later to test your wanted requirements.
    Note: For more information about building the different message components such as transport and formatter, header, body, and validation options, see Messages.
    Note: Messages that are created in the Requirements Library are displayed under their respective operations, in a Requirements folder, in the Test Factory perspective.

What to do next

After you create the message, different options are available when you apply it to a test.
  • When you drag the message onto the root of a Message Switch action, you can replace existing data or add new message cases. If you choose to add new cases, you have the following options:
    • Copy the message structure only
    • Use the message as a filter
    • Use the message as an assertion
    • Copy the structure and use the message as both a filter and an assertion
    If you choose the first option, the message structure and all values are copied, but filtering and assertions are disabled for all fields.
  • When you drag the message onto the root of any other action, you have the following options:
    Update this action with a link to the requirement
    Any changes you make to the requirement are reflected in all of the tests where the requirement has been applied.
    Update this action with a copy of the requirement
    Changes to the requirement do not affect the test.
After you add the message to a test action, you have the ability to change the instance of the message in the test. However, if you want to save your changes, you must break the link to the requirement. A window is displayed with the following options:
Discard any changes and keep the link
Reset the contents of the message instance to match the requirement message.
Keep any changes and unlink
Save your changes. Any subsequent updates to the requirement message will not be reflected in the instance of the message in the test.
At any time when you are editing an action that contains a link to a requirement message, you can click the link icon to display the following options:
Unlink from message
Any subsequent updates to the requirement message will not be reflected in the instance of the message in the test.
Change linked message
The requirements tree is displayed. Select another message to link to the current action.
Open linked message
The requirement message that is currently linked to the action is opened for editing. Note that changes you make to this message will be reflected in all actions to which the requirement message is linked.
Feedback