Mit Jira verbinden
Jira ist eine Cloud-Plattform oder eine serverbasierte Plattform für die Verfolgung von Softwareproblemen und für das Projektmanagement. Verwenden Sie den Jira-Datenkonnektor, um auf Jira-Daten Ihres Unternehmens zuzugreifen.
Vorbereitungen
Jira-Anmeldeinformationen
Für eine Verbindung mit Jira müssen Sie die folgenden Informationen einholen:
- Jira-Benutzername
- Das Jira-API-Token (Cloud-Konto) oder das Jira-Kennwort (Serverinstanz)
- Der Hostname der Jira-Plattform Ihres Unternehmens
Hilfe für die Zusammenstellung der Verbindungsvoraussetzungen erhalten Sie von dem Jira-Administrator Ihrer Organisation. Falls Ihr Administrator Ihnen nicht weiterhelfen kann, sollten Sie oder Ihr Administrator den Jira-Support kontaktieren.
API-Token abrufen
Um die Verbindung zu einem Jira-Cloud-Konto aufzunehmen, ist zur Kontoauthentifizierung ein API-Token notwendig. Um ein Token zu erstellen, melden Sie sich an Ihrem Atlassian-Konto an. Navigieren zur Seite „API-Tokens“, und klicken Sie auf API-Token erstellen. Kopieren Sie das erstellte Token, und fügen Sie es in das Feld API-Token im Bereich Datenverbindungseinstellungen ein.
Tabelle „Issues“ in Jira
Die Jira-Tabelle „Issues“ kann viele benutzerdefinierte Felder enthalten, die Ihre Organisation erstellt hat. Aus diesem Grund behandelt die Jira-API die Problemtabelle dynamisch, wobei die Felder der Tabelle bei jeder Verbindung mit der Tabelle zusammengestellt werden. Wenn Ihr Jira-Administrator eine Änderung an den benutzerdefinierten Feldern der Problemtabelle vornimmt, können Analyseskripts, die eine bestimmte Feldauswahl annehmen, scheitern.
Importieren Sie Daten manuell über das Fenster „Datenzugriff“ in Analytics, um dieses Problem zu lösen. Kopieren Sie den Befehl ACCESSDATA aus dem Protokoll, und verwenden Sie ihn zur Aktualisierung Ihres Skripts. Aktualisieren Sie die Feldspezifikationen im Skriptkörper um die Änderungen der Problemtabelle.
Jira-Verbindung erstellen
- Wählen Sie aus dem Analytics-Hauptmenü Importieren > Datenbank und Anwendung.
- Auf der Registerkarte Neue Verbindungen im Abschnitt ACL-Konnektoren wählen Sie Jira.
Tipp
Sie können die Liste verfügbarer Konnektoren filtern, indem Sie in das Feld Verbindungen filtern eine Suchzeichenfolge eingeben. Die Konnektoren sind alphabetisch aufgelistet.
- Im Bereich Datenverbindungseinstellungen rufen Sie die Verbindungseinstellungen auf und klicken unten innerhalb des Bereichs auf Speichern und verbinden.
Sie können den standardmäßigen Verbindungsnamen akzeptieren oder einen neuen Namen eingeben.
Die Verbindung für Jira wird in der Registerkarte Bestehende Verbindungen gespeichert. In Zukunft können Sie sich über die gespeicherte Verbindung erneut mit Jira verbinden.
Sobald die Verbindung hergestellt ist, wird das Fenster „Datenzugriff“ im Stagingbereich geöffnet und Sie können den Datenimport beginnen. Hilfe für den Datenimport aus Jira finden Sie unter Mit dem Fenster „Datenzugriff“ arbeiten.
Verbindungseinstellungen
Grundlegende Einstellungen
Einstellung | Beschreibung | Beispiel |
---|---|---|
Host |
Der Hostname des Jira-Cloud-Kontos oder der Jira-Serverinstanz. |
https://your_org.atlassian.net |
Instanzentyp | Der Typ der Jira-Plattform, den Ihr Unternehmen verwendet: cloudbasiert oder lokaler Server | Cloud |
Benutzer | Das Benutzerkonto, das zur Authentifizierung an Jira verwendet wird. | admin_1@your_org.com |
API-Token | Bei einem Jira-Cloud-Konto das Jira-API-Token für den aktuell authentifizierten Benutzer | |
Kennwort |
Bei einer Jira-Serverinstanz das Jira-Kennwort, das zur Authentifizierung des Benutzers verwendet wird |
|
Benutzerdefinierte Felder einschließen | Schließen Sie über die Standardfelder in Jira-Tabellen hinaus auch benutzerdefinierte Felder ein, die von Ihrem Unternehmen hinzugefügt wurden. | wahr |
Erweiterte Einstellungen
Einstellung | Beschreibung | Beispiel |
---|---|---|
Grenze der Schlüsselgröße |
Die maximale Länge einer Primärschlüsselspalte. Wenn die Größe auf „0“ eingestellt wird, wird die ursprüngliche Schlüssellänge wiederhergestellt. Durch diese Eigenschaft überschreibt der Konnektor die gemeldete Länge aller Primärschlüsselspalten. |
255 |
Long Varchar zuordnen |
Kontrolliert, ob eine Spalte als SQL_LONGVARCHAR zurückgegeben wird. Verwenden Sie diese Einstellung, um alle Spalten über einer bestimmten Größe so zuzuordnen, dass sie als SQL_LONGVARCHAR statt SQL_VARCHAR gemeldet werden. |
-1 |
WVarchar zuordnen |
Kontrolliert, ob Zeichenfolgentypen als SQL_WVARCHAR statt SQL_VARCHAR zugeordnet werden. Standardmäßig ist diese Option aktiviert. Zeichenfolgenspalten müssen SQL_WVARCHAR zugeordnet sein, um unterschiedliche internationale Zeichensätze zu unterstützen. „WVarchar zuordnen“ ist daher standardmäßig auf „wahr“ eingestellt. Sie können es auf „falsch“ setzen, wenn Sie stattdessen SQL_VARCHAR verwenden möchten. |
wahr |
Pseudospalten |
Gibt an, ob Pseudospalten der Tabelle ebenfalls als Spalten hinzugefügt werden sollen. Diese Einstellung ist besonders im Entity Framework hilfreich, das Ihnen nicht ermöglicht, einen Wert für eine Pseudospalte anzugeben, solange sie keine Tabellenspalte ist. Der Wert dieser Verbindungseinstellung hat das Format „Tabelle1=Spalte1, Tabelle1=Spalte2, Tabelle2=Spalte3“. Sie können das „*“-Zeichen verwenden, um alle Tabellen und alle Spalten einzuschließen. |
MeineTabelle=* |
SSL-Serverzertifikat |
Das durch den Server bei einer Verbindung mit TLS/SSL zu akzeptierende Zertifikat. Sie können die folgenden Einstellungen festlegen:
Wenn Sie eine TLS/SSL-Verbindung verwenden, kann diese Eigenschaft verwendet werden, um das TLS/SSL-Zertifikat festzulegen, das durch den Server akzeptiert wird. Andere Zertifikate, denen der Computer nicht vertraut, werden abgelehnt. |
C:\cert.cer |
Datumzeit auf GMT konvertieren |
Konvertiert während des Importierens Datumzeit-Felder auf die GMT-Zeitzone. Falls der Wert auf „falsch“ eingestellt ist, werden Datumzeit-Werte auf die Zeitzone des Betriebssystems für den Computer konvertiert, auf dem Analytics ausgeführt wird. |
wahr |
Authentifizierung für Proxy |
Der Authentifizierungstyp, der für die Authentifizierung mit dem unter „Proxy-Server“ angegebenen Proxy zu verwenden ist. Dieser Wert legt den Authentifizierungstyp fest, der für die Authentifizierung mit dem HTTP-Proxy (angegeben durch „Proxy-Server“ und „Proxy-Port“) zu verwenden ist. Hinweis Der Konnektor wird standardmäßig die Proxy-Einstellungen des Systems verwenden, sodass keine weitere Konfiguration notwendig ist. Wenn Sie sich mit einem anderen Proxy verbinden möchten, müssen Sie zusätzlich zur Angabe von „Proxy-Server“ und „Proxy-Port“ den Wert von „Autom. Proxy-Erkennung“ auf „falsch“ setzen. Zur Authentifizierung stellen Sie „Authentifizierung für Proxy“ ein und geben bei Bedarf „Proxy-Benutzer“ und „Proxy-Kennwort“ an. Es gibt folgende Authentifizierungstypen:
|
BASIC |
Autom. Proxy-Erkennung | Gibt an, ob die Proxy-Einstellungen des Systems verwendet werden sollen. Stellen Sie „Autom. Proxy-Erkennung“ auf FALSE ein, falls Sie benutzerdefinierte Proxy-Einstellungen verwenden möchten. Dies hat Vorrang gegenüber anderen Proxy-Einstellungen. | wahr |
Proxy-Benutzer |
Ein Benutzername kann für die Authentifizierung mit dem unter „Proxy-Server“ angegebenen Proxy verwendet werden. Die Optionen „Proxy-Benutzer“ und „Proxy-Kennwort“ werden verwendet, um eine Verbindung mit dem unter „Proxy-Server“ angegebenen HTTP-Proxy aufzunehmen und die Authentifizierung durchzuführen. Sie können eine der verfügbaren Authentifizierungsarten unter „Authentifizierung für Proxy“ angeben. Wenn Sie eine HTTP-Authentifizierung verwenden, geben Sie den Benutzernamen eines Benutzers an, der durch den HTTP-Proxy erkannt wird. Falls Sie eine Windows- oder Kerberos-Authentifizierung verwenden, geben Sie in dieser Eigenschaft einen Benutzernamen in einem der folgenden Formate ein:
|
karl_mustermann@beispiel.de |
Proxy-Kennwort |
Ein Kennwort kann für die Authentifizierung mit dem unter „Proxy-Server“ angegebenen Proxy verwendet werden. Diese Eigenschaft wird für eine Authentifizierung an einem HTTP-Proxy-Server verwendet, der eine NTLM- (Windows), Kerberos- oder HTTP-Authentifizierung unterstützt. Um den HTTP-Proxy festzulegen, können Sie „Proxy-Server“ und „Proxy-Port“ einstellen. Zur Festlegung der Authentifizierung stellen Sie „Authentifizierung für Proxy“ ein. Falls Sie eine HTTP-Authentifizierung nutzen, geben Sie zusätzlich den „Proxy-Benutzer“ und das „Proxy-Kennwort“ für den HTTP-Proxy an. Wenn Sie eine NTLM-Authentifizierung verwenden, stellen Sie „Proxy-Benutzer“ ein und geben in „Proxy-Kennwort“ Ihr Windows-Kennwort an. Dies kann auch notwendig sein, wenn Sie die Kerberos-Authentifizierung abschließen. |
|
Proxy-Server |
Der Hostname oder die IP-Adresse eines Proxy, durch den der HTTP-Datenverkehr geleitet werden soll. Der Hostname oder die IP-Adresse eines Proxy, durch den der HTTP-Datenverkehr geleitet werden soll. Der Treiber kann für die Authentifizierung an einem HTTP-Proxy die Authentifizierungsarten HTTP, Windows (NTLM) oder Kerberos verwenden. Standardmäßig verwendet der Treiber den System-Proxy. Wenn Sie einen anderen Proxy nutzen müssen, legen Sie „Autom. Proxy-Erkennung“ ebenfalls auf „falsch“ fest. |
206.174.193.115 |
Proxy-Port | Der TCP-Port, den der unter „Proxy-Server“ angegebene Proxy verwendet. | 80 |
Proxy-SSL-Typ |
Der SSL-Typ, der für die Verbindung mit dem unter „Proxy-Server“ angegebenen Proxy zu verwenden ist.
|
AUTO |
Updates von Datenkonnektoren
Wenn Sie Analytics, den Robots-Agent oder AX Server aktualisieren, sollten Sie Ihre Skripts für Datenimporte mit einem der Analytics-Datenkonnektoren (Befehl ACCESSDATA) testen.
Es besteht die Möglichkeit, dass Änderungen eines Drittanbieters von Datenquellen oder eines Herstellers von ODBC-Treibern Aktualisierungen eines oder mehrerer Datenkonnektoren erfordert. Über Skripts hergestellte Datenverbindungen müssen unter Umständen aktualisiert werden, um nach wie vor ordnungsgemäß zu arbeiten.
- Import erneut durchführen Die einfachste Möglichkeit, eine Verbindung zu aktualisieren, ist die manuelle Durchführung eines Imports mit dem Fenster „Datenzugriff“ der aktualisierten Version von Analytics. Kopieren Sie den Befehl ACCESSDATA aus dem Protokoll, und verwenden Sie ihn zur Aktualisierung Ihres Skripts.
Hinweis
Bevor Sie sich mit einer Datenquelle verbinden und den Import erneut ausführen, löschen Sie den Cache des Konnektors, um bestehende Tabellennamen zu entfernen.
In der Registerkarte Bestehende Verbindungen des Fensters „Datenzugriff“ wählen Sie
> Cache löschen.
- Feldspezifikationen aktualisieren Unter Umständen müssen Sie auch Feldspezifikationen im Skriptkörper aktualisieren, um die Änderungen des Tabellenschemas in der Datenquelle oder dem ODBC-Treiber anzupassen. Mögliche Änderungen beinhalten Feldnamen, Datentypen von Feldern sowie Feld- und Datensatzlängen.
- Ergebnisse von Filtern überprüfen Sie sollten auch Ergebnisse von Filtern überprüfen, die Sie im Rahmen des Datenimports nutzen. Stellen Sie sicher, dass der Importfilter Datensätze ordnungsgemäß ein- und ausschließt.
Änderungen des Jira-Datenkonnektors
Spezifische Änderungen des Jira-Datenkonnektors sind im Folgenden aufgelistet.
Analytics-Version | Jira-Tabelle | Hinzugefügte Felder | Entfernte Felder |
---|---|---|---|
14.2 |
Attachments |
AuthorAccountId |
AuthorKey ContentEncoded FilePath Name |
Boards |
FilterId (Bestehende Jira-Importe über Skripts, welche dieses Feld referenzieren, funktionieren weiterhin. Das Feld existiert jedoch nicht mehr.) |
||
Comments |
AuthorAccountId UpdateAuthorAccountId |
AuthorKey AuthorName UpdateAuthorKey UpdateAuthorName |
|
IssueChangeLogs |
AuthorAccountId AuthorDisplayName |
AuthorKey |
|
Projects |
LeadAccountId |
LeadKey LeadName Recent |
|
SecurityLevels |
SecuritySchemeId |
Link |
|
Users |
AccountId |
Key Name IncludeInactive |
|
Watchers |
AccountId |
Key Name |
|
Worklogs |
AuthorAccountId UpdateAuthorAccountId |
AuthorName UpdateAuthorName |