//Cloudogu EcoSystem Docs

Web interface

The following section describes the web interface with the individual pages of the Baseline Dogus. The start page of the Dogus looks like this. Project Overview

1. Project Overview

The baseline is based on Git repositories. Configured repositories are displayed in the project overview. This view also represents the number of potential, open and fixed baselines. The name of a project points to its baseline overview.

Project Overview Table

2. Baseline Overview

The baseline overview lists all available baselines of a project in tabular form. These form the basis of the baseline. The table shows the current status, the creation, opening, and fixation time, the primary tag and the link to the repository can be found. Using an action button in the last column it is possible to open a baseline and fix it afterwards. Fixed baselines do not provide any action option. When opening a baseline, elements are collected and their references are bundled in a file in a separate Nexus repository.

Baseline Overview

Afterwards it is possible to view these elements in a detail view using the reference of the name.

3. Baseline detail view

In this view the elements are shown with their properties. Elements are grouped according to their and displayed in the form of collapsible tables. A group of elements is also called an element group.

The "Collect elements" button allows authorized persons to perform the collection of elements again. again. In this case, the elements of all groups are collected again.

Open baseline](figures/opened_baseline.png)

In a fixed baseline, changing actions are no longer possible. The state is now fixed and its elements can be inspected using the reference location.

Fixed Baseline

The Baseline tool offers the possibility to fix and open element groups individually.

3.1 Open element group

Each open element group offers the action to recollect all elements of the group. This action can be performed by authorized persons using the "COLLECT" button.

Open element group

An authorized person can fix an element group using the "FIX" button.

3.2 Fixed element group

A fixed element group prevents the elements of this group from being modified. When collecting all elements of the baseline, fixed element groups are skipped. Also, there is no separate collection action for element group is offered anymore.

An authorized person has the possibility to reopen a fixed element group. This action can be performed with the button "REOPEN".

Fixed element group

3.3 Manual additions (element group)

The "Manual additions" element group is a special element group and part of each baseline project. It differs from other element groups in that elements are not collected automatically, but must be added manually. must be added manually. Another difference is that the group of manual elements cannot be fixed. can be fixed.

Manual additions

3.3.1 Adding manual elements

An authorized user can add new manual elements. There are two types of manual elements: Files and References. To add new elements, you should press the "Add references or files" button should be pressed. This opens a dialog, which helps the user to adding.

In the first step the type of the element must be selected.

Select element type

3.3.1.1 Adding references

A reference is a manual element of a baseline and consists of the following properties:

  • A reference to a resource (link) (Required).
  • A unique name for the manual element (Required)
  • A description for the manual element (Optional)

In the dialog for references you can now enter the desired data for the new reference into the form.

Add data for a reference

Now the button "Add reference" must be pressed. Thereby the transacted inputs are stored as reference as a reference. Note: The reference is not yet stored in the baseline at this point.

There are now the following possibilities:

  1. the dialog allows multiple references to be added at once. To do this, enter the data for another reference and reference and click on "Add reference". 2.
  2. use the "Save" button in the dialog to save all cached references in the baseline.

Save reference

3.3.1.2 Adding files

A file is a manual element of a baseline and consists of the following properties:

  • A file of any type (Required).
  • A description for the manual element (Optional)

In the dialog you can use the "Upload file" button to select a file from the local system. Optionally specify a description for the file.

Add data for a file

Now the button "Add file" must be pressed. Thus the transacted inputs are stored as file cached. Note: The file is not yet saved in the baseline at this point.

There are now the following possibilities:

  1. the dialog allows multiple files to be added at once. For this you have to enter the data for another file and press the "Add file" button. 2.
  2. use the "Save" button in the dialog to upload all cached files and save them in the baseline. save.

Save file

Depending on the file size, uploading can vary greatly. During the upload it is not possible to add further manual elements during the upload. You should not leave the page during the upload.

File is uploading

After the addition of references and files is finished, our elements will be displayed in the group "Manual additions" group.

Fixed element group

3.3.2 Delete & edit baseline elements

Besides adding, authorized persons have the possibility to change manual elements and to delete them completely.

To delete a manual element, the trash can icon in the Action column for the respective element must be must be pressed. After that, the deletion process must be confirmed again.

Editing manual elements allows to change various properties after their creation. Only certain properties on manual elements can be changed afterwards. These are as follows:

References:

  • Name
  • Link
  • Description

File:

  • Description

Modifiable properties (cell) of manual elements are marked in the table with a black triangle in the lower right corner of a cell. Cells marked with a triangle can be edited by double-clicking or under Focus with confirming the Enter key. For this purpose the cell puts itself into an editing mode. In the edit mode the content of the cell can be adjusted. By confirming the Enter key, the newly entered entered value is saved.

Edit mode for manual elements

Note: The content of some properties is verified and invalid values cannot be saved. not be saved. An invalid value is indicated by a red coloring of the cell. In general, the following restrictions apply:

  1. the name of a reference must not be empty.
  2. the name of a reference must not overlap with the name of another manual element.
  3. the link of a reference must be a valid URL.

Edit mode with invalid value for manual elements