 |
Open Test Framework
|
|
|
Open Test Framework
|
|
The project settings supports the following design-time and runtime settings related to the project:
Related Topics:
Note: Project settings can be accessed by right-clicking on the corresponding project node in the Solution Explorer and select Properties.
Note: Changes in the project settings can not be reverted by undoing. The changes are written directly to the corresponding file.
In this section, you can set the location path to store the backup OTX documents. Each time you start a sequence in the project or build the project, all the OTX documents including the contain OTX packages are copied to the storage folder. This helps to recover OTX documents in case the documents are unexpectedly changed, damaged or deleted at design-time. You can input the location path directly or browse for the folder via the Browse button.
For the purpose of sharing the project and tracing the modifications, you can set the version for the project manually by enter a number into each digit text box, or it can be done automatically by checking the "Bind last digit to SVN revision number" check box if the current project is under the version control (see Version Control for more information).
Here you can select a Meta-Data layout (*.xml) used in the project. You can then add the template Meta-Data for the documents, procedures or activites from the added layout. You can input the path of the Meta-Data layout file directly or browse for the folder via the Browse button. If you want to import the layout file into the project folder for exchanging the project purpose, you can check the "Import inside the project" check box.
Here you can input the location path for the PTX storage folder directly or browse for the folder via the Browse button.
This page allows to manage the OTX-Mapping of the current project (see OTX Mapping for more information). There can be many mapping files stored in the project but only one mapping file can be used at a time. Here you can select to use the OTX Mapping or HMI Mapping by checking on the corresponding radio button. After selecting OTX Mapping or HMI Mapping, you can select a mapping file which shall be used for the current project in runtime through the corresponding combo box.
All the available mapping files of the current project are displayed in the sub-panel (the old HMI Mapping files are not displayed here but they can be still selected in the HMI Mapping combo box). You can use the buttons below the sub-panel to manage the mapping files. Please note that you can only select and edit one mapping file at a time.
Below are the descriptions of the buttons to manage the mapping files:
| Button | Description |
|---|---|
| Rename | Renames the selected mapping file. |
| Import... | Imports an existing mapping file from outside of the project. |
| New... | Creates a new mapping file. |
| Edit... | Opens the selected mapping file in the OTX Mapping editor for editing. |
| Copy | Copies the selected mapping file. |
| Delete | Deletes the selected mapping file. |
UPDATING...
UPDATING...
Normally, the OTX documents in the current project can only import documents within the same project (Cross-Document reference). To import and use the global elements from the documents in another project, you need to add reference to that project (Cross-Project reference). See Project Structure for more information.
The referred projects can be classified into 2 types: the internal projects (the local projects in the current solution) and the external projects (the PTX libraries). Here in this page you can find the 2 sections with sub-panels corresponding to the 2 types of referred projects.
Here you can find all the available local projects of the current solution, each having a check box. You can add or delete a reference to a project by checking or unchecking the corresponding check box. When this settings page is loaded, the check boxes of the referred projects are already checked.
A PTX library is a zipped OTX project with access to all the public elements such as validities, signatures, global declarations and procedures to be used in another project (See Project Sharing - Export/Import for more information of packing a project into a PTX library). In this section, you can see all the referred PTX libraries displayed in the sub-panel. Above the sub-panel, you can find the Add (+) button to add reference to more PTX libraries, or the Delete button (X) to delete the selected PTX references in the sub-panel , or the "Convert to relative Path" button to convert a PTX reference path into relative path (conversion to relative path only has effect on references with absolute path in the same disk partition with the current project). You can also import the referred PTX libraries from outside into the project folder by using the "The libraries are stored inside the project folder" check box under the sub-panel. When the check box is checked, a check box shall appear at the left of each PTX entries, the PTX libraries with the checked check box shall be imported into the project folder.
Note that a document in the current project can not import a documents in another project with the same document and package name. There shall be the check rule OpenTestSystem::Otx::Core::CheckerRule::Core_Chk002 if a project refers to another project and both the 2 projects have a package and a document with the same name.
When the current project is exported into a PTX, all the referred local projects in the solution are included in the PTX. The referred local projects shall be unzipped together with the main project when the PTX library is added as a project in a solution, all the local projects shall also be added to the solution.
This page allows you to specify the behavior of the explicit logging i.e. using the OpenTestSystem::Otx::Extensions::Logging::Actions::WriteLog activities of the OpenTestSystem::Otx::Extensions::Logging extension or the behavior of the implicit logging which automatically saves runtime traces, exceptions or activity IDs etc.
At each time of an execution, the old contents in the log files are cleared and the current log messages are written into the log files.
Below are the controls in the Logging settings page with their descriptions (according to their position in the bar from left-to-right and top-to-bottom):
| Control | Description |
|---|---|
| Logging switch button | Allows to write log message in log files and apply the logging settings (ON) or not (OFF). Note that when this switch button is turned OFF, no log messages shall be written and all the control below shall be disabled, excepts for "WriteLog Target Resolving" check box. |
Directory Name check box | Uses the default output folder for created log files. |
| Directory Name text box | Users can manually input the output location for created log files here if the users does not use the default output folder. |
| ... (Browse) button | Browses and inputs the output location for created log files in the Directory Name text box if the users does not use the default output folder. |
| Open... button | Opens the current output folder of the log files in a new window. |
| File Name text box | Defines the file name format of the created log files. |
| Maximum File Number text box | Sets the maximum number of the created log files in case the log file size exceeds the defined size in the "Maximim File Size" text box. |
| Maximium File Size text box | Sets the maximum file size (in megabytes) for the created log files. If the size of the log file increases and exceeds the maximum size, a new log file is created and the OTF continues to write the log messages in the new file. |
| Message Format text box | Users can mannually input the format of the log message here. |
| Header Format multi-line text box | Users can mannually input the format of the header of the log message here. |
| Logging Level combo box | Sets the log level for the log messages of the OpenTestSystem::Otx::Extensions::Logging::Actions::WriteLog activities to be written in the log file (only the message with the severity level equal or higher than the set log level shall be written in the log file). |
| Communication Trace check box | Allows to automatically write the communication traces into the log file (checked) or not (unchecked). |
| Communication Trace combo box | Sets the log level for the communication traces to be written into the log file. |
| Variable Trace check box | Allows to automatically write the variable traces into the log file (checked) or not (unchecked). |
| Variable Trace combo box | Sets the log level for the variable traces to be written into the log file. |
| OTX-Exceptions check box | Allows to automatically write the OTX exceptions into the log file (checked) or not (unchecked). |
| OTX-Exceptions combo box | Sets the log level for the OTX exceptions to be written into the log file. |
| OTX-ID check box | Allows to automatically write the IDs of the executed activities into the log file (checked) or not (unchecked). |
| OTX-ID combo box | Sets the log level for the IDs of the executed activities to be written into the log file. |
| WriteLog Target Resolving check box | Allows to automatically fill all the empty "Target" properties of all the OpenTestSystem::Otx::Extensions::Logging::Actions::WriteLog activities in the project with the default value (checked) or not (unchecked) when the project is exported into a PTX. |
In this page, you can configure the Text Blocks Library for the OpenTestSystem::Otx::Extensions::i18n extension. The text library is an actual storage folder for the language files (*.ini). Each language file corresponds to a language and stores the data of that language.
This dialog box consists of a command bar above and a gridview displaying the data of all the language files below.
This command bar help you to edit the selected language data, below are the controls in the command bar with their descriptions (according to their position in the bar from left-to-right):
| Control | Description |
|---|---|
| New Language... button | Opens the "Add new language" dialog to add a new language. In the dialog, you can select to add a language which does not exist in the Language Folder (it shall create a new language file in the Language Folder), here you can also select to base on the data of an existing language which can be automatically translated later via Google Translate. |
| New Category button | Adds a new category to contain the translation keys related to that category. |
| New Text button | Adds a translation key in the current category. |
| Delete button | Deletes the selected categories or translation keys. |
| Sort A-Z button | Sorts all the categories/translation keys in A-Z order if one or many categories/translation keys are selected. |
| Filter text box | Users can input the criteria to filter language data here. Only the translation keys containing the filter criteria shall be displayed. |
| Translate From combo box | Sets the language (one of the existing languages) to be based on when using the "Translate via 'Google Translate'" button. |
| Translate Via "Google Translate" button | Translates all texts of the based language (selected in the "Translate From" combo box) into the selected language via Google Translate. |
| Delete The 'To Edit' Character button | Deletes all the 'To Edit' characters (#) in the selected language. |
| Open Language Folder button | Opens the current language folder in a new window. |
| Save button | Saves the all current changes. |
In the gridview, you can change the name of the categories and the translation keys, or the values of in each language by double-clicking on the corresponding cell and entering new texts (or you can select one entry and press F2 key). Here you can select one or many entries of the same type (i.e. same category type, or translation key type) by using the CTRL- or SHIFT-key and mouse click. The selected entries shall be edited with the controls in the command bar above or you can also manage them directly in the gridview such as moving selected entries with drag-and-drop, or copying keys from a category to the others with drag-and-drop and the CTRL key.
In this page, you can manage unit libraries (the ODX UNIT-SPEC containers) which support in calculating values with units in the current project (see OpenTestSystem::Otx::Extensions::Quantities extension).
Below are the elements in this page with their descriptions:
| Control | Description |
|---|---|
| Add button | Opens a window to browse and add reference to a new unit library (*.odx or *.odx-cc). |
| Delete button | Deletes the reference to the selected unit library. |
| Expand All button | Expands all nodes in all the unit libraries. |
| Collapse All button | Collapses all nodes, only displays the library nodes. |
| Filter text box | Users can input the criteria to filter unit data here. Only the unit data containing the filter criteria shall be displayed. |
| Unit Library tree view | Displays all the referrences to the unit libraries and the detail data of each library. Here you can only select one entry at a time, and only the selected unit library node can be used with the "Delete" button (X) or with the DEL key. |
| Stored/Imported Within Project check box | Sets one or many unit libraries to be stored/imported within the project. When the check box is checked, a check box shall appear at the left of each unit libraries, the unit libraries with the checked check box shall be imported into the project folder. This ensures the unit data is still available when used in another computer. |