Page tree

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

This is the documentation for ConfiForms Server/Data Center app

However, this might also work for ConfiForms cloud and in most cases it does. But please see this page to understand the differences between server and cloud versions of the ConfiForms app.


In this tutorial you will learn how to create JIRA issues with ConfiForms, in Confluence

This tutorial is quite technical...

  • You need to understand the basic concepts of ConfiForms first
  • You need to know what is JSON format and what is API
  • Your Confluence server must have an application link to JIRA configured

Error rendering macro 'excerpt-include'

No link could be created for 'Creating a simple form'.

Let's start with the form definition. We will create a very simple form with just two fields (field definitions):

  • summary - of text type
  • details - of textarea type

Add default "ConfiForms Registration Control"

Add "ConfiForms IFTTT macro" and choose option to create JIRA issue as IFTTT action.

You can set additional watches to the issue what will be created, but in this tutorial we omit this step (see IFTTT macro parameter "watchers"). Could be set dynamically, referencing entry fields or record owner or modifier.

For IFTTT macro body you will need to put some data in JSON format, as JIRA expects it.

You can learn more about JIRA API and creating JIRA issues using it's API's here: https://developer.atlassian.com/jiradev/api-reference/jira-rest-apis/jira-rest-api-tutorials/jira-rest-api-example-create-issue#JIRARESTAPIExample-CreateIssue-Exampleofcreatinganissueusingprojectkeysandfieldnames.

Basically what you see there in "Data" section is something you have to put as IFTTT body.

{
    "fields": {
       "project":
       { 
          "key": "TEST"
       },
       "summary": "REST ye merry gentlemen.",
       "description": "Creating of an issue using project keys and issue type names using the REST API",
       "issuetype": {
          "name": "Bug"
       }
   }
}

You can use "No Format macro" inside the IFTTT macro body to fix possible formatting issues with Confluence editor, like this:

{
    "fields": {
       "project":
       { 
          "key": "TEST"
       },
       "summary": "REST ye merry gentlemen.",
       "description": "Creating of an issue using project keys and issue type names using the REST API",
       "issuetype": {
          "name": "Bug"
       }
   }
}

So we do the following:

[entry.summary] and [entry.details] will be substituted by ConfiForms IFTTT macro before sending the data to JIRA

 

Integration between JIRA and ConfiForms is in experimental mode. We are open to feedback and feature requests: vertuna(at)vertuna.com

Also, important to note that the operation in NOT TRANSACTIONAL, this means that the ConfiForms record save operation and creation of JIRA issue is not run in the same transaction and if JIRA issue creation fails the ConfiForms record could still be created.

In general all the IFTTT integration operations are not transactional and executed in own scope, independently from ConfiForms internal operations

 

 

  • No labels