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

JiraSpoke V 5.1.0 Ist die neueste Version.

Spoke-Abhängigkeiten

Wenn Sie Probleme bei der Installation der App haben, stellen Sie sicher, dass diese 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-Aktionsschritt – REST (com.Glide.Hub.action_STEP.Rest)
ServiceNow Flow Designer – dynamische Eingaben (com.Glide.Hub.Dynamic_input)
Integrationen – Framework für externe Authentifizierung (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 API-Version v2 erstellt, ist jedoch möglicherweise mit späteren Versionen kompatibel.

Hinweis:

Wenn Sie JiraInstanz unterstützt eine andere API-Version. Geben Sie die API-Version in an API-Version Unter der zugehörigen Liste Attribute. Standardmäßig ist API-Version Ist 2 . Siehe Konfigurieren Sie eine Verbindung für Jira-SpokeInformationen zum Erstellen eines Verbindungsdatensatzes.
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 zu benachrichtigen ServiceNowInstanz. 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 automatisiert JiraAufgaben.

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

Jira-Webhook-Registrierungen
Jira-Webhook-Weiterleitungsrichtlinien

Verwenden Sie JiraWebhook registriert Modul, um ein Token zuzuweisen und den API-Pfad anzugeben. Sie müssen hier eine Rückruf-URL generieren und die URL in angeben Jira. Eine standardmäßige Weiterleitungsrichtlinie wird in bereitgestellt JiraWebhook-Weiterleitungsrichtlinienmodul. Die standardmäßige Weiterleitungsrichtlinie unterstützt diese Felder:


Kategorie	Feld
Problem	Jira-Instanz-URL Webhook-Ereignis Problembeschreibung Erstellt Aktualisiert Problemlösung Lösung Des Vorherigen Problems 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 Arbeitsprotokollzeit Erstellt Aktualisiert
Anhang	Jira Instanz-URL Webhook-Ereignis Erstellt Dateiname der Anlage Anhangsgröße Mime-Typ Des Anhangs
Projekt	Jira Instanz-URL Webhook-Ereignis Projekt
Version	Jira Instanz-URL Webhook-Ereignis Version Versionsbeschreibung Mit Version Zusammengeführt Mit Versionsbeschreibung Zusammengeführt

Um andere Bedingungen in der Weiterleitungsrichtlinie zu verwenden, erstellen Sie eine Weiterleitungsrichtlinie in JiraWebhook-Weiterleitungsrichtlinienmodul und geben Sie Bedingungen gemäß Ihren Anforderungen an. Siehe Richten Sie einen bidirektionalen Webhook für die Jira-Spoke einInformationen zum Einrichten und Konfigurieren der Webhooks.

Spoke-Subflow

Die JiraStellt einen Beispiel-Subflow zur Verarbeitung verschiedener dar JiraWebhook-Ereignisse. Der verfügbare Beispiel-Subflow ist „Prozess“ JiraWebhooks. Der Prozess JiraWebhooks-Subflow 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 das gesamte JiraNutzlast.

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 für den Subflow.

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

Hinweis:

Sie müssen Webhooks konfigurieren, um den Spoke-Subflow zu verwenden. Siehe Richten Sie einen bidirektionalen Webhook für die Jira-Spoke einInformationen zum Einrichten und Konfigurieren des Webhooks.
Der Beispiel-Subflow wird standardmäßig als Anwender ausgeführt. Th E subflow Kann so konfiguriert werden, dass sie als System ausgeführt wird.

Spoke-Auslöser

Auslöser in verwenden Jira-SpokeUm die erforderlichen Ereignisse zu abonnieren. Mit dem Endpunkt können Webhooks eine Verbindung mit Ihrer ServiceNow-Instanz herstellen. Sie können die Flows so konfigurieren, dass sie nur ausgeführt werden, wenn die angegebenen Auslöserbedingungen erfüllt sind. Die unterstützten Ereignisse sind:


Kategorie	Auslöser	Beschreibung
Tafelmanagement	Tafel Gelöscht	Auslöser wird initiiert, wenn eine Tafel gelöscht wird.
	Tafel Aktualisiert	Auslöser wird initiiert, wenn eine Tafel aktualisiert wird.
	Tafel Erstellt	Auslöser wird initiiert, wenn eine Tafel erstellt wird.
Kommentarverwaltung	Kommentar Gelöscht	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.
Problemmanagement	Problem Aktualisiert	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 sich auf die Aktualisierung eines Problems beziehen, gehören zu diesem 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.
Sprintverwaltung	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-SpokeIn Workflow-StudioZu automatisieren JiraAufgaben, wenn ein Ereignis in auftritt Now Platform. Folgende Aktionen sind verfügbar:

Hinweis:

Einige der Spoke-Aktionen ab diesem Release haben nicht Verbindungsalias Eingabe.
Die vorhandenen Flows in Ihrer Instanz, die Aktionen der vorherigen Versionen verwenden, funktionieren weiter. Diese früheren Aktionen werden jedoch umbenannt, indem hinzugefügt wird Veraltet Suffix, und Sie können sie ab dieser Version nicht verwenden.
Fehlerauswertungsfunktionen werden in einigen der Spoke-Aktionen bereitgestellt.


Kategorie	Aktion	Beschreibung
Audit-Management	Suchen Sie nach Stream für Auditprotokolle	Ruft die Anmeldeaktivität für den Atlassian ab JiraAnwenderabonnements.
Gruppenverwaltung	Anwender zu Gruppe hinzufügen	Fügt den angegebenen Anwender einer Gruppe in hinzu Jira.
	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 mit verwendet werden JiraNur Cloud-Abonnement.
	Sucht Anwender nach Gruppennamen-Stream	Ruft Details aller Mitglieder in einer atlassischen Gruppe ab.
	Gruppe entfernen	Entfernt die angegebene Gruppe aus Jira.
	Anwender aus Gruppe entfernen	Entfernt den angegebenen Anwender aus einer Gruppe in Jira.
Problemmanagement	Anmerkung hinzufügen	Fügt dem angegebenen Problem in einen Kommentar hinzu Jira.
	Fügen Sie Beobachter Hinzu	Fügt den angegebenen Anwender als Beobachter für das angegebene Problem hinzu.
	Problem Zuweisen	Weist das Problem in zu JiraAn den Anwender.
	Anhang kopieren	Kopiert den erforderlichen Anhang, der zugeordnet ist Die ServiceNowDatensatz für das erforderliche Problem in Jira.
	Problem erstellen	Erstellt ein Problem in Jira. Abhängig davon, wie Ihre Organisation verwendet Jira, Ein Problem kann einen Softwarefehler, eine Projektaufgabe, ein Help Desk-Ticket oder mehr darstellen. Ein Problem in JiraStellt eine Aufgabe in dar Now Platform.
	Erstellen Sie Probleme	Erstellt bis zu 50 Probleme in einem Massenvorgang. Die Art des Problems, das die Aktion erstellt, hängt von ab JiraSetup.
	Anhang löschen	Löscht den erforderlichen Anhang in Jira.
	Problem löschen	Löscht ein Problem in Jira.
	Löschen Sie Den Beobachter	Löscht den Anwender als Beobachter für das angegebene Problem.
	Übergang durchführen	Wechselt ein Problem in JiraVon einem Status in einen anderen.
	Problemtypstatus nach Projekt suchen	Ruft Details der Status in einem Projekt ab.
	Problem suchen	Ruft die Details für ein Problem ab.
	Suchen Sie 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.
	Suchen Sie nach Stream „Sprint-Probleme“	Ruft die Details aller Probleme für den angegebenen Sprint ab.
	Sucht nach Übergängen	Ruft Informationen zu allen Übergängen für eine bestimmte Problem-ID ab.
	Suchen Sie nach Beobachtern	Ruft die Liste der Beobachter für das angegebene Problem ab.
	Problem Aktualisieren	Aktualisiert eine festgelegte Anzahl von Feldern eines Problems in JiraMit Werten, die als Eingabe übergeben wurden.
Metadatenabruf	Tafeln Abrufen (Metadaten)	Ruft die Details aller Tafeln in ab Jira.
	Erstellbare Felder Abrufen (Metadaten)	Ruft die Liste aller Felder in einem Pflichtfeld ab JiraProjekt.
	Bearbeitbare Felder Abrufen (Metadaten)	Ruft die Liste aller bearbeitbaren Felder in einem Pflichtfeld ab JiraProblem.
	Problemtypen Abrufen (Metadaten)	Ruft die Liste aller Problemtypen in einem erforderlichen ab JiraProjekt.
	Projekte Abrufen (Metadaten)	Ruft die Liste aller ab JiraProjekte.
Projektmanagement	Projekt erstellen	Erstellt ein Projekt in Jira.
	Suchen Sie nach Projekt	Ruft Details des angegebenen Projekts anhand seiner ID oder seines Schlüssels ab.
	Suchen Sie nach Projekten	Ruft Details aller Projekte ab. Hinweis: Diese Aktion funktioniert nur für JiraServer.
	Suchen Sie nach Projektstream	Ruft Details aller Projekte ab. Hinweis: Diese Aktion funktioniert nur für JiraCloud.
	Suchen Sie nach Anwendern, die Projekten zugewiesen werden können	Ruft eine Liste von Anwendern ab, die Problemen in einem oder mehreren Projekten zugewiesen werden können.
Sprintverwaltung	Sprint erstellen	Erstellt einen Sprint in Jira.
	Sprint löschen	Löscht einen Sprint in Jira.
	Suchen Sie 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 JiraCloud-Instanz. Dies ist vergleichbar mit der Story im Plugin „Agile Entwicklung“ von ServiceNow.
	Suchen Sie nach Stories-Stream	Ruft Details aller Stories ab.
	Story Aktualisieren	Aktualisiert eine festgelegte Anzahl von Feldern einer Story in JiraCloud 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 atlassischen Anwenders ab.
	Suchen Sie nach Anwenderstream	Ruft Details aller Atlassianer ab JiraAnwenderabonnements. Hinweis: Diese Aktion kann mit verwendet werden JiraNur Cloud-Abonnement.
	Anwenderstream nach Name suchen	Ruft eine Liste von Anwendern ab, die der Suchzeichenfolge entsprechen. Hinweis: Diese Aktion kann mit verwendet werden JiraNur Serverabonnement.
	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 Anhang aus JiraAn einen beliebigen Datensatz in ServiceNowInstanz. Wenn Sie diese Aktion in einem Subflow verwenden, stellen Sie sicher, dass die Inhalts-URL-Datenpille im Feld „Anhang-URL“ angegeben ist.
	Suchen Sie nach Feldern	Ruft den internen Namen und andere Details der erforderlichen Feldbezeichnung in ab Jira.
	Problem aus Kommentar suchen	Ruft die Details des Problems ab, indem die Nutzlast für den angegebenen Kommentar analysiert wird. Sie können diese Aktion im Prozess verwenden JiraWebhook-Subflow für lokalen Jira-Server, wenn nur kommentarbezogene Informationen ohne Details zu angegeben sind JiraProblem. Wenn beispielsweise nur Kommentarinformationen angegeben sind, analysiert diese Aktion die Nutzlast und extrahiert die Problemdetails.
	Suchen Sie nach dem neuesten Anhang zu dem Problem	Ruft den neuesten Anhang für das angegebene Problem von ab Jira. 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 neueste Anhang eines Problems in JiraIst nicht wie der angegebene Anhang.
	Suchen Sie 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 JiraEntspricht nicht dem angegebenen Kommentar.
Webhook-Verwaltung	Webhooks suchen	Ruft Details aller registrierten Webhooks von ab JiraInstanz.
	Webhook Abonnieren	Registriert einen Webhook in JiraInstanz.
	Webhook abbestellen	Löscht den registrierten Webhook in JiraInstanz.
	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 Account-Anforderungen

Die JiraErfordert das Generieren eines API-Tokens für JiraVerwenden Sie Ihren Atlassian-Account.

Alias-Anforderungen für Verbindungen und Anmeldeinformationen

IntegrationHub Verwendet Aliasse, um Verbindungs- und Anmeldeinformationen sowie OAuth-Anmeldeinformationen zu verwalten. Durch die Verwendung eines Alias müssen bei der Verwendung mehrerer Umgebungen nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfiguriert werden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie keine Aktionen aktualisieren, die die Verbindung verwenden.

Diese Spoke verwendet JiraAlias-Datensatz. Um diese Aktionen zu verwenden, müssen Sie erstellen c Einbindungsdatensatz und ein c Datensatz mit Anmeldeinformationen und ordnen Sie sie dem zu JiraAlias-Datensatz.

Diese Aktionen verwenden REST-Aufrufe, die auf einer Instanz ausgeführt werden können. Verwenden Sie den Verbindungsdatensatz, der dem zugeordnet ist JiraAlias zum Konfigurieren des Endpunkts, für den die Aktionen durchgeführt werden Ausführen.