Einrichtung der Asset-Synchronisation
Zusätzlich zur Synchronisation von Debitoren und Kontakten mit Jira Organisationen und Kunden kann der DYCE Connector for Jira Service Management Debitoren, Kontakte, Projekte und Service Assets als Jira Assets (Insight) Objekte mit Jira synchronisieren. Die Asset-Synchronisation baut auf demselben OAuth2 Mechanismus auf, der in Einrichtung beschrieben ist, benötigt jedoch eigene Scopes und eine zusätzliche Konfiguration.
Voraussetzungen
- Jira Assets (Insight) ist auf der Jira Service Management-Website aktiviert.
- Die allgemeine Einrichtung des DYCE Connector for Jira Service Management ist bereits abgeschlossen oder wird zusammen mit der Asset-Synchronisation eingerichtet.
- Berechtigung zum Bearbeiten der verwendeten OAuth 2.0-App in der Atlassian Developer Console.
OAuth2 Einrichtung für Assets
Die Asset-Synchronisation verwendet dieselbe Tabelle Jira OAuth2 Einrichtung wie die Synchronisation von Organisation und Kunde, typischerweise als eigene Einrichtung, da ein anderer Satz an Scopes benötigt wird. Auf der Jira OAuth2 Einrichtungsliste kann mit Assets Einrichtung erstellen eine gebrauchsfertige Einrichtung mit dem Einrichtung Code ASSETS-OAUTH, der Standard Basis URL (https://api.atlassian.com) und allen bereits angewendeten benötigten Scopes erstellt werden. Existiert bereits eine Einrichtung mit diesem Code, wird das Überschreiben bestätigt.
Dieselben Scopes müssen auch der OAuth 2.0-App in der Atlassian Developer Console hinzugefügt werden - siehe Registrierung der OAuth 2.0-App in Atlassian für die allgemeinen Schritte. Es kann eine eigene App für Assets registriert oder die bestehende App um die unten genannten Scopes erweitert werden.
Benötigte Scopes
| Scope | Zweck |
|---|---|
offline_access | Ermöglicht ein Aktualisierungstoken, damit Zugriffstoken automatisch erneuert werden können |
read:jira-user | Liest Jira Benutzerinformationen (wird zum Testen der Verbindung verwendet) |
read:jira-work | Allgemeiner Lesezugriff auf Jira |
read:servicedesk-request | Liest Service Desk Anfragen |
read:cmdb-object:jira | Liest Jira Assets Objekte |
write:cmdb-object:jira | Erstellt und aktualisiert Jira Assets Objekte (Synchronisation von Debitor, Kontakt, Projekt und Service Asset) |
read:cmdb-schema:jira | Liest Jira Assets Schemata |
write:cmdb-schema:jira | Erstellt und aktualisiert Jira Assets Schemata |
read:cmdb-type:jira | Liest Jira Assets Objekttypen |
write:cmdb-type:jira | Erstellt und aktualisiert Jira Assets Objekttypen |
read:cmdb-attribute:jira | Liest Jira Assets Attributdefinitionen |
write:cmdb-attribute:jira | Erstellt und aktualisiert Jira Assets Attributdefinitionen |
read:cmdb-config:jira | Liest die Jira Assets Workspace-Konfiguration (wird zum Ermitteln der Workspace ID verwendet) |
Assets Einrichtung erstellen auf der Jira OAuth2 Einrichtungsliste wendet bereits alle oben genannten Scopes an - eine manuelle Ergänzung ist nur nötig, wenn die Einrichtung auf andere Weise erstellt wird.
Autorisierung und Ermittlung der Workspace ID
Die Autorisierung erfolgt wie bei jeder anderen OAuth2 Einrichtung - siehe Autorisierung mit Atlassian.
Jira Assets identifiziert den Ziel-Workspace zusätzlich über eine Assets Workspace ID, die auf der Karte der OAuth2 Einrichtung angezeigt wird. Nach der Autorisierung kann sie über Workspace ID abrufen automatisch ermittelt und eingetragen werden. Solange dieses Feld leer ist, schlägt die Asset-Synchronisation mit einem entsprechenden Fehler fehl.
Berechtigungen
Die Asset-Synchronisation verwendet dieselben Berechtigungssätze wie der übrige Connector - Lesen, Bearbeiten und Admin - erweitert um die Tabellen für Asset Schema, Objekttyp, Attribut und Feldzuordnung sowie die Service Asset Tabelle. Ein eigener Berechtigungssatz ist nicht erforderlich.