> 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/jira.md).

# Jira

Jira-Integration zur Synchronisierung von Tickets mit Anfragen zur Ausübung von Betroffenenrechten in Dastra

### Was macht die Integration?

Die Jira-Integration synchronisiert **Jira-Tickets mit Anfragen zur Ausübung von Betroffenenrechten (DSR) in Dastra** – in beide Richtungen:

* **Jira → Dastra**: Wenn ein Ticket im konfigurierten Jira-Projekt erstellt oder aktualisiert wird, erstellt oder aktualisiert Dastra die entsprechende Anfrage und füllt deren Felder entsprechend Ihrem Mapping aus.
* **Dastra → Jira**: Wenn eine Anfrage eine bestimmte Workflow-Phase erreicht, setzt Dastra das verknüpfte Jira-Ticket automatisch auf den Status, den Sie dieser Phase zugeordnet haben.

### Voraussetzungen

* Eine Jira-Cloud-Instanz (z. B. `https://ihr-unternehmen.atlassian.net`) und ein zu synchronisierendes Projekt.
* Je nach Authentifizierungsmethode:

  * **Basic** — die E-Mail-Adresse eines Jira-Kontos und ein [API-Token](https://id.atlassian.com/manage-profile/security/api-tokens) für dieses Konto.
  * **OAuth** — kein Token muss erstellt werden: Sie melden sich mit Ihrem Atlassian-Konto an und autorisieren Dastra.

Die OAuth-Methode wird in der Liste **Authentifizierungsmethode** angezeigt, sofern sie in Ihrer Dastra-Umgebung verfügbar ist. Andernfalls verwenden Sie ein API-Token.

### Installation

1. Öffnen Sie **Einstellungen > Integrationen** und wählen Sie **Jira** aus.
2. Klicken Sie im DSR-Anwendungsfall auf **Integration hinzufügen**.
3. Fügen Sie eine Verbindung hinzu:
   * **Basic**: Geben Sie die **Instanz-URL**, die **E-Mail-Adresse** und das **API-Token** ein und klicken Sie anschließend auf **Verbinden**.
   * **OAuth**: Geben Sie die **Instanz-URL** ein und klicken Sie anschließend auf **Speichern und verbinden** — Sie werden zu Atlassian 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%2FP770LKX9UAybKfqVvXvq%2Fimage.png?alt=media&amp;token=31970d8b-e07e-4e1e-a435-d0cbfca208b5" alt=""><figcaption></figcaption></figure>

### Konfiguration

* **Jira-Projekt** — das zu synchronisierende Projekt.
* **Ticket-Typ** — der Ticket-Typ, der eine Anfrage zur Ausübung von Betroffenenrechten darstellt.
* **Feld-Mapping** — ordnen Sie die Felder einer Dastra-Anfrage den Jira-Feldern zu. Wenn ein Jira-Ticket eine Anfrage erstellt oder aktualisiert, wird jedes Feld mit dem ausgewählten Jira-Wert ausgefüllt. Als Quellen stehen die Jira-Standardfelder (Zusammenfassung, E-Mail-Adresse des Meldenden, Beschreibung, Status) **sowie Ihre benutzerdefinierten Jira-Felder** zur Verfügung. Felder mit festgelegten Werten (Status, Auswahllisten) können im Bereich **Erweitert** in Dastra-Werte umgewandelt werden.
* **DSR-Status mit Jira-Übergängen verknüpfen** — ordnen Sie jeder Phase des DSR-Workflows einen Jira-Status zu. Wenn eine Anfrage diese Phase erreicht, führt Dastra die entsprechende Transition des verknüpften Tickets aus. Lassen Sie eine Phase auf **Keine Transition**, um sie zu ignorieren.
* **Standard-Organisationseinheit** (erforderlich) — die Organisationseinheit, die den von der Integration erstellten Anfragen zugewiesen wird.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2FVhcJ4WlDB7M3KEvW5myy%2Fimage.png?alt=media&amp;token=be63bf1f-2c4c-4981-865e-71dcd327e4db" alt=""><figcaption></figcaption></figure>

Das Feld **E-Mail** der Anfrage muss zugeordnet werden (oder einen Standardwert erhalten), da es die betroffene Person identifiziert. Ohne dieses Feld kann die Konfiguration nicht gespeichert werden.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2FpvHJbHxpxSRDesrGagQo%2Fimage.png?alt=media&amp;token=c8923141-182d-4f60-855e-a3a753696b1f" alt=""><figcaption></figcaption></figure>

#### Webhook (Jira → Dastra)

Speichern Sie zunächst die Konfiguration — die URL des eingehenden Webhooks wird verfügbar, sobald die Integration konfiguriert wurde. Im Schritt **Webhook** haben Sie anschließend zwei Möglichkeiten:

* **Manuelle Registrierung** — kopieren Sie die **Webhook-URL** und gehen Sie in Jira zu **Projekteinstellungen > Automation** (oder **Webhooks**). Fügen Sie dort einen Webhook hinzu, der für die Ereignisse *Ticket erstellt* und *Ticket aktualisiert* auf diese URL verweist.
* **Automatische Registrierung** — klicken Sie auf **Webhook in Jira registrieren**. Dastra registriert ihn anschließend über die Jira-API für Sie. Dafür benötigt das konfigurierte Konto die globale Berechtigung **Jira administrieren**. Sie können den Webhook später über **Webhook löschen** wieder entfernen.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2FOEnVSsrAmwpFrB2W7nbk%2Fimage.png?alt=media&amp;token=0ffb951d-b78d-4245-bbea-18e25d889e6e" alt=""><figcaption></figcaption></figure>

#### Deinstallation

Bei der Deinstallation der Integration werden die gespeicherten Zugangsdaten gelöscht und der in Jira registrierte Webhook entfernt (sofern dieser automatisch registriert wurde). Die von der Integration erstellten Anfragen bleiben erhalten.


---

# 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/jira.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.