> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/de/features/general/custom-fields.md).

# Benutzerdefinierte Felder

Ergänzen Sie Ihre Formulare mit benutzerdefinierten Feldern um die Felder, die Ihrer Tätigkeit eigen sind: Feldtypen, Optionen, Verwendung und API.

## Wann benutzerdefinierte Felder verwenden

Manche Informationen, die Ihrer Branche eigen sind, sind in den Standardfeldern des Verarbeitungsverzeichnisses, der Betroffenenanfragen, der Aufgaben usw. nicht enthalten. Mit benutzerdefinierten Feldern erstellen Sie Ihre eigenen Formularfelder, um die erfassten Daten anzureichern.

Hier ein Beispiel für die Konfiguration von Feldern für einen Stakeholder:

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-3b1b21b952c8187cc06f014da04d8ea3e6c8b7d8%2Fgeneral-custom-fields-1.png?alt=media" alt="Seite der benutzerdefinierten Felder des Stakeholders mit einer Feldgruppe und ihren Feldern"><figcaption><p>Konfiguration der Felder eines Stakeholders</p></figcaption></figure>

Und hier das Ergebnis im Formular:

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-5d7e1d3cec04a5f2365fe39d3c62a39bbbc2a4d9%2Fgeneral-custom-fields-2.png?alt=media" alt="Stakeholder-Formular mit der Gruppe benutzerdefinierter Felder"><figcaption><p>Die benutzerdefinierten Felder im Stakeholder-Formular</p></figcaption></figure>

## Betroffene Funktionen

Benutzerdefinierte Felder sind nicht in jedem Modul verfügbar. Sie können die folgenden Formulare anpassen:

* [Verarbeitungstätigkeiten](https://doc.dastra.eu/de/features/ropa.md)
* [Betroffenenanfragen](https://doc.dastra.eu/de/features/requests.md)
* [Aufgaben](https://doc.dastra.eu/de/features/tasks.md)
* [Assets](https://doc.dastra.eu/de/features/ropa/activity/assets.md)
* [Stakeholder](https://doc.dastra.eu/de/features/ropa/activity/stakeholders.md)
* [Sicherheitsmaßnahmen](https://doc.dastra.eu/de/features/ropa/activity/security.md)
* [Datensätze](https://doc.dastra.eu/de/features/ropa/activity/datasets.md)
* Datenfelder
* [Datenschutzvorfälle](https://doc.dastra.eu/de/features/incidents.md)
* [Risikobewertungen](https://doc.dastra.eu/de/features/risks/attach-to-processing.md)
* [KI-Systeme](https://doc.dastra.eu/de/features/ai-systems.md)
* [Verträge und Richtlinien](https://doc.dastra.eu/de/features/contracts.md)
* [Kontrollpunkte](https://doc.dastra.eu/de/features/risks/process/monitor.md)

{% hint style="warning" %}
**Begrenzte Anzahl von Feldern.** Die Anzahl der benutzerdefinierten Felder hängt vom Plan und vom Abonnement Ihrer Organisation ab. Auf der Konfigurationsseite wird eine Quotenanzeige eingeblendet. Weitere Informationen finden Sie auf der [Preisseite](https://www.dastra.eu/de/pricing).
{% endhint %}

## Verfügbare Feldtypen

Dastra bietet die folgenden Feldtypen:

| Typ                  | Verwendung                                                         |
| -------------------- | ------------------------------------------------------------------ |
| Text                 | Eine Textzeile                                                     |
| Textfeld             | Text über mehrere Zeilen                                           |
| Formatierter Text    | Text mit Formatierung                                              |
| Anzahl (ganze Zahl)  | Eine Zahl ohne Dezimalstellen                                      |
| Anzahl (Dezimalzahl) | Eine Zahl mit Dezimalstellen                                       |
| Datum                | Ein Datum                                                          |
| Datum und Uhrzeit    | Ein Datum und eine Uhrzeit                                         |
| Kontrollkästchen     | Mehrere Antworten aus einer Liste von Auswahlmöglichkeiten möglich |
| Radio                | Eine einzige Antwort aus einer Liste von Auswahlmöglichkeiten      |
| Einfacher Selektor   | Ein in einer Dropdown-Liste gewählter Wert                         |
| Mehrfachauswahl      | Mehrere in einer Dropdown-Liste gewählte Werte                     |
| Boolesche Werte      | Eine Antwort Ja oder Nein                                          |

## Benutzerdefinierte Felder verwenden

Einmal erstellt, funktionieren benutzerdefinierte Felder wie die nativen Felder:

* Sie werden in den Formularen jedes Moduls angezeigt und bearbeitet.
* Sie können in allen Tabellen der Anwendung angezeigt werden: Klicken Sie auf die Schaltfläche **Spalten anpassen** der Tabelle. Standardmäßig sind sie ausgeblendet.
* Sie sind **in allen Excel-Datenexporten enthalten**. Weitere Informationen zu Exporten finden Sie auf [der Seite zu Exporten](https://doc.dastra.eu/de/features/ropa/export-import.md).
* Sie sind in PDF- und Word-Berichten enthalten, wenn beim Feld **In PDF- oder Word-Berichten enthalten?** angekreuzt ist (standardmäßig angekreuzt).
* Sie lassen sich mit den [erweiterten Filtern](https://doc.dastra.eu/de/features/general/filters.md) filtern. Felder vom Typ **Kontrollkästchen** und **Mehrfachauswahl** können jedoch nicht zum Sortieren einer Liste verwendet werden.
* Sie können in Datentabellen gesammelt aktualisiert werden.
* Sie können mit dem [Importsystem](https://doc.dastra.eu/de/features/general/import.md) aus flachen Dateien importiert werden.
* Sie sind **über alle APIs zugänglich und bearbeitbar**, mit dem dem Feld zugewiesenen Variablennamen. Siehe [Benutzerdefinierte Felder in APIs verwenden](#benutzerdefinierte-felder-in-apis-verwenden).

## Benutzerdefinierte Felder einrichten

1. Klicken Sie in der Seitenleiste auf **Mandanteneinstellungen** und dann auf **Benutzerdefinierte Felder**.
2. Wählen Sie in der Liste links das Modul aus, in dem Sie ein benutzerdefiniertes Feld hinzufügen möchten.
3. Felder werden in Gruppen erstellt. Klicken Sie auf **Erstellen Sie eine Gruppe von Feldern**.
4. Füllen Sie die **Bezeichnung** der Gruppe und ihre **Position im Formular** aus. Bei manchen Modulen, etwa der Verarbeitungstätigkeit, können Sie den Schritt des Formulars wählen, in dem die Gruppe angezeigt wird.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-7bcc4ffe2ea12349185aeb9e25cdc8eeb3a774ac%2Fgeneral-custom-fields-3.png?alt=media" alt="Fenster zum Erstellen einer Feldgruppe mit der Bezeichnung und der Position im Formular"><figcaption><p>Eine Feldgruppe erstellen</p></figcaption></figure>

5. Ziehen Sie nach dem Erstellen der Gruppe einen Feldtyp aus der Liste **Benutzerdefinierte Felder** in die Gruppe. Das Fenster des Feldes öffnet sich.
6. Füllen Sie die Optionen des Feldes aus (siehe unten) und speichern Sie.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-5f2be64d6fb84314a228c98224892e1140800fae%2Fgeneral-custom-fields-4.png?alt=media" alt="Fenster zum Erstellen eines benutzerdefinierten Feldes mit seinen Optionen"><figcaption><p>Die Optionen eines benutzerdefinierten Feldes</p></figcaption></figure>

Sie können Felder per Drag-and-drop neu anordnen oder von einer Gruppe in eine andere verschieben. Eine Gruppe kann erst gelöscht werden, wenn sie kein Feld mehr enthält. Ein gelöschtes Feld landet im Papierkorb: Aktivieren Sie **Papierkorb anzeigen**, um es wiederherzustellen.

### Optionen eines Feldes

| Option                                     | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Bezeichnung**                            | Der in Formularen angezeigte Name des Feldes. Pflichtangabe.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Name der Variablen (Slug)**              | Der technische Name des Feldes, den APIs und Importe verwenden. Er wird aus der Bezeichnung vorgeschlagen, in Kleinbuchstaben mit Unterstrichen (zum Beispiel `business_owner` für „Business owner“), und kann nach dem Erstellen des Feldes nicht mehr geändert werden. Er wird nur in diesem Fenster angezeigt: Öffnen Sie das Feld in der Liste, um ihn zu lesen. Um das Feld aus einem Fragebogen zu befüllen, schreiben Sie `custom_` gefolgt von diesem Namen (siehe [Ein Verzeichnis aus den Antworten befüllen](https://doc.dastra.eu/de/features/questionnaires/templates/record-mapping.md)). |
| **Tooltip-Text**                           | Ein Hilfetext, der neben dem Feld angezeigt wird.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Pflichtfeld**                            | Macht die Eingabe verpflichtend.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **In PDF- oder Word-Berichten enthalten?** | Fügt das Feld den erzeugten Berichten hinzu. Standardmäßig angekreuzt.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Validierungsregel**                      | Bei Text-Feldern: prüft, ob die Eingabe einer Syntax (E-Mail, URL) oder einem **Benutzerdefinierten regulären Ausdruck (Javascript-Format)** folgt.                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Mindestgröße** und **Maximale Größe**    | Länge der Eingabe bei Textfeldern.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Mindestwert** und **Maximaler Wert**     | Grenzen für numerische Felder.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Auswahl der Antwort**                    | Bei Typen mit einer Liste von Auswahlmöglichkeiten: eine Zeile pro Auswahlmöglichkeit, mit einer Farbe. **Eine mögliche Option hinzufügen** fügt eine Zeile hinzu; wenn Sie Text einfügen, der eine Option pro Zeile enthält, wird pro Zeile eine Antwort erstellt.                                                                                                                                                                                                                                                                                                                                     |

Die Bezeichnung und der Variablenname eines Feldes müssen innerhalb eines Moduls eindeutig sein.

## Benutzerdefinierte Felder in APIs verwenden

Mit Dastra können Sie über die [REST-API](https://doc.dastra.eu/de/api/configuration.md) alle Werte von Entitäten abrufen, ändern und erstellen, die benutzerdefinierte Felder enthalten.

Eine Eigenschaft `customFields` ist in jeder Entität vorhanden, die Sie mit einem `GET` abrufen:

```json
 {
   "id": 1234,
   "label": "Test asset",
   etc...
   "customFields": {
     "dpo_name":"jean-marc le dpo",
     "dpo_email":"dpo@github.com",
     "dpo_habilitations": ["Expert","Consulting","Data Mapping"],
     "has_large_dataset":false,
     etc...
   }
 }
```

Um diese Eigenschaft zu ändern, senden Sie das Element mit `POST` oder `PUT` und aktualisieren Sie dabei die Elemente der Sammlung. Die zu verwendenden Variablennamen sind auf der Konfigurationsseite der benutzerdefinierten Felder aufgeführt.

{% hint style="info" %}
Alle **benutzerdefinierten Felder werden vom Server validiert**. Ist eine Spalte nicht in der Konfiguration vorhanden, wird sie automatisch entfernt.

Ist ein Feld nicht gültig (zum Beispiel wenn es leer ist, obwohl es als Pflichtfeld markiert ist), gibt die API einen Fehler mit dem Code 400 zurück.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.dastra.eu/de/features/general/custom-fields.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
