Integration von Jira

Durch Integration mit Jira können Sie auf einem beliebigen Gerät, Intranet oder Messengerdienst Vorgänge verfolgen und automatische Updates zu Aufgaben erhalten. Zum Aktivieren der Jira-Integration führen Sie folgende Schritte aus. Nachdem Sie diesen Vorgang abgeschlossen haben, wird die vorhandene Überwachungsprotokollierung beibehalten, einschließlich aller Aktionen, die mit Citrix Mikroapps ausgeführt werden.

Hinweis:

Es stehen zwei Jira-Integrationsvorlagen zur Verfügung. Wir empfehlen für die meisten Anwendungsfälle die neuere HTTP-Integration. Die HTTP-Integration bietet mehr Möglichkeiten zum Konfigurieren der zwischengespeicherten Datenstruktur. Ausführliche Informationen zu den verfügbaren Mikroapps in jeder Integration finden Sie unter Verwenden von Jira-Mikroapps.

Prüfung der Voraussetzungen

Alle Benutzerkonten, die Sie über diese Integration verwenden möchten, müssen in den Kontoeinstellungen für die Sichtbarkeit ihrer E-Mails die Option Anyone wählen. Dies umfasst Dienstkonten und die Konten, mit denen sich Benutzer über OAuth bei Citrix Workspace anmelden. Navigieren Sie zu https://id.atlassian.com/manage-profile/profile-and-visibility, melden Sie sich bei Bedarf im Bereich Contact an und wählen Sie neben dem E-Mail-Konto unter dem Menü Who can see this? die Option Anyone.

Hinweis:

Internet Explorer 11 wird nicht mehr von Jira unterstützt. Eine Konfiguration dieser Mikroapp mit Internet Explorer 11 führt zu Fehlern. Wechseln Sie zu einem anderen Browser (Chrome, Edge usw.), um eine korrekte Konfiguration zu erhalten.

Nach dem Vorbereiten dieser Integration in Jira benötigen Sie folgende Angaben, um die Integration in Citrix Workspace-Mikroapps hinzuzufügen:

• Basis-URL: templatebaseurl Ersetzen Sie {cloud-id} durch Ihre Cloud-ID. Sie finden Ihre Cloud-ID, indem Sie sich als Administrator Ihrer JIRA-Instanz anmelden und dann die URL ansehen.
• Autorisierungs-URL: Dies ist vordefiniert. Dies ist die Autorisierungsserver-URL, die beim Einrichten der Zielanwendungsintegration bereitgestellt wird.
• Token-URL: Dies ist vordefiniert. Dies ist die URL des autorisierenden Zugriffstoken.
• Epic-Name-CustomFieldD: Diese ID finden Sie im Jira-Administrationsportal. Siehe Ersetzen von Variablen für “Dienstaktionen”.
• Client-ID: Die Client-ID ist die Zeichenfolge, die die eindeutigen Angaben des Autorisierungsservers zur Clientregistrierung darstellt.
• Geheimer Clientschlüssel: Der geheime Clientschlüssel ist eine eindeutige Zeichenfolge, die beim Einrichten der Zielanwendungsintegration ausgegeben wird.
• Benutzername: Dies ist der Benutzername Ihres Dienstkontos.
• Kennwort: Dies ist das Kennwort Ihres Dienstkontos.

Hinweis:

Sofern verfügbar, sollten Sie stets OAuth 2.0 zur Dienstauthentifizierung verwenden. OAuth 2.0 stellt sicher, dass Ihre Integration höchste Sicherheitsansprüche mit Ihrer konfigurierten Mikroapp erfüllt.

Vor Beginn der Integration müssen folgende Voraussetzungen erfüllt sein:

• Ein dediziertes Benutzerkonto mit “Browse Projects”-Zugriff (Projekte durchsuchen) für alle Jira-Projekte, die Sie verwalten möchten.

  Weitere Hinweise zum Verwalten von Benutzern finden Sie unterhttps://www.atlassian.com/software/jira/guides#ManagingUsers-Addingusers.

  Weitere Informationen zum Hinzufügen eines Benutzers zu einem Berechtigungsschema für ein Jira-Projekt finden Sie unter Verwalten von Projektberechtigungen.

• Konfigurieren Sie in Citrix Gateway die Unterstützung für Single Sign-On für Jira, damit Benutzer sich nur einmal anmelden und ihre Anmeldeinformationen nicht erneut eingeben müssen. Folgen Sie den Anweisungen unter Konfigurieren von Single Sign-On für Jira. Weitere Hinweise zum Konfigurieren von SSO finden Sie unter Citrix Gateway Service.

Aktivieren von OAuth 2.0 (3LO)

Bevor Sie OAuth 2.0 mit 3-Parteien-Autorisierung (Three-legged authorization, 3LO) implementieren, müssen Sie das Protokoll für Ihre App in der App-Verwaltung von Jira aktivieren.

1. Navigieren Sie zur App-Verwaltung.
2. Erstellen Sie eine neue App: Wählen Sie Create new app, geben Sie einen Namen ein, akzeptieren Sie die Bedingungen und wählen Sie Create.
3. Kopieren Sie die Angaben unter Client ID und Secret für die spätere Verwendung.
4. Klicken Sie im Abschnitt APIs and Features in der Seitennavigation auf + Add.
5. Suchen Sie auf der Seite APIs and Features im Bereich “Features” die Option OAuth 2.0 (3LO). Wählen Sie Add und dann Configure.
6. Geben Sie unter Callback URL die Rückruf-URL ein. Wählen Sie für diese URL eine beliebige URL, auf die die App zugreifen kann. Wenn Sie OAuth 2.0 (3LO) in Ihrer App implementieren (siehe nächster Abschnitt), muss redirect_uri dieser URL entsprechen.
7. Klicken Sie auf “Save changes”.

Der Bildschirm sieht dann ungefähr wie folgt aus:

Erstellen von API-Token

Ein Skript oder anderer Prozess kann einen API-Token verwenden, um die Standardauthentifizierung bei Jira Cloud-Anwendungen oder Confluence Cloud durchzuführen. Sie müssen einen API-Token verwenden, wenn für das Atlassian-Konto, mit dem Sie sich authentifizieren, eine Überprüfung in zwei Schritten aktiviert ist.

1. Melden Sie sich beim Atlassian-Konto an, und gehen Sie zu API Tokens.
2. Wählen Sie Create API token und geben Sie im Feld Label einen Namen für den Token ein.
3. Wählen Sie Copy to Clipboard, um die Daten für die spätere Verwendung zu speichern.

Sie müssen den API-Token als Kennwort eingeben, wenn Sie die Integration zu Citrix Workspace-Mikroapps hinzufügen.

Hinzufügen der REST-API der Jira-Plattform

Fügen Sie jetzt die REST-API der Jira Plattform hinzu, wenn dies noch nicht erfolgt ist.

1. Klicken Sie im Abschnitt APIs and Features in der Seitennavigation auf + Add.
2. Suchen Sie auf der Seite APIs and Features im Bereich APIs die Option OAuth 2.0 (3LO). Wählen Sie Add und dann Configure.
3. Fügen Sie die gewünschten Bereiche für Ihre App hinzu.

Hinzufügen von Rückruf-URL

Fügen Sie Ihrer Instanzkonfiguration eine benutzerdefinierte URL hinzu, um Zugriff auf private Daten zu gewähren und OAuth-authentifizierte Benutzeraktionen zu aktivieren. Um Ihre Mikroappserver-URL zu finden, melden Sie sich bei Citrix Cloud an und wählen die Kachel Mikroapps. Kopieren Sie den ersten Abschnitt der URL in der URL-Leiste. Dies ist Ihre Mikroappserver-URL. Der Abschnitt {yourmicroappserverurl} setzt sich zusammen aus dem Mandanten, der Region und der Umgebung: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.

Für die Jira-HTTP-Integration müssen Sie zwei verschiedene Rückruf-URLs hinzufügen. Eine Jira-Anwendung kann jedoch nur eine Rückruf-URL haben. Das bedeutet, dass Sie zwei Anwendungen registrieren müssen: eine Anwendung für Benutzeraktionen und eine zweite für die Synchronisierung. Diese müssen unterschiedliche Rückruf-URLs verwenden.

https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext

https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

Hinweis:

Achten Sie beim Hinzufügen der Jira-Integration auf die Rückruf-URLs. Dienstauthentifizierung und Dienstaktionsauthentifizierung verwenden unterschiedliche Rückruf-URLs. Client-ID und geheimer Clientschlüssel müssen für die Rückruf-URL der Dienstauthentifizierung oder Dienstaktionsauthentifizierung gelten.

Hinzufügen der Integration zu Citrix Workspace-Mikroapps

Führen Sie folgende Schritte aus, um die Jira-HTTP-Integration einzurichten. Wir empfehlen für die meisten Anwendungsfälle die neuere HTTP-Integration. Die Authentifizierungsoptionen sind vorausgewählt. Stellen Sie sicher, dass diese Optionen ausgewählt sind, wenn Sie den Vorgang abschließen. Wir empfehlen für die meisten Anwendungsfälle diese neuere HTTP-Integration. Die HTTP-Integration bietet mehr Möglichkeiten zum Konfigurieren der zwischengespeicherten Datenstruktur.

Hinweis:

Standardmäßig synchronisiert diese Integration Daten für einen Zeitraum von sechs (6) Monaten. Wir empfehlen Ihnen, diesen Wert an Ihre Bedürfnisse und das übliche Alter Ihrer Tickets anzupassen. Der Filter berücksichtigt die letzte Aktualisierung, nicht das Erstellungsdatum. Um dies zu ändern, müssen Sie die Variable timeToSync in einem zum Laden von Daten verwendeten Endpunkt anpassen. Siehe Ersetzen der Variable für “Laden von Daten”.

Führen Sie folgende Schritte aus:

1. Wählen Sie auf der Seite Mikroappintegrationen die Optionen Neue Integration hinzufügen und Neue Integration aus Citrix-Vorlagen hinzufügen.
2. Wählen Sie unter Integrationen die Jira-Kachel.
3. Geben Sie einen Integrationsnamen ein.
4. Geben Sie Connectorparameter ein.
   • Geben Sie die Basis-URL der Instanz ein oder ersetzen Sie einfach {cloud-id} im Beispiel durch Ihre Cloud-ID. Sie finden Ihre Cloud-ID, indem Sie sich als Administrator Ihrer JIRA-Instanz anmelden und dann die URL ansehen. Diese Cloud-ID ist eine UUID, d. h. eine 8-4-4-4-12-stellige Hexadezimalzahl, die Teil der URL ist. Alternativ können Sie sich mit den Administratoranmeldeinformationen authentifizieren und eine GET-Anforderung an https://api.atlassian.com/oauth/token/accessible-resources senden. Die Cloud-ID ist Bestandteil der Antwort.
   • Wählen Sie ein Symbol für die Integration aus der Symbolbibliothek aus, oder belassen Sie das Jira-Standardsymbol.
   • Aktivieren Sie die Umschaltfläche On-Premises-Instanz, wenn Sie eine On-Premises-Verbindung erstellen. Weitere Informationen finden Sie unter On-Premises-Instanz. Aufgrund von Unterschieden zwischen Jira Cloud API v2 und Jira Server API v2 Ihrer Jira-Instanz müssen Sie einige Bestandteile der Integration manuell aktualisieren. Wenden Se sich an den Support.

   

5. Wählen Sie unter Dienstauthentifizierung im Menü Authentifizierungsmethode die Option OAuth 2.0 und geben Sie die Authentifizierungsdetails ein. Die Authentifizierungsoptionen sind vorausgewählt. Stellen Sie sicher, dass diese Optionen ausgewählt sind, wenn Sie den Vorgang abschließen. Generieren Sie über das Sicherheitsprotokoll OAuth 2.0 einen Anforderungs-/Autorisierungstoken zum delegierten Zugriff. Sofern verfügbar, sollten Sie stets OAuth 2.0 zur Dienstauthentifizierung verwenden. OAuth 2.0 stellt sicher, dass Ihre Integration höchste Sicherheitsansprüche mit Ihrer konfigurierten Mikroapp erfüllt.

   1. Wählen Sie im Menü Gewährungstyp - Prozess die Option Autorisierungscode. Dadurch wird ein temporärer Code gewährt, den der Client gegen einen Zugriffstoken tauscht. Der Code wird vom Autorisierungsserver abgerufen, wo Sie die vom Client angeforderten Informationen sehen. Nur dieser Gewährungstyp ermöglicht einen sicheren Benutzeridentitätswechsel. Dadurch wird die Rückruf-URL angezeigt, die Sie bei der Registrierung Ihrer Anwendung verwenden. Dienstauthentifizierung und Dienstaktionsauthentifizierung verwenden unterschiedliche Rückruf-URLs.
   2. Geben Sie im Feld Gewährungstyp - Wert den Wert authorization_code ein.
   3. Wählen Sie im Menü Tokenautorisierung die Option Anforderungstext.
   4. Wählen Sie im Menü Tokeninhaltstyp die Option URL-codiertes Formular.
   5. Ihre Autorisierungs-URL ist vordefiniert. Dies ist die Autorisierungsserver-URL, die beim Einrichten der Zielanwendungsintegration bereitgestellt wird.
   6. Ihre Token-URL ist vordefiniert. Dies ist die URL des autorisierenden Zugriffstoken.
   7. Stellen Sie sicher, dass Folgendes als Bereich eingegeben ist. Diese Zeichenfolge wird vom Autorisierungsserver beim Einrichten der Zielanwendungsintegration definiert. Um andere Entitäten zu synchronisieren, müssen Sie hier Bereiche hinzufügen. Verwenden Sie Folgendes, getrennt durch ein Leerzeichen: read:jira-user read:jira-work manage:jira-project manage:jira-configuration write:jira-work manage:jira-data-provider offline_access.
   8. Geben Sie Ihre Client-ID ein. Die Client-ID ist die Zeichenfolge, die die eindeutigen Angaben des Autorisierungsservers zur Clientregistrierung darstellt. Sie erfassen die Client-ID und den geheimen Clientschlüssel, indem Sie den OAuth-Client in Ihrem Jira-Konto registrieren. Client-ID und geheimer Clientschlüssel müssen für die Rückruf-URL der Dienstauthentifizierung gelten.
   9. Geben Sie Ihren geheimen Clientschlüssel ein. Der geheime Clientschlüssel ist eine eindeutige Zeichenfolge, die beim Einrichten der Zielanwendungsintegration ausgegeben wird.
   10. Geben Sie ein Headerpräfix ein (optional). Geben Sie das Headerpräfix ein, wenn Ihr Bearerpräfix sich vom Standardheader unterscheidet.

   

6. Aktivieren Sie unter Dienstaktionsauthentifizierung die Umschaltfläche Separate Benutzerauthentifizierung in Aktionen verwenden. Mit der Dienstaktionsauthentifizierung authentifizieren Sie sich auf der Dienstaktionsebene. Die Authentifizierungsoptionen sind vorausgewählt. Stellen Sie sicher, dass diese Optionen ausgewählt sind, wenn Sie den Vorgang abschließen.

   1. Wählen Sie im Menü Authentifizierungsmethode die Option OAuth 2.0 und geben Sie die Authentifizierungsdetails ein.
   2. Wählen Sie im Menü Gewährungstyp - Prozess die Option Autorisierungscode. Dadurch wird ein temporärer Code gewährt, den der Client gegen einen Zugriffstoken tauscht. Der Code wird vom Autorisierungsserver abgerufen, wo Sie die vom Client angeforderten Informationen sehen. Nur dieser Gewährungstyp ermöglicht einen sicheren Benutzeridentitätswechsel. Dadurch wird die Rückruf-URL angezeigt, die Sie bei der Registrierung Ihrer Anwendung verwenden. Dienstauthentifizierung und Dienstaktionsauthentifizierung verwenden unterschiedliche Rückruf-URLs.
   3. Geben Sie im Feld Gewährungstyp - Wert den Wert authorization_code ein.
   4. Wählen Sie im Menü Tokenautorisierung die Option Anforderungstext.
   5. Wählen Sie im Menü Tokeninhaltstyp die Option URL-codiertes Formular.
   6. Ihre Autorisierungs-URL ist vordefiniert. Dies ist die Autorisierungsserver-URL, die beim Einrichten der Zielanwendungsintegration bereitgestellt wird.
   7. Ihre Token-URL ist vordefiniert. Dies ist die URL des autorisierenden Zugriffstoken.
   8. Stellen Sie sicher, dass Folgendes als Bereich eingegeben ist. Diese Zeichenfolge wird vom Autorisierungsserver beim Einrichten der Zielanwendungsintegration definiert. Um andere Entitäten zu synchronisieren, müssen Sie hier Bereiche hinzufügen. Verwenden Sie Folgendes, getrennt durch ein Leerzeichen: read:jira-user read:jira-work manage:jira-project manage:jira-configuration write:jira-work manage:jira-data-provider offline_access.
   9. Geben Sie Ihre Client-ID ein. Die Client-ID ist die Zeichenfolge, die die eindeutigen Angaben des Autorisierungsservers zur Clientregistrierung darstellt. Sie erfassen die Client-ID und den geheimen Clientschlüssel, indem Sie den OAuth-Client in Ihrem Jira-Konto registrieren. Client-ID und geheimer Clientschlüssel müssen für die Rückruf-URL der Dienstaktionsauthentifizierung gelten.
   10. Geben Sie Ihren geheimen Clientschlüssel ein. Der geheime Clientschlüssel ist eine eindeutige Zeichenfolge, die beim Einrichten der Zielanwendungsintegration ausgegeben wird.
   11. Geben Sie ein Headerpräfix ein (optional). Geben Sie das Headerpräfix ein, wenn Ihr Bearerpräfix sich vom Standardheader unterscheidet.
   12. Bei Auswahl von OAuth 2.0 als Authentifizierungsmethode können Sie + Parameter hinzufügen wählen, um Zugriffstokenparameter einzubeziehen. Damit definieren Sie die Zugriffstokenparameter, falls dies für den Autorisierungsserver der Zielanwendung erforderlich ist.

   

7. (Optional) Wenn Sie das Ratenlimit für diese Integration aktivieren möchten, aktivieren Sie die Umschaltfläche Anforderungsratenlimit und definieren die Anzahl der Anforderungen pro Zeitintervall.
8. (Optional) Aktivieren Sie die Umschaltfläche Protokollierung, um 24-Stunden-Protokolle für Supportzwecke zu erstellen.

9. Das Feld Anforderungstimeout ist auf 120 voreingestellt.

   

10. Wählen Sie dann Speichern.
11. Wählen Sie unter OAuth-Autorisierung die Option Autorisieren, um sich mit Ihrem Dienstkonto anzumelden. Ein Popupfenster mit dem Webex-Anmeldebildschirm wird angezeigt.
    1. Geben Sie Benutzernamen und Kennwort Ihres Dienstkontos ein und wählen Sie Anmelden.
    2. Wählen Sie Akzeptieren.

Fahren Sie mit den folgenden Verfahren fort, um den Einrichtungsprozess abzuschließen.

Ersetzen von Variablen für “Dienstaktionen”

Um die Funktionen der Seite “Epic erstellen” zu aktivieren, müssen Sie die Dienstaktionen Create Epic und Create Epic wo Assignee manuell anpassen. Ersetzen Sie den Wert {Epic-Name-customFieldId} der Vorlagenvariable EpicFieldId durch die ID eines benutzerdefinierten Feldes, in dem der Epic-Name gespeichert ist.

1. Navigieren Sie im Jira-Verwaltungsportal zu Issues. Wählen Sie links die Menüoption Custom fields. Suchen Sie den Eintrag Epic name und wählen Sie das Menü auf der anderen Bildschirmseite. Wählen Sie View field information.
2. Kopieren und speichern Sie den numerischen Wert am Ende der URL.
3. Wählen Sie in Mikroapps das Menü neben der Jira-Integration und dann Bearbeiten. Wählen Sie in der Navigationsspalte auf der linken Seite die Option Dienstaktionen.
4. Wählen Sie das Menü neben einer der Dienstaktionen und wählen Sie Bearbeiten oder wählen Sie den Namen der Dienstaktion. Beginnen wir mit der Dienstaktion Create Epic.

5. Ersetzen Sie im Bildschirm Dienstaktion bearbeiten unter Vorlagenvariablen den Wert {Epic-Name-customFieldId} der Vorlagenvariablen EpicFieldId durch die benutzerdefinierte Feld-ID, die Sie zuvor in Jira erfasst haben.

   

6. Wählen Sie dann Speichern.
7. Wiederholen Sie dies nun für die Dienstaktion Create Epic wo Assignee.

Ersetzen der Variable für “Laden von Daten”

Diese Integration synchronisiert Daten standardmäßig für einen Zeitraum von sechs (6) Monaten. Wir empfehlen Ihnen, diesen Wert an Ihre Bedürfnisse und das übliche Alter Ihrer Tickets anzupassen. Der Filter berücksichtigt die letzte Aktualisierung, nicht das Erstellungsdatum. Um dies zu ändern, müssen Sie die Variable timeToSync in dem zum Laden von Daten verwendeten Endpunkt Vorgänge anpassen.

1. Wählen Sie auf der Seite Mikroappintegrationen das Menü neben der Jira-Integration und wählen Sie Bearbeiten. Der Bildschirm Laden von Daten wird geöffnet. Wenn das Konfigurationsfenster angezeigt wird, wählen Sie in der linken Navigationsspalte die Option Laden von Daten.
2. Wählen Sie das Menü neben dem Endpunkt Vorgänge und dann Bearbeiten oder wählen Sie den Namen des Endpunkts: Vorgänge.
3. Ersetzen Sie im Bildschirm Datenendpunkt bearbeiten unter Vorlagenvariablen den Wert für die Variable timeToSync durch den gewünschten Wert.

4. Wählen Sie am unteren Bildschirmrand Übernehmen und bestätigen Sie.

   

Sie können nun die erste Datensynchronisierung festlegen und ausführen. Vollständige Informationen zu Synchronisierungsregeln, zeitlich fehlgeschlagenen Synchronisierungen und zu Vetoregeln finden Sie unter Synchronisieren von Daten.

Weitere Informationen zu API-Endpunkten und Tabellenentitäten finden Sie unter Jira-HTTP-Connectorspezifikationen.

Verwenden von Jira-Mikroapps

Unsere HTTP-basierte Integration von Jira bietet folgende vorkonfigurierte Mikroapps:

Epic erstellen: Erstellen eines neuen Jira-Epic mit Details.

Hinweis:

Um die Funktionen der Seite “Epic erstellen” zu aktivieren, müssen Sie die Dienstaktionen Create Epic und Create Epic wo Assignee manuell anpassen. Siehe Ersetzen von Variablen für “Dienstaktionen”.

Benachrichtigung oder Seite	Workflows für Anwendungsfälle
Seite “Epic erstellen”	Formular zum Erstellen eines neuen Jira-Epic, mit Eingabe von Epic-Namen sowie Auswahl von Vorgangstyp, Projekt, Beauftragtem (optional) und einem Feld für Beschreibungstext.
Seite “Projekte”	Durchsuchbares Formular zur Auswahl eines Projekts, dem ein neues Epic zugewiesen werden soll.

Ticket erstellen: Erstellen eines neuen Jira-Tickets mit Details.

Benachrichtigung oder Seite	Workflows für Anwendungsfälle
Seite “Ticket erstellen”	Formular zum Erstellen eines neuen Jira-Tickets mit Vorgangstyp, Projekt, Beauftragtem (optional) und Feld für Beschreibungstext.
Seite “Projekte”	Durchsuchbares Formular zur Auswahl eines Projekts, dem das neue Ticket zugewiesen werden soll.

Tickets: Anzeigen von Tickets, Hinzufügen von Kommentaren, Erstellen von Unteraufgaben, Ändern von Status und Beauftragtem.

Benachrichtigung oder Seite	Workflows für Anwendungsfälle
Benachrichtigung: Kommentar bearbeitet (zugewiesenes Ticket)	Wenn ein Kommentar zu einem vorhandenen Ticket geändert wird, wird der Benutzer, dem das Ticket zugewiesen wurde, in Workspace benachrichtigt.
Benachrichtigung: Kommentar bearbeitet (erstelltes Ticket)	Wenn ein Kommentar zu einem vorhandenen Ticket geändert wird, wird der Benutzer, der das Ticket erstellt hat, in Workspace benachrichtigt.
Benachrichtigung: Neuer Kommentar (zugewiesenes Ticket)	Wenn ein neuer Kommentar zu einem vorhandenen Ticket hinzugefügt wird, wird der Benutzer benachrichtigt, dem das Ticket zugewiesen wurde.
Benachrichtigung: Neuer Kommentar (erstelltes Ticket)	Wenn ein neuer Kommentar zu einem Ticket hinzugefügt wird, wird der Benutzer benachrichtigt, der das Ticket erstellt hat.
Benachrichtigung: Ticket wurde Ihnen zugewiesen (ändern)	Wenn einem Benutzer ein vorhandenes Ticket zugewiesen wird, erhält er eine Benachrichtigung.
Benachrichtigung: Ticket wurde Ihnen zugewiesen (neu)	Wenn einem Benutzer ein neues Ticket zugewiesen wird, erhält er eine Benachrichtigung.
Benachrichtigung: Beauftragter für Ticket geändert (erstellt)	Wenn der Beauftragte für ein Ticket geändert wird, wird der Benutzer benachrichtigt, der das Ticket erstellt hat.
Benachrichtigung: Ticketstatusänderung (zugewiesenes Ticket)	Wenn der Status eines Tickets geändert wird, wird der Benutzer benachrichtigt, dem das Ticket zugewiesen ist.
Benachrichtigung: Ticketstatusänderung (erstellt)	Wenn der Status eines Tickets geändert wird, wird der Benutzer benachrichtigt, der das Ticket erstellt hat.
Seite “Kommentardetails”	Schreibgeschützte Ansicht eines Kommentars mit Details.
Seite “Unteraufgabe erstellen”	Formular zum Erstellen einer Unteraufgabe für ein Jira-Ticket.
Seite “Ticketdetails”	Detaillierte Ansicht eines Jira-Tickets mit Feldern zum Hinzufügen von Kommentaren und zum Anpassen von Status, Priorität und Beauftragten direkt auf der Seite.
Seite “Tickets”	Ermöglicht Benutzern das direkte Durchsuchen von Jira-Tickets, mit Suchfeld, Projektauswahl und Statusauswahl, um schnell zwischen allen / meinen / zugewiesenen / erstellten / beobachteten bzw. kommentierten Tickets zu wechseln.

Hinzufügen der Jira-Legacy-Integration

Befolgen Sie zusätzlich zur obigen Schrittfolge folgende Anweisungen, um die Legacy-Integration einzurichten.

Voraussetzungen

Für die Legacy-Integration benötigen Sie diese Werte.

• URL
• Benutzername
• Kennwort - Sie müssen den API-Token als Kennwort eingeben, wenn Sie die Integration zu Citrix Workspace-Mikroapps hinzufügen.
• Authentifizierungsmethode (entweder Anmeldeinformationen oder OAuth2)

Für OAuth 2.0 benötigen Sie außerdem:

• Client-ID
• Geheimer Clientschlüssel

Festlegen des Zeitraums für abgerufene Vorgänge

Legen Sie für die Jira-Legacy-Integration den Zeitraum fest, für den Vorgänge in Jira abgerufen werden sollen. Beim Hinzufügen der Integration zu Citrix Workspace-Mikroapps kann die Datenmenge, die die Integration von Jira abruft, durch einen Filter begrenzt werden.

1. Melden Sie sich mit Ihrem dedizierten Benutzerkonto und Kennwort bei Jira an.

   Hinweis:

   Wenn Sie ein vorhandenes Konto verwenden, ist der Benutzername nicht die E-Mail des Kontos. Um den Benutzernamen eines Kontos zu finden, melden Sie sich bei Ihrer Jira-Instanz ein, wählen die Miniaturansicht des Profils und wählen Profile.

2. Geben Sie an, für welchen Zeitraum Vorgänge abgerufen werden sollen.

   Standardwert: 90 Tage.

Hinzufügen von Jira-Legacy-Integrationen

Führen Sie folgende Schritte aus:

1. Klicken Sie auf der Seite “Übersicht” auf Starten.

   Die Seite “Integrationen verwalten” wird geöffnet.

2. Wählen Sie Neue Integration hinzufügen und Neue Integration aus Citrix-Vorlagen hinzufügen.
3. Wählen Sie die Jira-Kachel.

4. Geben Sie einen Namen für die Integration ein.

   

5. Geben Sie die Connectorparameter ein, die Sie im Verfahren unter “Voraussetzungen” erfasst haben.
   • Geben Sie Ihre URL ein.

   • Geben Sie Ihren Benutzernamen und Ihr Kennwort für die Dienstauthentifizierung ein.

     Hinweis:

     Geben Sie den API-Token ein, den Sie im vorherigen Schritt als Kennwort erfasst haben, wenn Sie die Integration zu Citrix Workspace-Mikroapps hinzufügen.

6. Wählen Sie eine Authentifizierungsmethode. Generieren Sie über das Sicherheitsprotokoll OAuth 2.0 einen Anforderungs-/Autorisierungstoken zum delegierten Zugriff.
   • Anmeldeinformationen - Es sind die Anmeldeinformationen des Clients zu verwenden.
   • OAuth 2.0 - Geben Sie die OAuth-Client-ID und den geheimen OAuth-Clientschlüssel ein, die Sie im Verfahren unter “Voraussetzungen” erfasst haben.
7. Wählen Sie einen Wert für Geänderte Tickets laden (Wochen).
8. Wählen Sie Hinzufügen aus.

Die Seite Mikroappintegrationen wird geöffnet und zeigt die hinzugefügte Integration mit zugehörigen Mikroapps an. Hier können Sie eine weitere Integration hinzufügen, vorkonfigurierte Mikroapps einrichten oder eine neue Mikroapp für diese Integration erstellen.

Sie können nun die erste Datensynchronisierung festlegen und ausführen. Da unter Umständen eine große Datenmenge von Ihrer integrierten Anwendung zur Mikroapps-Plattform übermittelt wird, empfehlen wir, für die erste Datensynchronisierung auf der Seite Tabelle Entitäten zu filtern, um die Synchronisierung zu beschleunigen. Weitere Informationen finden Sie unter Überprüfen erforderlicher Entitäten. Vollständige Informationen zu Synchronisierungsregeln, zeitlich fehlgeschlagenen Synchronisierungen und zu Vetoregeln finden Sie unter Synchronisieren von Daten.

Weitere Informationen zu API-Endpunkten und Tabellenentitäten finden Sie unter Jira-Connectorspezifikationen.

Jira-Legacy-Mikroapps

Unsere Integration von Jira bietet folgende vorkonfigurierte Mikroapps:

Ticket erstellen: Erstellen eines neuen Jira-Tickets mit Details.

Benachrichtigung oder Seite	Workflows für Anwendungsfälle
Seite “Ticket erstellen”	Formular zum Erstellen eines neuen Jira-Tickets mit Vorgangstyp, Projekt, Beauftragtem (optional) und Feld für Beschreibungstext.

Tickets: Anzeigen von Tickets, Hinzufügen von Kommentaren, Erstellen von Unteraufgaben, Ändern von Status und Beauftragtem.

Benachrichtigung oder Seite	Workflows für Anwendungsfälle
Benachrichtigung: Kommentar bearbeitet (zugewiesenes Ticket)	Wenn ein Kommentar zu einem vorhandenen Ticket geändert wird, wird der Benutzer, dem das Ticket zugewiesen wurde, in Workspace benachrichtigt.
Benachrichtigung: Kommentar bearbeitet (erstellt)	Wenn ein Kommentar zu einem vorhandenen Ticket geändert wird, wird der Benutzer, der das Ticket erstellt hat, in Workspace benachrichtigt.
Benachrichtigung: Neuer Kommentar (zugewiesenes Ticket)	Wenn ein neuer Kommentar zu einem vorhandenen Ticket hinzugefügt wird, wird der Benutzer benachrichtigt, dem das Ticket zugewiesen wurde.
Benachrichtigung: Neuer Kommentar (erstelltes Ticket)	Wenn ein neuer Kommentar zu einem Ticket hinzugefügt wird, wird der Benutzer benachrichtigt, der das Ticket erstellt hat.
Benachrichtigung: Ticket wurde Ihnen zugewiesen (ändern)	Wenn einem Benutzer ein vorhandenes Ticket zugewiesen wird, erhält er eine Benachrichtigung.
Benachrichtigung: Ticket wurde Ihnen zugewiesen (neu)	Wenn einem Benutzer ein neues Ticket zugewiesen wird, erhält er eine Benachrichtigung.
Benachrichtigung: Beauftragter für Ticket geändert (erstellt)	Wenn der Beauftragte für ein Ticket geändert wird, wird der Benutzer benachrichtigt, der das Ticket erstellt hat.
Benachrichtigung: Ticketstatusänderung (zugewiesenes Ticket)	Wenn der Status eines Tickets geändert wird, wird der Benutzer benachrichtigt, dem das Ticket zugewiesen ist.
Benachrichtigung: Ticketstatusänderung (erstellt)	Wenn der Status eines Tickets geändert wird, wird der Benutzer benachrichtigt, der das Ticket erstellt hat.
Seite “Kommentar hinzufügen”	Formular zum Hinzufügen eines Kommentars zu einem Jira-Ticket.
Seite “Beauftragten ändern”	Formular zum Ändern des Benutzers, dem ein Jira-Ticket zugewiesen wurde.
Seite “Status ändern”	Formular zum Ändern des Status eines Jira-Tickets.
Seite “Kommentardetails”	Schreibgeschützte Ansicht eines Kommentars mit Details.
Seite “Unteraufgabe erstellen”	Formular zum Erstellen einer Unteraufgabe für ein Jira-Ticket.
Seite “Ticketdetails”	Schreibgeschützte Ansicht eines Jira-Tickets mit Details.
Seite “Tickets”	Ermöglicht Benutzern die Suche nach Jira-Tickets, die ihnen zugewiesen bzw. von ihnen erstellt oder kommentiert wurden.