Testing a non-running flow with sample data

You can use auto-generated or custom sample data to test the mappings and transformations in the input fields for the nodes in a flow.

Tip: Testing a field's mappings and transformations affects only the sample data that is shown under the field in the flow editor; for example:

To use sample data to test the mappings and transformations in your input fields, complete the following steps:

1. From the flow editor, open the Context and sample data pane, which provides the facility for specifying sample data. You can open this pane in several ways:
   • Click the Context and sample data icon next to the event name, action name, or Request, Response, or Toolbox node name.
     
   • Click within a field that contains a mapping, and then click the Edit link that is next to the sample data under the field.
     
   • Click any mapping within a field, and then click Edit sample data from the menu, as shown in the following examples.
     
     

   When you click Context and sample data for an event, action, Toolbox, or Response node name, the Context and sample data pane opens with a collapsed section for each of the previous nodes in the flow. For a Request node, the collapsed section shows the input for the request. You can click to expand each section to view, regenerate, or customize the sample data for the fields. (The initial sample data typically displays a value of SampleFieldName for string fields, 1 for integer fields, true for Boolean fields, and 1985-04-12T23:20:50.52Z for date fields.)

   

   When you click an input field, then click Edit for its sample data, the Context and sample data pane opens with focus on the sample data for the first mapping in the input field.

   

   When you click a mapping within an input field, then click Edit sample data from the menu, the Context and sample data pane opens with a focus on the sample data for the selected mapping.

   
2. In the Context and sample data pane, you can manually specify one or more values that you want to use to test your field mappings and transformations. Alternatively, click Regenerate sample data to auto-generate a fresh set of sample data. If the auto-generated sample data is not a perfect match for the type of data that you require, you can tweak this data to match your expectations.

   Changes that you make to the sample data in the Context and sample data pane are reflected immediately in the sample data that is displayed for the fields in the current node. The changes are also reflected in any later nodes that reference those mappings. These changes persist while the flow editor is open.

3. To see the result of your changes to the sample data, look at the sample data under the node's input fields. If you applied JSONata functions to the mapping, the sample data is transformed to show the result of those functions.

   The following example shows results for auto-generated sample data.

   

   The following example shows results for custom data that was manually entered in the Context and sample data pane.

   

   After specifying sample data, you can close the Context and sample data pane by clicking the Close icon (x) or by clicking the Context and sample data icon again.

   

About this task

You can test the following actions in your flow:

• All actions for applications that you have created accounts for on the Applications tab of the App Connect catalog; for example, Salesforce / Create lead
• Any API that you have connected to on the APIs tab of the App Connect catalog
• The Log utility on the Toolbox tab

To test an action, ensure that the following conditions are met:

• For actions that require an account, ensure that an appropriate account is connected; for example, your Salesforce developer account.
• Make sure that the configured action has no validation errors, such as missing mandatory fields.

When these conditions are met, the Try this action icon is enabled:

To test your specified settings for an action, complete the following steps:

1. Specify realistic sample data for the type of action:
   1. Open the Context and sample data pane, as described in Testing the mappings and transformations of your data input within fields.
   2. Overwrite the default sample data with preferred custom values that you want to use for testing your mappings and transformations. Alternatively, click Regenerate sample data to auto-generate a fresh set of sample data and then tweak the values if necessary.
      Tip: Ensure that the sample data is appropriate for the type of action that you are testing. For example, if you are retrieving data by using an ID or email address, the sample data must provide a valid ID or email address that exists in the target application. Or if you are creating a record, the sample data must match any special format that the target application requires for certain fields; for example, an email address of abc@xyz.com rather than SampleEmail.
2. When you are satisfied with the results of the sample data that is shown under the fields for the action, click the Try this action icon .
   

   When the action is completed, a test result notification is displayed under the action name in the flow editor; for example:

   
3. To see the test result details that were returned from the application, click View details to open the Test results pane. The results are displayed on the Output tab as shown in the following example. (You can also click the Input tab to see the content of the request.)
   

   In the Test results pane, you can click the Code icon (</>) to see the JSON output for the test and can copy this output by clicking the Copy icon .

   

   For the preceding example, which resulted in a successful test for a Salesforce Create lead action, you can also see the new lead in your Salesforce instance. (For this reason, you must use test or nonproduction instances when you try out an action or flow.)

   

   If a triggered action on a target application fails with an error, the test notification shows a "failed" result, and the details provide more information.

   

About this task

To test a flow, ensure that the following conditions are met:

• For actions that require an account, ensure that an appropriate account is connected; for example, your Salesforce developer account.
• Ensure that the configured nodes have no validation errors, such as missing mandatory fields.
  Restriction:

  • Flows that contain Batch process or Notification nodes cannot be tested.
  • A For each node processes only the first three items that it receives.

When the conditions for testing are met, the Try this flow icon is enabled:

To test your configured settings for a flow, complete the following steps:

1. To specify realistic sample data for the configured nodes in the flow, complete the following steps for each node.
   1. Open the Context and sample data pane for the node, as described in Testing the mappings and transformations of your data input within fields.
   2. Overwrite the default sample data with preferred custom values that you want to use for testing your mappings and transformations. Alternatively, click Regenerate sample data to auto-generate a fresh set of sample data and then tweak the values if necessary.
      Tip: Ensure that the sample data you want to test with is appropriate for its associated field. For example, if you are retrieving data by using an ID or email address, the sample data must provide a valid ID or email address that exists in the target application. Or if you are creating a record, the sample data must match any special format that the target application requires for certain fields; for example, an email address of abc@xyz.com rather than SampleEmail.

   The following example shows the Request node of a simple flow for an API that retrieves contact details from Salesforce by ID. In the Context and sample data pane, the default sample data for the CustomerID request parameter is overwritten with an actual contact ID from the connected Salesforce instance.

   

   The Salesforce / Retrieve contacts action defines the retrieve by ID condition and indicates that the custom sample ID from the Request node is used to call Salesforce.

   

   The Response node defines the status code and contact data that is returned for a successful response.

2. When you are satisfied with the results of the sample data that is shown under the fields for the configured nodes, click the Try this flow icon .
   

   When the flow processing completes, a test result notification is displayed; for example:

   
3. To see the test result details that were returned from the application, click View details to open the Test results pane. The results are displayed on the Output tab as shown in the following example. (You can also click the Input tab to see the content of the request.)
   

   In the Test results pane, you can click the Code icon (</>) to see the JSON output for the test and can copy this output by clicking the Copy icon .

   

   For event-driven flows, successful test results show the message The flow test completed successfully. You can check the target applications to verify that you can see the expected results.

   

   If a triggered action on a target application fails with an error, the test notification shows a "failed" result, and the details provide more information. In the following example, a sample ID was generated to test the flow, which then resulted in a failure because that contact ID does not exist in the Salesforce instance.

   

1. Trigger the flow with a ServiceNow / New incident event, then add an IBM Watson Tone Analyzer / Get tone analysis action. Configure the Text field in this action to specify which data is analyzed from the ServiceNow incident. In this case, to analyze information that is recorded in the short description and comments, add mappings for these ServiceNow fields.
   
2. Add custom sample data that resembles the type of incidents to analyze and determine a tone score for. Click within the Text field, then click Edit to open the Context and sample data pane.
   The following example shows custom sample data that is likely to drive a negative score.

   
3. To test this action, click Try this action , then view the details of the (successful) test results to check the tone score returned from IBM Watson Tone Analyzer.
   For the sample data, the test generates mostly sadness and anger, which are tones that are associated with negative comments.

   

   You can run further tests of the action to understand what is a good threshold to trigger a notification message in Slack.

4. To define who needs to be notified in Slack, add a Slack / Send message action, then specify a channel and the message text. You can also test this action with sample data to check that the Slack messages contain the correct amount of information to help the SRE team investigate. When the test is successful, you can test the entire flow.
   
5. Click Try this flow for the flow name, then view the test results.
   

   You can see confirmation that the flow test was successful, and you can check for the Slack message in the connected Slack account.