Difference between revisions of "Versioning"

Revision as of 18:06, 29 June 2019

Please note that this page is currently under construction. There is more information to come.

Overview

Versioning (also referred to as SmartVersioning) is a SmartSimple function that allows you to make concurrent versions of applications and forms while using a common set of underlying fields. 

Benefits of Versioning:

• Greatly reduces the work required to manage the changes that occur in forms and applications
• Easy creation, modification, and testing of forms prior to going live 
• Preservation of past forms' values and appearance, allowing System Administrators to view previous form versions in their original format

 You must be a user with SysAdmin privileges to configure the Versioning setting in your system. 

Configuration - Essentials

How Versioning Works

Versioning works by first capturing all of the underlying fields that make up an application or form - this total set of fields is the "baseline." The baseline set of fields contains all of the fields in all application and form versions. The first step in using Versioning is to create a new "version" - this process includes giving that version a Name, Description, selecting the Application Name and Entity that contains the field-set, and taking a Snapshot of the field-set which creates the baseline. 

Follow the steps below to create the baseline. 

Create a New Version

1. Click on the 9-square menu icon on the top right of your page.

 
2. Under the heading Configuration, select Global Settings.

3. Under the heading System Configuration, click the hyperlink SmartVersioning.

Any existing versions that have already been created in your system may be listed here. If you want to edit these, simply click the pencil icon to the left of each version name.

4. To create a new version, click the + icon on the top left. 

5. The New Version form will be displayed. Fill out the fields of this form.

6. When done, click the Save button. 

Create a Baseline

Once you have created and Saved a new version, the page will reload to display the date and time stamp of the creation/modification, the name of the creator/modifier, and the Version Objects section. Through the Version Objects section, we will take the snapshot that comprises the baseline field-set for this version.

1. Click into the Select Application field - a drop-down list of available s within the system will appear.

Pick which application for which you would like to save a version of its fields. 

2. After selecting an application, click into the Entity field which will open a drop-down list of the associated entities with that application. All Level 1, Level 2, and Level 3 entities will be available. 

Select the specific entity level of your application to make up the field-set that you wish to capture. 

3. Once both the Application Name and Entity have been chosen, click the button on the right side: Take Snapshot. 

4. A confirmation pop-up message will appear. Click Yes.

 

5. After you confirm, the Version Objects section of the version form will reload and display the time and stamp date of the snapshot. 

 

The details outlined in red comprise the snapshot that you have taken - all the fields that were included with that application and entity level at the time that the snapshot was taken is what makes up the baseline. 

• Note: You may want to capture fields-sets from the Level 1, Level 2, and Level 3. In this case you will repeat the steps above and create additional Version Objects lines to capture any additional objects, activities, or transactions.

Finding the Current Version

Having followed the steps from the previous sections, you have just enabled Versioning onto your system and created your first snapshot. By default, your Current is your baseline version. You can verify the current version used in your system at any time by following the steps below: 

1. Navigate to the desired whose Version you want to confirm. 

Note: You can navigate to any UTA by clicking the 9-square menu icon on the top right and clicking on the UTA name under the heading Applications.

2. Click on the UTA settings icon - the gear icon - which will allow you to enter into Configuration Mode. 

3. Scroll down until the subheading Features and Options. 

4. Locate the Current Version field, which will display the current version of that UTA.

Note: To change the current version, click on the dropdown menu and select the new version you would like to activate, then click the "Activate" button, and finally click the Save button at the bottom of the window.

Custom Fields and Versioning

Once Versioning is enabled against a UTA object, then the list of Custom Fields related to that object will also indicate an Active Version on the top right of the page. 

1. After navigating to the desired UTA, click the gear icon above its name in order to enter Configuration Mode.

 

2. Click into the tab for the level of object that you have enabled Versioning for. 

3. Click on the hyperlink labelled Custom Fields.

At the top of the list of custom fields will be the Version combo box. 

The Version combo box contains the name of the version of the application or form that you are currently editing. It is this field that allows you to switch between the different concurrent versions that are available. Here is where you will switch between the baseline application version, the current application version, and the new application you are building and testing.

The individual Custom Field Setting page will also include be an indication of the Active Version at the top alongside a Version combo box.

There will also be a Set button to allow users to edit fields in a specific version, and a Diff button to allow users to compare fields in one Version with another version.

Editing Fields in Versions

1. Navigate to the desired UTA.

You can do so by clicking the 9-square menu icon on the top right of your page (), and selecting the UTA under the heading Applications.

2. Click on the gear icon above the UTA name, which will bring you into the UTA settings in Configuration Mode.

 

3. Click on the desired tab for Level 1, Level 2, or Level 3 entity associated with the UTA. The levels go in sequential order - the first tab after the General tab represents the Level 1 Entity and so on. 

4. Click on the Custom Fields hyperlink. 

5. From the Version drop-down option on the top right, select the Version whose fields you want to edit.

The list of Custom Fields displayed will differ depending on what has been saved as the field-set for the Version that you choose. 

6. To edit a specific field, click the pencil icon to the left of the custom field name.

 

You will be brought to the Custom Field edit page of that field. Make any required changes to the version you are working on.

• Remember, these edits will only affect the current version you are editing - which can always be known with the text box at the top right - unless you are making changes to the baseline version. 
• To learn more about editing a Custom Field, see our Custom Fields - General Settings page. 

Deleting Fields in Versions

It is very important you always double-check the version that you are editing. Always be careful when deleting fields from the baseline version. Deleting fields from the baseline will delete those fields from all associated applications and forms. Any new snapshots that are taken afterwards will not include the deleted fields. As well, deleting fields from baseline will remove your ability to reference those fields and their values, thus removing the ability to use the previously stored values.

Deleting fields from versions that are not the baseline will only remove those fields from the specific version you are editing - they will not be removed from other versions.

To delete a field, check the box next to the desired field(s) to delete. A trashcan icon will then appear in the top row of buttons. Clicking on this icon will delete the fields. 

 

• Remember, you can always note which version you are in with the Active Version text box that appears on the top right of your page. 

Comparing Fields in Versions

1. Navigate to the desired UTA.

You can do so by clicking the 9-square menu icon on the top right of your page (), and selecting the UTA under the heading Applications.

2. Click on the gear icon above the UTA name, which will bring you into the UTA settings in Configuration Mode.

 

3. Click on the desired tab for Level 1, Level 2, or Level 3 entity associated with the UTA. The levels go in sequential order - the first tab after the General tab represents the Level 1 Entity and so on. 

3. Click on the Custom Fields hyperlink.

4. Click the pencil icon to edit a specific Custom Field.

5. The details of the Custom Field will be displayed. At the top right, the Active Version is displayed. On the right of the Version field box, select the button Diff. 

6. A modal window that allows Version Comparison will appear, showing the custom field settings for two different versions side-by-side.

To toggle between which versions you would like to compare this custom field against, simply select different versions by clicking into each Version field. 

Creating a New Field

Best practice for creating new fields are to add them to the baseline version first. This makes the new field available to all versions once an update snapshot is taken.

1. Navigate to the desired UTA.

You can do so by clicking the 9-square menu icon on the top right of your page (), and selecting the UTA under the heading Applications.

2. Click on the gear icon above the UTA name, which will bring you into the UTA settings in Configuration Mode.

 

3. Click on the desired tab for Level 1, Level 2, or Level 3 entity associated with the UTA. The levels go in sequential order - the first tab after the General tab represents the Level 1 Entity and so on. 

3. Click on the Custom Fields hyperlink.

4. Click on the '+ 'icon on the left hand side to create a new field.

 

5. Input all the fields required to create your new field. For details on creating custom fields, see Custom Fields – General Settings. 

Adding All New Fields to an Existing Version 

If you want to mass update fields to an existing version, you can easily do by updating the Version Snapshot. This will update the field-sets that comprise the selected Version, and will include any newly added fields added to the baseline since the last snapshot. 

See Create a Baseline for details on how to take a snapshot. 

Add / update individual fields to Older Version

Sometimes a user may wish to apply a new custom field to an older version, or to apply changes made in single field, without taking a snapshot that would apply unwanted updates in other fields to the old version.

The Copy to Older Version option will allow users to do this.

This is available against all UTA custom field lists, but only appears once at least one field has been selected.

If you select some custom fields and click on the Copy to Older Version button then you are presented with the Copy to Older Versions screen.

Users select the version (or versions) that the field, or edits, should be added to from the Version drop-down list.

If this is a brand new field then it will automatically be added to the selected Versions.

If the field already exists on the selected versions then updates will only occur if users select the Update option from the If field already exists setting. If users leave it as Ignore then the changes will not be applied.

Users must then click on the Submit button, and should a confirmation message to indicate that the changes have been applied.

Viewing changes to the Application/Form

The changes that have been made to a version view can be viewed by opening the application or form and selecting the appropriate form document.

1. Navigate to the desired UTA

2. Open the desired application / form

3. From the Version dropdown option, select the version you with to view.

4. Click Set

Note: Toggling between different versions from this page will allow you to easily flip between the existing form and your modified version.

Activating a new Version

1. Navigate to the desired UTA

2. Click on the UTA Settings icon

3. Click on the appropriate Level 1, 2, or 3

4. Under the UTA Properties section, locate the Current Version field.

5. From the dropdown options select the version you wish to make active.

6. Click on the Activate button.

7. Click Save.

Note: Once an application or form is made active all new submissions will be completed and associated with the current version. Past submissions will retain their original version information.

Batch updating records to Versions

To update many different applications and forms to a new version, first start by creating the new version, then use the batch update feature to update as many applications and forms as desired.

1. Navigate to the desired UTA

2. Add a check mark to the check box for each application and form you want to bulk update

3. Click on the Batch Update icon

4. From the Update version to: drop down field, select the new version

5. Select the Batch Update button

Conditional Versioning

Conditional Versioning allows for a customized version of an application or form to be displayed to specific users based on conditions you set.

Conditions can include (but are not limited to):

• Geography
• Role
• Organization type
• Gender
• Age
• Past Activities
• Many, many more

Conditions can also be based on the individual fields that make up an application or form. Any field can be the basis of a condition.

Each Version has a Condition field. In the example below the condition looks at Country field value entered against the current users profile, and will only display the current version if the Country is not set to Canada.

Also See

Versioning - Why?

Click here to learn why this feature is a benefit to your organization.