Version Control

Introduction

• Application Version
• Process Version

These are the instances where versioning is involved with:-

• Process design update.
• App version update.
• App export/import.

Application Version

Coverage of Application Version

Updating Application Version

These are the instances when process version will change.

• Creation of new version from existing app version.
  
  The current app version selected will be cloned (process, form, datalist, userview and properties including default plugin properties, message bundles, and environment variables ) over to the next available version number.

• Import of App
  

Important Notes

• There can only be one published version at any point of time.
• End users will only be able to access the published version and consume what is available (accessing process, form, datalist, userview etc) in that version with the exception of process instance's form access. (Read more under process version below)

Process Version

Inside an app version, it contains process design but process design has its own set of versioning called process version.

Determine current process version

Under each process in processes tab, click on "Show Additional Info" link to reveal the Process Definition ID. You can find the process version in between the 2 hashes.

Coverage of Process Version

Updating Process Version

These are the instances when process version will change.

• Process design update via deployment from Process Builder or by uploading .xpdl definition file.

• Import of App

When one of the above takes place, Joget Workflow will find the next available process version and assign to it.

For example, in the table above, upon process design update via process builder, the process version will now turn to 2 from 1.

In some cases, one may perform a process design update on older app version even though there's a newer app version in place as illustrated in the table below.

In this case, app version 1 will now hold process version 3 and not 2.

Important Notes

1. One will always start a new process instance using the latest process version of the current published version.

2. By updating the process design in the same app version: all existing running process instances in the same app version will automatically be updated to the new process flow in the background. Do not perform this unless it is absolutely necessary in a production server.

   Do not repetitively update process design in a short time

   Process migration will takes place once process design is changed. Repetitive process change deployment will disrupt existing process instances migration in the background.

   By updating the process design in the same app version: all existing running process instances in the same app version will automatically be updated to the new process flow in the background. Do not perform this unless it is absolutely necessary in a production server.
   After you update the process design, do remember to check all the activity/plugin mappings to make sure that they are current and in sync with your process design. 

Access of Forms

Process instance that contains activity mapping(s) make use of the forms created under the same app version. Regardless of the current published app version, the process instance's assignment will show form mapped to it, of the same app version the process instance falls under.

For example, in the table and screenshot below, 123_hr_expense_process1 will show forms mapped according its activity mapping under app version 1 regardless of whether app version 1 or 2 is published or not.

On the other hand, 124_hr_expense_process1 will show forms from app version 2.