Fehlerbehebung bei Smartsheet Jira Connector

Smartsheet Jira Connector ist als Premium-Angebot erhältlich. Wenn Sie Smartsheet Jira Connector für Ihren Plan erworben haben, melden Sie sich an, um Workflows zwischen Smartsheet und Jira zu erstellen.

Wer kann das nutzen?

Pläne:

  • Advanced Work Management
  • Business
  • Enterprise

Berechtigungen:

Um einen Workflow zu erstellen oder zu bearbeiten, sind die folgenden Berechtigungen erforderlich:

  • Sie müssen ein lizenzierter Benutzer in der Smartsheet-Umgebung sein. Dies umfasst mindestens eine Bearbeiterberechtigung für Sheets, die dem Workflow zugeordnet sind.
  • Sie benötigen ein funktionales Jira-Konto mit entsprechenden Zugriffsrechten auf die Jira-Projekte, für die Sie einen Workflow erstellen möchten.
  • Ihr Systemadministrator muss die Einstellung „Restrict Users“ in Jira Connector aktivieren und Ihnen die Rolle „Smartsheet Jira Connector User“ zuweisen. Diese Rolle kann im Smartsheet Admin Center oder direkt auf der Oberfläche von Jira Connector zugewiesen werden.

Find out if this capability is included in Smartsheet Regions or Smartsheet Gov.

Synchronisierungsfehlern suchen und beheben

Sie können folgende Ressourcen verwenden, um nach Workflow-Fehlern zu suchen und sie zu beheben:

  • Run History (Ausführungsverlauf): Rufen Sie diese Seite auf, um die Anzahl der Synchronisierungsfehler für einen Workflow sowie die Fehlermeldung und Problemdetails anzuzeigen. 
  • Fehlerberichte: Wenn Probleme auftreten, erhalten der Workflow-Inhaber und die Person, die das Feld oder die Workflow-Zeile bearbeitet hat, die das Problem verursacht hat, eine E-Mail.
  • Fehlerspalte: In dieser Spalte in Ihrem Sheet finden Sie Meldungen zu Zeilen mit einem Synchronisierungsproblem.

Run History

Nachdem Sie einen Workflow erstellt haben, können Sie auf die Seite Run History (Ausführungsverlauf) zugreifen, um den Synchronisierungsverlauf und alle aufgetretenen Fehler anzuzeigen. Sie können auf den Run History zugreifen, indem Sie unter Letzte Ausführung den Zeitstempel Ihres Workflows auswählen.

Brandfolder Image
Jira last run log

Ihr Run History enthält die folgenden Ausführungstypen:

  • Sync to Smartsheet: Workflow-Ausführungen für Änderungen aus Jira, die mit Smartsheet synchronisiert wurden.
  • Sync to Jira: Workflow-Ausführungen für Änderungen aus Smartsheet, die mit Jira synchronisiert wurden.
  • Filtered Row Finder: Workflow-Ausführungen für Änderungen an Problemen, die gemäß Ihrer Workflow-Konfiguration herausgefiltert werden sollen. Filtered Row Finder ist ein Hintergrundprozess, der alle 2 Stunden ausgeführt wird. Herausgefilterte Vorgänge werden der Hierarchie Vom Connector herausgefiltert – Nicht synchronisiert Ihres Sheets hinzugefügt. Der Prozess Filtered Row Finder wird nur mit automatisierten Workflow-Typen ausgeführt. Dieser Prozess wird auch dann ausgeführt, wenn Sie keine Filter in Ihrem Workflow angegeben haben.

Häufige Fehler 

Wenn Probleme auftreten, erhalten der Workflow-Inhaber und die Person, die das Problem/die Zeile im Workflow bearbeitet hat, der das Problem verursacht hat, E-Mail-Fehlerberichte. Hier sind einige häufige Fehler und Probleme.

Feld [Gruppe] nicht festgelegt

Betreff

Details

Details

Vorgänge, für die in Jira kein Gruppierungswert festgelegt ist, werden in einer Hierarchie mit dem Namen „Feldgruppe nicht festgelegt“ angezeigt

Fehlerbehebung

Geben Sie Vorgängen in Jira einen Gruppierungswert an

Vom Connector herausgefiltert – nicht synchronisiert

Betreff

Details

Details

Dies geschieht mit dem Salesforce und Jira Connector. Die Zeile Vom Connector herausgefiltert – nicht synchronisiert fügt keine Zeilen mit Synchronisierungsproblemen hinzu; es werden nur in Jira gelöschte Elemente oder Zeilen angezeigt, die die Kriterien des Jira-Filters nicht mehr erfüllen und nicht mit Jira synchronisiert werden.

Fehlerbehebung

  • Wenn es Zeilen mit Fehlern oder Synchronisierungsproblemen gibt, wird im Feld Sync Error (Synchronisierungsfehler) ein Fehler angezeigt, der behoben werden muss, bevor die Zeile erfolgreich mit Jira synchronisiert wird.
  • Der Connector erstellt automatisch die Zeile Vom Connector herausgefiltert – nicht synchronisiert, und alle Zeilen, die nicht synchronisiert werden, werden darunter eingerückt.

Feld kann nicht festgelegt werden. It is not on the appropriate screen or is unknown.

Betreff

Details

Details

Dieser Fehler wird angezeigt, wenn der festzulegende Feldwert nicht im Bildschirm „Edit“ (Bearbeiten) von Jira angezeigt wird. Nur Felder im Bildschirm „Edit“ in Jira können über den Smartsheet Jira Connector bearbeitet werden.

Fehlerbehebung

  • Konfigurieren Sie den Bildschirm „Bearbeiten“ in Jira und fügen Sie das angegebene Feld hinzu. Weitere Informationen finden Sie unter Defining a Screen (Bildschirm definieren) in der Jira-Dokumentation.
  • Ordnen Sie das angegebene Feld nur in eine Richtung zu (Jira zu Smartsheet). Dadurch wird eine unidirektionale Karte erstellt; Änderungen in Smartsheet werden nicht in Jira zurückgeschrieben.

Einrichtung der Benachrichtigungen fehlgeschlagen

Betreff

Details

Details

Der Jira Connector kann keine Änderungsbenachrichtigungen von Jira über den Webhook empfangen. In diesem Fall kann der Connector Aktualisierungen in Jira nicht erkennen und sie mit Smartsheet synchronisieren.

Fehlerbehebung

Webhook-Registrierung in Jira überprüfen:

  • Melden Sie sich bei Jira als Systemadministrator an.
  • Gehen Sie zu Einstellungen > System > WebHooks.
  • Vergewissern Sie sich, dass ein Webhook für den Smartsheet Jira Connector aufgeführt und aktiv ist. Wenn er fehlt oder deaktiviert ist, erhält der Connector keine Benachrichtigungen.

Überprüfen Sie die Berechtigungen von Jira-Systemadministratoren:

  • Das Konto, das für die Verbindung von Jira verwendet wird, muss über Systemadministratorrechte verfügen. Wenn die Berechtigungen kürzlich geändert wurden, wurde der Webhook möglicherweise entfernt oder die Registrierung aufgehoben.

Connector erneut authentifizieren:

  • Im Jira Connector zu Einstellungen gehen und sich erneut mit einem Jira-Systemadministratorkonto authentifizieren. Dadurch wird versucht, den Webhook erneut zu registrieren.

Auf Jira-Firewall- oder Netzwerkeinschränkungen prüfen (nur selbst gehostetes Jira):

  • Wenn Sie eine selbst gehostete (lokale) Jira-Instanz verwenden, stellen Sie sicher, dass der Server die Connector-Endpunkte von Smartsheet erreichen kann. Überprüfen Sie die Voraussetzungen für eine erfolgreiche selbst gehostete Einrichtung, um sicherzustellen, dass Ihr Netzwerk richtig konfiguriert ist.

Stellen Sie sicher, dass keine Jira-Anwendungsupdates den Webhook beschädigt haben:

  • Nach Jira-Versions-Upgrades oder Plugin-Updates können Webhooks manchmal entfernt werden. Vergewissern Sie sich, dass auf Ihrer Jira-Instanz eine unterstützte Version ausgeführt wird.

 Wenn das Problem nach den oben genannten Schritten weiterhin besteht, wenden Sie sich an den Smartsheet-Support und stellen Sie eine WEX-Datei (Workflow Execution Support Info) zur Verfügung, um die Lösung zu beschleunigen. Siehe Generieren einer WEX-Datei für den Support weiter unten.


Generieren Sie eine WEX-Datei für den Support

Wenn Sie die obigen Schritte zur Fehlerbehebung durchgearbeitet haben und immer noch Hilfe benötigen, hilft das Generieren einer WEX-Datei (Workflow Execution Support Info) vor der Kontaktaufnahme dem Team, Ihr Problem schneller zu diagnostizieren und das Hin und Her zu reduzieren.

Die WEX-Datei enthält detaillierte Informationen zu Ihrem Workflow, einschließlich Feldzuordnungen, Synchronisierungsrichtung und Filterkonfigurationen. Sie enthält keine Smartsheet- oder Jira-Daten.

Jeder Smartsheet-Systemadministrator oder Connector-Administrator kann eine WEX-Datei wie folgt generieren:

  1. Melden Sie sich unter https://connectors.smartsheet.com/c/jira an.
  2. Wählen Sie im Jira Connector-Dashboard den Zeitstempel in der Spalte Run Date (Ausführungsdatum) für den betroffenen Workflow aus. Dadurch wird der Ausführungsverlauf des Workflows geöffnet.
  3. Wählen Sie unter Last Run (Letzte Ausführung) den Zeitstempel für die letzte Ausführung aus.
  4. Öffnen Sie auf der folgenden Seite das Hamburger-Menü (drei horizontale Linien oben links) und wählen Sie Download Workflow Execution Support Info aus.

Hängen Sie diese Datei an, wenn Sie Ihr Support-Ticket einreichen oder es für den Smartsheet-Support freigeben.

Die WEX-Datei liegt im JSON-Format vor. Der Support analysiert es auf seiner Seite – Sie müssen es nicht selbst interpretieren.

Häufig gestellte Fragen

Wenn Probleme auftreten, werden Fehlerberichte per E-Mail an den Workflow-Inhaber und die Person gesendet, die den Fehler/die Zeile im Workflow bearbeitet hat, der/die zu dem Problem geführt hat. Hier sind einige häufige Fehler und Probleme.

Problem: Zeilenreihenfolge ist nicht wie erwartet

Wenn Sie einen automatisierten Workflow ausführen, werden Probleme aufsteigend nach „Issue Key“ (Vorgangsschlüssel) sortiert, auch wenn sie in Jira anders sortiert sind. Verwenden Sie die Zeilengruppierung, um Probleme zu sortieren, die mit einem automatischen Workflow synchronisiert werden.

Bei manuellen Workflows wird der Prozess „Filtered Row Finder“ nicht ausgeführt. In diesem Fall können Sie die Zeilen in Ihrem Sheet manuell sortieren.

Wenn Sie Probleme manuell sortieren möchten, während Sie weiterhin einen automatisierten Workflow verwenden, gehen Sie wie folgt vor:

  1. Synchronisieren Sie Jira mit einem anderen Sheet.
  2. Verwenden Sie eine sheetübergreifende INDEX/MATCH- oder VLOOKUP-Formel, um die Werte mithilfe des „Issue Key“ in Ihr Hauptsheet zu übertragen. Beispielformel: =INDEX({Bereich mit zurückzugebendem Wert}, MATCH([Suchwert]@row, {Bereich mit Suchwert}, 0))

Problem konnte nicht in Jira gespeichert werden

Sie benötigen Schreibberechtigungen für die verknüpften Jira-Projekte, um Daten darin zu speichern.

Daten werden nach Filteraktualisierungen nicht aus einem Sheet entfernt

Smartsheet löscht keine aus Jira abgerufenen Daten, da jede Zeile wichtige Spaltendaten, Anlagen oder Kommentare enthalten kann.
Wenn die Jira-Probleme in Ihrem Sheet die Kriterien des Workflow-Filters nicht mehr erfüllen, erstellt Smartsheet oben den Abschnitt Vom Connector herausgefiltert – nicht synchronisiert, in dem die vom Connector herausgefilterten Informationen erhalten bleiben. Sämtliche Zeilen, die herausgefiltert werden, werden erst dann synchronisiert, wenn sie die Filterkriterien wieder erfüllen. Und diese Zeilen können gelöscht werden, wenn Ihr Team sie nicht mehr im Sheet benötigt.

Fehler beim Aktualisieren einer Fehlerspalte in Smartsheet

Eine Fehlermeldung wird angezeigt, wenn Sie die Spalte „Synch.-Fehler“ aus dem verknüpften Sheet entfernen. Stellen Sie sicher, dass das Sheet die Spalte „Synch.-Fehler“ enthält, denn sie ist erforderlich. Sie können Ihren Workflow bearbeiten, um die Spalte „Synch.-Fehler“ wieder Ihrem Sheet zuzuordnen. Weitere Informationen finden Sie unter „Workflow ändern“.

Spalte „Fehler“

Diese Spalte wird vom Connector automatisch Ihrem Sheet hinzugefügt und enthält Details zu Synchronisierungsproblemen, die für die Zeile auftreten. 

 

..is not a valid user for the given JIRA project

Diese Nachricht kann angezeigt werden, wenn eine ungültige E-Mail-Adresse in ein mit Jira synchronisiertes Smartsheet-Feld eingegeben wird, was Probleme bei der Kontaktsynchronisierung verursachen kann. 

Zudem kann dieser Fehler in Jira Cloud auftreten, wenn der Benutzer dem Projekt in Jira nicht zugewiesen ist oder wenn externe Services (wie Smartsheet Jira Connector) in Jira daran gehindert wurden, E-Mail-Adressen anzuzeigen. Eine benutzerspezifische Konfiguration kann geändert werden, indem Sie auf Profile > Manage your account > Profile and visibility zugreifen und die Option Who can see this? bearbeiten. Einstellung für das Kontaktfeld unten. Wenn diese Option auf Only you and the admins festgelegt ist, kann Jira Connector nicht auf die E-Mail-Adressinformationen des Benutzers mit dieser Einstellung zugreifen und das E-Mail-Feld wird nicht ausgefüllt.

Wenn ich versuche, auf den Jira Connector zuzugreifen, wird die Meldung angezeigt, dass ich zum Durchführen dieser Aktion nicht berechtigt bin. Was kann ich tun?

Möglicherweise verfügen Sie noch nicht über die erforderlichen Berechtigungen für den Zugriff auf Jira Connector. Wenden Sie sich an Ihren Smartsheet-Systemadministrator, um Hilfe zu erhalten. 

Erfahren Sie , wie Sie Ihren Systemadministrator kontaktieren.