specs/models/M_APP_VER

App Versions

An App Version is a saved state of an app that will use the same logic and visuals every time it is run in the Tulip Player.

There are three types of versions:

  1. Development Version: It is a test version of the app that is meant for testing logic and visuals that have been created in the App Editor. The Dev version of apps can be run in Player when an authorized users launches it from the App Editor.
  2. Published Version: This is an immutable, saved state of the app that can be used by a device running the Tulip Player. These can be “restored” to the development version at any time, which will replace all content in the development version.
  3. Snapshot: This cannot be run in the Tulip Player. It is meant for app builders that want to store a version of the app outside of the versioning system that they may want to return to later.

An App Version must be approved using a series of App Approvals before it can be published and released to the Tulip Player.

An App Version can have five states:

  1. Development: Described above.
  2. Published pending approval: Published by the app builder, but has not received a review from an approver within every App Approval yet
  3. Published: Approved by at least one approver in every App Approval and can be run in the Tulip Player
  4. Rejected: At least one approver has rejected the version and it cannot be used in the Player
  5. Approval request cancelled: sAn app builder realized a mistake and canceled the request for approval.

It contains the following Models:

The following Models can be changed and will automatically update within published versions. This means that they can impact published versions from outside of the app publishing system.

The following Models are versioned alongside the app version, and therefore that means that they cannot impact published versions if they are changed:

Fields

Name Description
Version Number A number that automatically increments by 1 every time a new version is published. Cannot be edited by user.
Publisher The name of the user that initiated the publishing workflow
Description An optional description fields for details about the version
Publish Time The timestamp that the publishing workflow was completed and the version was released
Completion List This can be seen on the App Completions Page. A list of all completions related to the version
App Triggers Triggers that can be fired upon the following events:
  • App Started
  • App Completed
  • App Cancelled
  • App Resolution The default size of all steps in that app version. Can be overridden at the step level. Variable List A list of all variables, their default values and the steps that reference these variables Process Cycle Time An expected time to complete the app. Can be either set manually or automatically sum all step cycle times

    Tests

    IDName
    QA-T327Apps Page : 05 - App Versions
    QA-T595Table Queries : 08 - Editing and Deleting Queries, Aggregations in Published and Development Version Apps
    QA-T720Apps Page : 05 / Failing to edit older App Versions

    Requirements

    IDRequirement
    PLAT-8859 (121)Ability to define procedural sequences with relevant process information that can guide an operator through task execution.
    PLAT-8946 (806)All records shall be Enduring, ie. stored, managed, accessible and unalterable for the full retention period.