Page tree
Skip to end of metadata
Go to start of metadata

Integration Hub for Jira      #i.hub

Welcome to the world of integrations!

With Integration Hub for Jira, you can easily create no-code automated REST-integrations to extend, automate and integrate with Jira. 

Since integrations can be triggered from either an issue event, scheduled job or (coming soon) a post function the possibilities are endless. REST Request actions can also be chained, using the response from the previous RINT REST request action as input for the chained integration(s). 



Getting started

Getting started is easy. Once installed, the RINT user interface is available for the administrator at the applications page. (Cog → applications) 

Click the REST-integrations link underneath the RESTFUL INTEGRATOR section to get started. 

User interface

Create a new RINT REST Request action by clicking the "CREATE" button

The user interface has 3 sections; Configuration, Triggers, and Execution Log. 

Configuration

In this section, you will set up most of the RINT configuration.

Setting

Explanation

NAMEName of the RINT Rest integrations & automation
Parent actionSpecify a parent RINT Integration. Makes this integration a child to the parent. A child will be executed after successful execution of the parent.
MethodHTTP Method
UrlTarget endpoint URL
Authentication Method

Currently supported auth. methods.

  • Basic Auth
  • Bearer token
  • Parent - Uses the same authentication as the parent integration Only applicable for child integrations. 


HeadersSpecifies the request headers required for the target endpoint.
DescriptionGeneric description of what this integration does.
BodyREST body for the RINT integration REST request
Variables

Variables are only available for child integrations. This allows you to specify variables based on the parent REST response. Variables are configured by using JSONPath expressions. Read more about this in the chapter "Defining variables" All variables defined will be available in the variable scope that can be used when defining the urls, headers and body.  Read more of this in the chapter "Using variables" 

JSON Path - Pick data from response

Variables

Triggers

You must specify a trigger for your RINT integration in order to wake up the integration.

There are two kinds of triggers for your application:

Issue events

Select the Jira issue event types that you wish your RINT integration to trigger on

Optional: Specify a JQL condition that must evaluate in order for your RINT integration to trigger

Scheduled jobs

Specify a Cron expression that will trigger your integration. Cron expressions are of Quartz format. Hint: Use an online cron maker, ie: http://www.cronmaker.com/ 

Optional. Specify a JQL context scope for the RINT integration to work on. 

Post functions

Coming soon. Post function triggers are currently not supported. 

Enable integration

New RINT integrations will be enabled by default. If you wish to disable an integration this can be done in the Triggers section. 

NOTE

 Child integrations are always triggered by the parent application and cannot have a trigger defined. 

Execution log

Once a RINT integration has been executed you will find the output in the execution log section. This is useful for debugging/monitoring for an application. 

Read View Execution Log for further info.

Testing an action

Testing an action is easy. Make sure the action is saved, then click the "Test" button. 

Enter an issue key for your RINT integration action scope if the action(s) require an issue to work upon. Ie. if there are variable substitutions that refer to an issue. Example: {{issue.key}} in the URL, body, headers.

Read How to Test an action for further info.

Chained child actions

See the section Chained actions and JSON Path



  • No labels