Transform Revisions Dashboard

Deprecated: On January 10, 2023, the Transform Revisions Dashboard was sunset. Sunsetting means:

• Access to the tool on existing environments has been removed.
• Module Settings are set to No Access on existing environments.
• The tool is no longer included when provisioning new environments.

The Transform Revisions Dashboard displays all transforms in the environment and supports viewing revision history, restoring previous versions, and testing transforms with specific data or module submissions.

Restoring a transform is environment-specific. To restore the same transform in another environment, open the tool in that environment and repeat the process.

Transforms Reference

A transform converts data from one format or structure to another. Input transforms always use JSON (Unqork's native format). Output transforms support the following formats:

• NJK (JSON)
• XSL (XML)
• NJK (PDF)
• NJK (XML)
• NJK (TXT)

Common use cases include sending data to external services that require a non-JSON format, accepting data from services that provide non-JSON responses, and mapping data between Unqork modules with different Property IDs for the same data.

Locating a Transform

The tool provides two ways to locate a transform: the Transform Revisions Dashboard and the Transforms Dashboard.

Transform Revisions Dashboard

Use the Module ID and Transform drop-downs to select a module and its transform. Not all modules use transforms; if a selected module has none, an error message displays.

1. From the Module ID drop-down, select a module.
2. From the Transform drop-down, select a transform. Click the link to the right of the drop-down to open the module and verify the transform.
3. Click Apply Filters, or click Reset Filters to begin a new query.

Transforms Dashboard

The Transforms Dashboard lists all transforms in the environment with filters for Application, Module ID, Module Title, and Transform Name. Results update automatically as text is entered. Click the funnel icon to clear all filters.

1. At the top-right of the Transform Revisions Dashboard, click Transforms Dashboard.
2. Use the filters to locate a module.
3. Click View to the right of the module.

Clicking View opens a dialog with the following information:

Transform Revisions Table

After locating a transform and clicking Manage Revisions, the Transform Revisions Dashboard displays three sections: Transform Revisions, Transform Details, and Transform Debugger.

Transform Revisions

The Transform Revisions table lists all revisions for the selected transform.

The table displays 10 entries by default. Use the pagination buttons to navigate to older entries.

Restoring a Revision

Restoring a transform is permanent and affects only the current environment level.

A revision cannot be previewed before restoring. Confirm the correct revision before proceeding.

1. Locate the revision and click Restore.

   

2. In the confirmation dialog, click Restore to confirm, or Cancel to abort.

Transform Details

The Transform Details section displays basic information about the selected transform.

Transform Debugger

Tests the transform against specific data or a module submission.

Testing with Specific Data

1. In the Test Data field, enter test data in JSON format: for example, {"key": "panelInfo"}.
2. Click Test Transform.

The Output window displays the transformed result.

Testing with a Module Submission

1. Click View in App to open the transform module in Express View. Trigger the module and copy the submission ID from the URL. The submission ID is the middle of the three alphanumeric codes: for example, in the URL https://trainingx.unqork.io/5e13aa4616d385021040e00/**5e8769e9c74b570d5e9d88bb**/5e12aa4616d38502104, the submission ID is 5e8769e9c74b570d5e9d88bb.
2. Click Reference a Module Submission.
3. In the Module ID field, enter the transform module's ID.
4. In the Submission ID field, enter the submission ID.
5. Click Test Transform.

The Output window displays the transformed result.