Freigeben über


Atlassian Jira Data Center Microsoft 365 Copilot Connector (Vorschau)

Der Jira Data Center Microsoft 365 Copilot-Connector ermöglicht es Ihrem organization, Jira Data Center-Probleme und zugehörige Daten zu indizieren, sodass sie innerhalb des Microsoft 365-Ökosystems leicht auffindbar und umsetzbar sind.

Dieser Artikel richtet sich an Microsoft 365-Administratoren, die für die Konfiguration, Ausführung und Überwachung des Jira Data Center Microsoft 365 Copilot-Connectors verantwortlich sind. Sie ergänzt die allgemeinen Anweisungen unter Einrichten Microsoft 365 Copilot Connectors im Microsoft 365 Admin Center.

Funktionen

Erweiterte Copilot-Funktionen: Benutzer können Fragen in natürlicher Sprache zu Jira-Problemen und Projektdaten in Microsoft 365 Copilot stellen. Zum Beispiel:

  • "Fassen Sie die offenen Probleme im Projekt alpha zusammen."

  • "Zeige mir alle Fehler mit hoher Priorität, die diese Woche eingereicht wurden."

Unterstützung der semantischen Suche: Benutzer können Abfragen in natürlicher Sprache in Microsoft Search eingeben, um hochgradig relevante und kontextreiche Antworten zu Jira-Problemen und -Projekten zu erhalten.

Hinweis

Der Connector ist nur mit Jira Data Center Version 8.14 und höher kompatibel.

Durch die Verwendung des Jira Data Center Microsoft 365 Copilot-Connectors können Teams ihre Jira-Umgebung lokal beibehalten und gleichzeitig von leistungsstarken Microsoft Search- und Copilot-Funktionen profitieren, um sicherzustellen, dass kritische Probleme und Projektdetails sofort auffindbar und umsetzbar sind.

Voraussetzungen

  1. Installieren des Microsoft 365 Copilot Connector-Agents (GCA)

Zum Indizieren Ihres Jira Data Center-Inhalts müssen Sie den GCA auf einem Windows-Computer im selben Netzwerk wie der Jira Data Center-Standort installieren. Weitere Informationen finden Sie unter Installieren des Graph-Connector-Agents. Sie müssen der Administrator für den Microsoft 365-Mandanten Ihres organization und der Administrator für die Jira-Website Ihrer organization sein.

Hinweis

Wenn Sie den GCA bereits installiert haben, stellen Sie sicher, dass er auf Version 3.1.3.0 oder höher aktualisiert wurde.

  1. Installieren des Jira Data Center-Plug-Ins

Weitere Informationen finden Sie unter Jira Data Center Microsoft 365 Copilot Connector | Atlassian Marketplace.

Hinweis

Dieses Plug-In funktioniert mit den Jira Data Center-Versionen 8.10.0 bis 10.5.1.

Erste Schritte

Auswählen des Anzeigenamens

Der Anzeigename hilft Benutzern, die zugeordnete Datei oder das zugehörige Element in Copilot leicht zu erkennen, was auf vertrauenswürdige Inhalte hinweist. Der Anzeigename wird auch als Inhaltsquellenfilter verwendet. Für dieses Feld ist ein Standardwert vorhanden, aber Sie können es an einen Namen anpassen, den Benutzer in Ihrem organization erkennen.

Geben Sie die Jira Data Center-URL an.

Um eine Verbindung mit Ihren Jira Data Center-Daten herzustellen, verwenden Sie die Jira Data Center instance URL Ihres organization, die in der Regel als https://<your-organization-domain>.comformatiert ist.

Graph-Connector-Agent (GCA)

Der Graph-Connector-Agent fungiert als Brücke zwischen Ihrem Jira Data Center instance und den Connector-APIs und ermöglicht eine sichere und effiziente Datenübertragung. Wählen Sie in diesem Schritt die Agent-Konfiguration aus, die Sie für Ihren Connector verwenden möchten. Weitere Informationen finden Sie unter Installieren des Graph-Connector-Agents.

Authentifizierungstyp

Derzeit wird OAuth 2.0 beim Verbindungsaufbau unterstützt. Informationen zum Eingeben der Client-ID und des geheimen Clientschlüssels in die Verbindungseinrichtung finden Sie in den Anweisungen in diesem Thema.

  1. Melden Sie sich bei Ihrem Jira Data Center an.

  2. Klicken Sie auf Einstellungen>Anwendungsanwendungslinks>.

    Screenshot: Klicken Sie auf Anwendung.

    Screenshot: Anwendungslinks.

  3. Wählen Sie Link erstellen aus.

    {Screenshot: Link

  4. Wählen Sie Externe Anwendung und dann Eingehend als Richtung aus.

    {Screenshot: Externe Anwendung auswählen und dann Eingehend als Richtung auswählen.}

  5. Füllen Sie das Formular "Konfigurieren eines eingehenden Links" aus.

    • Umleitungs-URL: für Microsoft 365 Enterprise. https://gcs.office.com/v1.0/admin/oauth/callback
    • Bereich: Admin

    {Screenshot: Ausfüllen des Formulars

  6. Kopieren Sie die angegebene Client-ID und den geheimen Schlüssel von der Seite "Anmeldeinformationen", und fügen Sie sie in die entsprechenden Felder auf der Seite zum Einrichten der Jira Data Center-Verbindung ein.

    {Screenshot der Client-ID und des Geheimnisses.}

Rollout für eine begrenzte Zielgruppe

Stellen Sie diese Verbindung für eine eingeschränkte Benutzerbasis bereit, wenn Sie sie in Copilot und anderen Suchoberflächen überprüfen möchten, bevor Sie den Rollout auf eine breitere Zielgruppe erweitern. Weitere Informationen zum eingeschränkten Rollout finden Sie hier.

An diesem Punkt können Sie die Verbindung für Ihr Jira Data Center erstellen. Sie können den Hinweis bestätigen und dann auf die Schaltfläche Erstellen klicken, und der Microsoft 365 Copilot Connector beginnt mit der Indizierung von Daten von Ihrer Jira Data Center-Website.

Für andere Einstellungen, z. B. Zugriffsberechtigungen, Schema und Durchforstungshäufigkeit, werden Standardwerte basierend auf den am besten geeigneten Jira Data Center-Daten festgelegt.

Seite Einstellungen Standardwerte
Benutzer Zugriffsberechtigungen Nur Personen mit Zugriff auf diese Datenquelle.
Benutzer Identitäten zuordnen Datenquellenidentitäten, die mithilfe von Microsoft Entra-IDs zugeordnet werden.
Inhalt Filter Alle Projekte
Inhalt Eigenschaften verwalten Klicken Sie hier, um die Standardeigenschaften und deren Schema zu überprüfen.
Synchronisieren Inkrementelle Durchforstung Häufigkeit: Alle 15 Minuten
Synchronisieren Vollständige Durchforstung Häufigkeit: Jeden Tag

Benutzerdefiniertes Setup

Im benutzerdefinierten Setup können Sie jeden der Standardwerte für Benutzer, Inhalte und Synchronisierung bearbeiten.

Benutzer

Zugriffsberechtigungen

Der Jira Data Center Microsoft 365 Copilot-Connector unterstützt Daten, die nur für Personen mit Zugriff auf diese Datenquelle (empfohlen) oder Jeder sichtbar sind. Wenn Sie Alle auswählen, werden indizierte Daten in den Suchergebnissen für alle Benutzer angezeigt. Wenn Sie Nur Personen mit Zugriff auf diese Datenquelle auswählen, müssen Sie weiter auswählen, ob Ihr Jira Data Center über Microsoft Entra ID bereitgestellte Benutzer oder Nicht-AAD-Benutzer verfügt.

So ermitteln Sie, welche Option für Ihre organization geeignet ist:

  1. Wählen Sie die Option Microsoft Entra ID aus, wenn die E-Mail-ID der Jira Data Center-Benutzer mit dem UserPrincipalName (UPN) von Benutzern in Microsoft Entra ID identisch ist.

  2. Wählen Sie die Nicht-AAD-Option aus, wenn sich die E-Mail-ID der Confluence-Benutzer von der UserPrincipalName (UPN) der Benutzer in Microsoft Entra ID unterscheidet.

Wichtig

  • Wenn Sie Microsoft Entra ID als Typ der Identitätsquelle auswählen, ordnet der Connector die E-Mail-IDs von Benutzern, die von Jira Data Center abgerufen wurden, direkt der UPN-Eigenschaft aus Microsoft Entra ID zu.
  • Wenn Sie für den Identitätstyp "Non-AAD" ausgewählt haben, finden Sie anweisungen zum Zuordnen der Identitäten unter Zuordnen Ihrer Nicht-Azure AD-Identitäten. Sie können diese Option verwenden, um den regulären Ausdruck für die Zuordnung zwischen E-Mail-ID und UPN anzugeben.
  • Updates für Benutzer oder Gruppen, die Zugriffsberechtigungen steuern, werden nur in vollständigen Durchforstungen synchronisiert. Inkrementelle Durchforstungen unterstützen derzeit nicht die Verarbeitung von Updates für Berechtigungen.

Wenn Sie "Nur Personen mit Zugriff auf diese Datenquelle (empfohlen)" auswählen, erzwingt der Jira Data Center Copilot-Connector die Zugriffssteuerung basierend auf den nativen Berechtigungsmodellen von Jira, um eine übermäßige Freigabe vertraulicher Inhalte zu verhindern. Bei Indizierungsproblemen wendet der Connector eine hierarchische Auswertung an, die der internen Berechtigungslogik von Jira ähnelt. Dadurch wird sichergestellt, dass nur autorisierte Benutzer Inhalte über Copilot entdecken können. Die folgende Abbildung veranschaulicht die Auswertungslogik, die die Zugriffsrechte für Jira-Probleme bestimmt. Diagramm: Workflow der Jira Data Center Copilot-Connector-ACL

Der Connector verwendet die folgende Zugriffssteuerungshierarchie:

  1. Problemsicherheitsstufe (höchste Priorität) Wenn für ein Problem die Sicherheitsstufe "Problem " konfiguriert ist, ist der Zugriff auf Benutzer, Gruppen oder Rollen beschränkt, die dieser Ebene explizit zugeordnet sind. In diesem Fall setzt die Problemsicherheitsstufe alle anderen Berechtigungseinstellungen außer Kraft. Benutzern, die nicht in der Definition der Sicherheitsebene enthalten sind, wird der Zugriff verweigert, unabhängig von ihren Berechtigungen auf Projektebene.

  2. Fallback auf Berechtigungen auf Projektebene Wenn keine Problemsicherheitsstufe festgelegt ist, wird der Zugriff durch das Berechtigungsschema des Projekts bestimmt. Insbesondere muss dem Benutzer die Berechtigung Projekte durchsuchen für das entsprechende Projekt erteilt werden. Der Connector unterstützt derzeit das Auflösen der folgenden Arten von Browse Projects Berechtigungszuweisungen: Projektrollen, Gruppen, Aktueller Zugewiesener, Reporter, Projektleiter und Einzelbenutzer. Wenn die Browse Projects Berechtigung jedoch mit anderen Typen konfiguriert wird (z. B. Anwendungszugriff, öffentlich, Jeder angemeldeter Benutzer, Benutzerdefinierter Gruppenfeldwert, Benutzerdefinierter Benutzerfeldwert und Dienstprojekt Customer-Poratal Access), kann der Connector diese Einstellungen nicht auswerten. In solchen Fällen wird der Zugriff auf das Problem verweigert , um die Datensicherheit zu gewährleisten.

Inhalt

Auswählen von Projekten und Filtern von Daten

Wenn Sie "Gesamte JiraDataCenter-Website" auswählen, werden alle aktuellen und zukünftigen Projekte indiziert. Wenn Sie "Nur einige Projekte" auswählen, werden nur die ausgewählten Projekte indiziert.

Filtern von Daten

Sie können JiraDataCenter-Probleme basierend auf ihrer Erstellung oder dem Zeitstempel der letzten Aktualisierung filtern, um nur aktuelle Inhalte zu indizieren. Für erweiterte Filter können Sie auch eine JQL-Zeichenfolge hinzufügen.

Eigenschaften verwalten

In diesem Abschnitt wird das Schema für die Verbindung definiert. Das Schema bestimmt, wie der indizierte Jira-Inhalt innerhalb des 365 Copilot-Connectors erfasst und verarbeitet wird. Sie können Eigenschaften hinzufügen oder ändern, um sicherzustellen, dass die Datenstruktur den Anforderungen Ihrer Organisation an Copilot- und Suchfunktionen entspricht. Sie können auch benutzerdefinierte Felder aus Jira Data Center als Eigenschaften hinzufügen. Weitere Informationen.

Source-Eigenschaft Semantische Bezeichnung Schema
AssigneeEmailId Abfragen, Abrufen, Suchen
AssigneeName Abfragen, Abrufen, Suchen
blockieren blockieren Abfrage, Abrufen
Erstellt Erstellungsdatum und Uhrzeit Wiedergewinnen
DueDate Wiedergewinnen
IssueDescription Suche
IssueIconUrl IconUrl Wiedergewinnen
IssueId Wiedergewinnen
IssueKey Abfragen, Abrufen, Suchen
IssueLink Url Abfragen, Abrufen, Suchen
IssuePriority Abfragen, Abrufen, Suchen
IssueStatus Abfrage, Abrufen
IssueSummary Suche
IssueType Abfrage, Abrufen
Labels Abfrage, Abrufen
ProjectName Abfrage, Abrufen
ReporterEmailId Erstellt von Abfragen, Abrufen, Suchen
ReporterName Abfragen, Abrufen, Suchen
Position Titel Abfragen, Abrufen, Suchen
Aktualisiert Datum der letzten Änderung Uhrzeit Abfrage, Abrufen

Datenvorschau

Verwenden Sie die Schaltfläche für die Vorschau der Ergebnisse, um ausgewählte Eigenschaften und Filter zu überprüfen.

Synchronisierung

Das Aktualisierungsintervall bestimmt, wie oft Ihre Daten zwischen der Datenquelle und dem 365 Copilot-Connectorindex synchronisiert werden. Es gibt zwei Arten von Aktualisierungsintervallen: vollständige Durchforstung und inkrementelle Durchforstung. Weitere Informationen finden Sie hier.

Überprüfen und Testen Der Verbindung

Für MS Search, wenn Sie die Suchergebnisseite anpassen müssen. Informationen zum Anpassen von Suchergebnissen finden Sie unter Anpassen der Suchergebnisseite.

Problembehandlung

Nachdem Sie Ihre Verbindung veröffentlicht haben, können Sie die status unter Datenquellen im Admin Center überprüfen. Informationen zum Durchführen von Updates und Löschungen finden Sie unter Verwalten ihres Connectors.

Wenn Sie Probleme haben oder Feedback geben möchten, wenden Sie sich an Microsoft Graph | Unterstützung.