Project Data Map
Control Architect provides a feature that allows mapping of multiple version sets of PKS Xml folder files to a common project alias name. It accomplishes this mapping of multiple version files by parsing the last folder name in a folder path to form a common project alias name.
This view can be accessed from the Ribbon Toolbar menu Data/View Data Map.
Project Alias Name Formation
Typically you will define an internal standard as to how Xml compressed file names are formed when exporting the configuration from a server. An example would be where a Coker unit export would have its folder name (compressed file name) formed as in "DCU_20130628", which indicates that this is a Coker type unit exported on June 28, 2013. Another version from the same unit server would be formed as "DCU_20130726". The common alias name that can be formed using this convention would be "DCU".
Control Architect uses Regex expression types to allow a user to provide a custom match expression that will accurately resolve a file/folder name to a common project alias name. The default expression installed with Control Architect simply looks for the first '_' character and uses all characters to the left of '_' to form the common project alias name.
Default Regex Match Expression
This is the default expression that will search for the first '_' character and use all characters to its left to form the project alias name:
(^[a-zA-Z0-9]+)[_]
This expression simply tries to match starting at the beginning of a text any Upper/Lower case letter including the digits 0-9 until the '_' character is encountered. The resulting match if this expression was applied to the text phrase "DCU2_20130628" would be "DCU2".
It is recommended that users form the folder name that contains PKS Xml configuration files using the following format:
UUUU_yyyymmdd where U=Unit descriptor such as DCU, y=calendar year, m=calendar month and d=calendar day.
Using the Project Data Map
The Project Data Map view shows 3 groups of information that are currently used in a project data map.
-
The Project Alias names in use
-
The Xml folder locations that are mapped to a project alias name
-
The document references that are currently mapped to a project alias name
Project Alias names
This data grid displays the current set of Xml project alias names that have been formed as a result of attaching a document reference using the ChartView function on a function block. The following functions are available within this data grid:
Add New Xml Alias Name:
Click the data grid row that indicates "Click here to add a new item..." to manually add a new Xml alias name. You do not normally have to manually add project alias names here as this will automatically be defined and added when you view a particular Control Module in the ChartView and add a document reference to a function block.
Edit Existing Xml Alias Name and Regex Parse Expression:
Clicking in a data grid cell that for a selected row will enable editing of the cells contents. Click the toolbar Save button to save any changes.
If the Regex parse expression is changed, it is recommended that you test the expression modification by using the Project Data Map Configuration to verify the results of the modifications. Simply copy the modified expression, navigate to the Data Map Configuration, paste the copied expression into the current default Regex expression text box, enter a test phrase and click the Test button. Do not click the Save button unless you want to keep this Regex expression as the application default to use when Xml alias names are automatically defined as a result of adding an attached document to a new PKS Xml configuration file folder.
Delete Xml Alias:
Press the Delete key to delete the selected data grid row item. After confirming the delete request, if document references exist for the project alias you will be presented with a view to choose how to resolve the disposition of its attached documents. You can choose to delete the document references or to move the document references to another project alias mapping. Only a single Xml project alias data grid row item can be deleted in the same operation. If multiple data grid rows are selected, the first data grid row that was selected in the sequence will be the item that is deleted.
Tip: If the format used for defining folder path names is changed and another Xml project data map alias is automatically defined, then you can delete the old project alias and choose to move its attached document references to this new Xml project alias.
View Attached Document References
You can view attached document references for a single or multiple project alias names by pressing and holding the Control Key while selecting an Xml alias name row in the data grid. Pressing Ctrl+A while focused in the Xml project data map grid will select all configured Xml alias names and their attached document references.
Delete Attached Document References
You can delete attached documents by selected one or more document references and pressing the Delete key.
Tips and Tricks
-
If the format used for defining folder path names is changed and another Xml project data map alias is automatically defined, then you can delete the old project alias and choose to move its attached document references to this new Xml project alias.
Shortcuts
-
Pressing the key sequence Ctrl+A while focused in a data grid or list will select all its contained items.
Notes:
-
You cannot edit or delete any data displayed in the Xml folder locations list.
-
Only a single Xml project alias data grid row item can be deleted in the same operation.
-
If this view is currently open when a document reference is attached while in a ChartView, this view will automatically be refreshed. You can can also manually refresh the view by clicking the refresh button located in the upper right corner of the view.
Project Data Map Options
The default Regex expression that is used when a new Project data alias is created can be changed by the user through the Project Data Map Configuration view.
Internet References to Regex Expression Development
