Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Mit dem Atlassian Jira Cloud Microsoft 365 Copilot-Connector können Ihre organization Jira-Probleme indizieren. Nachdem Sie den Connector und den Inhalt der Jira-Website konfiguriert haben, können Benutzer nach diesen Elementen in Microsoft Search suchen und Microsoft 365 Copilot.
In diesem Artikel werden die Schritte zum Bereitstellen und Anpassen des Atlassian Jira Cloud-Connectors beschrieben.
Wichtig
Der Atlassian Jira Cloud Copilot-Connector unterstützt nur in der Cloud gehostete Jira-Instanzen. Dieser Connector unterstützt keine Jira Server- und Jira Data Center-Versionen.
Informationen zur Konfiguration des Jira Cloud-Diensts finden Sie unter Einrichten des Jira Cloud-Diensts für die Connectorerfassung.
Voraussetzungen
Stellen Sie vor der Bereitstellung des Atlassian Jira Cloud-Connectors sicher, dass die Jira Cloud-Umgebung in Ihrem organization konfiguriert ist. In der folgenden Tabelle sind die Schritte zum Konfigurieren der Jira Cloud-Umgebung und zum Bereitstellen des Connectors zusammengefasst.
| Aufgabe | Rolle |
|---|---|
| Einrichten des Jira Cloud-Diensts | Jira Cloud-Administrator |
| Bereitstellen des Connectors im Microsoft 365 Admin Center | Microsoft 365 Admin |
| Anpassen der Connectoreinstellungen (optional) | Microsoft 365 Admin |
Stellen Sie vor der Bereitstellung des Connectors sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Sie müssen der Suchadministrator für den Microsoft 365-Mandanten Ihres organization sein.
- Stellen Sie sicher, dass Sie die Jira Cloud instance URL für Ihre organization kennen. Um eine Verbindung mit Ihren Jira-Daten herzustellen, benötigen Sie die Jira instance-URL Ihres organization.
- Um eine Verbindung mit Jira herzustellen und dem Atlassian Jira Cloud Copilot-Connector das regelmäßige Aktualisieren von Problemen zu ermöglichen, benötigen Sie ein Dienstkonto mit den folgenden Berechtigungen.
| Berechtigungsname | Berechtigungstyp | Erforderlich für |
|---|---|---|
| Projekte durchsuchen | Projektberechtigung | Durchforstung von Jira-Problemen. Diese Berechtigung ist für die Projekte erforderlich , die indiziert werden müssen. |
| Sicherheitsberechtigungen auf Problemebene | Sicherheit auf Problemebene | Durchforsten verschiedener Problemtypen. Diese Berechtigung ist optional. |
| Durchsuchen von Benutzern und Gruppen | Globale Berechtigungen | Sicherheitskürzung basierend auf Zugriffsberechtigungen für Suchergebnisse. Diese Berechtigung ist erforderlich, wenn Sie die Benutzereinstellung Nur Personen mit Zugriff auf diese Datenquelle auswählen. Andernfalls ist dies optional. |
| Verwalten von Jira | Globale Berechtigungen | Sicherheitskürzung basierend auf Zugriffsberechtigungen für Suchergebnisse. Diese Berechtigung ist erforderlich, wenn Sie die Benutzereinstellung Nur Personen mit Zugriff auf diese Datenquelle auswählen. Andernfalls ist dies optional. |
Bereitstellen des Connectors
So fügen Sie den Atlassian Jira Cloud-Connector für Ihre organization hinzu:
- Wählen Sie im Microsoft 365 Admin Center im linken Bereich Copilot-Connectors> aus.
- Wechseln Sie zur Registerkarte Connectors , und wählen Sie im linken Bereich Katalog aus.
- Wählen Sie in der Liste der verfügbaren Connectors Atlassian Jira Cloud aus.
Festlegen des Anzeigenamens
Der Anzeigename wird verwendet, um Verweise in Copilot-Antworten zu identifizieren, damit Benutzer die zugeordnete Datei oder das zugeordnete Element erkennen können. Der Anzeigename steht auch für vertrauenswürdigen Inhalt und wird als Inhaltsquellenfilter verwendet.
Sie können den Standardmäßigen Atlassian Jira Cloud-Anzeigenamen übernehmen oder den Wert anpassen, um einen Anzeigenamen zu verwenden, den Benutzer in Ihrem organization erkennen.
Weitere Informationen zu Anzeigenamen und Beschreibungen von Connectors finden Sie unter Verbessern der Copilot-Ermittlung mit Microsoft 365 Copilot Connectorinhalten.
Festlegen instance URL
Um eine Verbindung mit Ihren Jira-Clouddaten herzustellen, benötigen Sie die Jira-instance-URL Ihres organization. Die Jira-instance-URL Ihres organization sieht in der Regel wie folgt aus: https://<your-organization-domain>.atlassian.net.
Wenn Sie noch keine instance haben, lesen Sie Atlassian Jira, um eine Test-instance zu erstellen.
Auswählen des Authentifizierungstyps
Um Probleme von Jira zu authentifizieren und zu synchronisieren, wählen Sie eine der folgenden unterstützten Authentifizierungsmethoden aus:
Standardauthentifizierung : Geben Sie den Benutzernamen (in der Regel die E-Mail-ID) und das API-Token Ihres Kontos ein, um sich mit der Standardauthentifizierung zu authentifizieren. Informationen zum Generieren eines API-Tokens finden Sie unter Verwalten von API-Token für Ihr Atlassian-Konto.
Atlassian Jira OAuth 2.0 (empfohlen): So verwenden Sie Jira OAuth für die Authentifizierung:
- Registrieren Sie eine App in Atlassian Jira, damit die Microsoft Search-App und Microsoft 365 Copilot auf die instance zugreifen können. Weitere Informationen finden Sie unter Aktivieren von OAuth 2.0.
- Melden Sie sich mit Ihrem Atlassian Jira-Administratorkonto bei der Atlassian Developer-Konsole an.
- Wählen Sie Erstellen und dann OAuth 2.0-Integration aus.
- Geben Sie einen geeigneten Namen für die Anwendung an, und erstellen Sie die neue App.
- Wechseln Sie im Navigationsbereich auf der linken Seite zu Berechtigungen . Wählen Sie Für Jira-APIhinzufügen und dann Konfigurieren aus. Fügen Sie unter Differenzierte Berechtigungen die erforderlichen Bereiche hinzu.
- Wechseln Sie im Navigationsbereich auf der linken Seite zu Autorisierung , um die Rückruf-URL hinzuzufügen:
- Für Microsoft 365 Enterprise:
https://gcs.office.com/v1.0/admin/oauth/callback - Für Microsoft 365 Government:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- Für Microsoft 365 Enterprise:
- Wählen Sie Speichern aus.
- Wechseln Sie im linken Bereich zu Einstellungen , um die Client-ID und den geheimen Schlüssel abzurufen. Führen Sie den Schritt mit den Verbindungseinstellungen mithilfe der Client-ID und des Geheimen Schlüssels aus.
Hinweis
- Weitere Informationen zu Jira-Berechtigungen finden Sie unter Jira-Bereiche für OAuth 2.0.
- Die ursprünglichen (klassischen) OAuth-Berechtigungen für Jira Cloud sind veraltet. Weitere Informationen finden Sie in der Änderungsprotokollankündigung.
Ausrollen
Um das Rollout für eine begrenzte Zielgruppe durchzuführen, wählen Sie die Umschaltfläche neben Rollout für eingeschränkte Zielgruppe aus, und geben Sie die Benutzer und Gruppen an, für die der Connector rollout ausgeführt werden soll. Weitere Informationen finden Sie unter Gestaffelter Rollout für Microsoft 365 Copilot Connectors.
Wählen Sie Erstellen aus, um die Verbindung bereitzustellen. Der Atlassian Jira Cloud Copilot-Connector beginnt sofort mit der Indizierung von Inhalten.
Im Folgenden sind die Standardwerte für den Connector aufgeführt:
Benutzer
- Zugriffsberechtigungen: Nur Personen mit Zugriff auf Inhalte in Der Datenquelle.
- Zuordnungsidentitäten: Datenquellenidentitäten, die mithilfe von Microsoft Entra-IDs zugeordnet werden.
Inhalt
- Websiteprojekte: Alle Projekte werden indiziert.
- Daten filtern: Alle Probleme werden indiziert. Es werden keine Zeitfilter oder JQL-Kriterien angewendet.
- Eigenschaften verwalten: Informationen zum Überprüfen der Standardeigenschaften und des zugehörigen Schemas finden Sie unter Anpassen von Inhaltseinstellungen.
Synchronisierung
- Inkrementelle Durchforstung: Häufigkeit: alle 15 Minuten
- Vollständige Durchforstung: Häufigkeit: Jeden Tag
Nachdem Sie Ihre Verbindung erstellt haben, können Sie die status im Abschnitt Connectors des Microsoft 365 Admin Center überprüfen.
Anpassen von Einstellungen (optional)
Sie können die Standardwerte für die Atlassian Jira Cloud-Connectoreinstellungen anpassen. Wählen Sie zum Anpassen der Einstellungen auf der Connectorseite im Admin Center Die Option Benutzerdefiniertes Setup aus.
Anpassen von Benutzereinstellungen
Zugriffsberechtigungen
Der Atlassian Jira Cloud Copilot-Connector unterstützt Suchberechtigungen, die für "Jeder " oder "Nur Personen mit Zugriff auf diese Datenquelle" 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, werden indizierte Daten in den Suchergebnissen für Benutzer angezeigt, die Zugriff darauf haben. In Atlassian Jira werden Sicherheitsberechtigungen mithilfe von Projektberechtigungsschemas definiert, die Gruppen auf Websiteebene und Projektrollen enthalten. Die Sicherheit auf Problemebene kann auch mithilfe von Berechtigungsschemas auf Problemebene definiert werden.
Wichtig
Der Atlassian Jira Cloud Copilot-Connector muss in der Lage sein, die E-Mail-ID eines Benutzers in Jira zu lesen, um sicherheitsrelevante Berechtigungen in Microsoft Search und Microsoft 365 Copilot zuzuweisen. Dies erfordert, dass Sie eine der folgenden Punkte sicherstellen:
- Alle Benutzer sollten die Option Jeder für ihre Profilsichtbarkeitseinstellungen auswählen. Weitere Informationen zu Profilsichtbarkeitseinstellungen finden Sie unter Aktualisieren Ihres Profils und der Sichtbarkeitseinstellungen.
- Für Organisationen, die verwaltete Konten verwenden:
- Für alle Benutzer muss die Einstellung für das verwaltete Konto in den Einstellungen für die Profilsichtbarkeit ausgewählt sein.
- Für Benutzer, die nicht Teil des verwalteten Kontos sind (identisch mit dem Durchforstungskonto), muss in ihren Profilsichtbarkeitseinstellungen jeder ausgewählt sein.
- Das während der Verbindungskonfiguration verwendete Durchforstungskonto muss über die Domäne des verwalteten Kontos verfügen.
Zuordnen von Identitäten
Die Standardmethode zum Zuordnen Ihrer Datenquellenidentitäten zu Microsoft Entra ID besteht darin, die E-Mail-ID von Jira-Benutzern mit dem Benutzerprinzipalnamen (User Principal Name, UPN) oder der E-Mail-Adresse der Benutzer in Microsoft Entra ID identisch zu machen. Wenn die Standardzuordnung für Ihre organization nicht funktioniert, können Sie eine benutzerdefinierte Zuordnungsformel bereitstellen. Weitere Informationen finden Sie unter Zuordnen Ihrer nicht Azure AD-Identitäten.
- Wählen Sie die Option Microsoft Entra ID aus, wenn die E-Mail-ID der Jira-Benutzer mit dem UPN der Benutzer in Microsoft Entra ID identisch ist.
- Wählen Sie die Option Nicht Microsoft Entra ID aus, wenn sich die E-Mail-ID von Jira-Benutzern vom UPN und der E-Mail-Adresse der Benutzer in Entra ID unterscheidet.
Hinweis
Updates mit Gruppen, die Zugriffsberechtigungen steuern, werden nur in vollständigen Durchforstungen synchronisiert. Inkrementelle Durchforstungen unterstützen nicht die Verarbeitung von Updates für Berechtigungen.
Anpassen von Inhaltseinstellungen
Auswählen von Projekten und Filtern von Daten
- Websiteprojekte: Sie können auswählen, dass die Verbindung entweder die gesamte Jira-Website oder nur bestimmte Projekte indiziert.
- Wenn Sie die gesamte Jira-Website indizieren möchten, werden Jira-Probleme in allen Projekten auf der Website indiziert. Neue Projekte und Probleme werden während der nächsten Durchforstung nach ihrer Erstellung indiziert.
- Wenn Sie einzelne Projekte auswählen, werden nur Jira Issues in den ausgewählten Projekten indiziert.
Hinweis
Wenn Sie einem Jira-Projekt die Berechtigung Projekte durchsuchen erteilen, wird es in der Projektauswahl aufgeführt und kann durchforstet werden. Wenn ein Projekt fehlt, überprüfen Sie die Berechtigungen für Ihr Konto.
- Daten filtern: Sie können die Jira-Probleme filtern, die auf zwei Arten indiziert werden:
- Geben Sie den Zeitraum für die Änderung des Problems an. Diese Option indiziert nur die Jira-Probleme, die in dem zeitraum erstellt oder geändert werden, der basierend auf der aktuellen Durchforstung parallel ausgewählt wurde.
- Verwenden Sie den JQL-Filter, um nur bestimmte Jira-Problemtypen mithilfe
issueType in (Bug, Improvement)von zu indizieren.
Eigenschaften verwalten
Sie können der Jira-Datenquelle verfügbare Eigenschaften hinzufügen oder daraus entfernen, der Eigenschaft ein Schema zuweisen (definieren, ob eine Eigenschaft durchsuchbar, abfragbar, abrufbar oder verfeinernd ist), die semantische Bezeichnung ändern und der Eigenschaft einen Alias hinzufügen. In der folgenden Tabelle sind die Eigenschaften aufgeführt, die standardmäßig ausgewählt sind.
| Source-Eigenschaft | Label | Beschreibung | Schema |
|---|---|---|---|
| blockieren | blockieren | Benennen Sie alle Personen, die an dem Element teilgenommen haben bzw. an dem Element zusammengearbeitet haben. | Wiedergewinnen |
| Erstellt | Erstellungsdatum und Uhrzeit | Datum und Uhrzeit der Erstellung des Elements in der Datenquelle | Abfrage, Abrufen |
| IssueDescription | Inhalt | Die Beschreibung des Problems | Suche |
| IssueIconURL | IconUrl | Symbol-URL, die den Problemtyp darstellt | Wiedergewinnen |
| IssueId | |||
| IssueKey | |||
| IssueLink | url | Die Ziel-URL des Elements in der Datenquelle | Abfrage, Abrufen |
| IssueStatus | Abfrage | ||
| IssueSummary | |||
| ProjectName | Abfrage | ||
| ReporterEmailId | Erstellt von | Wiedergewinnen | |
| ReporterName | Abfrage, Abrufen | ||
| Position | Titel | Der Titel des Elements, das in Copilot und anderen Suchfunktionen angezeigt werden soll | Suchen, Abfragen, Abrufen |
| Aktualisiert | Datum der letzten Änderung Uhrzeit | Datum und Uhrzeit der letzten Änderung des Elements in der Datenquelle | Abfrage, Abrufen |
Hinweis
- Der Atlassian Jira Cloud Copilot-Connector kann sowohl Standardproblemfelder als auch benutzerdefinierte Issuefelder indizieren.
- Wenn ein ausgewähltes benutzerdefiniertes Feld in einem Jira-Problemtyp nicht vorhanden ist, wird das Feld als NULL (leer) erfasst.
- Die Liste der ausgewählten Eigenschaften wirkt sich darauf aus, wie Benutzer ergebnisse in Copilot filtern, suchen und anzeigen können.
Datenvorschau
Verwenden Sie die Schaltfläche "Vorschauergebnisse", um die Beispielwerte der ausgewählten Eigenschaften und des Abfragefilters zu überprüfen.
Anpassen von Synchronisierungsintervallen
Das Aktualisierungsintervall bestimmt, wie oft Ihre Daten zwischen der Datenquelle und dem Atlassian Jira Cloud Copilot-Connectorindex synchronisiert werden. Im Folgenden sind die beiden Arten von Aktualisierungsintervallen aufgeführt:
- Inkrementelle Durchforstung: Alle 15 Minuten
- Vollständige Durchforstung: Jeden Tag
Sie können die Standardwerte des Aktualisierungsintervalls ändern. Weitere Informationen finden Sie unter Richtlinien für Synchronisierungseinstellungen.