- 31 Jul 2023
- 7 Minuten zu lesen
- Drucken
- DunkelHell
- pdf
Airtable Sync-Integration: Jira-Server / Data Center
- Aktualisiert am 31 Jul 2023
- 7 Minuten zu lesen
- Drucken
- DunkelHell
- pdf
Erfahren Sie, wie Sie das Feature Sync-Integration von Airtable nutzen können, um Informationen aus externen Anwendungen in einer einzigen, zentralisierten Tabelle in Airtable zusammenzuführen. Dieser Artikel beschreibt, wie Jira-Server- / Data Server Issues mit einer Airtable Base synchronisiert werden können. Wir verwenden den Begriff Jira-Server sowohl für das Data Center als auch für den Server, da für beide Produkte die gleichen Schritte durchzuführen sind. Diese spezielle Sync richtet sich an Organisationen, die Jira lokal einsetzen. Wenn Ihre Organisation Jira-Cloud verwendet, gehen wir darauf in einem gesonderten Support-Artikel ein. Derzeit ist diese Sync-Quelle ein Feature, das nur im Enterprise-Abo zur Verfügung steht.
Wenn Sie die erste Jira-Server-Synchronisation in Ihrer Organisation einrichten, sollten Sie sich vergewissern, dass Ihre Admins für IT/Airtable/Jira unsere Server- und Firewall-Anforderungen geprüft und die erforderlichen Schritte unternommen haben, bevor Sie Ihr Jira-Server-Konto mit Airtable verbinden. Diese Schritte müssen nur einmal durchgeführt werden.
Einführung
Abo-Verfügbarkeit | Nur für Workspaces im Enterprise-Abo verfügbar |
Berechtigungen |
|
Plattform(en) | Web/Browser, Mac-App und Windows-App |
Ähnliche Themen |
|
Jira-Server-Sync einrichten
Klicken Sie zunächst auf das +-Symbol neben Ihrer Tabellenliste. Wählen Sie dann unter „Daten synchronisieren von“ die Option „Jira-Server“ aus.
Wählen Sie ein bestehendes Jira-Server-Konto aus oder stellen Sie eine Verbindung zu einem neuen Jira-Server-Konto her. Es wird Ihnen eine Liste der Jira-Server-Instanzen angezeigt, die Ihr*e Airtable Admin eingerichtet hat. Wählen Sie die Jira-Server-Instanz aus, die Sie zum Erstellen der synchronisierten Tabelle verwenden möchten, um eine Verbindung zu einem Jira-Server-Konto herzustellen. Wenn Sie den gewünschten Server nicht finden, müssen Sie sich an das Team wenden, das für Ihr Airtable Konto zuständig ist, damit der Server in die Liste aufgenommen wird.
Nachdem Sie auf „Weiter“ geklickt haben, werden Sie aufgefordert, Airtable für die Verbindung mit Ihrem Jira-Server-Konto zu autorisieren. Weitere Informationen zur Authentifizierung finden Sie weiter unten.
Sobald Sie mit einem Jira-Server verbunden sind, können Sie auswählen, welchen Issue-„Filter“ Sie für die Erstellung von Airtable Datensätzen verwenden möchten.
Wenn Sie die Fehlermeldung „Das Konto konnte nicht autorisiert werden“ erhalten, hat das verbundene Konto möglicherweise das Ratenlimit der Jira-REST-API erreicht.
Für diese Sync stehen nur Filter zur Verfügung, die mit einem Sternchen markiert sind. Hilfe beim Einrichten eines neuen Filters oder beim Hinzufügen eines Filters zu Ihren Favoriten finden Sie in der Dokumentation von Atlassian. Wichtig: Wählen Sie einen Filter mit Konditionen, die sich nicht ändern. Wenn sich die Konditionen eines Filters in Jira ändern, werden Datensätze, die nicht mehr übereinstimmen, zusammen mit allen in Airtable vorgenommenen Ergänzungen gelöscht.
Wenn Sie beispielsweise einen Filter synchronisiert haben, der nur offene Bugs enthält und ein Bug geschlossen wird, wird der Airtable Datensatz zusammen mit allen Kommentaren und Aktivitäten sowie anderen Felddaten, die möglicherweise hinzugefügt wurden, gelöscht. Wird derselbe Bug erneut geöffnet, wird ein neuer Airtable Datensatz erstellt.
Wir empfehlen daher, einen Filter zu wählen, der sich wahrscheinlich nicht ändern wird.
Nachdem Sie auf „Weiter“ geklickt haben, werden Ihnen zwei Optionen für die Synchronisierung angeboten. Folgende Felder können synchronisiert werden:
- Alle Felder aus der Quellansicht (Jira-Filter) einschließlich aller Felder, die von Jira zukünftig hinzugefügt werden.
- Bestimmte Felder aus der Quellansicht (Jira-Filter).
Wenn Sie sich für die Synchronisierung bestimmter Felder entscheiden, wird ein Menü angezeigt, in dem Sie jedes einzelne Feld, das Sie mit Jira synchronisieren möchten, aktivieren können.
Nachstehend finden Sie weitere Informationen über Jira-Felder.
Bevor Sie mit der Erstellung Ihrer synchronisierten Tabelle beginnen, können Sie in den Einstellungen festlegen, wie oft die Synchronisierung erfolgen soll und wie Datensätze behandelt werden sollen, die aus der Quelle (Jira) gelöscht oder ausgeblendet werden. Sie können aus folgenden Optionen auswählen:
- Die Häufigkeit der Synchronisierung. Zurzeit gibt es die Optionen „manuelle Synchronisierung“ und „automatische Synchronisierung“, die etwa alle 5 Minuten erfolgt.
- Ob gelöschte Datensätze (Issues im ausgewählten Jira-Filter) aus der Airtable Tabelle entfernt werden sollen oder nicht. In der Standardeinstellung werden gelöschte Ereignisse entfernt.
Klicken Sie auf die Schaltfläche „Tabelle erstellen“, sobald Sie die gewünschten Einstellungen ausgewählt haben. Der Synchronisierungsvorgang ruft alle Issues im ausgewählten Jira-Filter ab und erzeugt Airtable Datensätze.
Welche Jira-Felder werden unterstützt?
Nachfolgend finden Sie eine Liste aller Felddaten, die von Jira bereitgestellt werden und die mit der nativen Sync-Konfiguration von Airtable synchronisiert werden können:
Issue-Schlüssel | Priorität | Übergeordnet |
Zusammenfassung | Bezeichnungen | Umgebung |
Beschreibung | Zeitaufwand | Betrifft die Versionen |
Status | Aggregieren | Epic-Name |
Projekt | Zeitaufwand | Sprint |
Art des Issues | Verbleibende Zeit | Ersteller*in des Issues |
Erstellt | Insgesamt verbleibende Zeit | Gekennzeichnet |
Aktualisiert | Ursprüngliche Schätzung | Story-Point-Schätzung |
Komponenten | Fälligkeitsdatum | Startdatum |
Story Points | Farbe des Issues | |
Fix-Versionen | Zugewiesen an |
Diese Liste umfasst nur benutzerdefinierte Felder, nicht die oben genannten Systemfelder. Die Namen und Arten entsprechen den benutzerdefinierten Feldern auf der Seite /ViewCustomFields im Jira-Server.
> Einstellungen > Issues > benutzerdefinierte Felder
Feldart „Benutzerdefiniert“ | Hinweise |
---|---|
Zahlenfeld | Standard |
Kontrollkästchen | Standard |
Liste auswählen (Mehrfachauswahl/Einzelauswahl) | Standard |
Optionsschaltflächen | Standard |
Datums-/Zeitauswahl | Standard |
Datumsauswahl | Standard |
Bezeichnungen | Standard |
Textfeld (mehrzeilig/einzeilig) | Standard |
Benutzerauswahl (einzelne*r Benutzer*in) | Standard Als Klartext synchronisiert. |
URL-Feld | Standard |
Globaler Rang | Fortgeschritten |
Feld „Jira-Sprint“ | Fortgeschritten |
Ursprüngliche Story Points | Fortgeschritten Kann in einem Issue nur einmal verwendet werden. |
Ziel-Start | Fortgeschritten |
Ziel-Ende | Fortgeschritten |
Benutzerauswahl (mehrere Benutzer*innen) | Fortgeschritten |
Schalter „Ausgeblendeter Job“ | Fortgeschritten |
Kontrollkästchen „Job“ | Fortgeschritten |
Projektauswahl (einzelnes Projekt) | Fortgeschritten |
Textfeld (schreibgeschützt) | Fortgeschritten |
Benutzerauswahl (mehrere Benutzer*innen) | Fortgeschritten |
Die Namen von „vorab gespeicherten/gesperrten Feldern“ werden auch in Jira als benutzerdefinierte Felder betrachtet. Jira-Benutzer*innen sind nicht berechtigt, andere benutzerdefinierte Felder mit diesen Namen zu erstellen.
Feldname | Feldfunktion | Hinweise |
---|---|---|
Epic-Farbe | Farbe des Epic | |
Epic-Link | Epic-Linkrelation | Wird nur angezeigt, wenn es sich bei dem Issue NICHT um ein Epic handelt |
Epic-Name | Name des Epic | Wird nur angezeigt, wenn es sich bei dem Issue um ein Epic handelt |
Epic-Status | Status des Epic | Wird nur angezeigt, wenn es sich bei dem Issue um ein Epic handelt |
Rang | Globaler Rang | Fortgeschritten |
Sprint | Feld „Jira-Sprint“ | Fortgeschritten |
Ursprüngliche Story Points | Ursprüngliche Story Points | Fortgeschritten |
Ziel-Start | Datum Ziel-Start | Fortgeschritten |
Ziel-Ende | Datum Ziel-Ende | Fortgeschritten |
Feldname | Feldart | Hinweise |
---|---|---|
Liste auswählen | Kaskadierend | Fortgeschritten |
Übergeordnete Verknüpfung | Unbekannt | Fortgeschritten – dieses Feld kann nicht eingestellt werden |
Team | Unbekannt | Fortgeschritten – dieses Feld kann nicht eingestellt werden |
Versionsauswahl | Einzelversion / mehrere Versionen | Fortgeschritten |
Entwicklung | Unbekannt | Fortgeschritten – dieses Feld kann nicht eingestellt werden |
Gruppenauswahl | Einzelne/mehrere Gruppe(n) | Fortgeschritten |
Jira-Versionshistorie „Freigegeben“ | Fortgeschritten |
Sicherheits- und OAuth-Bereiche
Authentifizierung
Um Anfragen von einzelnen Benutzer*innen in Ihrer Jira-Server-Instanz zu authentifizieren, verwendet die Jira-Server-Integration auf Airtable OAuth. Der Bildschirm für die OAuth-Einwilligung sieht wie folgt aus:
Airtable kann nur auf die Issues und Filter zugreifen, auf die der*die Benutzer*in, der*die die Jira-Synchronisierung hergestellt hat, Zugriff hat. Deaktiviert der*die Benutzer*in, der*die eine Jira-Synchronisierung hergestellt hat, sein*ihr Jira oder Airtable Konto, funktioniert die Synchronisierung nicht mehr.
Jira-Server-Bereiche
Airtable ermöglicht die Integration mit dem Jira-Server (On-Premises) über OAuth 1.0a. Sie müssen keine Bereiche angeben, und die Berechtigungen der Integration entsprechen den im Jira-Server gewährten individuellen Berechtigungen. Weitere Informationen finden Sie in der Jira-Dokumentation, die hier eingesehen werden kann.
Die Tokens werden zwischen Airtable und den Jira-Servern sicher über HTTPS übertragen. Auf der Seite von Airtable werden die Tokens in Datenbanken gespeichert, die im Ruhemodus verschlüsselt sind.
FAQs
Airtable kann nur auf die Issues und Filter zugreifen, auf die der*die Benutzer, der*die die Jira-Synchronisierung hergestellt hat, Zugriff hat.
Im Gegensatz zum Feature der Jira-Cloud-Sync-Integration von Airtable kann die Jira-Server-/Data-Center-Synchronisierung nur Informationen aus den Filtern ziehen, die mit Sternchen markiert sind.
Wird das verbundene Jira-Konto deaktiviert, funktioniert die Synchronisierung nicht mehr.
Benutzerdefinierte Felder, die auf den in Jira integrierten Feldarten basieren, werden unterstützt, andere Arten von benutzerdefinierten Feldern werden jedoch möglicherweise nicht unterstützt. Weitere Einzelheiten hierzu siehe oben.
Es können maximal 10.000 Issues synchronisiert werden. Dieses Limit setzen wir, um eine angemessene Leistung zu gewährleisten.
Ja. Um Ihren Jira-Server zu schützen, legen wir standardmäßig ein Ratenlimit von 5 Anfragen pro Sekunde für die API-Anfrage fest, die Airtable an Ihren Jira-Server sendet. Wenn Sie Fragen oder Bedenken bezüglich dieses Limits haben, wenden Sie sich bitte an das für Ihr Airtable Konto zuständige Team.
Darüber hinaus ist die API von Jira in Bezug auf die Datenmenge, die mit jeder Anfrage übertragen werden kann, sehr begrenzt. Es ist von einer Synchronisierungsleistung im Bereich von 1 Sekunde pro 100 Issues auszugehen. Wir empfehlen Ihnen, die Filter so zu wählen, dass Sie Ihre Anfrage möglichst eingrenzen.
Ja, aktuell unterstützt dieser Airtable Sync-Typ die Jira-Software Version 7.13 oder höher.