Skip to main content

Inspect Documentation - How to

This documentation is regularly updated to reflect any changes or improvements in the software.

If you have any questions or need further assistance, please don't hesitate to contact us or submit a ticket through our service desk.

We're here to help! 😇

Introduction​

Inspect comes in two versions: one for users with ERP integration, and one for those who work manually. In the rest of this documentation, we’ll refer to them as ERP users and Manual users.

Schemas​

How to compare changes between Schema versions in Inspect​

Inspect does not yet include this functionality directly. Until it does, you can use the steps below to retrieve and compare Schema versions manually.

This guide explains how to find, download, and compare different versions of Schemas in Inspect. Use this method to verify what has changed between versions or to restore details from an earlier revision.

Step-by-step guide

1. Open the Ignos API overview​

You can find the Ignos APIs at docs.ignos.io or directly at https://api.ignos.io/index.html

ignos_api

2. Authorize (log in with a valid user)​

ignos_api_auth

  1. Click Authorize (the padlock icon)
  2. Click select all
  3. Log in using your regular Ignos platform credentials
  4. Click Close when done

3. Find the ID of the Schema you're working with​

  1. Open the Schemas overview in Inspect and search for the correct Schema
  2. Click to open it, then copy the ID found at the end of the URL.

schema_id

4. Download the current version of the Schema​

  1. In the API overview, scroll down to the endpoint: /measurementforms/schemas/{id}

current_schema_version

  1. Click the endpoint, then click Try it out
  2. Paste the copied ID into the id field and click Execute

current_schema_version2

  1. If everything is correct, you’ll get status code 200 (successful response).
  2. Click Download to save the JSON file for the current Schema version.

current_schema_version3

5. Download a previous version of the Schema​

  1. Scroll further down to the endpoint: /measurementforms/schemas/archived/{id}

older_schema_version

  1. Click the endpoint, then Try it out again.
  2. Paste the same ID into the id field, but adjust the last number in the ID to match the version you want.
    Example: change ...__3 to ...__1.

older_schema_version2

  1. Click Execute.
  2. If successful, you’ll again receive status code 200, and can download the JSON file showing the older version of the Schema.

older_schema_version3

Note on migrated templates

For some customers, certain Schemas in the system have been migrated from the previous Measurement forms solution.
For these templates, version numbering is not consistent, so changing the last digit in the ID will not always work.

Contact Ignos Support if you encounter these cases.

How to recognize a migrated Schema ID:

  • It typically contains a much higher version number than others
    Example: 3dfb0492-321c-4788-8345-a9c639a788cc__292
  • A 404 (Not Found) error when trying to fetch an older version is also another sign that the Schema was migrated.

6. Compare versions​

Use a text editor that supports file comparison, such as Notepad++ with the Compare plugin.
This lets you see what has been added, removed, or modified between versions.

Example showing changes detected with Notepad++ Compare:

schema_compare

Feedback​

🛠️ Writing in process

Instances​

🛠️ Writing in process