Statuses (Provision Portal)

This module is currently unavailable and will be available in future versions. The documentation below is provided for reference only.

Provision Portal Statuses manages custom status codes and their descriptions for device provisioning workflows.

When to use it

Use Statuses when you need to:

  • define custom status codes for provisioning operations,

  • manage status descriptions for operator clarity,

  • create, edit, or delete status entries,

  • export status definitions before making changes,

  • import updated statuses with a dry-run preview.

Prerequisites

Before working with Statuses:

  • Confirm you are logged into the correct environment.

  • Confirm your permissions:

    • VIEWER — browse statuses and Export.

    • EDITOR / ADMIN — create, edit, delete, and Import.

VIEWER accounts run in read-only mode. Write actions (Create/Edit/Delete/Import) are blocked.

Status structure

Each status entry contains:

Status Code

Numeric identifier for the status (e.g., 200, 404, 1001). Must be unique.

Status Description

Human-readable description of what the status represents.

Browse statuses

  1. Review the statuses table:

    • Code — status code (numeric).

    • Description — status description text.

    • Actions — view, edit, delete buttons.

  2. Statuses are sorted by code by default (ascending).

  3. Use the search field to filter by code or description.

Search statuses

Use the search field to filter statuses:

  1. Enter text in the search field.

  2. Statuses are filtered by code or description as you type.

View status details

  1. Click on a status row or the view button.

  2. The dialog displays:

    • Status code.

    • Status description.

    • Metadata (Created/Updated timestamps and authors).

Create a new status (EDITOR/ADMIN)

  1. Click New Status.

  2. Enter Status Code (unique numeric value).

  3. Enter Status Description.

  4. Click Create.

Expected outcomes:

  • The status is added to the list.

  • Duplicate status codes are not allowed.

Edit a status (EDITOR/ADMIN)

  1. Open the status view dialog or click the edit button.

  2. Update the status code or description.

  3. Click Save.

Changing a status code requires it to remain unique.

Delete a status (EDITOR/ADMIN)

  1. Click the delete button on a status row.

  2. Confirm deletion in the dialog.

Deleted statuses cannot be restored. Ensure the status is not in use before deletion.

Export statuses

  • Click Export to download a JSON file with all status definitions.

Import with dry-run

  1. Click Import and upload a JSON file.

  2. Review the dry-run preview:

    • Summary counts (to add / update / delete / skip).

    • Details per status, grouped by status.

    • Errors and warnings.

  3. If warnings exist, check Allow warnings.

  4. Click Apply import.

Expected outcomes:

  • Dry-run runs automatically after file selection.

  • Warnings require explicit confirmation before apply.

  • Errors block apply until resolved.

Refresh

  • Click Refresh to reload the current statuses from the server.

  • Use after imports or changes by other operators.

Troubleshooting

Edit actions are disabled

Confirm your role is EDITOR or ADMIN.

Duplicate status code

Choose a unique status code that doesn’t already exist.

Cannot delete status

Ensure the status is not referenced in active provisioning configurations.

Import blocked by errors

Fix the reported issues in the JSON file and re-import.

Configuration not found

Click Refresh or import a JSON file to create the initial snapshot.

Related pages