# Konfiguration der Projektvorlage (Felder)

Wir haben die Seite zur Konfiguration der Projektvorlage komplett neu gestaltet, um Klarheit, Flexibilität und Benutzerfreundlichkeit zu verbessern. Dieser Artikel führt Sie durch alle wichtigen Änderungen und erklärt, wie Sie mit der neuen Benutzeroberfläche arbeiten.

{% hint style="info" %}
**Wichtige Änderungen**

Felder sind jetzt in zwei Kategorien unterteilt:

* Sichtbare Felder: Erscheinen auf der Elementseite
* Ausgeblendete Felder: Existieren in der Vorlage, werden aber nicht in der Elementansicht angezeigt

Sie können das Panel für verborgene Felder über den Schalter in der oberen rechten Ecke umschalten (standardmäßig aktiviert).

Speichern überträgt alle Änderungen pro Elementtyp (Anforderung, Testfall, usw.). Wenn Sie Tabs mit nicht gespeicherten Änderungen wechseln, werden Sie gewarnt: "Änderungen, die Sie gemacht haben, werden nicht gespeichert". Wenn keine Änderungen vorgenommen wurden, bleibt die Schaltfläche Speichern inaktiv.
{% endhint %}

## **Struktur**

* Sichtbare Felder: Auf der Elementseite in **derselben Reihenfolge und Layout** wie auf der Vorlagenseite angezeigt.
* Ausgeblendete Felder: Auf der Elementseite nicht angezeigt.

### **Standardfelder (Fest)**

* **ID** und **Name**:
  * Immer sichtbar
  * Können nicht entfernt, verborgen, in der Größe verändert, umgeordnet oder gelöscht werden
  * Können nur umbenannt werden

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FoTqVyT7djDXZmFq9DsUH%2Fimage.png?alt=media&#x26;token=6e57f63b-0ac4-4f86-9b8a-e7e0dece965c" alt=""><figcaption><p>Standardfelder Screenshot</p></figcaption></figure>

### **Systemstandardfelder**

* Können ausgeblendet, umbenannt, in der Größe angepasst oder neu positioniert werden
* Können nicht gelöscht werden

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FlJyux8AJVMF0iOu0ZEcx%2Fimage.png?alt=media&#x26;token=d50b8e66-69d4-4d50-a784-dcdbcae21572" alt=""><figcaption><p>System default Feld Screenshot</p></figcaption></figure>

| Feldname            |                  Typ | Beschreibung                                                                                                                                                                                                                                 |
| ------------------- | -------------------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID                  |                   ID | Wird automatisch generiert, wenn das Element erstellt wird, ist eindeutig über alle Projekte auf einem Server hinweg und kann nicht bearbeitet werden.                                                                                       |
| Name                |               String | Immer in der ersten Zeile des Layouts angezeigt.                                                                                                                                                                                             |
| Status              |   Single-select list | Dieses Feld ist mit dem Workflow verknüpft. Die möglichen Statuswerte können in der Vorlagenkonfiguration konfiguriert werden. Die erlaubten Statusübergänge und Einschränkungen können dann in der Workflow-Konfiguration definiert werden. |
| Besitzer            |                 User | Wird bei der Erstellung eines Elements automatisch mit dem aktuellen Benutzer ausgefüllt und kann nicht bearbeitet werden.                                                                                                                   |
| Last Editor         |                 User | Wird automatisch mit dem aktuellen Benutzer ausgefüllt, wenn eine Änderung am Element vorgenommen wird, und kann nicht bearbeitet werden.                                                                                                    |
| Zugewiesen an       |                 User | Dieses Feld ist mit den folgenden Benachrichtigungseinstellungen verknüpft: - Einem Artikel zugewiesen werden - Änderungen in Artikeln, die mir zugewiesen sind                                                                              |
| Erstellt am         |           Date/ Time | Wird beim Erstellen eines Elements automatisch mit dem aktuellen Datum und der aktuellen Uhrzeit ausgefüllt und kann nicht bearbeitet werden.                                                                                                |
| Zuletzt modifiziert |           Date/ Time | Wird automatisch mit dem aktuellen Datum und der Uhrzeit gefüllt, wenn der Artikel geändert wird, und kann nicht bearbeitet werden.                                                                                                          |
| Umgesetzt in        | Text (Auto complete) | Eingabefeld, das sich an zuvor eingegebene Werte erinnert und diese als Auswahlliste bereitstellt. Nur für Anforderungen und Fehler verwendet.                                                                                               |
| Gefunden in         | Text (Auto complete) | Eingabefeld, das zuvor eingegebene Werte speichert und sie als Auswahlliste bereitstellt. Nur für Defekte verwendet.                                                                                                                         |
| Valid for           | Text (Auto complete) | Eingabefeld, das sich zuvor eingegebene Werte merkt und diese als Auswahlliste anbietet. Nur für Testfälle und Testszenarien verwendet.                                                                                                      |
| Progress            |       Decimal Number | In diesem Bereich kann der Fortschritt eines Elements zwischen 0 % und 100 % mit einem Schieberegler verfolgt werden.                                                                                                                        |
| Sprint              |               Sprint | Zeigt Sprints an, die im Agile-Modul im Desktop-Client erstellt wurden.                                                                                                                                                                      |
| Points              |       Decimal Number | Punkte zur Schätzung der Anstrengung in agilen Projekten; verwendet im agilen Modul (z.B. Burndown-Diagramm).                                                                                                                                |

### **Benutzerdefinierte Felder**&#x20;

* Können ausgeblendet, umbenannt, in der Größe geändert oder neu positioniert werden&#x20;
* Können gelöscht werden

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FXRpGmWGEuewe6bqLL6wh%2Fimage.png?alt=media&#x26;token=aabcb091-492d-4de9-84db-5fe6a2928056" alt=""><figcaption><p>Benutzerdefinierte Felder Screenshot</p></figcaption></figure>

### **Grenzen**

<table><thead><tr><th>Type</th><th width="158.199951171875" align="right">Max # of fields per project</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>String</td><td align="right">35</td><td>Wird für kurze Textwerte verwendet.</td><td>Name, Notiz, Link zu einer Website</td></tr><tr><td>Decimal</td><td align="right">20</td><td>Wird für Zahlenwerte verwendet.</td><td>Punkte, Währung, Unternehmenswerte</td></tr><tr><td>Date</td><td align="right">20</td><td>Verwendet für Kalenderdaten und Zeit.</td><td>Datum, an dem der Defekt behoben wurde, Datum, bis zu dem der Testfall ausgeführt werden soll</td></tr><tr><td>Dictionary (single selection)</td><td align="right">25</td><td>Wählen Sie einen Wert aus einer vordefinierten Liste.</td><td>Version, Priorität, Bedeutung</td></tr><tr><td>Dictionary (multi selection)</td><td align="right">10</td><td>Wählen Sie mehrere Werte aus einer vordefinierten Liste aus.</td><td>Betroffenes System, angeforderter Kunde</td></tr><tr><td>User (single selection)</td><td align="right">20</td><td>Wählen Sie einen Benutzer aus den bestehenden Benutzern des Projekts aus.</td><td>Hauptverantwortlicher Benutzer, Projektmanager</td></tr><tr><td>User (multi selection)</td><td align="right">5</td><td>Wählen Sie mehrere Benutzer aus den vorhandenen Benutzern des Projekts aus.</td><td>Teammitglieder</td></tr><tr><td>Rich Text Field</td><td align="right">5</td><td>Verwendet für Rich-Text wie Kommentare, Beschreibungen und Bilder.</td><td>Kommentare</td></tr></tbody></table>

## Ein neues Feld hinzufügen

{% stepper %}
{% step %}

### Feld hinzufügen

Klicken Sie auf Hinzufügen und wählen Sie den Feldtyp aus.

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FotlV5WZaYqDz9by9CjiT%2Fimage.png?alt=media&#x26;token=ec12bf24-0137-4f95-8acc-6c845bfdfaef" alt=""><figcaption><p>Feld hinzufügen screenshot</p></figcaption></figure>
{% endstep %}

{% step %}
Das Feld wird am Ende der Liste der sichtbaren Felder hinzugefügt und die Seitenleiste mit den Feldeinstellungen wird automatisch geöffnet.

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2Fwp1T2AP5tdn9dnddvbel%2Fimage.png?alt=media&#x26;token=f562061b-53a6-4de9-b63e-4ba3e4d30e0e" alt=""><figcaption><p>Screenshot der neuen Feld-Seitenleiste</p></figcaption></figure>
{% endstep %}

{% step %}
Feldname angeben

* Felder über die Breite-Option in der Seitenleiste anpassen
* Definieren, ob das Feld immer zuerst auf der Artikelseite erscheinen soll, indem Sie die Neue Zeile-Option aktivieren.

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FcgIB36RWRXSvb48Qu3bN%2Fimage.png?alt=media&#x26;token=c628b781-9883-4178-a585-44654a707434" alt=""><figcaption><p>Screenshot der Breitenoption</p></figcaption></figure>
{% endstep %}

{% step %}
Definieren Sie, ob das Feld immer zuerst auf der Artikelseite erscheinen soll, wenn andere Felder mehr Platz beanspruchen und es im Layout verdrängen könnten, indem Sie die Option **Neue Zeile** aktivieren.
{% endstep %}
{% endstepper %}

<div align="center"><figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2Fv32MBnJVILByxNHcRfU3%2Fimage.png?alt=media&#x26;token=6cdca745-3b3e-478f-9eea-e20e1434b86c" alt=""><figcaption><p>Neue Zeile Option Screenshot</p></figcaption></figure></div>

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FyhLnEdMNAiCd2gCeeXZU%2Fimage.png?alt=media&#x26;token=0a0f5b25-5dcc-4f6c-93db-5407b7dc0034" alt=""><figcaption><p>Item page</p></figcaption></figure>

* Verschieben Sie Felder zwischen sichtbaren/versteckten Abschnitten, indem Sie den **Sichtbarkeit**-Schalter aktivieren/deaktivieren.

{% hint style="info" %}
*Das Layout in der Konfiguration spiegelt direkt das Artikelseiten-Layout wider.*
{% endhint %}

{% stepper %}
{% step %}

### **Felder neu anordnen**

{% endstep %}
{% endstepper %}

Sie können Felder neu anordnen, indem Sie sie per Drag & Drop an die gewünschte Position ziehen.

**Logik der Felderbewegung:**

* Wenn Sie Feld A über Feld B bewegen, wird Feld B hervorgehoben; das Fallenlassen von A führt dazu, dass die Felder neu angeordnet werden, um den freien Raum entsprechend der Breite (1, 2, 3 Spaltenbreite) einzunehmen.
* Wenn vor den Feldern ein Leerraum ist, werden die Felder von rechts nach links neu angeordnet, um den Leerraum zu übernehmen.

![Neu anordnen screenshot 1](https://content.gitbook.com/content/G5QhcVbqFZtVzVvlkYfm/blobs/gyPOl7brHlVIeztcUdoS/image)

* Wenn kein leerer Raum vorhanden ist, werden die Felder von links nach rechts verschoben.

![Neu anordnen screenshot 2](https://content.gitbook.com/content/G5QhcVbqFZtVzVvlkYfm/blobs/olgnYlwaJD0XtCsSdrfV/image)

{% stepper %}
{% step %}

### Anzeigen / Verbergen von Feldern

{% endstep %}
{% endstepper %}

* Felder entweder über die Feldeinstellungen in der Seitenleiste (Sichtbarkeitsschalter) ausblenden oder anzeigen oder indem Sie Felder zwischen den Abschnitten Sichtbare Felder und Versteckte Felder verschieben.
* Ausgeblendete Felder sind in der Ansicht deaktiviert, aber nicht gelöscht; ihre gespeicherten Daten bleiben in der Datenbank und werden wieder angezeigt, wenn sie erneut aktiviert werden.

![Sichtbarkeit screenshot](https://content.gitbook.com/content/G5QhcVbqFZtVzVvlkYfm/blobs/owLBPTuS2yCSetEyEJUN/image)

{% stepper %}
{% step %}

### Abschnitte hinhinzufügen (Gruppen)

{% endstep %}
{% endstepper %}

Um Felder logisch zu trennen und zu gruppieren, fügen Sie Trennlinien über **Abschitt hinhinzufügen** hinzu. Der Abschnitt wird am Ende der Liste hinzugefügt. Geben Sie ihr einen Namen.

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2F42yhDyBgmOuVA1Aqmr73%2Fimage.png?alt=media&#x26;token=a68fc97d-181a-4004-90b5-620b43769ede" alt=""><figcaption><p>Abschnitt hinhinzufügen screenshot</p></figcaption></figure>

Ein Teiler wird am Ende der Liste hinzugefügt. Geben Sie ihm einen Namen.

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FBRIo37cgZTeJKTWMMMpe%2Fimage.png?alt=media&#x26;token=94d51d3a-d07b-42dd-a5ee-3f8cb411df77" alt=""><figcaption><p>Abschnittplatzierung screenshot</p></figcaption></figure>

Ziehen Sie es dann per Drag & Drop an eine beliebige Stelle, um die Felder zu trennen und zu gruppieren.&#x20;

Alternativ können Sie es an derselben Stelle belassen und einfach im Seitenleisten-Menü die Felder auswählen, die unter dem Trennzeichen platziert werden sollen.

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FqQqIyceCkKAEIb4F9ir2%2Fimage.png?alt=media&#x26;token=dc689e55-1e04-48b6-9d10-f90e5ca039d6" alt=""><figcaption><p>Screenshot 1: Standardmäßige Sichtbarkeit von Abschnitte</p></figcaption></figure>

Sie können festlegen, ob die Felder unter dem Trennzeichen standardmäßig auf der Artikelseite angezeigt oder ausgeblendet werden sollen.

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2F9LlWIKgmIESs2ajeYsV7%2Fimage.png?alt=media&#x26;token=3542ef51-0ad9-458d-a7b5-867b7dc63236" alt=""><figcaption><p>Screenshot 2: Standardmäßige Sichtbarkeit von Abschnitte</p></figcaption></figure>

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FhNsIlTxFOkwdOFKZaMPl%2Fimage.png?alt=media&#x26;token=c5862ac0-a16a-4d8d-be5c-b24fc0a0af22" alt=""><figcaption><p>item page: Anschitte Sichtbarkeit  </p></figcaption></figure>

{% hint style="info" %}
Bitte beachten Sie, dass Sie Trennfelder nicht durch Ziehen in den Abschnitt **Verborgene Felder** ausblenden können. Ein Trenner kann nur gelöscht werden.
{% endhint %}

Änderungen an der Vorlage werden übernommen, sobald Sie auf Änderungen speichern klicken und sind sofort auf der Artikelseite sichtbar.

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FTHWqN2XgU7WyQXYsCvRA%2Fimage.png?alt=media&#x26;token=dc2a244b-33f1-4a84-9483-b61d17ccd52b" alt=""><figcaption><p>Änderungen speichern Screenshot</p></figcaption></figure>

## **Änderung von Feldern in einem Live-Projekt**

Wenn Sie Konfigurationsänderungen in einem laufenden Projekt vornehmen, kann dies die bestehenden Elemente beeinflussen.&#x20;

Sobald das Layout geändert und Felder verschoben werden, wird das neue Layout sowohl auf neue als auch auf bestehende Elemente angewendet.&#x20;

Wenn Sie also Felder aus der Ansicht entfernen (durch Klicken auf den grünen Punkt), wird das Feld nicht in bestehenden Elementen angezeigt. Die in diesem Feld gespeicherten Informationen (z. B. der Auswahlwert eines Auswahlfeldes) bleiben jedoch in der Datenbank erhalten und werden entsprechend angezeigt, wenn das Feld wieder in die Ansicht aufgenommen wird.

Löschen Sie jedoch ein Feld, wird dieses aus allen bestehenden Elementen, einschließlich der darin gespeicherten Daten, gelöscht.

Wenn Sie die Reihenfolge der Auswahlwerte in Auswahlfeldern ändern oder neue Auswahlwerte hinzufügen, werden diese Änderungen sowohl in neuen als auch in bestehenden Elementen angezeigt, ohne dass bestehende Einträge verloren gehen oder geändert werden.&#x20;

Wenn Sie Werte in einem Auswahlfeld umbenennen, wird diese Umbenennung direkt auf alle bestehenden Elemente angewendet.

> Wenn Sie die Priorität in einem Live-Projekt von "hoch" auf "1 - Hoch" ändern, wird "1 - Hoch" nun direkt bei allen Elementen angezeigt, für die "hoch" ausgewählt wurde.

Wenn Sie einen Wert aus einem Auswahlfeld in der Projektkonfiguration löschen, wird dieser Wert in neuen Elementen nicht mehr als Auswahl angezeigt, bleibt jedoch in vorhandenen Elementen erhalten. Der gelöschte Wert wird daher weiterhin in bestehenden Elementen angezeigt, wenn er dort ausgewählt wurde. Wenn Sie dann das Auswahlfeld öffnen, wird dieser Wert in Rot hervorgehoben, um zu zeigen, dass er nicht mehr existiert. Sie können einfach einen der vorhandenen Auswahlwerte auswählen und diese Änderung im Verlauf nachverfolgen.

Bevor Sie Felder oder Auswahlwerte für Elemente löschen, bei denen diese Auswahlwerte verwendet werden, wird empfohlen, die gewünschten neuen Auswahlwerte über ein Batch-Update festzulegen oder bei Bedarf neue Felder auszufüllen, die die alten Felder ersetzen sollen. Eine schnelle Möglichkeit, dies zu tun, besteht darin, die gewünschten Elemente zu filtern (siehe [Ansichten](https://docs.aqua-cloud.io/documentation/de-documentation/navigation/ansichten)) und sie mit *Strg+a* auszuwählen und das gewünschte Batch-Update durchzuführen (siehe [Elemente](https://docs.aqua-cloud.io/documentation/de-documentation/elemente)).