Besides many useful built-in action templates, JWT offers the possibility to create individual remote actions.
A remote action always refers to a defined connection in which the information about the remote service, such as the URL and the authentication, is configured. In the action, all further configurations are made in order to clearly address an entry point and with the relevant information. This includes, among other things, the relative path of the actual entry point as well as the parameters which are to be used for the query.
A custom remote action can either be directly created within the Execute remote action post function or within the Remote actions page in the Manage apps administration. On the Remote actions page, you can furthermore copy, edit and delete custom actions.
Define the path to the endpoint to be called by the action. This path will get appended to the configured base URL in the connection.
In order to make it easier and more powerful to work with the REST path, you can use placeholders for path and query parameters. A path needs to follow the following pattern:
/path/to/my/endpoint/{pathParameter}?{queryParameter1}&{queryParameter2}
A path parameter is every placeholder before the first found question mark character. It will get replaced by runtime with the value set in the further configuration.
If a placeholder is found after the first question mark character, it will get treated as a query parameter. You can configure the placeholder in the further configuration and set a custom value. At runtime, it will get replaced by the default query parameter pattern:
queryParameter1=you custom value
If you have defined any placeholders in the REST path, you need to configure how they will get replaced when executing the action. You can set a value either by passing the value of a field to the placeholder or by setting it manually using a Parser expression.
In case the methods POST or PUT is configured as a method type for the action, a JSON-based action body can be defined and configured. Within the body, you can insert usual field codes and Expression parser functions.
Within the Remote actions page in the Manage apps administration, you are able to edit an action just by clicking the edit icon on the remote action that you want to update.
Within the Remote actions page in the Manage apps administration, you are able to copy an action just by clicking the copy icon on the remote action that you want to copy. All configurations are taken over. As the name has to be unique across all remote actions, you need to at least update the action name parameter.
Within the Remote actions page in the Manage apps administration, you are able to delete an action just by clicking the delete icon on the remote action that you want to delete. Please keep in mind that deleting an action might result in an invalid workflow configuration in case they are still used.
Every remote action uses a connection the request will be sent to. This can either be an internal connection that can help to overcome some platform limitations or an external one. Those connections can be created directly within the Execute remote action post function or within the Remote actions page at the Connections tab in the Manage apps administration. There, you can furthermore copy, edit and delete the connections or get information on whether they are used or not.
Select whether to create an internal or an external connection. Although there is a usable default internal connection authenticated as the logged-in user, you can create further internal connections with a dedicated authentication.
Expert tip: On the cloud platform, not all REST endpoints are available for a 3rd party app like Jira Workflow Toolbox. If you want to use such an endpoint, you can overcome this limitation by creating an external connection using the current site URL and passing the authentication of a privileged user instead of using the internal one.
Select the authentication used for the connection.
| Option | Connection type | Description | |
|---|---|---|---|
| Current user | Current instance | The logged-in user will be used to execute the remote action. | |
| Selected user | Current instance | Independent of the logged-in user, the selected user will be the one executing the remote action. | |
| No authentication | External | No authentication details will be passed when executing the remote action. This option can be used to access anonymous accessible web services. | |
| Basic | External | A combination of username and password will be used to execute the remote action. | |
| Bearer | External | An API token will be passed when executing the remote action. |
Within the Remote actions page at the Connections tab in the Manage apps administration, you are able to edit a connection just by clicking the edit icon on the connection that you want to update.
Within the Remote actions page at the Connections tab in the Manage apps administration, you are able to copy a connection just by clicking the copy icon on the connection that you want to copy. Most configurations are taken over except the credentials in case of an external connection. As the name has to be unique across all remote connections, you need to at least update the connection name parameter.
Within the Remote actions page at the Connections tab in the Manage apps administration, you are able to delete a connection just by clicking the delete icon on the connection that you want to delete. If the connection is used in any connection as a default connection, you need to update the affected actions first. Please keep in mind that deleting a connection might result in an invalid workflow configuration in case they are still used.
