| Table of Contents |
|---|
Introduction
This plugin is designed to facilitate form data versioning, allowing user to manage and track different versions of your form data. To enable it, simply select the "Data Versioning" option within Form Builder, located under "Settings" and "Load Data From."
The plugin source code is available in JogetOSS repository at https://github.com/jogetoss/data_versioning.
Data Versioning Plugin Configuration
This plugin has very minimal configuration. After the plugin has been installed, In the folder builder, go to Settings and for Load Data Form, select the "Data Versioning" option and you are good to go.
Figure 1: Plugin Configurations
Plugin Usage
1. Create a form with the desired fields and set the Data Versioning as Load Data Form.
2. Generate a datalist for the form.
3. Create a UI menu, add a CRUD menu to link the datalist and form.
Figure 2: UI Builder
4. Run the UI, click new to create a new record. Key in the form data and save.
5. Edit the form. At the top right corner, you will see a Manage Versions Option, as shown below:
Figure 3: Edit Form Data & Manage Versions.
6. If this is first edit and you click on the Manage Versions link, you will see an empty list. This is because there is no previous version(s) as shown below:
Figure 4: Empty Versions List
7. Now let us change some field value(s). At the most bottom, there is an input field saying: "What did you change?". Key in something meaningful about the edit and save the form.
Figure 5: First Edit and Save
8. Click on edit again and click on the Manage Versions button. In this page you can see all the versions available. Every time you make changes and save, it will generate a new version. Click on View Difference.
Figure 6: Form Data Version List
9. Now you You can see the difference, the red color strikethrough text shows that previously the word does not exist in that version, the green color text shows the original text in that version. Let us click on now observe the distinction: the text with a red strikethrough indicates that the word did not exist in the previous version, while the green text represents the original content in that version. Click "Restore to This Version" to proceed.
Figure 7: View Difference in Versioning
10. Now click on edit again. You can see that the field values have been restored to the chosen version.
Figure 8: Restored to Chosen Version
11. Whenever you restore to previous version, the history will also be saved in Form Data Version List.
Figure 9: Form Data Version List with Restore Version History
12. By clicking selecting "View Difference of " for the Restore Restored Version record, we can see what we have modified. Green color is the added text, red color is the removed textreview our modifications. In this visual comparison, the green text represents added content, while the red text signifies removed content.
Figure 10: Restore Version Difference
13. This versioning plugin works with other languages as well.