Documentation

Assets to SQL for Jira Service Management

Last updated: April 2026

Overview

Assets to SQL transforms your Jira Assets (CMDB) data into relational SQL dumps (PostgreSQL-compatible) and CSV files for use in BI tools like eazyBI, Power BI, Tableau, or Metabase. It flattens the Assets object hierarchy into proper SQL tables with inlined reference attributes, handles multi-value fields (either flattened or as junction tables), and supports scheduled syncs with webhook delivery and a REST pull endpoint. The app runs natively on Atlassian Forge — no external databases, and data stays inside the Atlassian infrastructure.

Prerequisites

Jira site requirements

License

The app requires an active license. During Marketplace review, the evaluation license provided by the review process is sufficient.

Installation

  1. Install the app from the Atlassian Marketplace listing onto your Jira Cloud site.
  2. Open the app via Apps → Assets to SQL for Jira. It registers as a Jira Global Page.
  3. The app loads with six tabs: Dashboard, Configure, Export, Settings, Sync History, Help.

Testing Instructions (for Marketplace Reviewers)

Configure tab — 3-step wizard

Click the "Configure" tab. You will see a 3-step progress tracker: Select Schemas → Select Object Types → Configure Attributes.

Step 1: Select Schemas

Check the box next to one or more schemas, then click "Next".

Step 2: Select Object Types

Review the listed object types and uncheck any you don't want to export. Click "Next".

Step 3: Configure Attributes

Click each object type button to review its attributes. For multi-value attributes choose either "Flatten (comma-separated)" or "Junction table" mode. Click "Save Configuration".

Settings tab — Schedule, Webhook, Pull Endpoint

Configure scheduled sync, webhook URL, and generate an API key for the pull endpoint. Click "Save Settings".

Testing each major feature

First export (manual)

Complete the Configuration wizard. Go to the Export tab, select "CSV Zip" + "Download from UI", and click "Export Now". A progress bar appears; when complete, download the ZIP.

SQL export and schema preview

Select "SQL Dump (PostgreSQL)" and click Export Now. Use "Preview Schema" on the Configure tab to see generated DDL.

Dashboard overview

Shows last sync timestamp, trigger type, status, row count, duration, plus a table breakdown.

Sync History

Table of the last 20 sync entries with expandable details.

Scheduled sync

Toggle on, set frequency, and save. Uses the same export pipeline as manual exports.

Webhook delivery

Test Webhook sends a test POST. Run an export with "Push to Webhook" to test delivery.

Pull endpoint (BI tool integration)

Generate an API key (shown once — copy it immediately). Use as ?apiKey=<key> query param or Bearer header. Returns JSON or base64-encoded CSV ZIP.

Multi-value attribute handling

Choose "Junction table" mode to create a separate link table per multi-value attribute, or "Flatten" to keep them as comma-separated strings.

Troubleshooting

SymptomCauseFix
"No schemas found" in Step 1Assets / CMDB is not enabled or no schemas existVerify JSM Standard or above. Create a schema with at least one object type.
Export returns 0 objectsObject types are selected but contain no objectsVerify the selected object types have actual objects.
Export status shows "Partial (capped)"More than 10,000 objects across all selected typesReduce the number of selected schemas or object types.
Pull endpoint returns 401Missing or invalid API keyGenerate a key and use it as ?apiKey=<key> or Bearer header.
Webhook test shows "Failed"URL is unreachable or returns a non-2xx statusTry https://webhook.site for a free test endpoint.

Support

For support enquiries: support@3t-apps.com

Support hours: Monday–Friday, 9:00 AM–5:00 PM CET. Target response time: 1 business day.

Visit Support page → · View full SLA →