Erstellen, Aktualisieren und Löschen von Verbindungen in Microsoft Graph
Die Microsoft Graph Connectors-Plattform bietet eine intuitive Möglichkeit, Ihre externen Daten in Microsoft Graph einzufügen. Eine Verbindung ist ein logischer Container für Ihre externen Daten, den ein Administrator als eine Einheit verwalten kann.
Nachdem eine Verbindung hergestellt wurde, können Sie Ihre Inhalte von jeder externen Datenquelle, wie z. B. einer lokalen Inhaltsquelle oder einem externen SaaS-Dienst, hinzufügen. Sie können nur die Verbindungen anzeigen und verwalten, die Sie angelegt haben oder zu deren Verwaltung Sie explizit autorisiert wurden. Ein Suchadministrator kann alle Verbindungen im Mandanten über das Modern Admin Center anzeigen und verwalten.
Beispiel für ein benutzerdefiniertes Helpdesk-System einer Tickets-Connector-Struktur.
Administrator-Ansicht von Verbindungen einschließlich des benutzerdefinierten Ticket-Connectors.
Sie können eine Verbindung beliebig modellieren, aber das häufigste Modell ist das Erstellen einer Verbindung für jede Instanz Ihres Connectors. Beispielsweise wird jedes Mal, wenn Sie den Microsoft Windows-Dateifreigabe-Connector einrichten, eine neue Verbindung erstellt. Sie können auch eine einzige Verbindung erstellen, um alle Elemente aus Ihrer Datenquelle hinzuzufügen. Beispielsweise können Sie eine einzige Verbindung erstellen, um alle Tickets und Vorfälle für mehrere Teams aus Ihrem Helpdesk-System hinzuzufügen.
Status und Vorgänge
Ihre Verbindung kann in einem der folgenden Status existieren.
| Status | Beschreibung |
|---|---|
| Entwurf | Eine leere Verbindung wird bereitgestellt. Die Datenquelle, das Schema oder alle Einstellungen wurden noch nicht konfiguriert. |
| Bereit | Die Verbindung wird mit dem registrierten Schema bereitgestellt und ist zur Erfassung bereit. |
| Veraltet | Dies geschieht, wenn ein abhängiges Feature, z. B. eine API, veraltet ist. Das Löschen der Verbindung ist der einzige zulässige Vorgang. |
| LimitExceeded | Wenn Sie die Höchstgrenze einer einzelnen Verbindung oder die Quote auf Mandantenebene für alle Verbindungen erreicht haben, können Sie keine weiteren Elemente hinzufügen, bis Sie den Status verlassen. |
In der folgenden Tabelle sind die verfügbaren Vorgänge in den einzelnen Status angegeben.
| Vorgang | Entwurf | Bereit | Veraltet | LimitExceeded |
|---|---|---|---|---|
| Verbindung erstellen | ❌ | ✔️ | ❌ | ✔️ |
| Verbindung lesen | ✔️ | ✔️ | ✔️ | ✔️ |
| Verbindung aktualisieren | ✔️ | ✔️ | ❌ | ✔️ |
| Verbindung löschen | ✔️ | ✔️ | ✔️ | ✔️ |
| Schema erstellen | ✔️ | ❌ | ❌ | ❌ |
| Schema lesen | ❌ | ✔️ | ✔️ | ✔️ |
| Schema aktualisieren | ❌ | ❌ | ❌ | ❌ |
| Schema löschen | ❌ | ❌ | ❌ | ❌ |
| Element erstellen | ❌ | ✔️ | ❌ | ❌ |
| Element lesen | ❌ | ✔️ | ✔️ | ✔️ |
| Element aktualisieren | ❌ | ✔️ | ❌ | ✔️ |
| Element löschen | ❌ | ✔️ | ❌ | ✔️ |
Eine Verbindung ermöglicht es Ihrer Anwendung, ein Schema zu definieren für Elemente, die indiziert werden sollen, und stellt einen Endpunkt für Ihren Dienst zum Hinzufügen, Aktualisieren oder Löschen von Elementen im Index bereit.
Das Erstellen einer Verbindung ist der erste Schritt, damit eine Anwendung Elemente zum Suchindex hinzufügen kann.
Erstellen einer Verbindung
Bevor eine Anwendung dem Suchindex Elemente hinzufügen kann, muss eine Verbindung erstellt und konfiguriert werden:
- Erstellen Sie eine Verbindung mit einem eindeutigen Bezeichner, einem Anzeigenamen und einer Beschreibung.
- Registrieren Sie ein Schema, um die Felder zu definieren, die im Index enthalten sein sollen.
Hinweis: Informationen zum Aktualisieren des Schemas für eine vorhandene Verbindung finden Sie unter Schemaupdatefunktionen.
Aktivieren von Inhaltserfahrungen
Ein Microsoft Graph-Connector kann über Microsoft Search hinaus in Microsoft 365-Umgebungen integriert werden.
Um eine oder mehrere Inhaltserfahrungen zu aktivieren, legen Sie den Wert der enabledContentExperiences-Eigenschaft auf die Werte fest, die diese Inhaltserfahrungen beim Erstellen der Verbindung darstellen. Die unterstützten Werte sind in der folgenden Tabelle aufgeführt.
| enabledContentExperiences-Wert | Beschreibung |
|---|---|
| search | Ermöglicht, dass Ihre Inhalte in Microsoft-Suchergebnissen angezeigt werden. Das Format dieser Ergebnisse ist in verschiedenen Suchbereichs wie SharePoint und Microsoft Bing konsistent. |
| Beachtung | Ermöglicht es Ihnen, Ihre Inhalte für die erweiterte eDiscovery-Lösung von Microsoft Purview sichtbar zu machen. Ausführliche Informationen zu erweiterten Lizenzierungsanforderungen für eDiscovery-Lösungen & finden Sie unter Microsoft Purview-Lösungen. |
Das folgende Beispiel zeigt, wie Sie eine Verbindung aktualisieren, um sowohl die Such- als auch die Kompatibilitätsinhalte zu ermöglichen.
PATCH https://graph.microsoft.com/beta/external/connections/contosohelpdesk
Content-Type: application/json
{
"enabledContentExperiences": "search, compliance"
}
Verbindungseinstellungen
Sie können die Standardverbindungseinstellungen für jede aktivierte Inhaltsumgebung konfigurieren. Wenn diese Einstellungen aktiviert sind, wirken sich diese Einstellungen auf die Inhaltserfahrung aus.
Sucheinstellungen
Sie können definieren, wie Suchergebnisse auf der Microsoft Search-Ergebnisseite angezeigt werden, indem Sie die standardmäßigen Suchanzeigevorlagen für Ihre Inhalte angeben. Eine Gruppe von Suchanzeigevorlagen kann verwendet werden, um verschiedene Arten von Suchergebnissen unterschiedlich anzuzeigen. Eine Suchanzeigevorlage verfügt über ein Ergebnislayout, das mit adaptiven Karten und Regeln erstellt wurde, die eine oder mehrere Bedingungen angeben. Wenn diese Bedingungen erfüllt sind, wird das Layout auf das Suchergebnis angewendet und auf der Ergebnisseite angezeigt.
Complianceeinstellungen
Ähnlich wie bei den Einstellungen für die Unternehmenssuche müssen Sie definieren, wie erweiterte eDiscovery-Suchergebnisse angezeigt werden, indem Sie Ergebnistypen für Ihre Inhalte angeben. Dadurch kann der eDiscovery-Manager den Inhalt beim Überprüfen der Datasets visualisieren. Das folgende Beispiel zeigt die Ergebnisse einer eDiscovery-Suchüberprüfung eines Azure DevOps-Elements.
Wichtig
Das Format adaptiver Karten wird verwendet, um Ergebnisse in eDiscovery zu rendern. Im Gegensatz zur Suchumgebung unterstützt die eDiscovery-Benutzeroberfläche nur Elemente für adaptive Karten bis Version 1.2.
Wenn Sie die eDiscovery-Ergebnisvorlage im Designer für adaptive Karten konfigurieren, wählen Sie 1.2 als Zielversion aus.
Beachten Sie, dass die folgenden Einschränkungen für adaptive Karten in den eDiscovery-Ergebnisvorlagen gelten:
- Markdown wird nicht unterstützt.
- Datenbindungsausdrücke mit
${}werden nicht unterstützt. Beispielsweise"text": "Hello {name}"wird unterstützt, ist dies jedoch"text": "Hello ${name}"nicht. - Nur Datenbindungsausdrücke für einwertige Eigenschaften werden unterstützt. Beispielsweise
"text": "Hello {name}"wird unterstützt, ist dies jedoch"text": "Hello {employee.Name}"nicht.
Aktivitätseinstellungen
In den Aktivitätseinstellungen können Sie Microsoft 365-Apps eine Möglichkeit bieten, Freigabeaktivitäten zu erkennen, wodurch Ihre Inhalte Benutzern empfohlen werden können, die am meisten mit diesen Inhalten interagieren. Dazu fügen Sie einen urlToItemResolver hinzu, der es ermöglicht, dass eine bestimmte URL, die in Microsoft 365-Apps erkannt wurde, in ihre jeweilige Element-ID im externalItem aufgelöst wird.
Die folgende Abbildung zeigt, wie Ihr Element in der Empfehlungserfahrung in der Microsoft 365-Suite angezeigt werden kann.
Aktualisieren einer Verbindung
Um den Anzeigenamen, die Beschreibung oder die aktivierten Inhaltsfunktionen für eine vorhandene Verbindung zu ändern, können Sie die Verbindung aktualisieren.
Löschen einer Verbindung
Um alle Elemente zu entfernen, die über eine Verbindung indiziert wurden, können Sie eine Verbindung löschen.