Mit Jira verbinden

Konzept-Informationen

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
Der 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 vom 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 einen 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 den erstellten Token, und fügen Sie ihn 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.Analytics
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 der 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: vollständiges PEM-Zertifikat Pfad zu einer lokalen Datei, die das Zertifikat enthält der öffentliche Schlüssel der MD5-Fingerabdruck (Hexadezimalwerte können auch entweder durch Leerzeichen oder Doppelpunkte getrennt werden) der SHA1-Fingerabdruck (Hexadezimalwerte können auch entweder durch Leerzeichen oder Doppelpunkte getrennt werden) 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 Der Treiber führt eine HTTP-Standardauthentifizierung durch. DIGEST Der Treiber führt eine HTTP-DIGEST-Authentifizierung durch. NEGOTIATE In Abhängigkeit vom zutreffenden Authentifizierungsprotokoll ruft der Treiber einen NTLM- oder Kerberos-Token ab. PROPRIETARY Der Treiber generiert keinen NTLM- oder Kerberos-Token. Sie müssen diesen Token im Autorisierungskopf der HTTP-Anforderung angeben.	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: benutzer@domäne Domäne\Benutzer	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 Wenn die URL eine HTTPS-URL ist, wird der Konnektor die TUNNEL-Option verwenden. Wenn die URL eine HTTP-URL ist, wird der Konnektor die NEVER-Option nutzen (Standard). ALWAYS Für die Verbindung ist stets SSL aktiviert. NEVER Für die Verbindung ist SSL nicht aktiviert. TUNNEL Die Verbindung erfolgt durch einen Tunneling-Proxy: Der Proxy-Server öffnet eine Verbindung mit dem Remote-Host und der Datenverkehr fließt durch den Proxy.	AUTO

Updates von Datenkonnektoren

Wenn Sie Analytics, oder den Robots-Agent 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.)
	Anmerkungen	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