Jira-Parameter MOD009D6O

Einstieg

Rolle PLANTA link → Jira-Schnittstellen → Benutzersynchronisation → Jira-Parameter

Information

Dieses Modul listet alle globalen Parameter auf, die definiert werden müssen, um PLANTA project gemeinsam mit Jira zu nutzen.

Hinweis

Die in diesem Modul enthaltenen Parameter sind nur ein Teil der für den Betrieb von PLANTA project gemeinsam mit Jira notwendigen Einstellungen. Weitere Voraussetzungen siehe hier.

Allgemeine Einstellungen (Jira link)

Parameter-Bezeichnung	Parameter-ID	Bedeutung und Werte
API-Token	`jira_api_token`	API-Token, das zur Authentifizierung bei Jira verwendet werden soll. Ist kein API-Token konfiguriert, werden Benutzername und Passwort verwendet. Wenden Sie sich für Informationen zur Erstellung des API-Tokens bitte an den Jira-Hersteller Atlassian.
API-URL	`jira_api_url`	Über die Adresse im Parameter API-URL erfolgt die Synchronisation zwischen PLANTA project und Jira. Sie muss gesetzt sein, damit PLANTA project und Jira gemeinsam genutzt werden können.
Client-URL	`jira_client_url`	Die Adresse im Parameter Client-URL wird verwendet, um Jira vom PLANTA project-Client aus aufzurufen. Die Client-URL kann optional konfiguriert werden. Wenn der Parameter leer bleibt, wird stattdessen die API-URL verwendet.
Jira-Plattform	`jira_platform`	Jira-Plattform: Jira Server oder Jira Cloud. Im Parameter wird "server" oder "cloud" eingetragen.
Jira-Passwort	`jira_password`	Für Jira Server muss sowohl der Benutzername als auch das Passwort eingetragen werden Für Jira Cloud muss lediglich der Benutzername (`jira_username)`mit der E-Mail-Adresse des Benutzers gefüllt werden. Dieser Eintrag ist jedoch obligatorisch. Der Benutzer muss in Jira über die folgenden Rechte verfügen: Benutzer anlegen/aktualisieren Projekt anlegen/aktualisieren Issue anlegen/aktualisieren Workloads anlegen/aktualisieren
Jira-Benutzername	`jira_username`
Jira-Benutzergruppe	`jira_group_name`	Name der Jira-Benutzergruppe, in der die verknüpften Benutzer landen sollen. Standardmäßig ist es jira-software-users. In Jira Cloud heißt die Standardgruppe jira-software-users-<Name der Jira-Instanz>. Den Namen muss man im Parameter manuell ergänzen.

Benutzer-Synchronisation (Jira link)

Information

Im Bereich Benutzer-Synchronisation (Jira link) werden bei den jeweiligen Parametern die UUIDs der für die Anwendung von PLANTA project mit Jira notwendigen Schnittstellen hinterlegt.
- Defaultmäßig sind hier bereits PLANTA-Standard-Schnittstellen hinterlegt.
Die Benutzersynchronisierung in der Cloud erfordert die Jira OAuth Connect-App OAuth 2.0 (3LO) apps, die unsere Webschnittstelle jira_oauth_authentication als Callback verwendet. Erforderliche Jira-Bereiche:
- read:jira-user
- read:jira-work
- manage:jira-webhook
- Der Jira-API-Benutzer muss zur Jira-Administratorengruppe gehören.

Hybrid-Schnittstellen (Jira link)

Information

Im Bereich Hybrid-Schnittstellen (Jira link) werden bei den jeweiligen Parametern die UUIDs der für die Anwendung von PLANTA project mit Jira notwendigen Schnittstellen hinterlegt.
- Defaultmäßig sind hier bereits PLANTA-Standard-Schnittstellen hinterlegt.

API-Token für Jira-Web-Schnittstellen generieren

Vorgehensweise

Über die Schaltfläche API-Token für Jira-Schnittstellen generieren wird automatisch ein API-Token zur Authentifizierung von Jira gegenüber von PLANTA project erzeugt und automatisch den vorhandenen Standard-Web-Schnittstellen für project-Jira-Integration zugeordnet. Der generierte Token ist sofort in der erschienenen Dialogmeldung sichtbar.

Details

Alle erzeugten API-Token und deren Zuordnungen können im Modul API-Tokens verwalten eingesehen und verwaltet werden.