POST Method for Data Sources

Owned by Hung Techlead
Aug 06, 2024
4 min read

POST Method For Data Sources Now Available!

We are thrilled to announce a significant enhancement to our data management capabilities: the introduction of the POST method for Data Sources!

Previously, our platform only supported the GET method, which allowed you to retrieve data from external sources only through Path Variables. Now, with the addition of the POST method, you can retrieve data by passing parameters via the request body, providing greater flexibility for your data source expansion.

We are committed to continuously improving your experience and believe this new feature will significantly enhance your data management capabilities. Thank you for your continued support and trust in our platform.

With this feature, we have released two versions for users to choose in Jira Datacenter

  • 2.1.0 (Upgrade from 2.0.0)

  • 1.22.0 (Upgrade from 1.21.10 - For user who don’t want to upgrade to Major updates version but still want to use this feature).

For the Cloud version, there is only one release, 2.1.0.

1. Getting Started

We only support whitelist request for POST function in this release with Jira Base URL and Jira Asset API https://api.atlassian.com/*

  • Go to “Apps” → “Table Grid Next Generation” → “Data Sources” → Click “Add Data Source” button

image-20240627-041927.png

  • In the creation Data Source screen, you will see a new input “Method” that you can choose to connect to your external REST API. Choose the “POST” method.

image-20240627-013637.png

 

  • After choosing POST method, there will be some more inputs display:

    • Content Type: “application/json”: Type of data you can pass into the “Body” input.

    • Body: where you enter your data with JSON format.

2. Usage

2.1. Connect a Data Sources using POST Method

  1. Add correct informations to connect Datasource

  1. Click “Test connection” button → see the result on the top right popup

2.2. Using POST Data Sources to get data with Dynamic option

  1. Make sure your Data Source with POST method has been created.

  2. Go to select list column configuration screen

  1. Configure “Dynamic Option”

    1. Choose the Data Source created.

    2. Click on “Get data” button

    3. Check the result and then mapping the value the to the label.

  1. Result

  • Configuration screen

  • Issue view screen

2.3 Using POST Data Sources with Placeholder (2 cases)

2.3.1 Jira value placeholder:

  • Configure “Body” containing placeholder. In this example, we will use placeholder {issue:key}

  • Configure in Column Configuration screen

    • Choose the Data Source created.

    • Mapping the value the to the label.

    • Note: With placeholder, we can only see its value mapping on issue screen.

  • See the result in Issue view screen

2.3.2 Column value placeholder

  1. Configure “Body” containing placeholder. In this example, we will use column placeholder {column:jsummary}

  1. Configure in Column Configuration screen

  1. See the result

  • Configuration screen

  • Issue view screen

2.4. Data Receiver

  • Mapping with Data Receiver.