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 v5.1.0 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 Action Template – Data Stream (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)
Integrationen – Externes Authentifizierungs-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 unter API-Version in 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 Ereignisse benachrichtigt werden. Die Weiterleitungsrichtlinie definiert Bedingungen, die erfüllt sein müssen, um die Instanz ServiceNow zu benachrichtigen. Diese Bedingungen basieren auf den Ereignissen in Jira, über die Sie benachrichtigt werden möchten. Wenn die Bedingungen erfüllt sind, löst die Weiterleitungsrichtlinie den zugehörigen Subflow aus, der wiederum die Aufgaben Jira automatisiert.

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

Jira-Webhook-Registrierungen
Weiterleitungsrichtlinien für Jira WebHook

Verwenden Sie das Modul Jira Webhook-Registrierungen, um ein Token zuzuweisen und den API-Pfad anzugeben. Sie müssen hier eine Rückruf-URL generieren und die URL in Jiraangeben. Eine Standardweiterleitungsrichtlinie wird im Modul Jira WebHook Routing Policies (WebHook-Routing-Richtlinien) bereitgestellt. Die Standardweiterleitungsrichtlinie unterstützt diese Felder:


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

Um andere Bedingungen in der Weiterleitungsrichtlinie zu verwenden, erstellen Sie eine Weiterleitungsrichtlinie im Modul Jira WebHook-Weiterleitungsrichtlinien, und geben Sie Bedingungen entsprechend Ihren Anforderungen an. Informationen zum Einrichten und Konfigurieren der Webhooks finden Sie unter Richten Sie einen bidirektionalen Webhook für die Jira-Spoke ein.

Spoke-Subflow

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


Kategorie	Feld
Problem	Anwender Problem Anhänge Problem-Change-Protokoll Projekt
Kommentar	Problem Projekt Kommentar
Arbeitsprotokoll	Arbeitsprotokoll
Anhänge	Anhang
Projekt	Projekt
Version	Version
Webhook-Ereignis
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 entsprechend Ihren Anforderungen anpassen. Die Nutzlast ist eine der Eingaben für 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 für die Verwendung des Spoke-Subflows konfigurieren. Informationen zum Einrichten und Konfigurieren des Webhook finden Sie unter Richten Sie einen bidirektionalen Webhook für die Jira-Spoke ein.
Der Beispiel-Subflow wird standardmäßig als -Benutzer ausgeführt. Der Subflow kann so konfiguriert werden, dass er als System ausgeführt wird.

Spoke-Auslöser

Verwenden Sie Auslöser in Jira-Spoke, um die erforderlichen Ereignisse zu abonnieren. Über den Endpunkt können Webhooks eine Verbindung zu Ihrer ServiceNow-Instanz herstellen. Sie können Flows so konfigurieren, dass sie nur ausgeführt werden, wenn die angegebenen Auslöserbedingungen erfüllt sind. Folgende Ereignisse werden unterstützt:


Kategorie	Auslöser	Beschreibung
Tafelmanagement	Tafel gelöscht	Der Auslöser wird initiiert, wenn eine Tafel gelöscht wird.
	Tafel aktualisiert	Der Auslöser wird initiiert, wenn eine Tafel aktualisiert wird.
	Tafel erstellt	Der Auslöser wird initiiert, wenn eine Tafel erstellt wird.
Kommentarverwaltung	Kommentar gelöscht	Der Auslöser wird initiiert, wenn ein Kommentar gelöscht wird.
	Kommentar aktualisiert	Auslöser wird initiiert, wenn ein Kommentar aktualisiert wird.
	Kommentar erstellt	Auslöser wird initiiert, wenn ein Kommentar erstellt wird.
Problemverwaltung	Problem aktualisiert	Der Auslöser wird initiiert, wenn ein Problem aktualisiert wird. Die Ereignisse wie „Problem zugewiesen“, „Problem gelöst“, „Problem geschlossen“, „Problem erneut geöffnet“, „Problem verschoben“ und andere Ereignisse, die mit der Aktualisierung eines Problems zusammenhängen, fallen unter dieses Webhook-Ereignis.
	Problem zugewiesen	Auslöser wird initiiert, wenn ein Problem zugewiesen wird.
	Problem gelöscht	Auslöser wird initiiert, wenn ein Problem gelöscht wird.
	Problem erstellt	Auslöser wird initiiert, wenn ein Problem erstellt wird.
Sprint Management	Sprint aktualisiert	Auslöser wird initiiert, wenn ein Sprint aktualisiert wird.
	Sprint gelöscht	Auslöser wird initiiert, wenn ein Sprint gelöscht wird.
	Sprint erstellt	Auslöser wird initiiert, wenn ein Sprint erstellt wird.
	Sprint geschlossen	Auslöser wird initiiert, wenn ein Sprint geschlossen wird.
	Sprint gestartet	Auslöser wird initiiert, wenn ein Sprint gestartet wird.

Informationen zum Einrichten der Auslöser für die Jira-Spoke finden Sie unter Richten Sie Auslöser für die Jira-Spoke ein. Weitere Informationen zur eingehenden Integration finden Sie unter Bedingte und ereignisgesteuerte eingehende Integration.

Spoke-Aktionen

Verwenden Sie Aktionen in Jira-Spoke in Workflow-Studio, um Jira -Aufgaben zu automatisieren, wenn ein Ereignis 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 durch Hinzufügen des Suffixes veraltet umbenannt und können ab dieser Version nicht mehr verwendet werden.
Fehlerbewertungsfunktionen werden in einigen der Spoke-Aktionen bereitgestellt.


Kategorie	Aktion	Beschreibung
Audit-Management	Stream mit Audit-Protokollen suchen	Ruft die Anmeldeaktivität für die Abonnements des Atlassian-AnwendersJira ab.
Gruppenverwaltung	Anwender 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 Gruppennamen-Stream	Ruft Details aller Mitglieder in einer Atlassian-Gruppe ab.
	Gruppe entfernen	Entfernt die angegebene Gruppe aus Jira.
	Anwender 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 Anwender als Beobachter für das angegebene Problem hinzu.
	Problem zuweisen	Weist dem Anwender das Problem in Jira zu.
	Anhang kopieren	Kopiert den erforderlichen Anhang, der dem Datensatz ServiceNow 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 vieles mehr darstellen. Ein Problem in Jira entspricht einer Aufgabe in Now Platform.
	Probleme erstellen	Erstellt einen Massenvorgang für bis zu 50 Probleme. 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 ausführen	Überführt ein Problem in Jira von einem Status in einen anderen.
	Sucht Problemtypstatus nach Projekt	Ruft Details der Status in einem Projekt ab.
	Problem suchen	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 Reihe von Feldern eines Problems in Jira mit als Eingabe übergebenen Werten.
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.
	Projekt suchen	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.
	Löschen Sie den Sprint	Löscht einen Sprint in Jira.
	Sucht nach Sprint	Ruft die Details des erforderlichen Sprints als komplexes Objekt ab.
	Sprints nach Tafel suchen	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 Plugin „ServiceNow Agile Development“.
	Stream „Stories“ suchen	Ruft Details aller Stories ab.
	Story aktualisieren	Aktualisiert eine Reihe von Feldern einer Story in Jira Cloud mit den angegebenen Eingabewerten.
Anwenderverwaltung	Anwender 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 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 Cloud-Abonnement Jira verwendet werden.
	Sucht Stream mit Anwendern nach Name	Ruft eine Liste der Anwender ab, die der Suchzeichenfolge entsprechen. Hinweis: Diese Aktion kann nur mit einem Serverabonnement Jira verwendet werden.
	Anwender 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 den Anhang von 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 Anhangs-URL angegeben ist.
	Felder suchen	Ruft den internen Namen und andere Details der erforderlichen Feldbezeichnung in Jiraab.
	Sucht nach Problem aus Kommentar	Ruft die Details des Problems ab, indem die Nutzlast für den angegebenen Kommentar analysiert wird. Sie können diese Aktion im Subflow „Webhook von Prozess Jira für Jira On-Prem-Server verwenden, wenn nur kommentarbezogene Informationen ohne Details zum Problem Jira angegeben sind. Wenn beispielsweise nur Kommentarinformationen angegeben sind, analysiert diese Aktion die Nutzlast und extrahiert die Problemdetails.
	Sucht nach dem neuesten Anhang für 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 der 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 neueste Kommentar eines Problems in Jira nicht derselbe 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 einen Webhook mit der angegebenen ID in Jira. Hinweis: Diese Aktion wird nicht unterstützt, wenn die OAuth 2.0-Authentifizierung verwendet wird.

Jira Kontoanforderungen

Für Jira müssen Sie mit Ihrem Atlassian-Konto ein API-Token für Jira generieren.

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-Rundfunkdatensatz erstellen und diese dem Jira -Alias-Datensatz zuordnen.

Diese Aktionen verwenden REST-Aufrufe, die in einer -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.