Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Integration Hub for Jira

...

  #iHub

Welcome to the world of integrations!

...

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 iHub REST request action as input for the chained integration(s). 

Image RemovedFor non REST calls checkout our Extensions like Kafka.


Image Added


Getting started

Getting started is easy. Once installed, the RINT iHub 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 new iHub REST Request action by clicking the "CREATE" button

Image RemovedImage Added

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

...

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

Setting

Explanation

NAMEName of the RINT iHub Rest integrations & automation
Parent actionSpecify a parent RINT iHub 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 iHub 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

Mustache Variables - Usage

Triggers

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

...

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

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

Scheduled jobs

...

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

Post functions

Coming soon. Post function triggers are currently not supported. with and without JQL

Enable integration

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

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

Execution log

Once a RINT a iHub 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 Tab 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 your iHub 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.

...