Jira Spoke

Apps im Store anfordern

Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.

IntegrationHub-Abonnement

Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.

Spoke-Version

Jira Spoke v4.3.2 ist die neueste Version.

Spoke-Abhängigkeiten

Wenn Sie Probleme beim Installieren der App haben, stellen Sie sicher, dass die folgenden abhängigen Plugins installiert sind:

ServiceNow IntegrationHub-Aktionsvorlage – Datenstrom (com.glide.hub.action_type.datastream)
Komplexes Objekt (com.glide.cobject)
ServiceNow IntegrationHub-Aktionsschritt – Verbindungsinformationen abrufen (com.glide.hub.action_step.get_connection_info)
ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
ServiceNow Flow Designer – Dynamische Eingaben (com.glide.hub.dynamic_inputs)
Integrations – External Authentication Framework (com.glide.external.app)

Hinweis:

Einige dieser Plugins sind lizenzierbare Funktionen und erfordern eine entsprechende Lizenz, wenn sie außerhalb der Spoke-Implementierung verwendet werden. Informationen zu Lizenzen erhalten Sie von Ihrem Account Manager.

Unterstützte Versionen

Diese Spoke wurde für die API-Version v2 erstellt, ist jedoch möglicherweise mit späteren Versionen kompatibel.

Hinweis:

Wenn Ihre Instanz Jira eine andere API-Version unterstützt, geben Sie die API-Version in API-Version unter der zugehörigen Liste Attribute an. Standardmäßig ist die API-Version2. Informationen zum Erstellen eines Verbindungsdatensatzes finden Sie unter Konfigurieren Sie eine Verbindung für die Jira-Spoke.
Jira Service Desk wird von der -Spoke nicht unterstützt.

Jira Webhooks-Modul

Bidirektionale Webhooks können so eingerichtet werden, dass sie über die erforderlichen Events benachrichtigt werden. Die Weiterleitungsrichtlinie definiert Bedingungen, die erfüllt sein müssen, um die Instanz ServiceNow zu benachrichtigen. Diese Bedingungen basieren auf den Events in Jira, über die Sie benachrichtigt werden möchten. Wenn die Bedingungen erfüllt sind, löst die Routing-Richtlinie den zugehörigen Subflow aus, der wiederum die Jira -Aufgaben automatisiert.

Die bidirektionalen Webhooks erfordern ein separates Setup und können unabhängig verwendet werden, ohne die Spoke-Aktionen zu verwenden. Standardmäßig ist die Webhook-Anwendung Jira in Jira verfügbar und verfügt über die folgenden Module:

Jira-Webhook-Registrierungen
Weiterleitungsrichtlinien für Jira-Webhooks

Verwenden Sie das Modul Jira Webhook-Registrierungen, um ein Token zuzuweisen und den API-Pfad bereitzustellen. Sie müssen hier eine Rückruf-URL generieren und die URL in Jiraangeben. Eine standardmäßige Routing-Richtlinie wird im Modul Jira WebHook-Routing-Richtlinien bereitgestellt. Die standardmäßige Weiterleitungsrichtlinie unterstützt die folgenden Felder:


Kategorie	Feld
Vorfall	URL der Jira-Instanz Webhook-Event Problembeschreibung Erstellt Aktualisiert Problemlösung Vorherige Problemlösung Problemzusammenfassung Problemtyp Typ des vorherigen Problems Problempriorität Priorität des vorherigen Problems Problemstatus Vorheriger Problemstatus Problemstatuskategorie Statuskategorie des vorherigen Problems Projekt
Kommentar	Jira Instanz-URL Webhook-Event Kommentar Erstellt Aktualisiert Problemzusammenfassung Problemtyp Problempriorität Problemstatus Problemstatuskategorie Projekt
Arbeitsprotokoll	Jira Instanz-URL Webhook-Event Arbeitsprotokoll – aufgewendete Zeit Erstellt Aktualisiert
Anhang	Jira Instanz-URL Webhook-Event Erstellt Dateiname der Anlage Anhangsgröße MIME-Typ des Anhangs
Projekt	Jira Instanz-URL Webhook-Event Projekt
Version	Jira Instanz-URL Webhook-Event Version Versionsbeschreibung Mit Version zusammengeführt Mit Versionsbeschreibung zusammengeführt

Um andere Bedingungen in der Routing-Richtlinie zu verwenden, erstellen Sie eine Routing-Richtlinie im Modul Jira WebHook-Routing-Richtlinien, und geben Sie die Bedingungen gemäß Ihren Anforderungen an. Informationen zum Einrichten und Konfigurieren der Webhooks finden Sie unter Richten Sie einen bidirektionalen Webhook ein.

Spoke-Subflow

Jira stellt einen Beispiel-Subflow zur Verarbeitung verschiedener Jira -Webhook-Events bereit. Der verfügbare Beispiel-Subflow ist Prozess Jira Webhooks. Der Subflow „ Jira Webhooks verarbeiten unterstützt die folgenden Felder:


Kategorie	Feld
Vorfall	Anwender Vorfall Anhänge Problem-Change-Protokoll Projekt
Kommentar	Vorfall Projekt Kommentar
Arbeitsprotokoll	Arbeitsprotokoll
Anhänge	Anhang
Projekt	Projekt
Version	Version
Webhook-Event
Zeitstempel
Nutzlast Hinweis: Dies ist die gesamte Nutzlast Jira.

Um den Standard-Subflow anzupassen, müssen Sie eine Kopie des Beispiel-Subflows erstellen, die Nutzlast analysieren und den Subflow gemäß Ihren Anforderungen anpassen. Nutzlast ist eine der Eingaben in den Subflow.

Beim Anpassen von Subflows müssen Sie sicherstellen, dass die Subflows so konfiguriert sind, dass Endlosschleifen vermieden werden.

Hinweis:

Sie müssen Webhooks konfigurieren, um den Spoke-Subflow zu verwenden. Informationen zum Einrichten und Konfigurieren des Webhooks finden Sie unter Richten Sie einen bidirektionalen Webhook ein.
Der Beispiel-Subflow wird standardmäßig als Benutzer ausgeführt. Derund der Subflow können so konfiguriert werden, dass sie als System ausgeführt werden.

Spoke-Aktionen

Verwenden Sie Aktionen in Jira-Spoke in Flow Designer, um Jira Aufgaben zu automatisieren, wenn ein Event in Now Platformauftritt. Folgende Aktionen sind verfügbar:

Hinweis:

Einige der Spoke-Aktionen ab diesem Release verfügen nicht über die Eingabe „Verbindungsalias“.
Die vorhandenen Flows in Ihrer Instanz, die Aktionen der vorherigen Versionen verwenden, funktionieren weiterhin. Diese früheren Aktionen werden jedoch umbenannt, indem das veraltete Suffix hinzugefügt wird, und Sie können sie ab dieser Version nicht mehr verwenden.
Fehlerauswertungsfunktionen werden in einigen der Spoke-Aktionen bereitgestellt.


Kategorie	Feld	Beschreibung
Audit Management	Stream mit Audit-Protokollen suchen	Ruft die Anmeldeaktivität für die Atlassian-AnwenderabonnementsJira ab.
Gruppenverwaltung	Benutzer zu Gruppe hinzufügen	Fügt den angegebenen Anwender einer Gruppe in Jirahinzu.
	Gruppe erstellen	Erstellt eine Gruppe in Jira.
	Stream mit Gruppen suchen	Ruft alle Gruppen im Atlassian-Account ab, einschließlich der Standardgruppen. Hinweis: Diese Aktion kann nur mit dem Cloud-Abonnement Jira verwendet werden.
	Sucht Anwender nach Gruppenname-Stream	Ruft Details aller Mitglieder in einer Atlassian-Gruppe ab.
	Gruppe entfernen	Entfernt die angegebene Gruppe aus Jira.
	Benutzer aus Gruppe entfernen	Entfernt den angegebenen Anwender aus einer Gruppe in Jira.
Problemverwaltung	Anmerkung hinzufügen	Fügt dem angegebenen Problem in Jiraeinen Kommentar hinzu.
	Beobachter hinzufügen	Fügt den angegebenen Benutzer als Beobachter für das angegebene Problem hinzu.
	Problem zuweisen	Weist dem Benutzer das Problem in Jira zu.
	Anhang kopieren	Kopiert den erforderlichen Anhang, der ServiceNowdem Datensatz [] zugeordnet ist, in das erforderliche Problem in Jira.
	Problem erstellen	Erstellt ein Problem in Jira. Je nachdem, wie Ihre Organisation Jiraverwendet, kann ein Problem einen Softwarefehler, eine Projektaufgabe, ein Help Desk-Ticket oder mehr darstellen. Ein Problem in Jira stellt eine Aufgabe in Now Platformdar.
	Erstellen Sie Probleme	Erstellt bis zu 50 Probleme im Massenvorgang. Die Art des Problems, das die Aktion erstellt, hängt vom Setup von Jira ab.
	Anhang löschen	Löscht den erforderlichen Anhang in Jira.
	Problem löschen	Löscht ein Problem in Jira.
	Beobachter löschen	Löscht den Anwender als Beobachter für das angegebene Problem.
	Übergang durchführen	Überführt ein Problem in Jira von einem Status in einen anderen.
	Sucht nach Problemtypstatus nach Projekt	Ruft Details der Status in einem Projekt ab.
	Sucht nach Problem	Ruft die Details für ein Problem ab.
	Sucht nach Problemprioritäten	Ruft die Liste der Problemprioritäten und Details für einzelne Problemprioritäten ab.
	Stream mit Problemen suchen	Ruft eine Liste von Problemen ab, die einer JQL-Abfragezeichenfolge entsprechen.
	Sucht den Stream mit Sprint-Problemen	Ruft die Details aller Probleme für den angegebenen Sprint ab.
	Suchen Sie nach Übergängen	Ruft Informationen zu allen Übergängen für eine bestimmte Problem-ID ab.
	Sucht Beobachter	Ruft die Liste der Beobachter für das angegebene Problem ab.
	Problem aktualisieren	Aktualisiert eine festgelegte Anzahl von Feldern eines Problems in Jira mit Werten, die als Eingabe übergeben wurden.
Metadatenabruf	Tafeln abrufen (Metadaten)	Ruft die Details aller Tafeln in Jiraab.
	Erstellbare Felder abrufen (Metadaten)	Ruft die Liste aller Felder in einem erforderlichen Jira Projekt ab.
	Bearbeitbare Felder abrufen (Metadaten)	Ruft die Liste aller bearbeitbaren Felder in einem erforderlichen Jira -Problem ab.
	Problemtypen abrufen (Metadaten)	Ruft die Liste aller Problemtypen in einem erforderlichen Jira -Projekt ab.
	Projekte abrufen (Metadaten)	Ruft die Liste aller Jira Projekte ab.
Projektmanagement	Projekt erstellen	Erstellt ein Projekt in Jira.
	Sucht nach Projekt	Ruft Details des angegebenen Projekts anhand seiner ID oder seines Schlüssels ab.
	Projekte suchen	Ruft Details aller Projekte ab. Hinweis: Diese Aktion funktioniert nur für den Server Jira.
	Stream mit Projekten suchen	Ruft Details aller Projekte ab. Hinweis: Diese Aktion funktioniert nur für die Jira Cloud.
	Sucht Anwender, die Projekten zugewiesen werden können	Ruft eine Liste von Anwendern ab, die Problemen in einem oder mehreren Projekten zugewiesen werden können.
Sprint-Management	Sprint erstellen	Erstellt einen Sprint in Jira.
	Sprint löschen	Löscht einen Sprint in Jira.
	Sucht nach Sprint	Ruft die Details des erforderlichen Sprints als komplexes Objekt ab.
	Sucht nach Sprints nach Tafel	Ruft die Details aller Sprints in der erforderlichen Tafel ab.
	Sprint aktualisieren	Aktualisiert die Details eines Sprints in Jira.
Story-Management	Story erstellen	Erstellt eine Story in der Cloud-Instanz Jira. Dies ist vergleichbar mit der Story im ServiceNow Agile Development-Plugin.
	Stream „Storys“ suchen	Ruft Details aller Storys ab.
	Story aktualisieren	Aktualisiert eine festgelegte Anzahl von Feldern einer Story in Jira Cloud mit den angegebenen Eingabewerten.
Anwenderverwaltung	Benutzer erstellen	Erstellt einen Anwender in Jira. Hinweis: Diese Aktion wird nicht unterstützt, wenn die OAuth 2.0-Authentifizierung verwendet wird.
	Authentifizierten Anwender suchen	Ruft Details des authentifizierten Anwenderaccounts ab.
	Sucht nach Gruppenmitgliedschaften für Anwender	Ruft Details aller Gruppen eines Atlassian-Anwenders ab.
	Stream mit Anwendern suchen	Ruft Details aller Atlassian-Anwenderabonnements Jira ab. Hinweis: Diese Aktion kann nur mit einem Jira Cloud-Abonnement verwendet werden.
	Sucht Anwender-Stream nach Name	Ruft eine Liste der Anwender ab, die der Suchzeichenfolge entsprechen. Hinweis: Diese Aktion kann nur mit einem Jira -Serverabonnement verwendet werden.
	Benutzer entfernen	Entfernt einen Anwender aus Jira. Hinweis: Diese Aktion wird nicht unterstützt, wenn die OAuth 2.0-Authentifizierung verwendet wird.
Dienstprogrammaktionen	Problemanhang in Datensatz kopieren	Kopiert Anhang aus Jira in einen beliebigen Datensatz in der Instanz ServiceNow. Wenn Sie diese Aktion in einem Subflow verwenden, stellen Sie sicher, dass die Datenpille Inhalts-URL im Feld Anhang-URL angegeben ist.
	Felder suchen	Ruft den internen Namen und andere Details der erforderlichen Feldbezeichnung in Jiraab.
	Sucht in Kommentar nach Problem	Ruft die Details des Problems ab, indem die Nutzlast für den angegebenen Kommentar analysiert wird. Sie können diese Aktion im Subflow „ Jira Webhook für Jira On-Premise-Server verarbeiten“ verwenden, wenn nur kommentarbezogene Informationen ohne Details zum Jira ]-Problem angegeben werden. Wenn beispielsweise nur Kommentarinformationen angegeben sind, analysiert diese Aktion die Nutzlast und extrahiert die Problemdetails.
	Sucht den neuesten Anhang zu Problem	Ruft den neuesten Anhang für das angegebene Problem von Jiraab. Sie können diese Aktion in einem Flow oder Subflow zur Validierung verwenden. Beispielsweise fügt ein Subflow nur dann einen zusätzlichen Anhang hinzu, wenn der letzte Anhang eines Problems in Jira nicht derselbe angegebene Anhang ist.
	Sucht nach dem neuesten Kommentar zum Problem	Ruft den neuesten Kommentar für das angegebene Problem aus Jira ab. Sie können diese Aktion in einem Flow oder Subflow zur Validierung verwenden. Beispielsweise fügt ein Subflow nur dann einen zusätzlichen Kommentar hinzu, wenn der letzte Kommentar eines Problems in Jira nicht der angegebene Kommentar ist.
Webhook-Verwaltung	Webhooks suchen	Ruft Details aller registrierten Webhooks aus der Instanz Jira ab.
	Webhook abonnieren	Registriert einen Webhook in der Instanz Jira.
	Webhook abbestellen	Löscht den registrierten Webhook in der Instanz Jira.
	Webhook aktualisieren	Aktualisiert den Webhook mit der angegebenen ID in Jira. Hinweis: Diese Aktion wird nicht unterstützt, wenn die OAuth 2.0-Authentifizierung verwendet wird.

Jira -Kontoanforderungen

Jira erfordert die Generierung eines API-Tokens für Jira mit Ihrem Atlassian-Konto.

Alias-Anforderungen für Verbindungen und Anmeldeinformationen

IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen sowie OAuth-Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren.

Diese Spoke verwendet den Aliasdatensatz Jira. Um diese Aktionen zu verwenden, müssen Sie einen c-Verbindungsdatensatz und einen c-Berechtigungsdatensatz erstellen und sie dem Jira ]-Alias-Datensatz zuordnen.

Diese Aktionen verwenden REST-Aufrufe, die für eine Instanz ausgeführt werden können. Verwenden Sie den Verbindungsdatensatz, der dem Alias Jira zugeordnet ist, um den Endpunkt zu konfigurieren, für den die Aktionen ausgeführt werden.