Disclaimer

Your use of this download is governed by Stonebranch’s Terms of Use, which are available at https://www.stonebranch.com/integration-hub/Terms-and-Privacy/Terms-of-Use/

Overview

This integration allows customers to execute AWS Step Functions from Universal Controller.

Version Information

...

Disclaimer

Your use of this download is governed by Stonebranch’s Terms of Use, which are available at https://www.stonebranch.com/integration-hub/Terms-and-Privacy/Terms-of-Use/

 Version Information

Refer to Changelog for version history information.

...

Requirements

This integration requires a Universal Agent and a Python runtime to execute the Universal Task.

...

execute the Universal Task.

...

...

...

...

...

...

Network and Connectivity Requirements

Extensions' Universal Agent host should be able to reach AWS Step Functions REST endpoints. The AWS Credentials provided in the Universal Task, should have sufficient permissions on AWS to execute the Step Function.

Overview

This integration allows customers to execute AWS Step Functions from Universal Controller.

Key Features

This Universal Extension provides the following key features.

...

1. This Universal Task requires the Resolvable Credentials feature, check . Check that the Resolvable Credentials Permitted system property has been set to true. For  For more information about Resolvable Credentials click here.

2. To import the Universal Template into your Controller, follow the instructions here.

3. When the files have been imported successfully, refresh the Universal Templates list; the Universal Template will appear on the list.

...

1. appear on the list.

Modifications of this integration, applied by users or customers, before or after import, might affect the supportability of this integration. For more information refer to Integration Modifications.

Configure Universal Task

For a new Universal Task, create a new task, and enter the required input fields.

...

...

There is no specific cancel logic. In the case of Retry, the Action action will be re-executed.

Output Only Fields

...

Exit Codes

The exit codes for AWS Step Functions Extension are described below.

...

Attribute changed is populated as follows"

• true, in case the AWS Step Function is successfully triggered.

...

An example of the Extension Output for a successful execution an AWS Step Function with the Wait For Success or Failure option selected is presented below.

...

An example of the Extension Output for a successful execution an AWS Step Function with the Wait For Success or Failure option selected is presented below.

{
    "exit_code": 0,
    "status_description": "SUCCESS: AWS Stepfunctions workflow executed successfully.",
    "changed": true,
        "invocation": {
        "extension": "ue-aws-stepfunctions",
        "version": "2.0.0",
        "fields": {
            "action": "Start Asynchronous Execution",
            "credentials_user": "****",
            "credentials_password": "****",
             "extensionregion": "ueus-awseast-stepfunctions1",
         "version   "role_based_access": "1.0.0",false,
         "fields   "role_arn": null,
 {             "action": "Start Asynchronous Execution","state_machine_arn": "arn:aws:states:us-east-1:169598488829:stateMachine:UE_Test_StateMachine",
             "credentialsexecution_username": "****",

            "credentials_passwordinput": "****",null,
             "region": "us-east-1",
"use_proxy": false,
            "role_based_accesswait_for_success_or_failure": falsetrue,

            "rolepolling_arninterval": null2,
             "stateproxy_machine_arntype": "arn:aws:states:us-east-1:123456789012:stateMachine:UE_Test_StateMachine",
null,
            "execution_nameproxy": "ue-stepfunction-fd1aaa9a-8dde-4c8d-bed9-e56e1fb44243",
null,
            "inputproxy_credentials_user": {}null,

            "useproxy_credentials_proxypassword": falsenull,
             "waitproxy_forca_successbundle_or_failurefile": true, null
        }
    },
    "polling_intervalresult": 5,{
             "proxy_type": "",
  "executionArn": "arn:aws:states:us-east-1:169598488829:execution:UE_Test_StateMachine:ue-stepfunction-65cb4d81-08ff-4fe2-a2c4-0aa6ca878661-1",
          "proxystateMachineArn": null,
            "proxy_credentials_user": null,
            "proxy_credentials_password": null,
    "arn:aws:states:us-east-1:169598488829:stateMachine:UE_Test_StateMachine",
        "proxy_ca_bundle_filename": null"ue-stepfunction-65cb4d81-08ff-4fe2-a2c4-0aa6ca878661-1",
         }
 "status": "SUCCEEDED",
   },     "resultstartDate": {
"2023-08-15 16:27:58.977000+03:00",
        "executionArnstopDate": "arn:aws:states:us-east-1:123456789012:execution:UE_Test_StateMachine:ue-stepfunction-2d091ad5-9efd-499c-9f3a-4bf5c8c02eff",2023-08-15 16:28:05.081000+03:00",
        "output": "stateMachineArn": "arn:aws:states:us-east-1:169598488829:stateMachine:UE_Test_StateMachine",null",
        "outputDetails": {
            "nameincluded": "ue-stepfunction-2d091ad5-9efd-499c-9f3a-4bf5c8c02eff",
        "status": "SUCCEEDED",
        "startDate": "2022-07-22 13:17:05.548000+00:00",
        "stopDate": "2022-07-22 13:17:11.578000+00:00",
        "output": "{}",
        "outputDetails": {
            "included": true
        }
    }
}

STDOUT and STDERR

STDOUT and STDERR provide additional information to User. The populated content can be changed in future versions of this extension without notice. Backward compatibility is not guaranteed.

Integration Modifications

Modifications applied by users or customers, before or after import, might affect the supportability of this integration. The following modifications are discouraged to retain the support level as applied for this integration.

• Python code modifications should not be done.
• Template Modifications
  • General Section
    • "Name", "Extension", "Variable Prefix", "Icon" should not be changed.
  • Universal Template Details Section
    • "Template Type", "Agent Type", "Send Extension Variables", "Always Cancel on Force Finish" should not be changed.
  • Result Processing Defaults Section
    • Success and Failure Exit codes should not be changed.
    • Success and Failure Output processing should not be changed.
  • Fields Restriction Section
    • Default configured values should not be changed.

Users and customers are encouraged to report defects, or feature requests at Stonebranch Support Desk.

Document References

This document references the following documents.

...

 true
        }
    }
}

STDOUT and STDERR

STDOUT and STDERR provide additional information to User. The populated content can be changed in future versions of this extension without notice. Backward compatibility is not guaranteed.

Integration Modifications

Modifications applied by users or customers, before or after import, might affect the supportability of this integration. The following modifications are discouraged to retain the support level as applied for this integration.

• Python code modifications should not be done.
• Template Modifications
  • General Section
    • "Name", "Extension", "Variable Prefix", "Icon" should not be changed.
  • Universal Template Details Section
    • "Template Type", "Agent Type", "Send Extension Variables", "Always Cancel on Force Finish" should not be changed.
  • Result Processing Defaults Section
    • Success and Failure Exit codes should not be changed.
    • Success and Failure Output processing should not be changed.
  • Fields Restriction Section
    • Default configured values should not be changed.

Users and customers are encouraged to report defects, or feature requests at Stonebranch Support Desk.

Document References

This document references the following documents.

Changelog

ue-aws-stepfunctions-2.0.0 (2023-09-01)

• Breaking Change: This version supports Universal Agent and Universal Controler from version 7.2 onwards. Customers that used older versions of this integration on Universal Controller and Universal Agent of versions <= 7.2 are required to upgrade to use the new functionality introduced by 2.0.0.
• Added:A suffix is added to the Execution Name before AWS Service is called. That suffix represents the execution count for a specific task instance, therefore providing uniqueness of the Execution Name.
• Fix: The Extension Output attribute “fields.invocation.execution_name” is corrected to represent the user input after the resolution of UC Functions and variables

ue-aws-stepfunctions-1.0.1 (2022-09-29)

• Fix: Correct the handling of the escaped characters within input field json payload which led to the impossibility of execution of the Step Function.(#30334)

ue-aws-stepfunctions-1.0.0 (2022-08-23)

...