Jira-Integration

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 der Jira-Integration können sie einrichten und aktivieren, sodass Benutzer ein Jira-Ticket direkt aus einer Automatisierungsidee 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.

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://[yourworskpace].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 Felder für die Site-URL und den Scope vorausgefüllt sein sollten. Wählen Sie Verbinden aus.

• Die Atlassian-Webseite, auf der Sie die UiPath-Jira-Integration bestätigen müssen, wird geöffnet. Wählen Sie die Option 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 übrigen Benutzer wiederverwendet werden, die die Integration verwenden. Alle Benutzer müssen über eine vorhandene Verbindung verfügen, um die Integration zu verwenden.

• Sie werden zur ersten Seite „Jira-Verbindung“ im Automation Hub umgeleitet, wo Sie unter der Schaltfläche Authentifizierung öffnen die Option Bestätigenauswählen müssen, damit die Integrationsverbindung erfolgreich ist.

  Zu diesem Zeitpunkt ist Ihre Verbindung zu 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 auf der Basis einer Automatisierungsidee ein Jira-Ticket 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://yourworskpace.atlassian.net/browse/YOURPROJECTKEY-1111

Beispiel für die Konfiguration der Jira-Ausgabevorlage:

• Sie starten mit einem vorhandenen Ticket aus Ihrem Jira-Projekt https://yourworskpace.atlassian.net/browse/KEY-1111 .
• Das Problem ist vom Typ Aufgabe und enthält die grundlegenden Jira-Felder sowie 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 einen bestimmten Wert (z. B. Ja) in der Vorlage hartcodieren.
• Zum Abschluss können Sie der Jira-Problemvorlage noch die 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, dessen Wert für alle Probleme auf Ja hartcodiert ist.

  • Beschriftung für alle Probleme auf AUTOMATION_HUB_IDEA hartcodiert.

    Sobald die Tickets erstellt wurden, folgen sie dem Workflow, der in Jira für diesen Problemtyp definiert ist.

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 Verbindungsfluss 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 Automation Hub-Feld das gewünschte verfügbare Feld aus der Dropdownliste aus.

Die Zeilen in der Zuordnungstabelle werden automatisch gespeichert.

Um eine Zeile zu löschen, öffnen Sie das 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.
• Außerdem haben Sie im Automation Hub ein Feld 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 erstellt, erhält das Feld Geschäftsgrund in Jira den Wert aus dem Feld Geschäftsgrund 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 das 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.