Jira-Integration

Gilt nur für Automation Cloud.

Wenn der UiPath Automation Hub der Ort ist, an dem Sie die Pipeline Ihrer Automatisierungsmöglichkeiten zentral verwalten können, dann ist Jira höchstwahrscheinlich der Ort, an dem Ihre Entwickler die zugrunde liegenden Aufgaben verfolgen, die im Lebenszyklus der Automatisierungsentwicklung verwendet werden.

Durch die Verknüpfung von Automation Hub-Ideen mit Jira-Tickets erhalten Sie ein klareres Bild des Entwicklungsfortschritts für Ihre Automatisierungen.

Für die Authentifizierung zwischen Automation Hub und Jira wird der vorhandene Jira Cloud-Connector vom UiPath Integration Service genutzt.

Konfigurieren der Jira-Integration

Automation Hub-Benutzer mit Berechtigungen zum Verwalten Jira-Integration können diese Funktion einrichten und aktivieren, sodass Benutzer ein Jira-Ticket direkt von einer Automatisierungsidee aus verknüpfen oder erstellen können.

Authentication

Die Jira-Integration muss von einem Automation Hub-Benutzer mit Berechtigungen zum Verwalten der Integration aktiviert und konfiguriert werden, bevor sie für die restlichen Benutzer bereitgestellt wird.

Auf dieser Registerkarte muss der Benutzer zuerst einen Jira-Arbeitsbereich eingeben, bevor er die Konfiguration durchführen kann.

Hinweis:

• Administratoren muss die Berechtigung „Jira-Integration verwalten“ zugewiesen sein.
• Den Rollen Kontoinhaber und Systemadministrator wird die Berechtigung standardmäßig zugewiesen.
• Sie benötigen Zugriff auf einen persönlichen Arbeitsbereich.

Führen Sie die folgenden Schritte aus, um die Konfiguration zu starten:

1. Stellen Sie zunächst eine Verbindung mit Ihrem Jira-Arbeitsbereich her.

• Wählen Sie unter Administratorkonsole > Plattformeinrichtung die Option Jira-Integration aus.

• Im Abschnitt Authentifizierung müssen Sie zunächst die URL Ihres Jira-Arbeitsbereichs hinzufügen und Verbinden auswählen.

  

Die URL des Jira-Arbeitsbereichs muss das folgende Format haben: https://[yourworkspace].atlassian.net

2. Authentifizieren Sie sich bei Jira.

• Wählen Sie Authentifikator öffnen aus .
• Der UiPath Integration Service wird in einem neuen Fenster geöffnet, in dem Sie Verbindung hinzufügen auswählen können.

Weitere Informationen zur Connector-Verwendung finden Sie auf der Seite Verbindungen.

Ein neues Fenster „Mit Jira verbinden “ wird angezeigt, in dem die Site-URL und der Scope vorausgefüllt werden sollten. Wählen Sie Verbinden aus .

• Die Atlassian-Webseite wird geöffnet, auf der Sie die UiPath-Jira-Integration bestätigen müssen. Wählen Sie Akzeptieren aus .

  

  Hinweis:

  Wenn Sie noch nicht bei Jira angemeldet sind, werden Sie aufgefordert, sich zuerst anzumelden und dann mit der UiPath-Jira-Integration fortzufahren. Die Verbindung, die der Administrator auf Integration Service-Ebene konfiguriert, kann nicht für die restlichen Benutzer wiederverwendet werden, die die Integration verwenden. Alle Benutzer müssen eine bestehende Verbindung besitzen, um die Integration verwenden zu können.

• Sie werden zur ersten Seite der Jira-Verbindung in Automation Hub umgeleitet. Dort müssen Sie unter der Schaltfläche Authentifizierung öffnen die Option Bestätigen auswählen, damit die Integrationsverbindung erfolgreich ist. An diesem Punkt ist Ihre Verbindung mit Jira hergestellt und Sie können mit den nächsten Schritten fortfahren. 3. Konfigurieren Sie Problemtyp und Projektname

• Indem Sie das Dropdown-Menü für jedes Feld verwenden, können Sie den Projektnamen und den Problemtyp auswählen, die verwendet werden, wenn ein Jira-Ticket aus einer Automatisierungsidee erstellt wird. Wählen Sie Bestätigen aus .

• Die Dropdown-Werte werden aus dem Jira-Arbeitsbereich abgerufen, mit dem Sie verbunden sind.

  

4. Wählen Sie ein vorhandenes Problem als Vorlage aus.

• Jetzt muss der Problemlink hinzugefügt werden, der die Jira-Ticketvorlage für Ihr Projekt darstellt. Vorab ausgefüllte Abschnitte dieses Tickets werden immer den von Benutzern erstellten Tickets hinzugefügt. Fügen Sie die URL des Jira-Tickets hinzu und wählen Sie Überprüfen aus.

  

Das Vorlagenproblem wird vor dem Speichern validiert, um sicherzustellen, dass:

• Es stammt aus demselben Projekt wie das im vorherigen Schritt definierte.
• Der Problemtyp entspricht dem im vorherigen Schritt definierten.
• Das Problem besteht im verbundenen Jira-Arbeitsbereich.
• Das Format der URL ist korrekt: https://yourworkspace.atlassian.net/browse/YOURPROJECTKEY-1111

Beispiel für die Konfiguration der Jira-Ausgabevorlage:

• Sie beginnen mit einem vorhandenen Ticket aus Ihrem Jira-Projekt https://yourworkspace.atlassian.net/browse/KEY-1111 .
• Das Problem ist vom Typ Aufgabe und enthält die grundlegenden Jira-Felder und ein zusätzliches benutzerdefiniertes Feld namens Validierung erforderlich .
• Das Ticket wird in der Automation Hub-Konfiguration gespeichert.
• Auf der Registerkarte Feldzuordnung können Sie die folgende Konfiguration vornehmen:
  • Der Ideentitel ist der Jira-Zusammenfassung zugeordnet.
  • Die Ideenbeschreibung ist der Jira-Beschreibung zugeordnet.
• Sie können das Jira-Feld Validierung erforderlich einem Feld im Automation Hub zuordnen oder in der Vorlage hartcodieren, um immer einen bestimmten Wert zu haben, z. B. Ja .
• Als letztes können Sie der Jira Issue-Vorlage auch eine hartcodierte Beschriftung AUTOMATION_HUB_IDEA hinzufügen.
• Bei Verwendung dieser Konfiguration haben die über den Automation Hub erstellten Jira-Tickets die folgende Konfiguration:
  • Zusammenfassung und Beschreibung, die aus den entsprechenden Feldern des Automation Hubs abgerufen wurden.
  • Benutzerdefiniertes Feld Validierung erforderlich für alle Probleme auf Ja fest codiert.
  • Beschriftung für alle Probleme auf AUTOMATION_HUB_IDEA hartcodiert. Sobald das Ticket erstellt wurde, folgt es dem in Jira für diesen Problemtyp definierten Workflow.

Wichtig:

Stellen Sie sicher, dass die Vorlage nicht gelöscht oder geändert wird, während die Jira-Verbindung aktiv und festgelegt ist, da dies dazu führen kann, dass der Integrationsfluss unterbrochen wird.

5. Der letzte Schritt im Verbindungsablauf zeigt Ihnen, dass die Verbindung jetzt aktiviert ist.

   

Feldzuordnung

Auf der Registerkarte Feldzuordnung können Sie Automation Hub-Felder Jira-Feldern zuordnen. Auf diese Weise konfigurieren Sie die Art und Weise, wie Tickets von Benutzern mit der Berechtigung erstellt werden, die Erstellung von Jira Issues über den Automation Hub auszulösen.

Wenn eine Zuordnung vorgenommen wird, bedeutet dies, dass die Werte aus dem Automation Hub-Feld zum Ausfüllen des entsprechenden zugeordneten Jira-Felds verwendet werden.

Standardmäßig werden nach einer erfolgreichen Jira-Verbindung zwei Jira-Felder zugeordnet:

Jira-Feld	Automation Hub-Feld
Zusammenfassung	Name der Automatisierung
Ein Nur-Text-Feld	Beschreibung

Eine neue Feldzuordnung kann wie folgt hinzugefügt werden:

1. Wählen Sie +Zuordnung hinzufügen aus .
2. Wählen Sie unter Jira-Feld die neu erstellte Zeile aus, und wählen Sie aus der Dropdownliste das gewünschte verfügbare Feld aus.
3. Wählen Sie unter dem Feld Automation Hub das gewünschte verfügbare Feld aus der Dropdownliste aus.

Die Zeilen in der Zuordnungstabelle werden automatisch gespeichert.

Um eine Zeile zu löschen, wechseln Sie zum Drei-Punkte-Menü rechts neben der Zeile und wählen Sie Löschen aus.

Beispiel für die Zuordnung:

• Sie haben ein Jira-Feld mit dem Namen Geschäftsgrund.
• Sie haben auch ein Feld im Automation Hub mit dem Namen Geschäftsgrund (die Namen müssen nicht übereinstimmen), das Sie in einer Ihrer Bewertungen definiert haben.
• Auf der Registerkarte Feldzuordnung ordnen Sie die beiden zu.
• Wenn ein Benutzer ein neues Jira-Ticket aus dem Automation Hub erstellen auswählt, erhält das Feld „ Business Reason “ in Jira den Wert aus dem Feld „ Business Reason “ aus der Automation Hub-Idee.

Wenn das Feld NULL ist oder nicht im Automatisierungsprofil der Idee vorhanden ist, wird die Erstellung durchgeführt, aber das entsprechende Jira-Feld hat NULL-Werte.

Jira-Verbindung löschen

Durch Löschen der Jira-Verbindung werden alle Daten aus dem Authentifizierungsformular gelöscht.

1. Wählen Sie unter Administratorkonsole > Plattformeinrichtung die Option Jira-Integration aus.
2. Wählen Sie Verbindung löschen aus .

Die Schaltfläche Verbindung zurücksetzen kann verwendet werden, um das Formular für die Administratorauthentifizierung bei Jira zurückzusetzen, bevor die Verbindung gespeichert wird.