About the Connector Wizard

The Connector Wizard makes it easy to prototype, test, and use flexible and powerful Process Definitions that communicate with REST APIs.

How it Works

The ultimate output of the Connector Wizard is one or more Process Definitions that you can use to communicate with a REST API from RunMyJobs. Process Definitions generated by the Connector Wizard work just like other Process Definitions, with customizable input and output parameters that can be incorporated into complex workflows.

Speaking generally, the procedure for using the Connector Wizard is as follows.

  1. Create a REST API Connection in the Connections screen and configure its authentication controls to work with the API you want to communicate with.

  2. Use the Connector Wizard to create a Connector that uses that Connection, and optionally specify the base URL for the API calls you want to make.

  3. Inside the Connector, create an Operation for each type of call you want to make to that REST API. When creating an Operation, you can use Operation Variables to represent values that needs to be customized for each call (such as, for example, object IDs and query strings). You can automatically populate headers and bodies for HTTP calls, set call parameters dynamically, and parse call responses to output parameters in a variety of ways.

  4. Test each Operation in real time as you're building it, to make sure it works the way you want. You can view logs, response headers, and the response body, as well as the contents of any output parameters you create, all before you even save the Operation.

  5. When you’re finished configuring an Operation and you save it, the Connector Wizard generates a corresponding Process Definition with the same name as the Operation. That Process Definition exposes the Operation Variables you created as fields in the Submit Wizard and Process Definition parameters.

  6. Use the generated Process Definitions in your RunMyJobs instance. You can use them as standalone Process Definitions, or incorporate them into Chains as you would any other Process Definition.