Manage your systems¶
Before proceeding to test anything on the test bed you need to define one or more systems. Recall that systems represent your organisation’s software components for which you make conformance statements to test for (see System).
Systems are configured by you or by your community administrator. To view your systems click the TESTS button from the screen’s header.
The screen that follows displays your organisation’s currently defined systems.
Your systems are presented in a table that displays for each one:
Its short name, a brief name used to display in search results.
Its full name, the complete system name presented in reports and detail screens.
A description, providing additional context on the specific system.
A version number.
To proceed with a specific system, either to view its past tests, conformance testing status or to execute new tests, click the appropriate row from the table. Once clicked you will change to view the conformance statements for the selected system (see View your conformance statements).
Create a new system¶
Note
Create option missing: The create system option may be missing if your community administrator has disabled the management of systems by organisation users.
To create a new system click on the Create system button displayed in the top right side of the system list header. Doing so presents you with a popup form to input the new system’s information.
The information to enter in the presented form are:
The system’s short name (required). This is used when the system is displayed in lists.
The system’s full name (required). This is included in reports that mention the system.
An optional description to provide more information about the system.
A version number (required). Although required this is not currently used in the test bed apart from display purposes.
If your organisation includes other systems you are also presented here with an option to copy the test setup from one of them as a source. Selecting one will replicate the selected system’s conformance statements for the new system.
Once another system is selected to copy from, you are also presented with additional options to include:
System properties: To also copy any additional system-level properties that the source system defines.
Conformance statement configurations: To also copy any of the source system’s configuration parameters set on its conformance statements.
If your community foresees additional system properties, and as long as you are not copying the properties from another system, you will also see a Show properties checkbox. Checking this you can manage your new system’s properties.
Configured properties can be simple texts, secret values (e.g. passwords) or files for which, if supplied by your community administrator, you will also see a help tooltip to understand their meaning. Such properties can be edited as follows:
For texts through an editable text field or by selecting a preset value from a dropdown list.
For files using the Upload button. Once one is selected you can download it by clicking on its link, or delete it by clicking Remove.
For secrets a read-only text field indicates whether a value is currently set. Provide a new value by checking Update which makes the text field editable. While editing you can also toggle the display of typed characters.
Note
Required properties are marked with an asterisk. It is is not mandatory to fill these in when providing the system’s information but as long as required properties are missing you will not be able to launch tests.
Once you have entered the system’s information click the Save button to record it. You can also click the Cancel button to close the popup without making any changes.
Edit an existing system¶
To edit an existing system click the pencil icon displayed on the right end of the system’s row. Doing so results in a popup being displayed with the system’s information, presented in editable input fields.
You can proceed here to modify the short name, full name, description and version of the system. If your organisation defines other systems you can also select to copy the test setup from another system which will reset the system’s conformance statements to match the selected one (upon confirmation).
Once another system is selected to copy from, you are also presented with additional options to include:
System properties: To also copy any additional system-level properties that the source system defines.
Conformance statement configurations: To also copy any of the source system’s configuration parameters set on its conformance statements.
If your community foresees additional system properties, and as long as you are not copying the properties from another system, you will also see a Show properties checkbox. Checking this you can manage the system’s properties.
Configured properties can be simple texts, secret values (e.g. passwords) or files for which, if supplied by your community administrator, you will also see a help tooltip to understand their meaning. Such properties can be managed as follows:
For texts the current value is presented in an editable text field or dropdown menu (if the property has preset values).
For files the Upload button is used to select a new file, whereas if one is already set you can download it by clicking on its link, or delete it by clicking Remove.
For secrets a read-only text field indicates whether a value is currently set, whereas to provide a new value you check Update. When providing a new value you can also toggle the display of the typed characters.
Certain properties may actually be non-editable. Such properties can only be managed by your community administrator.
Note
Required properties are marked with an asterisk. It is is not mandatory to fill these in when providing the system’s information but as long as required properties are missing you will not be able to launch tests.
Once ready click the Save button to finish. Here you may also click the Delete button which, following confirmation, will proceed to completely delete the system. In this case the tests realised for this system will still be searchable but will be presented as obsolete (see View your test history). Finally, you can also click the Cancel button to close this popup without making any changes.
Note
Missing delete option: The delete system option may be missing if your community administrator has disabled the management of systems by organisation users.