Home
Home
Englische Version
Support
Impressum
23.1 Release ►

    Main Navigation

    • Vorbereitung
      • Einrichten InSpire G7 Primärsystem und Standby Appliances
      • Initiale Inbetriebnahme für G7 Appliances
      • Konnektoren
    • Datenquellen
      • Anleitung zur Datenintegration mithilfe eines SQL Datenbank-Beispiels
      • Handbuch - Mindbreeze InSpire Insight Apps in Salesforce
      • Indizierung benutzerspezifischer Eigenschaften (SharePoint 2013 Connector)
      • Indizierung benutzerspezifischer Objekttypen (Documentum)
      • Installation & Konfiguration - Atlassian Confluence Sitemap Generator Add-On
      • Installation & Konfiguration - Caching Principal Resolution Service
      • Installation & Konfiguration - Jive Sitemap Generator
      • Installation & Konfiguration - Mindbreeze InSpire Insight Apps in Microsoft SharePoint On-Prem
      • Konfiguration - Atlassian Confluence Connector
      • Konfiguration - Best Bets Connector
      • Konfiguration - Box Connector
      • Konfiguration - COYO Connector
      • Konfiguration - Data Integration Connector
      • Konfiguration - Documentum Connector
      • Konfiguration - Dropbox Connector
      • Konfiguration - Egnyte Connector
      • Konfiguration - GitHub Connector
      • Konfiguration - Google Drive Connector
      • Konfiguration - GSA Adapter Service
      • Konfiguration - HL7 Connector
      • Konfiguration - IBM Connections Connector
      • Konfiguration - IBM Lotus Connector
      • Konfiguration - Jira Connector
      • Konfiguration - JiveSoftware Jive Connector
      • Konfiguration - JVM Launcher Service
      • Konfiguration - LDAP Connector
      • Konfiguration - Microsoft Azure Principal Resolution Service
      • Konfiguration - Microsoft Dynamics CRM Connector
      • Konfiguration - Microsoft Exchange Connector
      • Konfiguration - Microsoft File Connector (Legacy)
      • Konfiguration - Microsoft File Connector
      • Konfiguration - Microsoft Graph Connector
      • Konfiguration - Microsoft Project Connector
      • Konfiguration - Microsoft SharePoint Connector
      • Konfiguration - Microsoft SharePoint Online Azure Principal Resolution Service
      • Konfiguration - Microsoft SharePoint Online Connector
      • Konfiguration - Microsoft Stream Connector
      • Konfiguration - Microsoft Teams Connector
      • Konfiguration - Salesforce Connector
      • Konfiguration - SAP KMC Connector
      • Konfiguration - SemanticWeb Connector
      • Konfiguration - ServiceNow Connector
      • Konfiguration - Sitecore Connector
      • Konfiguration - Web Connector
      • Konfiguration - Yammer Connector
      • Konfiguration - Zoho Connector
      • Mindbreeze InSpire Insight Apps in Microsoft SharePoint Online
      • Mindbreeze Web Parts in Microsoft SharePoint
      • Whitepaper - Web Connector Erweiterte JavaScript Anwendungsfälle
    • Konfiguration
      • CAS Authentifizierung
      • Cognito JWT Authentifizierung
      • Cookie Authentifizierung
      • Handbuch - MMC_ Services
      • Handbuch - SSO mit Microsoft AAD oder AD FS
      • Handbuch - Text Classification Insight Services
      • I18n Item Transformation
      • Konfiguration - Alternative Suchvorschläge und automatische Sucherweiterung
      • Konfiguration - Backend Credentials
      • Konfiguration - Benachrichtigungen
      • Konfiguration - Box Connector
      • Konfiguration - CJK Tokenizer Plugin
      • Konfiguration - CSV Metadata Mapping Item Transformation Service
      • Konfiguration - Entity Recognition
      • Konfiguration - Export Funktionalität
      • Konfiguration - External Query Service
      • Konfiguration - Filter Plugins
      • Konfiguration - Gesammelte Ergebnisse
      • Konfiguration - GSA Late Binding Authorization
      • Konfiguration - Identity Conversion Service - Replacement Conversion
      • Konfiguration - InceptionImageFilter
      • Konfiguration - Index-Servlets
      • Konfiguration - Item Property Generator
      • Konfiguration - Kerberos Authentfizierung
      • Konfiguration - Management Center Menü
      • Konfiguration - Metadata Reference Builder Plugin
      • Konfiguration - Metadaten Anreicherung
      • Konfiguration - Mindbreeze InSpire
      • Konfiguration - Mindbreeze Proxy Umgebung (Remote Connector)
      • Konfiguration - NLQA Plugin
      • Konfiguration - Outlook Add-In
      • Konfiguration - Personalisierte Relevanz
      • Konfiguration - Plugin Installation
      • Konfiguration - Principal Validation Plugin
      • Konfiguration - Profile
      • Konfiguration - QueryExpr Label Transformer Service
      • Konfiguration - Reporting Query Log
      • Konfiguration - Reporting Query Performance Tests
      • Konfiguration - Request Header Session Authentisierung
      • Konfiguration - Verteilte Konfiguration (Windows)
      • Konfiguration - Vokabulare für Synonyme und Autovervollständigung
      • Konfiguration von Vorschaubildern
      • Mindbreeze Personalization
      • Mindbreeze Property Expression Language
      • Mindbreeze Query Expression Transformation
      • Non-Inverted Metadata Item Transformer
      • SAML Authentifizierung
      • Spracherkennung mit dem LanguageDetector Plugin
      • Trusted Peer Authentication für Mindbreeze InSpire
      • Verwendung von InSpire-Snapshots in einer CI_CD-Umgebung
    • Betrieb
      • app.telemetry Statistiken zu Suchanfragen
      • Bereitstellen von app.telemetry Informationen mittels SNMPv3 auf G7 Appliances
      • Handbuch - Filemanager
      • Handbuch - Indizierungs- und Suchlogs
      • Handbuch - Kommandozeilenwerkzeuge
      • Handbuch - Sichern & Wiederherstellen
      • Handbuch - Updates und Downgrades
      • Handbuch - Verteilter Betrieb (G7)
      • Index Betriebskonzepte
      • Inspire Diagnose und Ressourcen Monitoring
      • Konfiguration - app.telemetry Dashboards für Nutzungsanalyse
      • Konfiguration - Nutzungsanalyse
      • Löschung der Festplatten
      • Mindbreeze InSpire SFX Update
      • Wiederherstellen des Lieferzustandes
    • Anwenderhandbuch
      • Browser Extension
      • Cheat Sheet
      • iOS App
      • Tastaturbedienung
    • SDK
      • api.v2.alertstrigger Schnittstellenbeschreibung
      • api.v2.export Schnittstellenbeschreibung
      • api.v2.personalization Schnittstellenbeschreibung
      • api.v2.search Schnittstellenbeschreibung
      • api.v2.suggest Schnittstellenbeschreibung
      • api.v3.admin.SnapshotService Schnittstellenbeschreibung
      • Einbetten des Insight App Designers
      • Entwicklung eines API V2 Search Request Response Transformer
      • Entwicklung von Insight Apps
      • Java API Schnittstellenbeschreibung
      • SDK Übersicht
    • Release Notes
      • Release Notes 20.1 Release - Mindbreeze InSpire
      • Release Notes 20.2 Release - Mindbreeze InSpire
      • Release Notes 20.3 Release - Mindbreeze InSpire
      • Release Notes 20.4 Release - Mindbreeze InSpire
      • Release Notes 20.5 Release - Mindbreeze InSpire
      • Release Notes 21.1 Release - Mindbreeze InSpire
      • Release Notes 21.2 Release - Mindbreeze InSpire
      • Release Notes 21.3 Release - Mindbreeze InSpire
      • Release Notes 22.1 Release - Mindbreeze InSpire
      • Release Notes 22.2 Release - Mindbreeze InSpire
      • Release Notes 22.3 Release - Mindbreeze InSpire
      • Release Notes 23.1 Release - Mindbreeze InSpire
    • Sicherheit
      • Bekannte Schwachstellen
    • Produktinformation
      • Produktinformation - Mindbreeze InSpire - Standby
      • Produktinformation - Mindbreeze InSpire
    Home

    Path

    Sure, you can handle it. But should you?
    Let our experts manage the tech maintenance while you focus on your business.
    See Consulting Packages

    Atlassian Jira Connector

    Installation und Konfiguration

    Copyright ©

    Mindbreeze GmbH, A-4020 Linz, 2023.

    Alle Rechte vorbehalten. Alle verwendeten Hard- und Softwarenamen sind Handelsnamen und/oder Marken der jeweiligen Hersteller.

    Diese Unterlagen sind streng vertraulich. Durch die Übermittlung und Präsentation dieser Unterlagen alleine werden keine Rechte an unserer Software, an unseren Dienstleistungen und Dienstleistungsresultaten oder sonstigen geschützten Rechten begründet. Die Weitergabe, Veröffentlichung oder Vervielfältigung ist nicht gestattet.

    Aus Gründen der einfacheren Lesbarkeit wird auf die geschlechtsspezifische Differenzierung, z.B. Benutzer/-innen, verzichtet. Entsprechende Begriffe gelten im Sinne der Gleichbehandlung grundsätzlich für beide Geschlechter.

    InstallationPermanenter Link zu dieser Überschrift

    Vor der Installation des Atlassian Jira Connector muss sichergestellt werden, dass der Mindbreeze Server installiert und der Atlassian Jira Connector in der Lizenz inkludiert ist. Zur Installation oder Aktualisierung des Konnektors verwenden Sie bitte das Mindbreeze Management Center.

    Konfiguration von Index und CrawlerPermanenter Link zu dieser Überschrift

    Navigieren Sie auf den Reiter „Indices“ und klicken Sie rechts oben auf „+ Add Index“, um einen neuen Index zu erzeugen.


    Fügen Sie eine neue Datenquelle durch Klick auf „Add Data Source“ rechts oben hinzu. Wählen Sie die Category „Atlassian Jira“ aus.

    Setzen Sie folgende notwendige Einstellungen:

    „User Name“

    Benutzername eines Jira-Benutzers der Leserechte auf die REST-API besitzt. ACHTUNG: Dieser Benutzer muss dieselbe Zeitzonen Präferenz gesetzt haben, wie die Zeitzone des Jira Servers.

    Wenn „Disable ACLs“ gesetzt ist, können die Felder „User Name“ und „Password“ leer gelassen werden. Für weitere Informationen zu „Disable ACLs“ siehe weiter unten.

    „Password“

    Passwort des Benutzers

    Wenn Sie eine Jira Cloud-Instanz indizieren möchten, muss hier stattdessen das API-Token gesetzt werden. Wie Sie diesen erstellen, erfahren Sie im nächsten Abschnitt.

    „Atlassian Jira URL“

    URL unter der die Jira REST-API erreichbar ist

    Um ein API-Token zu erstellen, gehen Sie auf https://id.atlassian.com/manage-profile/security/api-tokens und melden Sie sich mit dem Jira-Benutzer an, der für das Crawlen verwendet werden soll. Klicken Sie anschließend auf „Create API token“ um das Token zu erstellen, zu benennen und dann zu kopieren.

    Folgende Einstellungen sind optional:

    „REST API Base Path“ (Advanced Setting)

    Normalerweise befindet sich die REST API auf <Atlassian Jira URL>/rest/api/2. Wenn der Pfad zu Ihrer API ein anderer als „rest/api/2“ ist, können Sie diesen hier angeben.

    „Is Cloud“

    Aktivieren Sie diese Option beim Indizieren einer Jira Cloud-Instanz.

    „Ignore Proxy“

    Verwendet keinen HTTP-Proxy, unabhängig was im „Network“-Tab konfiguriert ist.

    „Page Size“ (Advanced Setting)

    Setzt die Anzahl der Elemente, die gleichzeitig abgerufen werden. Standardwert: 100 (Hinweis: höhere Werte können den Durchsatz erhöhen, erhöhen jedoch auch den Arbeitsspeicherverbrauch)

    „Crawler Thread Count“ (Advanced Setting)

    Anzahl der Threads, die zum Herunterladen von Inhalten verwendet werden. Standardwert: 20

    „Issue Constraint (JQL)“

    Eine JQL (Jira Query Language) Query, welche die zu crawlenden Issues einschränkt. Z.B.: project = "Machine Learning". Sie können in der Jira-Oberfläche die „Advanced Search“ verwenden, um eine passende JQL Query zu erstellen. Hier finden Sie auch die offizielle Jira-Dokumentation zur JQL Syntax. Hinweis: die Keywords „ORDER BY“ dürfen nicht verwendet werden, da dies der Crawler selbst verwendet. Eine Änderung dieser Option erfordert einen Re-Index. Standardwert: nicht gesetzt (Alle Issues werden gecrawlt)

    „Max Attachment Size (MB)“

    Wenn gesetzt, werden größere Anhänge nicht indiziert. (Hinweis: ein Wert von 0 indiziert gar keine Anhänge)

    „Attachment Extension Include Pattern“

    Wenn gesetzt, werden nur Anhänge indiziert, dessen Dateinamenerweiterungen auf diesen regulären Ausdruck matchen. (Java Regex) z.B. odt|xls|doc|docx

    „Include Issue Comments“

    Wenn gesetzt, werden Kommentare zu Issues als HTML-Content gesetzt.

    „Disable ACLs“

    Wenn gesetzt, werden keine ACL-Informationen Indiziert. Nur für öffentliche Server verwenden. Aktivieren Sie außerdem in der Index-Konfiguration die Option „Unrestricted Public Access“ (Advanced Setting) und deaktivieren Sie die Option „Enforce ACL Evaluation“. ACHTUNG: Alle Dokumente am Index sind anschließend für jeden Benutzer einsehbar)

    „Ignore Issue Level Security“

    Im Normalfall ist diese Option nicht aktiviert und alle (Jira-)Issues, bei denen „Issue Level Security“ gesetzt ist, sind aus Sicherheitsgründen für niemanden zugänglich.

    Wenn diese Option aktiviert wird, werden ebenfalls alle Issues, die die Eigenschaft „Issue Level Security“ besitzen gecrawlt und die relevanten Projekt-Berechtigungen werden verwendet.

    ACHTUNG: Wenn Sie diese Option aktivieren, können Benutzer möglicherweise Issues sehen, die sie in Jira nicht sehen sollen. Verwenden Sie diese Option nur, wenn das für Ihren Anwendungsfall kein Problem darstellt.
    Issues mit „Issue Level Security“ sind an dem roten, geschlossenen Schlosssymbol zu erkennen.

    „Issue Level Security Override“

    Die Projektrollen (eine pro Zeile), welche auf alle Issues Zugriff haben sollen, bei denen „Issue Level Security“ gesetzt ist.
    Wenn diese Option leer ist, sind alle Issues, bei denen „Issue Level Security“ gesetzt ist, aus Sicherheitsgründen für niemanden zugänglich.

    ACHTUNG: Wenn Sie diese Option aktivieren, können Benutzer möglicherweise Issues sehen, die sie in Jira nicht sehen sollen. Verwenden Sie diese Option nur, wenn das für Ihren Anwendungsfall kein Problem darstellt.
    Issues mit „Issue Level Security“ sind an dem roten, geschlossenen Schlosssymbol zu erkennen.

    Wenn Ihre Jira Instanz eine große Menge an Daten enthält, wird empfohlen, Delta Crawling zu aktivieren:

    „Enable Attachment Delta Crawling“

    Wenn aktiv, werden nur Anhänge heruntergeladen, die noch nicht indiziert worden sind

    „Enable Issue Delta Crawling“

    Wenn aktiv, werden nur neue oder geänderte Issues heruntergeladen. Issues, die in Jira gelöscht wurden, werden bei einem Delta Crawl Run nicht gelöscht. Um auch gelöschte Issues aus dem Index zu entfernen, müssen Sie einen „Delete Job Schedule“ konfigurieren (siehe Beschreibung weiter unten).

    „Crawler State Persistence Directory“

    Wenn „Enable Issue Delta Crawling“ aktiv ist, wird ein Verzeichnis benötigt, um Statusinformationen zum letzten Delta Crawl Run (oder Delete Crawl Run) abzulegen. Wenn kein Verzeichnis angegeben wird, werden diese Statusinformationen standardmäßig in „/data/servicedata/<service-id>“ abgelegt.

    „Delete Job Schedule“

    Wenn „Enable Issue Delta Crawling“ aktiv ist, wird empfohlen, hier eine Extended Cron Expression anzugeben (eine Dokumentation und Beispiele zu den cron expressions finden Sie hier). Wird der Cron Job getriggert, wird direkt nach dem nächsten Delta Crawl Run ein Delete Crawl Run gestartet, um Issues und Attachments zu löschen, die nicht mehr in Jira vorhanden sind. Bitte beachten Sie, dass ein Delete Crawl Run bei großen Datenmengen sehr lange dauern kann.

    Speichern Sie anschließend die Konfiguration und starten Sie neu.

    Konfiguration des Principal Resolution ServicePermanenter Link zu dieser Überschrift

    Wenn Sie im Crawler die Option „Disable ACLs“ angehakt haben, können Sie die Konfiguration des Atlassian Jira Caching Principal Resolution Services überspringen. Ansonsten ist der Atlassian Jira Caching Principal Resolution Service notwendig, damit Gruppen, Rollen etc. korrekt aufgelöst werden können und die Jira Berechtigungen korrekt in Mindbreeze InSpire funktionieren.

    Navigieren Sie auf den Reiter „Indices“, scrollen sie runter zum Abschnitt „Services“ und klicken Sie rechts auf „+ Add Service“, um einen neuen Atlassian Jira Caching Principal Resolution Service hinzuzufügen. Wählen Sie das „Service“ „Atlassian Jira Caching Principal Resolution Service“ aus.

    Setzen Sie folgende notwendige Einstellungen:

    „User Name“

    Benutzername eines Jira-Benutzers der Leserechte auf die REST-API besitzt.

    „Password“

    Passwort des Benutzers

    „Atlassian Jira URL“

    URL unter der die Jira REST-API erreichbar ist

    Folgende Einstellungen sind optional:

    „REST API Base Path“ (Advanced Setting)

    Normalerweise befindet sich die REST API auf <Atlassian Jira URL>/rest/api/2. Wenn der Pfad zu Ihrer API ein anderer als „rest/api/2“ ist, können Sie diesen hier angeben.

    „Is Cloud“

    Aktivieren Sie diese Einstellung beim Indizieren einer Jira Cloud-Instanz.

    „Ignore Proxy“

    Verwendet keinen HTTP-Proxy, unabhängig was im „Network“-Tab konfiguriert ist.

    „Page Size“ (Advanced Setting)

    Setzt die Anzahl der Elemente, die gleichzeitig abgerufen werden. Standardwert: 100 (Hinweis: höhere Werte können den Durchsatz erhöhen, erhöhen jedoch auch den Arbeitsspeicherverbrauch)

    „Maximum Request Threads“

    Die maximale Anzahl von Threads, die für Jira API-Anfragen verwendet werden. Ein höherer Wert kann die Cache-Update-Dauer verkürzen, führt jedoch zu einer höheren Last am Jira-Server.

    „CSV Access Logging Mode“

    HTTP Anfragen zur Jira API werden in access-log.csv im Log-Verzeichnis protokolliert. Mit dieser Option kann gesteuert werden, wie detailliert diese protokolliert werden. Folgende Auswahlmöglichkeiten stehen zur Verfügung:

    Normal

    Alle API Responses (ohne HTTP Body wenn HTTP Status Code 200), Standardwert.

    Debug

    Alle API Responses (inklusive HTTP Body). Diese Option soll nur zu Debuging-Zwecken verwendet werden, da die Logs dadurch sehr groß werden können.

    Disabled

    CSV Logging für Jira API Requests ist deaktiviert.

    Wählen Sie anschließend auf ihrem Jira Index den gerade konfigurierten „Caching Principal Resolution Service“ aus.

    Weitere Config Optionen zu den Cache, Health Check und den Webservice Services sind in der Dokumentation des Caching Principal Resolution Service beschrieben: https://help.mindbreeze.com/de/index.php?topic=doc/Installation--Konfiguration---Caching-Principal-Resolution-Service/index.htm

    AppendixPermanenter Link zu dieser Überschrift

    EinschränkungenPermanenter Link zu dieser Überschrift

    • Jira Permission Schemes mit “Group custom field value” in den “Browse projects” Permission werden nicht unterstützt.
    • Jira Issue-Level Security wird nicht unterstützt. Jira Issues mit gesetztem Security Level können in der Suche nicht gefunden werden, wenn ACLs aktiviert sind.

    TroubleshootingPermanenter Link zu dieser Überschrift

    “ERROR: CrawlRun was unsuccessful” mit URL Pfad “/search” und “status code 400”Permanenter Link zu dieser Überschrift

    Höchstwahrscheinlich ist ein "Issue Constraint (JQL)" konfiguriert, welche den Fehler verursacht

    1. Überprüfen Sie die konfigurierte "Issue Constraint (JQL)" mithilfe der Funktion "Advanced Search" in Jira direkt. Die JQL muss jedenfalls innerhalb von Jira funktionieren.
    2. Prüfen Sie, ob es in der JQL keine unerlaubten Schlüsselwörter gibt, wie z.B. "ORDER BY". Entfernen Sie diese Schlüsselwörter.
    3. Der Crawler verwendet nicht die eingegebene JQL direkt, sondern transformiert diese noch, bevor damit Jira-API-Requests durchgeführt werden. Die eingegebene JQL wird in Klammern gesetzt und es werden noch weitere Einschränkungen und Sortierungen durchgeführt. Die transformierte JQL wird dann als URL-Parameter bei den Jira-API-Requests übergeben. In der Fehlermeldung wird dann die effektive URL angezeigt.
      Z.B.: https://jira.mycompany.com/ rest/api/2/search?jql=%28proect+%3D+%22Big+Data%22%29+AND+updated+%3E%3D+%272020-06-17+17%3A10%27+ORDER+BY+updated+ASC&startAt=100&maxResults=100&fields=key,updated,description...

    Dies entspricht decodiert z.B. der effektiven JQL: (proect = \"Big Data\") AND updated >= '2020-06-17 17:10' ORDER BY updated ASC

    Wenn Sie die effektive URL aus der Fehlermeldung in einem Browser aufrufen, bekommen Sie eine detaillierte Fehlermeldung, was genau mit der effektiven JQL nicht stimmt. Z.B.: "Field 'proect' does not exist or you do not have permission to view it."

    Crawl-Run wird nicht fertiggestellt oder gewisse Issues wurden nicht indiziertPermanenter Link zu dieser Überschrift

    Wenn die Zeitzonenpräferenz des Benutzers der zum Crawlen verwendet wird und dem Jira Server unterschiedlich sind, kann es zu verschiedenen Fehlern kommen. Zum Beispiel ist es möglich, dass der Crawl-Run nie fertiggestellt wird oder gewisse Issues übersprungen werden.

    Den ersteren Fall kann man erkennen, indem man das Log des Crawlers überprüft. Wenn immer wieder dieselben URLs aufgerufen werden, kann der Grund dafür an der Zeitzone des Benutzers liegen.

    Deshalb sollte immer sichergestellt werden, dass die Zeitzone des Users mit der des Servers übereinstimmt. Diese kann im Profil des Users eingestellt werden.

    PDF herunterladen

    • Konfiguration - Jira Connector

    Inhalt

    • Installation
    • Konfiguration von Index und Crawler
    • Konfiguration des Principal Resolution Service
    • Appendix

    PDF herunterladen

    • Konfiguration - Jira Connector