Verwalten Sie Probleme, Benutzer, Stories und Gruppen in Jira. Rufen Sie Jira-Daten ab, die in einem Flow verwendet werden sollen. Verwenden Sie bidirektionale Webhooks, und abonnieren Sie Jira mit einer ServiceNow-Callback-URL.

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 V 5.3.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-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_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 Ihr Jira Instanz 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-Spoke Informationen zum Erstellen eines Verbindungsdatensatzes.
  • Jira Service Desk wird von der Spoke nicht unterstützt.

Jira Webhooks-Modul

Bidirektionale Webhooks können eingerichtet werden, um über die erforderlichen Ereignisse benachrichtigt zu werden. Die Weiterleitungsrichtlinie definiert Bedingungen, die erfüllt sein müssen, um zu benachrichtigen ServiceNow Instanz. 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 Jira Aufgaben.

Die bidirektionalen Webhooks erfordern ein separates Setup und können unabhängig verwendet werden, ohne die Spoke-Aktionen zu verwenden. Standardmäßig ist Jira Die Webhooks-Anwendung ist in verfügbar Jira Und verfügt über die folgenden Module:
  • Jira-Webhook-Registrierungen
  • Jira-Webhook-Weiterleitungsrichtlinien
Verwenden Sie Jira Webhook-Registrierungsmodul zum Zuweisen eines Tokens und Bereitstellen des API-Pfads. Sie müssen hier eine Rückruf-URL generieren und die URL in angeben Jira. Eine standardmäßige Weiterleitungsrichtlinie wird in bereitgestellt Jira Modul „Webhook-Weiterleitungsrichtlinien“. 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
  • Typ des vorherigen Problems
  • Problempriorität
  • Priorität des vorherigen Problems
  • Problemstatus
  • Status des vorherigen Problems
  • 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 im eine Weiterleitungsrichtlinie Jira Webhook-Routing-Richtlinienmodul und geben Sie Bedingungen entsprechend Ihren Anforderungen an. Siehe Richten Sie einen bidirektionalen Webhook für die Jira-Spoke ein Informationen zum Einrichten und Konfigurieren der Webhooks.

Spoke-Subflow

Die Jira Stellt einen Beispiel-Subflow bereit, um verschiedene zu verarbeiten Jira Webhook-Ereignisse. Der verfügbare Beispiel-Subflow ist Prozess Jira Webhooks. Der Prozess Jira Der Webhooks-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 entsprechend 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 ein Informationen 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

Verwenden Sie Auslöser in 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. 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.
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-SpokeIn Flow Designer Zur Automatisierung JiraAufgaben, wenn ein Ereignis in auftritt ServiceNow AI 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 Stream mit Audit-Protokollen suchen Ruft die Anmeldeaktivität für den Atlassian ab Jira Anwenderabonnements.
Hinweis: Diese Aktion wird in unterstützt Jira Server 9 und frühere Versionen, und Jira Cloud.
Stream mit Auditprotokollen suchen (Server 10 und höher) Ruft Audit-Protokolldatensätze aus dem ab Jira Instanz innerhalb eines angegebenen Datumsbereichs.
Hinweis: Diese Aktion wird in unterstützt Jira Server 9 und höher.
Gruppenverwaltung Anwender zu Gruppe hinzufügen Fügt einen bestimmten 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 Jira Nur Cloud-Abonnement.
Stream mit Anwendern anhand von Gruppennamen suchen 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 einen Kommentar hinzu Jira.
Beobachter hinzufügen Fügt den angegebenen Anwender als Beobachter für das angegebene Problem hinzu.
Problem zuweisen Weist das Problem in zu Jira An den Anwender.
Anhang kopieren Kopiert den erforderlichen Anhang, der zugeordnet ist Die ServiceNow Zeichnen Sie das erforderliche Problem in auf 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 Jira Stellt eine Aufgabe in dar ServiceNow AI Platform.
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 Wechselt ein Problem in Jira Von 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.
Problemprioritäten suchen 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.
Stream mit Sprint-Problemen suchen Ruft die Details aller Probleme für den angegebenen Sprint ab.
Übergänge suchen Ruft Informationen zu allen Übergängen für eine bestimmte Problem-ID ab.
Beobachter suchen 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 werden.
Metadatenabruf Erstellbare Felder abrufen (Metadaten) Ruft die Liste aller Felder in einem Pflichtfeld ab Jira Projekt.
Bearbeitbare Felder abrufen (Metadaten) Ruft die Liste aller bearbeitbaren Felder in einem Pflichtfeld ab Jira Problem.
Problemtypen abrufen (Metadaten) Ruft die Liste aller Problemtypen in einem erforderlichen ab Jira Projekt.
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 Jira Server.
Stream mit Projekten suchen Ruft Details aller Projekte ab.
Hinweis: Diese Aktion funktioniert nur für Jira Cloud.
Projekten zuweisbare Anwender suchen 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.
Sprint suchen 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 Jira Cloud-Instanz. Dies ist mit Story im ServiceNow Agile Development-Plugin vergleichbar.
Stream mit Stories suchen Ruft Details aller Stories ab.
Story aktualisieren Aktualisiert eine festgelegte Anzahl 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.
Gruppenmitgliedschaften für Anwender suchen Ruft Details aller Gruppen eines Atlassian-Anwenders ab.
Stream mit Anwendern suchen Ruft Details aller Atlassian ab Jira Anwenderabonnements.
Hinweis: Diese Aktion kann mit verwendet werden Jira Nur Cloud-Abonnement.
Stream mit Anwendern anhand von Namen suchen Ruft eine Liste von Anwendern ab, die der Suchzeichenfolge entsprechen.
Hinweis: Diese Aktion kann mit verwendet werden Jira Nur 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 den Anhang aus Jira An einen beliebigen Datensatz in ServiceNow Instanz. Wenn Sie diese Aktion in einem Subflow verwenden, stellen Sie sicher, dass die Inhalts-URL-Datenpille im Feld Anhang-URL angegeben ist.
Felder suchen 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 Jira Webhook-Subflow für lokalen Jira-Server, wenn nur kommentarbezogene Informationen ohne Details zu angegeben sind Jira Problem. Wenn beispielsweise nur Kommentarinformationen angegeben sind, analysiert diese Aktion die Nutzlast und extrahiert die Problemdetails.
Neuesten Anhang für Problem suchen 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 ist Jira Entspricht nicht dem angegebenen Anhang.
Neuesten Kommentar für Problem suchen 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 angezeigt wird Jira Entspricht nicht dem angegebenen Kommentar.
Server suchen Ruft allgemeine Informationen zur aktuellen Jira-Instanz ab.
Webhook-Verwaltung Webhooks suchen Ruft Details aller registrierten Webhooks von ab Jira Instanz.
Webhook abonnieren Registriert einen Webhook in Jira Instanz.
Webhook abbestellen Löscht den registrierten Webhook in Jira Instanz.
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.

Verfügbare KI-Agents

Installieren Now Assist Für Spokes und beginnen Sie mit der Verwendung der verfügbaren KI-Agents. Weitere Informationen finden Sie unter Now Assist Für Spokes.

Diese Spoke bietet eigenständige KI-Agents, die menschliche Intelligenz nachahmen, um Aufgaben in auszuführen ServiceNow Instanz.
  • In ServiceNow Agentic-System können Sie einen agentischen Workflow erstellen, der aus einem Satz von Anweisungen für ein großes Sprachmodell (LLM) zusammen mit einem oder mehreren eigenständigen KI-Agents besteht, um ein Ziel auszuführen. Siehe Agenten-Workflow erstellen Informationen zum Hinzufügen von KI-Agents zum Erstellen von agentischen Workflows gemäß Ihren Anforderungen und zum Bereitstellen des erforderlichen Auslösers.

    Sie können auch nach anderen verfügbaren KI-Agents suchen und sie Ihrem agentischen Workflow hinzufügen. Weitere Informationen finden Sie unter KI-Agents suchen.

  • Sie können einen Klon des erforderlichen Spoke-KI-Agents erstellen und entsprechend Ihren Anforderungen anpassen. Siehe Duplizieren Sie einen KI-Agent Weitere Informationen zum Erstellen eines Klons.
  • Siehe Now Assist KI-Agents Für Informationen zu KI-Agents.

Verfügbare KI-Agents:

KI-Agent Beschreibung
KI-Agent für Story-Management in Jira Ruft Informationen zu Stories in einem Stream ab, erstellt neue Stories und aktualisiert vorhandene Stories.
KI-Agent für Jira-Dienstprogrammverwaltung Stellt Dienstprogrammaktionen bereit, die Problemanhänge in einen Datensatz kopieren, den neuesten Anhang und Kommentare zu einem Jira-Problem abrufen und Felddetails mithilfe von Bezeichnungen abrufen können. Stellt einen genauen Datenabruf sicher.
KI-Agent für Jira-Anwenderverwaltung Erstellt und entfernt den erforderlichen Anwender. Ruft Informationen zu Anwendern, Gruppenmitgliedschaften und authentifizierten Anwenderaccounts ab.
KI-Agent für Audit-Management in Jira Verwaltet Audit-Protokolle und bietet umsetzbare Einblicke, indem sich wiederholende Aufgaben automatisiert werden.
KI-Agent für Sprint-Management in Jira Löscht Sprints, aktualisiert Sprint-Details und ruft bestimmte Sprint-Informationen ab.
KI-Agent für Jira-Projektmanagement Ruft Projektdetails ab, erstellt neue Projekte, ruft Projektstreams ab und identifiziert Anwender, die Projekten zugewiesen werden können.
KI-Agent für Jira-Gruppenverwaltung Verwaltet Gruppen, indem Aktionen wie das Erstellen und Löschen von Gruppen, das Hinzufügen und Entfernen von Anwendern, das Abrufen von Details zu Gruppen, das Abrufen von Daten und Updates und das Abrufen von Gruppenmitgliedern ausgeführt werden.
KI-Agent für Jira-Problemmanagement Verwaltet Probleme, indem Aktionen wie das Löschen von Problemen, das Verwalten von Übergängen, die Verarbeitung von Beobachtern und die Arbeit mit Anhängen ausgeführt werden. Verwaltet auch Übergänge, Kommentare, Anhänge und Beobachter.
Suchen Sie nach einem KI-Agent?
  • Möglicherweise sind KI-Agents mit installiert Now Assist Anwendung, die nicht in agentischen Workflows verwendet wird. Informationen zum Anzeigen aller in Ihrer Instanz verfügbaren Agents finden Sie unter KI-Agents suchen .
  • Um Service Desk-Mitarbeiter zu finden, die möglicherweise nicht auf Ihrer Instanz installiert sind, besuchen Sie die KI-Agent-Marketplace Auf der ServiceNow Store.
Hinweis: Stellen Sie sicher, dass der Anwender, der einen KI-Agent ausführt, über die erforderlichen Rollen und Berechtigungen verfügt, um auf Daten zuzugreifen oder Vorgänge für Daten in der Tabelle auszuführen, die dem KI-Agent zugeordnet ist.

Jira Account-Anforderungen

Die Jira Erfordert die Generierung eines API-Tokens für Jira Mit Ihrem Atlassian-Account.

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 Jira Alias-Datensatz. Um diese Aktionen zu verwenden, müssen Sie eine erstellen c Onnection-Datensatz und ein c Datensatz mit Anmeldeinformationen und ordnen Sie sie dem zu Jira Alias-Datensatz.

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