Getting Started Using Control Conversion Views

 

 

Control Architect provides3 Control Templates that are used to define a Control Conversion task.

 

 

 

 

 

You can quickly establish your Control Property templates by copying the header values from an Excel Worksheet and pasting them into a Control Property Template using Ctrl+C/Ctrl+V keyboard sequences.

 

Control Architect provides an Import Wizard that also allows you to quickly connect to Honeywell exported configuration file types including PKS Server CEE exported XML files, PKS Server QuickBuilder exported PNT/HDW text files, LCN Exception Build (EB) text files to establish the target Control Property set for a Template.

 

The configuration file entity that is used to establish your set of target control properties becomes the basis for your BasedOn Control Template.  This Control Template is used when executing Bulk Build/Edit type tasks as the basis for editing or creating new configuration entity instances.

 

 

A Control Binding Template establishes a relationship or mapping between 2 Control Property Templates that represent the source of the Property or Parameter data and the Property or Parameter data for the target Control System platform.

 

A Control Binding establishes a relationship or mapping between a particular source Property and a target Property.  A default C# script is automatically generated for a Control Binding when the source and target properties have been defined.  You can change the results of the Property get accessor in the generated script to provide custom transformation of the source Property value during conversion.

 

Each Control Binding Template instance must define a Primary Key attribute so that the Control Conversion task can uniquely identify the data contained in the Excel Data Source.  This will almost always be the entity NAME data property.

 

The Control Binding Template also contains a button target that will automatically generate a list of Control bindings based on exact source and target Property name matching.  It will also automatically set the Primary key binding for a Control Binding whose source Property name equates to NAME.

 

You can view/edit the Control Binding script by left mouse double-clicking on the column named Code.  This will expand a details view of the Control Binding item and display the script code in a C# Code Editor View.  To collapse the detailed script view double-click on the Code column.  Hovering your mouse cursor over a Control Binding items Code column will also show a ToolTip of the script code.

 

 

 

When modifying the default generated Control Binding scripts you should always compile and evaluate the script to validate its script code changes.  Select a particular Control Binding or use the key sequence Ctrl+A while focused in the Control bindings DataGrid view to select all Control Binding items.  Right mouse-click to display a shortcut menu and select the menu item Compile and Evaluate Property Snippet to compile and generate a set of properties to be tested in the Evaluate View.  After compilation has completed successfully the Evaluation View will be popped into view.  You will enter values in the Source Value column and verify that the Target Value column displays the proper transformed results.

 

If a code compilation fails, the Output View will show a Flashing LightRed background color to indicate that errors were encountered during compilation.  The compilation error usually indicates the source code line number where the error occurred.  You can view the full compiled C# script by clicking on the Code View  and looking at the referenced source code line number.  This Code View is a read-only view of the compiled source code.  You will need to open the C# script editor for the Control Binding that contains the errors and modify its script contents.

 

 

 

A Control Conversion Template establishes a relationship between a Control Binding Template instance and an Excel File Data Source.  It also defines the type of data to be generated by specifying the type of Output Adapter to use.  This release of Control Architect only supports PKS XML configuration as the output adapter type.

 

The basis of all Bulk Build and Bulk Edit tasks is the Control Conversion Template.  The execution of a Control Conversion task from within the Control Conversion Template view will generate a Data Collection View that contains the results of processing Control binding evaluations against your Excel Data Source and referenced Control BasedOn Template files.

 

The saved results of the generated Collection View are used in a Workflow Control Conversion Activity to update existing or create new control configuration entities.

 

 

 

A Workflow activity uses the Data Collection results to generate output based on the type of Output Adapter that was chosen in the Control Conversion Template.

 

Workflow activity types for Control Conversion include: