> 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/api-references/integrations/verbindungen-anwendungsfalle-und-feld-mapping.md).

# Verbindungen, Anwendungsfälle und Feld-Mapping

Funktionsweise von Verbindungen, Anwendungsfällen und Feld-Mappings, die für alle nativen Integrationen gelten

Diese Seite beschreibt die Konzepte, die für alle nativen Integrationen gelten. Anweisungen für die einzelnen Konnektoren finden Sie auf den jeweiligen Seiten (ServiceNow, SAP LeanIX, Jira, Microsoft Teams usw.).

### Der Integrationskatalog

Öffnen Sie in Ihrem Workspace **Einstellungen > Integrationen**. Der Katalog listet alle verfügbaren Integrationen auf und kann nach Kategorie sowie nach dem jeweiligen Dastra-Objekt gefiltert werden. Zusätzlich stehen die Registerkarten **Alle / Installiert** zur Verfügung.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2F5cYQoseHSSKZEsN57rje%2Fimage.png?alt=media&amp;token=09c834d1-531b-4cb6-8bb4-d8c2cf80e870" alt=""><figcaption></figcaption></figure>

Klicken Sie auf eine Integration, um ihre Seite zu öffnen. Dort werden die verfügbaren **Anwendungsfälle** angezeigt (jeweils mit der Richtung des Datenflusses, z. B. *ServiceNow > Dastra*), außerdem die Beschreibung und — bei Konnektoren, die sich bei einem externen Tool authentifizieren — die Schaltfläche **Verbindungen verwalten**.

### Die Verbindungen

Eine Verbindung speichert die Informationen, die Dastra zur Authentifizierung beim externen Tool benötigt: entweder Zugangsdaten (Benutzername/Passwort oder API-Schlüssel, von Dastra verschlüsselt gespeichert) oder eine delegierte **OAuth**-Autorisierung (Dastra speichert dabei kein Passwort).

Sie können **mehrere Verbindungen zum selben Tool** erstellen — beispielsweise eine Produktionsinstanz und eine Sandbox — und für jeden Anwendungsfall auswählen, welche Verbindung verwendet werden soll.

Klicken Sie auf **Verbindungen verwalten**, um das Verbindungsfenster zu öffnen. Für jede Verbindung sehen Sie:

* ihren Status: **Verbindung funktionsfähig**, **Autorisierung ausstehend** (OAuth wurde gestartet, aber noch nicht abgeschlossen) oder **Verbindungsfehler** (mit der letzten Fehlermeldung und der Anzahl der Fehler),
* die Authentifizierungsmethode,
* die Anwendungsfälle, die diese Verbindung verwenden.

In diesem Bereich können Sie eine Verbindung **testen** (ein erfolgreicher Test setzt auch ihren Fehlerstatus zurück) oder sie **löschen**.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2FEocTa8sjyOg98ZKh0R0Z%2Fimage.png?alt=media&amp;token=773e8199-7097-4ec9-846e-98a8e35f4f37" alt=""><figcaption></figcaption></figure>

Um eine Verbindung zu erstellen, klicken Sie auf **Verbindung hinzufügen**:

1. Geben Sie einen **Verbindungsnamen** ein (z. B. *Produktionsinstanz*) — optional, aber hilfreich, wenn Sie mehrere Verbindungen verwenden.
2. Wählen Sie die **Authentifizierungsmethode**, wenn der Konnektor mehrere Optionen unterstützt: **Basic (Zugangsdaten / API-Schlüssel)** oder **OAuth**.
3. Füllen Sie die vom Konnektor benötigten Felder aus (Instanz-URL, API-Token usw.).
4. Klicken Sie auf **Verbinden** — oder bei OAuth auf **Speichern und verbinden**. Sie werden anschließend zum externen Tool weitergeleitet, um Dastra zu autorisieren.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fyd60vxCrdPgA3PCyqJzH%2Fimage.png?alt=media&amp;token=85c09671-2c52-43f7-bd53-e183ccd87a8e" alt=""><figcaption></figcaption></figure>

### Einen Anwendungsfall installieren

Klicken Sie auf der Karte eines Anwendungsfalls auf **Integration hinzufügen**. Das Installationsfenster führt Sie durch maximal drei Schritte:

1. **Verbindung** — wählen Sie eine bestehende Verbindung aus oder erstellen Sie direkt über die Liste eine neue.
2. **Konfiguration** — die konnektorspezifischen Einstellungen (Synchronisierungsoptionen, Feld-Mapping usw.). Dieser Schritt wird freigeschaltet, sobald eine gültige Verbindung ausgewählt wurde.
3. **Webhook** — nur für Konnektoren, die Ereignisse von einem externen Tool empfangen (z. B. Jira). Dieser Schritt wird nach dem Speichern der Konfiguration freigeschaltet.

Nach der Installation bietet die Karte des Anwendungsfalls folgende Optionen:

* einen Schalter **Aktivieren**,
* den Eintrag **Konfiguration**, um die Einstellungen erneut zu öffnen,
* **Synchronisierung starten** (nur bei Import-Konnektoren), um eine sofortige Synchronisierung auszulösen,
* **Protokolle anzeigen**, um vergangene Ausführungen einzusehen,
* **Deinstallieren**.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2F0YhGjGE7cDFGM8SGEHPf%2Fimage.png?alt=media&amp;token=2d64ccf5-ac52-4929-ac34-37029e1065ad" alt=""><figcaption></figcaption></figure>

Durch die Deinstallation eines Anwendungsfalls werden die zugehörigen Zugangsdaten gelöscht. Assets, Anfragen und andere von der Integration erstellte Datensätze bleiben erhalten — sie gehören zu Ihrem Workspace.

### Das Feld-Mapping

Import-Anwendungsfälle enthalten einen Abschnitt **Feld-Mapping**: Wählen Sie für jedes Dastra-Feld das Feld des externen Tools aus, das bei der Synchronisierung als Quelle dient. Ein Feld ohne zugewiesene Quelle behält sein **Standardverhalten** bei.

* Pflichtfelder in Dastra sind mit einem roten Sternchen gekennzeichnet. Die Konfiguration kann nicht gespeichert werden, solange ein Pflichtfeld weder eine Quelle noch einen Standardwert hat.
* Mit **Feld zuordnen** können Sie für jedes weitere Dastra-Feld eine zusätzliche Zeile hinzufügen, einschließlich Ihrer benutzerdefinierten Felder.
* Die Liste der Quellfelder wird, wenn möglich, live aus dem externen Tool abgerufen. Dadurch werden auch Ihre benutzerdefinierten Attribute auf der Quellseite angezeigt.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2FsMe8Nh2woRDatPw2yKhl%2Fimage.png?alt=media&amp;token=027cec77-c8a5-4ef7-8bbc-dcc7d951b3fe" alt=""><figcaption></figcaption></figure>

### **Erweiterte Optionen**

Für jede Zeile steht ein Bereich **Erweitert** mit zwei Optionen zur Verfügung:

* **Standardwert** — wird verwendet, wenn kein Quellfeld vorhanden ist, oder als Fallback für Quellwerte, die nicht transkodiert wurden. Bei Datumsfeldern können Sie **Heute** oder ein relatives Datum auswählen (z. B. *in 30 Tagen*), das zum Zeitpunkt der Erstellung des Datensatzes aufgelöst wird.
* **Wertetranscodierung** — für geschlossene Listen (Status, Lebenszyklusphasen usw.): Ordnen Sie jedem Quellwert einen Dastra-Wert zu. Nicht zugeordnete Werte übernehmen den Standardwert.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2FVoFxNw3OaAWVoVVTpzkw%2Fimage.png?alt=media&amp;token=b6d87125-d339-4a6f-a02e-c036ec8a8682" alt=""><figcaption></figcaption></figure>

Bei Datumsfeldern kann der Standardwert dynamisch sein — er wird zum Zeitpunkt der Erstellung des Datensatzes aufgelöst:

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2FPvWQo3MJWGZrnt4rEmko%2Fimage.png?alt=media&amp;token=646bc359-6ed5-4b07-9589-e48dee7c2613" alt=""><figcaption></figcaption></figure>

<sub>Ein relativer Standardwert für das Datum (hier: in 30 Tagen) für die Fälligkeit der Anfrage</sub>

#### **KI-Vorschläge**

Wenn der KI-Assistent für Ihr Konto aktiviert ist, schlägt die Schaltfläche **Von KI vorschlagen lassen** ein vollständiges Mapping vor. Zusätzlich verfügt jede Zeile über eine eigene Schaltfläche für Vorschläge. Bereits zugeordnete Felder werden dabei niemals überschrieben, und alle Vorschläge werden Ihnen vor dem Speichern zur Überprüfung angezeigt.

### Synchronisierung und Protokolle

* Import-Konnektoren (ServiceNow, SAP LeanIX, Filerskeepers) synchronisieren **täglich**. Sie können außerdem jederzeit über **Synchronisierung starten** eine Synchronisierung manuell auslösen.
* **Protokolle anzeigen** zeigt jede Ausführung mit ihrem Ergebnis und den zugehörigen Zählern: erstellte, aktualisierte, markierte und fehlerhafte Elemente sowie gegebenenfalls die Details zum jeweiligen Fehler.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2FTuuZpowhSr9nhlGHqEU1%2Fimage.png?alt=media&amp;token=d2e89ebe-3a99-4c6f-a75a-a0820d9b55dc" alt=""><figcaption></figcaption></figure>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.dastra.eu/de/api-references/integrations/verbindungen-anwendungsfalle-und-feld-mapping.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.