ARCWAY Cockpit

Introduction to Forms Editors

Modes

Since release 3.0 selected project data (e.g. requirements, issues) can be edited by means of the forms editor in ARCWAY Cockpit.
The forms editor supports two modes - the viewmode for displaying data and the editmode for creating and editing data. By means of the forms editor multiple project data can be viewed and edited at the same time.

Viewmode

In viewmode the properties of the selected project data can be viewed. The picture below shows the forms editor for a requirement in viewmode.

Übersichtsmodus

Editmode

In editmode the properties of the selected project data can be edited. For this there are input fields for the individual properties which can be filled by the user. The picture below shows a forms editor for a requirement in editmode.

Bearbeitungsmodus

If properties of a project data are modified with the editor, the editor is marked as "modified" by obtaining an asterisk in the tab above.
To accept the modification you have to save the contents of the editor (Tell me more about saving changes...).

Geänderter Editor

Switching Modes

To switch between the individual modes click on the button Edit or Finish editing on the right side above. Please note that the editor can be switched to editmode only if no other user has a lock for the selected project data. An editor for a project data which is just created cannot be switched to viewmode before saving for the first time.

Editing Properties

To edit the properties of project data in the forms editor you have to switch it to editmode first. Now, you can enter the desired values in the input fields. To finish editing the properties reset the editor into viewmode. In order to accept your changes you have to save the content of the editor first. (Tell me more about saving changes..).

Editing Custom Properties

If you have defined so-called "custom properties" for your project data, these are displayed within the forms editor. Custom properties are displayed in a separate block (e.g. with regard to requirements on the first page of the forms editor)

Editing Custom Properties

External Editing

You can directly open and edit the files that are attached to a properties of the type "file". For this the attached file will be opened in the appropriate external editor after clicking the corresponding button.

External Editing

While editing the file the current saving status of the file is shown. After you have saved your changes and closed the external editor, you can submit your changes to the project again. Alternatively you can also discard these changes.

External Editing in progress

Editing Links

In some forms editors links between project data can be displayed, created and removed, too. For this, different options are available.

Multiple Choice

Within the multiple choice all project data is displayed to which a link can be created. By setting respectively removing the checkmarks the links are created respectively deleted.

Mehrfachauswahl

Tree

The tree works similar to the multiple choice. Here, the project data is displayed hierarchically though. By setting respectively removing the checkmarks the links are created respectively deleted.

Tree

Drag'n'Drop

You can also create the links via drag'n'drop. For this, drag the desired project data from the respective view into the field of the editor. To delete the link click on the "minus" icon behind the name of the project data. Please note that you can possibly drag only project data of a specific type (e.g. requirement) to the field. Normally, there is a description of the required type above the input field. When you hold the mouse pointer over the linked data, the tooltip shows you where the data is stored (e.g. in which requirement set you can find the linked requirement).

Drag'n'Drop

Highlighting Errors, missing Permissions and Locks

In case of errors, missing permissions or missing locks different data is displayed as feedback for the user within the forms editor.

Error

Apart from few exceptions erroneous inputs are immediately displayed in the forms editor. In case of an error the modified properties cannot be saved. To support you in troubleshooting the editor displays the following information:

  1. A general error message in the upper part of the editor.
  2. An icon Fehlermarkierung behind the missing or erroneous property of the project data. When you hold the mouse pointer over the linked data a description of the error appears.

Fehlermeldung im Editor

Missing Permissions

Missing permissions are displayed in editmode as small crosses behind the fields for those properties for which you have no permissions.

Fehlende Berechtigungen

Missing Locks

Project data for which you cannot obtain a lock (e.g. because it is currently edited by another user) cannot be edited. In this case a lock message appears in the upper part of the editor. The lock message shows you who is editing the data at the moment. In this case the editor does not switch to editmode.

Fehlende Berechtigungen

Saving Changes

You can save your changes as follows:

  1. In the menu via File→Save
  2. Using the shortcut [Ctrl] + 'S'
  3. Via the dialog that appears when you close an editor or switch to another mode with unsaved changes or when you close a project