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

In einem Google Spreadsheet:

1. Klicke auf Erweiterungen > Add-ons und dann auf Add-ons aufrufen.
2. Suche nach "Jira Cloud for Sheets", bewege den Mauszeiger über den Tab und klicke auf das Programm und wähle dann Installieren aus.
3. Folge den Anweisungen, um dem Add-on Zugriff auf deine Google Sheets-Tabelle zu geben.

1. Öffne ein Google Spreadsheet und wähle Erweiterungen → Jira Cloud for Sheets → Öffnen... aus.
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 Instanzen aus und klicke auf Accept. 

Sobald die Autorisierung erfolgreich war, wirst du zu deinem Google Spreadsheet weitergeleitet und solltest ungefähr folgendes sehen (auch bekannt als das 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:

Die Verwendung von JQL

1. Klicke auf Erweiterungen → Jira Cloud for Sheets → Open ... → Get issues from Jira.
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 aus.
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 "Enable =JIRA() function for users of this sheet"
3. Lies die Warnung und akzeptiere sie.
   
   

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, indem du deine Standardspalten verwendest.

Abfrage

=JIRA("Projekt = ProjA und createdDate >= -7d")

Szenario

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

Abfrage

=JIRA("Projekt = ProjA", "issuekey,summary,created,reporter")

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.

Abfrage

=JIRA("Projekt = 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 Reporter.

Abfrage

=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 Site und klicke auf "Add another site...".
3. Folge den Anweisungen, um den Zugang zum Add-on für die zusätzliche Jira Cloud Site zu ermöglichen.
4. Jetzt kannst du während des Imports zwischen den einzelnen Instanzen 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 durchblättern 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/e Nutzer*in seine/ihre Profildaten als privat eingestuft hat, gibt das Add-on für diesen/diese Nutzer*in einen leeren Wert in Spalten wie assignee oder reporter 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 > Add-ons verwalten > Jira Cloud for Sheets > 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 es sich um Cloud oder Server handelt.

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, wo du die Verbindung zum Add-on/zur App trennen kannst, indem du auf "Remove access" klickst.

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/ (Englisch)