Mit Jira Cloud for Sheets kannst du Jira-Daten in deine Spreadsheets importieren, indem du bestehende Jira-Filter oder benutzerdefinierte JQL (Jira Query Language) verwendest.

In einem Google Spreadsheet:

1. Klicke auf Erweiterungen und dann auf Add-ons > Add-ons aufrufen...
2. SuchenachJira Cloud for Sheets, bewege den Mauszeiger über das Feld und klicke auf Installieren.
3. Folge den Anweisungen, um dem Add-on Zugriff auf dein Google Spreadsheet zu geben.

1. Öffne ein Google Spreadsheet und klicke auf Erweiterungen → Jira Cloud für Spreadsheets → Open...
2. Klicke auf CONNECT, dadurch öffnet sich ein neues Browserfenster.
3. Wähle die Site, die du hinzufügen möchtest, aus der Liste der verfügbaren Sites aus und klicke auf Accept.

Sobald die Autorisierung erfolgreich war, wirst du zu deinem Google Spreadsheet weitergeleitet und solltest etwas wie das Folgende sehen (auch bekannt als Hamburger-Menü):

Du kannst jetzt Jira Vorgänge in dein Spreadsheet importieren, indem du auf Get issues from Jira klickst und dann eine der folgenden Methoden verwendest:

JQL verwenden

1. Klicke auf Erweiterungen → Jira Cloud for Sheets → Open ... → Get issues from Jira > Import type = JQL.
2. Gib die JQL für die Abfrage an, die du ausführen möchtest. Du kannst auf den Link Open in Jira klicken, um die JQL-Abfrage in Jira zu öffnen und zu testen.
3. Klicke auf GET ISSUES NOW.
4. Jira führt nun die Abfrage aus und gibt alle passenden Vorgänge im aktuellen Blatt zurück.

Verwenden von Filtern

Wenn du Filter auf deiner Jira Cloud Site definiert hast, kannst du sie im Spreadsheet verwenden.

1. Klicke auf Erweiterungen → Jira Cloud for Sheets → Open ... → Get issues from Jira
2. Wähle bei Import type = Filter aus.
3. Wähle deinen Filter aus der Liste der verfügbaren Filter
4. Klicke auf GET ISSUES NOW.
   Du kannst die Anzahl der zurückgegebenen Zeilen mit „Max Rows“ einschränken.

Jira führt die Abfrage aus und gibt alle passenden Vorgänge im aktuellen Blatt zurück. Es sollte ungefähr so aussehen wie in der folgenden Abbildung:

Verwende die JIRA()-Funktion mit JQL

Das Add-on bietet auch eine benutzerdefinierte Google Spreadsheet-Funktion =JIRA(), mit der du Jira von einer Zelle in einem Spreadsheet abfragen kannst:

1. Klicke auf Erweiterungen → Jira Cloud for Sheets → Open... → Settings
2. Aktiviere =JIRA() function for users of this sheet.
3. Lies die Warnung durch und akzeptiere sie.
   Nur Besitzer des Dokuments können diese Funktion aktivieren. Wenn sie aktiviert ist, verwendet diese Funktion die konfigurierte Site und das Jira-Konto des Dokumenteneigentümers, um Jira abzufragen.

Du kannst die Funktion von einer Zelle des Spreadsheets aus verwenden:

Szenario

Gib die Vorgänge im Projekt ProjA zurück, die in der letzten Woche erstellt wurden, und verwende dabei deinen Standardspaltensatz.

Query

=JIRA("project = ProjA and createdDate >= -7d")

Szenario

Alle Vorgänge in ProjA zurückgeben, aber nur den Vorgangsschlüssel, die Zusammenfassung, die Erstellungszeit und den Autor.

Query

Szenario

Die ersten 10 Vorgänge in ProjA zurückgeben, aber nur den Vorgangsschlüssel, die interne ID des Status und eine benutzerdefinierte Spalte mit Leerzeichen in ihrem Namen.

Query

=JIRA(„project = ProjA order by createdDate desc“, „issuekey,status.id,another column“, 0, 10)

Szenario

Alle Vorgänge in ProjA zurückgeben, aber nur den Vorgangsschlüssel, den Zusammenfassungstext, die Erstellungszeit und den Autor.

Query

=JIRA(„Projekt = ProjA“, „issuekey,summary,created,reporter“)

So verbindest du eine weitere Jira Cloud Instanz:

1. Klicke auf Erweiterungen → Jira Cloud for Sheets → Open...
2. Klicke auf das Dropdown-Menü neben deiner aktuellen Instanz und klicke auf Add another site... .
3. Befolge die Anweisungen, um den Zugriff auf das Add-on für die zusätzliche Jira Cloud Site zu ermöglichen.
4. Jetzt kannst du während des Imports zwischen den Sites wechseln.

Ich habe die Funktion =JIRA() aktiviert, aber es wird immer noch ein Fehler angezeigt.

Lösche den Wert in der Zelle, in der du die Funktion =JIRA() verwendest, und drücke die Eingabetaste. Gib die Abfrage erneut ein und sie sollte jetzt funktionieren. Du musst das nur einmal machen (wir arbeiten daran, einen Fehler zu beheben, der dieses Verhalten verursacht).

Das Add-on gibt einen Fehler zurück, wenn ich eine große Anzahl von Vorgängen abfragen will.

Das Add-on sollte mit Abfragen von bis zu 10.000 Vorgängen problemlos funktionieren. Wenn du mehr Vorgänge abfragen willst, solltest du die Funktion =JIRA() verwenden, mit der du die Ergebnisse paginieren kannst. Achte darauf, dass du die Ergebnisse in der Abfrage sortierst.

Wenn du z. B. 20000 Vorgänge zurückgeben willst, gibst du dies in eine Zelle ein, um die ersten 10.000 Vorgänge zurückzugeben:

=JIRA("project = ProjA order by updated desc", "", 0, 10000)

Und das in einer anderen Zelle, um die folgenden 10.000 Vorgänge zurückzugeben:

=JIRA("project = ProjA order by updated desc", "", 10000, 10000)

Das Add-on gibt leere Zellen für Nutzerdaten zurück.

Das Add-on respektiert die Datenschutzeinstellungen der einzelnen Nutzer*innen für Profildaten. Wenn ein Nutzer seine Profildaten für privat erklärt hat, gibt das Add-on in Spalten wie Zugewiesene Person oder Autor einen leeren Wert für diesen Nutzer zurück.

Welche Funktionen bietet Jira Cloud for Sheets?

Jira Cloud for Sheets ist ein Add-on, das du in Google Spreadsheets verwenden kannst, um Daten von Jira Cloud Sites zu importieren:

• basierend auf einer JQL (Jira Query Language)
• basierend auf markierten/vordefinierten Filtern in Jira Cloud

Wie lege ich fest, welche Spalten in das Spreadsheet eingefügt werden?

Das Add-on nutzt deine Spalteneinstellungen in der Jira Cloud beim Importieren von Daten. Du kannst verschiedene Spalteneinstellungen für dein Konto und auch für Filter vornehmen. Wenn in Jira Cloud keine benutzer-/filterspezifischen Spalten konfiguriert sind, verwendet das Add-on die Standardspalten des Systems.

Du kannst verschiedene Spalten festlegen, indem du z. B. die Funktion =JIRA() verwendest:

=JIRA("project=MYP","issueType,reporter,another column")

=JIRA("project=MYP","issueType.id,reporter.displayName")

Wie kann ich dieses Add-on deinstallieren?

Du kannst das Add-on deinstallieren, indem du auf Erweiterungen > Add-ons verwalten > Verwalten > Deinstallieren klickst.

Kann ich dieses Add-on verwenden, wenn ich kein lizenziertes Atlassian-Produkt habe?

Nein, du brauchst eine Lizenz/ein Abonnement für Jira Cloud, um dieses Add-on zu nutzen.

Kann ich dieses Add-on mit Jira Server verwenden?

Nein, das Add-on funktioniert nur mit Jira Cloud Sites für Jira Work Management, Jira Software und Jira Service Management. Erkundige dich bei deinem Jira Administrator, wenn du dir nicht sicher bist, ob Cloud oder Server.

Wie trenne ich das Spreadsheet von einer oder mehreren verbundenen Jira Cloud-Instanzen?

Du kannst alle deine konfigurierten Jira Cloud Sites vom Add-on abkoppeln. Von einem Spreadsheet aus:

1. Klicke auf Erweiterungen → Jira Cloud for Sheets → Open...
2. Klicke auf die Schaltfläche Disconnect Site
3. Du wirst auf die Seite deines Atlassian-Identitätsprofils weitergeleitet, auf der du das Add-on/die App durch Klicken auf „Zugriff entfernen“ deaktivieren kannst.

Ist dieses Add-on GDPR-konform?

Ja, und wir speichern keine persönlichen Nutzerdaten. Weitere Informationen findest du unter dem folgenden Link:

• https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/