With Version Workbench you can create, delete, copy and update versions with a user interface that supports working with multiple versions. Updating versions consists of four areas:
- Version details;
- Processing options;
- Data selection;
- Data sequencing.
The following sections will discuss version maintenance functionality of Version Workbench in more detail.
1. Create Versions
New versions need to be created within an OMW project. From the OMW Projects tab of the Version Workbench main screen use the Add button with the project you want to place the new version in selected, or have your default project selected in order to create a new project first, to enter the Create Versions screen:
Here you can enter version specifications in the grid manually or import from an Excel sheet. When the OK button is used and validations are passed, the new versions are added, batch versions will be checked out, to the specified project. As notified at the bottom of the screen, new versions are created with blank processing options and batch versions will have their template defined data selection and sequencing.
2. Delete Versions
In order to delete versions, you need to have the versions you want to delete present in a project. Use the Delete button from the OMW Projects tab of the Version Workbench main screen with the project containing versions you want to delete selected, or have your default project selected in order to make a project selection (creating a new project for version deletion makes no sense), to open the Delete Versions screen:
This screen displays all versions that are currently present in the project. Selecting grid records will enable deletion of the selected versions by using formexit Delete Selected. Formexit Delete Selected will perform a standard ‘delete from all locations’ process for selected versions. Grid record selection is indicated by a green checkmark on the grid row header as displayed above. Use the Select button in combination with multiple grid record selection, double click on a grid record or use formexit Select All to make your grid record selection.
3. Copy Versions
Depending on your project tree selection, the Copy button from the OMW Projects tab of the Version Workbench main screen will open the Copy Version screen for a single version copy (when a single version was selected) with the option for multiple targets as a formexit or the Copy Versions screen that allows you to define a ‘copy configuration’ (when a version template or the project node was selected) in order to perform a mass version copy process. As in general Version Workbench use, if the default project is selected when you use the Copy button, you will have the option to make a project selection or create a new project prior to entering the Copy Version or Copy Versions screen.
3.1 Single Version Copy
The Copy Version screen is displayed when you use the Copy button from the OMW Projects tab of the Version Workbench main screen while you have a single version selected:
By specifying the new version name and description you can create a copy of the selected version. Formexit Multiple Targets will open the Copy Version – Multiple Targets screen:
You can specify multiple copies of the same selected version in the grid which will be created after validations have passed when the OK button is used.
3.2 Mass Version Copy
In the Copy Versions screen you define a ‘copy configuration’. This copy configuration is a collection of source versions with specified target versions and descriptions. A copy configuration can be saved and worked on over time before executing the actual mass copy process. You will enter this Copy Versions screen from the OMW Projects tab of the Version Workbench main screen when you have either the project or a version template listed in a project selected when you use the Copy button:
Initially, a new (unsaved) copy configuration ID is generated based on your user ID and system date and time. You can use formexit Conf. Description to add a description to this generated configuration ID. Instead of working with the initial new generated copy configuration from the screen startup, you can open a previously saved configuration to continue working on by clicking the configuration description link left above the grid. You can specify source versions for the copy process manually or import them from a grid query, OMW Project or Taskview by using the appropriate formexits. The OK button in this screen is multi-functional; it allows you to choose between saving or executing the configuration:
The Validate button will perform validations on the grid content regarding execution of the mass copy process. It will either report through a popup screen that there are errors displayed in the grid:
Or report that validation was passed and execution could be performed:
4. Update Versions
There are four areas to discuss when we talk about updating versions:
- Version details;
- Processing options;
- Data selection;
- Data sequencing.
Except for data sequencing, all these update areas have a cross version, multiple version enabled user interface.
4.1 Updating Version Details
The Select button from the OMW Projects tab of the Version Workbench main screen will open the Version Revision screen for a single version or the Versions Revision screen that allows you to revise version details across versions in the grid. Here is the single Version Revision screen:
And here is the grid enabled multiple Versions Revision screen:
Both screens have batch version specific details available or displayed only for checked out batch versions. The multiple Versions Revision screen offers wildcarded ‘Find and Replace’ / ‘Replace All’ functionality for the version description.
4.2 Updating Processing Options
Using rowexit Processing Options from the OMW Projects tab of the Version Workbench main screen will open the standard Processing Option dialog if an individual version was selected. If a project or version template node was selected, the PO Mass Update screen will be opened after you have confirmed the generation of a working Freezepoint for the detected number of versions popup screen:
The grid is QBE enabled and Visual Assist functionality is supported though a clickable visual assist form or UDC specification in a separate grid column. There is wildcarded ‘Find and Replace’ / ‘Replace All’ functionality available. Any changes in the grid are indicated by a clickable Reset value in the most left column which will undo the grid change for that grid line. The actual Processing Option updates will take place in the login environment after the OK button is pressed.
4.3 Updating Data Selection
Using rowexit Data Selection from the OMW Projects tab of the Version Workbench main screen will open the standard Data Selection dialog if an individual batch version was selected. If a project node or version template node was selected, the DS Literal Mass Update screen will be opened after you have confirmed the generation of a working Freezepoint for the specified number of batch versions popup screen:
This screen only offers data selection lines with a literal value specification for update. The literal value update supports special values and conversions between Single Value, Range of Values and List of Values. There is a syntax specified for these purposes which is also displayed in the error message glossary:
- Special Values: <Zero>, <Blank>, <Null> and <Null Date>
- Single Value: 'value'
- Range of Values: 'value bottom' .. 'value top'
- List of Values: 'value1','value2','value3'...
For date literals the same formats appy for Single, List and Range. In addition, the date format is MM/DD/YYYY.
The grid is QBE enabled and there is wildcarded ‘Find and Replace’ / ‘Replace All’ functionality available. Any changes in the grid are indicated by a clickable Reset value in the most left column which will undo the grid change for that grid line. The actual Data Selection updates will take place on the local specs in the login environment after the OK button is pressed.
4.4 Updating Data Sequencing
Using rowexit Data Sequencing from the OMW Projects tab of the Version Workbench main screen will open the standard Section Data Sequencing dialog if an individual batch version was selected. Version Workbench does not support mass update functionality for data sequencing.