Jira Data Center

​

Überblick

Dieser Konnektor verbindet eine selbst betriebene Jira-Data-Center- oder Jira-Server-Instanz mit Novaplan AI. Für eine von Atlassian gehostete Instanz verwenden Sie den Jira-Cloud-Konnektor. Die Anmeldeverfahren und REST-APIs der beiden Varianten sind verschieden. Synchronisiert werden Projekte, Vorgänge, Kommentare, Anhänge, Benutzer, Gruppen sowie Projekt- und Anwendungsrollen. Beschreibungen, Status, Prioritäten, Labels, benutzerdefinierte Felder, Verknüpfungen und übergeordnete Vorgänge können so durchsucht werden. Die Sichtbarkeit richtet sich nach Projekt-Berechtigungsschemata und der Sicherheit einzelner Vorgänge.

​

Voraussetzungen und Rechte

Die Jira-Instanz muss über HTTPS aus der Novaplan-Umgebung erreichbar sein. Verwenden Sie als Base URL die Stammadresse, etwa https://jira.example.com, gegebenenfalls mit Basispfad wie /jira. Eine Vorgangs-URL mit /browse/ ist dafür ungeeignet. Für die Integration empfiehlt sich ein eigenes Dienstkonto. Jira-Benutzer werden über E-Mail-Adressen ihren Novaplan-AI-Konten zugeordnet. Laut Quellanleitung können bereits anderweitig bekannte Benutzer auch bei verborgener Jira-Adresse erkannt werden; öffentlich sichtbare Adressen sind für diesen Konnektor nicht zwingend erforderlich. User email visibility ist eine globale Einstellung der Jira-Administration. Eine Änderung auf Public sollte nur nach Prüfung Ihrer Datenschutz- und Sicherheitsregeln erfolgen.

​

Anmeldemethode wählen

OAuth-Anwendungen aus der Atlassian Developer Console gehören zu Jira Cloud und funktionieren hier nicht. Beide Data-Center-Methoden synchronisieren dieselben Inhalte.

​

Personal Access Token erstellen

1. Melden Sie sich mit dem gewünschten Jira-Konnektorkonto an.
2. Öffnen Sie über das Profilbild Profile → Personal Access Tokens.
3. Wählen Sie Create token, benennen Sie es zum Beispiel Novaplan AI Jira Connector und setzen Sie ein Ablaufdatum gemäß Ihrer Richtlinie.
4. Erstellen und kopieren Sie das Token sofort. Jira zeigt es nur einmal an; nach Verlust erstellen Sie ein neues.

​

Verbindung in Novaplan AI einrichten

1. Öffnen Sie Workspace Settings → Connectors, suchen Sie Jira Data Center und wählen Sie + Setup.
2. Wählen Sie auf Authenticate Instance unter Authentication method Personal Access Token oder Basic Authentication.
3. Geben Sie die Base URL und das Token ein. Bei Basic Authentication verwenden Sie stattdessen den Jira-Username und das Password; der Benutzername ist nicht zwingend die E-Mail-Adresse.
4. Wählen Sie Next. Nach der Zugangsdatenprüfung öffnet sich Configure Records.

Wird das Token oder Passwort geändert, aktualisieren Sie es in Authenticate Instance. Diese Zugangsdaten werden nicht automatisch erneuert.

​

Synchronisierung und Suche einrichten

Unter Configure Records wählen Sie Scheduled oder Manual. Der voreingestellte Sync Interval beträgt 60 Minuten. Eine Echtzeit-Synchronisierung ist nicht vorgesehen. Die Projektliste wird aus Ihrer Jira-Instanz geladen. Projekt- und Datumsfilter begrenzen die verarbeiteten Projekte und Vorgänge. Der zugängliche Jira-Data-Center-Konnektor liest dennoch Nutzer und Gruppen für Identitäts- und Berechtigungszuordnungen; die Inhaltsfilter garantieren deshalb nicht, dass keine weiteren Quellmetadaten gelesen werden. Die getrennten Optionen Index issues und Index issue and comment attachments steuern die Aufnahme synchronisierter Inhalte in die KI-Suche, nicht allein den Abruf aus Jira; beide sind laut Quellanleitung standardmäßig eingeschaltet. Kommentare werden im jeweiligen Vorgang mit indexiert und nicht als getrennte Datensätze gespeichert. Wählen Sie Save und anschließend Start syncing now oder I’ll do it later. Über Indexing Progress können Sie den Lauf verfolgen. Beim ersten Lauf und nach Änderungen an Synchronisierungsfiltern erfolgt ein vollständiger Abgleich. Spätere Läufe verwenden Änderungszeiten und projektbezogene Checkpoints. Löschungen werden über das Audit-Log erkannt, wenn das Konnektorkonto darauf Zugriff hat. Kann das Konto das Audit-Log nicht lesen, bleiben gelöschte Vorgänge zunächst im Index. Der Lösch-Fortschrittspunkt bleibt stehen; nach Wiederherstellung des Zugriffs werden die versäumten Löschereignisse nachgeholt. Vorübergehende Fehler beim Lesen von Projektberechtigungen oder Gruppenmitgliedern erhalten die gespeicherten Zugriffe und werden beim nächsten Lauf erneut versucht. Andere Vorgänge werden weiter synchronisiert; ein Lesefehler erweitert oder entzieht dabei keine Rechte. Die Jira-Data-Center-Gruppenliste endet nach 1.000 Gruppen. Projektrollen mit Gruppen jenseits dieser Grenze behalten ihre bisher gespeicherten Mitgliedschaften: Neue Mitglieder erhalten möglicherweise keinen Zugriff, ausgeschiedene behalten unter Umständen ihren bisherigen Zugriff. Prüfen Sie diese Grenze bei großen Instanzen. Scheitert die Verarbeitung eines einzelnen Vorgangs, laufen die übrigen weiter und der Fortschrittspunkt wartet auf einen erneuten Versuch. Nach fünf aufeinanderfolgenden Fehl-Läufen für denselben Vorgang wird er protokolliert und übersprungen; eine spätere Änderung erfasst ihn erneut. Bei anhaltender Begrenzung der Jira-Suchanfragen wird das betroffene Projekt nach drei Versuchen erst beim nächsten Lauf fortgesetzt.

​

Berechtigungen und Ergebnisse prüfen

Der Konnektor nutzt Projekt-Berechtigungsschemata, Projektrollen, Anwendungsrollen und Vorgangssicherheit. Prüfen Sie nach dem ersten Lauf mit Konten aus unterschiedlichen Projektrollen, ob nur zulässige Vorgänge angezeigt werden. Fehlen Rechteinformationen, kann die Suche zu stark eingeschränkt sein. Für agentengesteuerte Änderungen an Jira-Vorgängen wird das getrennte Jira-Data-Center-Toolset benötigt; dieser Konnektor synchronisiert Inhalte für die Suche.

​

Häufige Fragen

Bei Fragen zur Berechtigungszuordnung oder zu fehlenden Vorgängen wenden Sie sich an Novaplan Support.