Registrieren und Aktualisieren des Schemas für die Microsoft Graph-Verbindung

Das Verbindungsschema bestimmt, wie Ihre Inhalte in verschiedenen Microsoft Graph-Anwendungen verwendet werden. Das Schema ist eine flache Liste aller Eigenschaften, die Sie der Verbindung zusammen mit ihren Attributen, Bezeichnungen und Aliasen hinzufügen möchten. Sie müssen das Schema registrieren, bevor Sie Elemente zur Verbindung hinzufügen können.

Beispielschema

Die folgende Tabelle stellt ein Beispiel für ein mögliches Schema für einen Arbeitsticketsystem-Connector dar.

Eigenschaft	Typ	Searchable	Queryable	Retrievable	Refinable	Exakte Übereinstimmung erforderlich	Labels	Aliases
ticketId	String		✔️			✔️		ID
title	String	✔️	✔️	✔️			title
createdBy	Zeichenfolge	✔️	✔️				createdBy	creator
assignedTo	String	✔️	✔️
lastEditedDate	DateTime		✔️	✔️	✔️		lastModifiedDateTime	editedDate
lastEditedBy	String	✔️	✔️	✔️			lastModifiedBy	edited
workItemType	String		✔️	✔️				ticketType
priority	Int64	✔️
tags	StringCollection		✔️	✔️	✔️	✔️
status	String		✔️	✔️
url	Zeichenfolge						url
resolved	Boolean		✔️	✔️

Eigenschaftsattribute

Searchable

Wenn eine Eigenschaft durchsucht werden kann, wird ihr Wert dem Volltextindex hinzugefügt. Wenn ein Benutzer eine Suche ausführt, werden Ergebnisse zurückgegeben, wenn es einen Suchtreffer in einem der durchsuchbaren Felder oder dessen Inhalt gibt.

Suchvorgang nach "Design" mit Ergebnissen für Treffer in der Eigenschaft (title) und Inhalten.

Queryable

Wenn eine Eigenschaft abgefragt werden kann, können Sie sie mithilfe von Knowledge Query Language (KQL) abfragen. KQL besteht aus einem oder mehreren freien Textschlüsselwörtern (Wörtern oder Ausdrücken) oder Eigenschafteneinschränkungen. Der Name der Eigenschaft muss in der Abfrage enthalten sein (entweder in der eigentlichen Abfrage angegeben oder programmseitig in die Abfrage eingefügt). Sie können den Präfix-Abgleich mit dem Platzhalterzeichen (*) verwenden.

Hinweis

Suffixvergleiche werden nicht unterstützt.

Eine Suche nach "search ba*" mit Ergebnissen, die diesem Präfix entsprechen.

Suchvorgang nach "tags:design" zum Einschränken der Ergebnisse auf Elemente mit "Design" in der tags-Eigenschaft.

Retrievable

Wenn eine Eigenschaft abgerufen werden kann, kann Ihr Wert in den Suchergebnissen zurückgegeben werden. Alle Eigenschaften, die Sie in der Anzeigevorlage hinzufügen oder die von der Abfrage zurückgegeben werden sollen und in Suchergebnissen relevant sind, müssen abgerufen werden können. Das Kennzeichnen großer oder zu vieler Eigenschaften als abrufbar erhöht die Suchlatenz. Gehen Sie selektiv vor, und wählen Sie relevante Eigenschaften aus.

Eine Reihe abrufbarer Eigenschaften (title und lastEditedBy), die als Ergebnis dargestellt werden.

Refinable

Wenn eine Eigenschaft einschränkbar ist, kann ein Administrator sie auf der Microsoft Search-Ergebnisseite als benutzerdefinierten Filter konfigurieren. Eine refinable Eigenschaft kann nicht sein searchable.

Verfeinern der Ergebnisse nach tags, einer einschränkbaren Eigenschaft.

Exakte Übereinstimmung erforderlich

Wenn isExactMatchRequired für eine Eigenschaft ist true , wird der vollständige Zeichenfolgenwert indiziert. isExactMatchRequired kann nur für nicht durchsuchbare Eigenschaften auf true festgelegt werden.

Beispielsweise ist die ticketId-Eigenschaft sowohl abfragbar als auch gibt den genauen Abgleich an.

• Bei abfragen ticketId:CTS-ce913b61 wird das Element mit der Ticket-ID-Eigenschaft CTS-ce913b61 zurückgegeben.
• Bei Abfragen ticketId:CTS wird das Element nicht mit der Ticket-ID CTS-ce913b61 zurückgegeben.

Auf ähnliche Weise gibt die tags-Eigenschaft auch den genauen Abgleich an.

• Bei Abfragen tags:contoso wird jedes Element mit dem Tag contoso zurückgegeben.
• Bei Abfragen tags:contoso werden KEINE Elemente mit dem Tag contoso ticket zurückgegeben.

Es kann z. B. ein Szenario geben, in dem die Elementeigenschaft eine GUID-formatierte Zeichenfolge ist. Wenn diese Eigenschaft für Elementabfragen genau abgeglichen werden muss, geben Sie an, dass isExactMatchRequired ist true.

Die title-Eigenschaft gibt keinen genauen Abgleich an. Wenn nichts angegeben ist, ist falseisExactMatchRequired . Die title-Eigenschaft wird basierend auf den Tokenisierungsregeln der Sprache des Elementinhalts tokenisiert.

• Bei abfragen title:Contoso Title wird jedes Element zurückgegeben, das "Contoso" oder "Title" in der title-Eigenschaft enthält.

Semantische Bezeichnungen

Eine semantische Bezeichnung ist ein bekanntes, von Microsoft veröffentlichtes Tag, das Sie für eine Eigenschaft in Ihrem Schema hinzufügen können. Wenn Sie eine semantische Bezeichnung hinzufügen, können verschiedene Microsoft-Produkte die Eigenschaft verstehen und eine bessere Benutzererfahrung bieten.

Semantische Bezeichnungen bieten einen domänenunabhängigen Ansatz, um einer Reihe bekannter Klassen Eigenschaften aus verschiedenen Inhaltsdomänen zuzuweisen. Sie finden Anwendung in vielen verschiedenen Inhaltsumgebungen und bieten automatisierte Unterstützung für Aufgaben wie:

• Datenintegration in heterogene Umgebungen
• Erstellen von Allgemeinen Wissensgraphen (z. B. Viva Topics)
• Standardvorlagen für Benutzerumgebungen

Sie können Ihren Quelleigenschaften auf der Seite Eigenschaftenbezeichnungen zuweisen semantische Bezeichnungen zuweisen. Bezeichnungen bieten semantische Bedeutung und ermöglichen es Ihnen, Ihre Connector-Daten in Microsoft 365-Lösungen zu integrieren.

Label	Beschreibung
title	Der Titel des Elements, der in der Suche und anderen Umgebungen angezeigt werden soll.
url	Die Ziel-URL des Elements in der Datenquelle
createdBy	Der Name der Person, die das Element in der Datenquelle erstellt hat.
lastModifiedBy	Der Name der Person, die das Element zuletzt in der Datenquelle bearbeitet hat.
authors	Die Namen aller Personen, die an dem Element in der Datenquelle beteiligt waren/zusammengearbeitet haben.
createdDateTime	Datum und Uhrzeit der Erstellung des Elements in der Datenquelle.
lastModifiedDateTime	Datum und Uhrzeit der letzten Änderung des Elements in der Datenquelle.
fileName	Bei einer Datei der Name der Datei in der Datenquelle
fileExtension	Bei einer Datei die Erweiterung der Datei in der Datenquelle.
iconUrl	Die URL eines Symbols
containerName	Der Name des Containers.
containerUrl	Die URL des Containers

So hat beispielsweise die Verbindungseigenschaft lastEditedBy die gleiche Bedeutung wie die Microsoft-Bezeichnung lastModifiedBy.

Sie können beliebig viele Bezeichnungen hinzufügen, müssen aber sicherstellen, dass sie Eigenschaften exakt zugeordnet sind. Fügen Sie einer Eigenschaft keine Bezeichnung hinzu, wenn dies nicht sinnvoll ist. Falsche Zuordnungen beeinträchtigen die Benutzererfahrung.

Wichtig

Alle Eigenschaften, die Sie Bezeichnungen zuordnen, müssen abgerufen werden können.

Die Bezeichnung title ist die wichtigste Bezeichnung. Weisen Sie dieser Bezeichnung unbedingt eine Eigenschaft zu, damit Ihre Verbindung am Ergebniscluster teilnehmen kann. Das falsche Zuordnen von Bezeichnungen beeinträchtigt die Sucherfahrung. Es ist in Ordnung, dass einigen Bezeichnungen keine Eigenschaft zugewiesen ist.

Relevance

Wenn Sie möglichst viele exakt zugeordnete Bezeichnungen anwenden, können Sie das Auffinden Ihrer Inhalte über die Suchfunktion verbessern. Es wird dringend empfohlen, möglichst viele der nachstehenden Bezeichnungen zu definieren (nach potenziellem Einfluss auf die Ermittlung in absteigender Reihenfolge aufgeführt):

• title
• lastModifiedDateTime
• lastModifiedBy
• url
• fileName
• fileExtension

Beachten Sie für die Ermittlung (Suchszenarien) Folgendes:

• Stellen Sie sicher, dass Ihre Zuordnungen korrekt sind.
• Wenn Sie eine Eigenschaft als eine Bezeichnung verwenden, die umfangreiche Inhalte enthält, wird dadurch möglicherweise die Suchwartezeit erhöht und Sie müssen länger warten, bis Suchergebnisse zurückgegeben werden.
• Besonders in dem Szenario, in dem Sie eine benutzerdefinierte Suchsparte konfigurieren, die die Suche über mehr als eine Verbindung ermöglicht, ist es für die Suchergebnisse von erheblichem Vorteil, wenn Sie so viele Bezeichnungen wie möglich angeben.

Ranghinweise

Ranghinweise können auf Texteigenschaften angewendet werden, die nicht semantischen Bezeichnungen zugeordnet sind und als durchsuchbar festgelegt sind. Sie können im Search-Verwaltungsportal in einem Bereich von standard bis sehr hoch festgelegt werden. Die Hinweise werden mit anderen Attributen jedes Elements verwendet, um die relevantesten Elemente für eine bestimmte Abfrage zurückzugeben.

Führen Sie die folgenden Schritte aus, um Ranghinweise festzulegen:

1. Wechseln Sie im Verwaltungsportal auf der Registerkarte Search und Intelligenz zuAnpassungss-Relevanzoptimierung>.

2. Um eine Liste der Verbindungen anzuzeigen, die optimiert werden können, wählen Sie Details> anzeigenRanghinweise konfigurieren aus.

3. Ändern Sie die Wichtigkeitsgewichtungen für verfügbare Quelleigenschaften.

Standardergebnistypen

Bezeichnungen wirken sich auch darauf aus, wie Standardergebnistypen generiert werden. Durch das Hinzufügen von Titel- und Inhaltsbezeichnungen wird mindestens sichergestellt, dass ein Ergebnistyp für Ihre Verbindung erstellt wird.

Ein Standardergebnistyp mit title und ein Ergebnisausschnitt.

Der Standardergebnistyp bewirkt eine bessere Benutzererfahrung, wenn Sie die folgenden Bezeichnungen ggf. definieren (in aufsteigender Reihenfolge aufgeführt):

• title
• url
• lastModifiedBy
• lastModifiedDateTime
• fileName
• fileExtension

Vergewissern Sie sich abschließend beim Zuweisen von Bezeichnungen folgender Dinge:

• Die Eigenschaften, die Sie als Bezeichnungen auswählen, müssen als "abrufbar" gekennzeichnet sein.
• Die Eigenschaften und die ihnen zugeordneten Bezeichnungen müssen denselben Datentyp aufweisen.
• Sie können einer Bezeichnung nur je eine Eigenschaft zuordnen.

Aliases

Aliase sind Anzeigenamen für Eigenschaften, die von Ihnen zugewiesen werden. Diese werden in Abfragen und Auswahlen in verfeinerbaren Eigenschaftenfiltern verwendet.

Funktionen für die Schemaaktualisierung

Dieser Abschnitt enthält Informationen zu den Aktualisierungsfunktionen für die Schema-API.

Hinweis

Es wird empfohlen, Elemente nach einem Update erneut zu erfassen, um sie auf das neueste Schema zu aktualisieren. Ohne erneutes Erfassen wird das Verhalten der Elemente uneinheitlich sein.

Hinzufügen einer Eigenschaft

Sie können Ihrem Schema eine Eigenschaft hinzufügen. dies erfordert keine erneute Erfassung, sie wird jedoch empfohlen.

Wenn Sie eine Eigenschaft hinzufügen, können Sie alle benötigten Suchattribute mit einschließen.

Hinzufügen/Entfernen einer Suchfunktion

Sie können einer Eigenschaft bestimmte Suchattribute hinzufügen, beachten Sie jedoch, dass Sie kein Einschränkungssuchattribut als Schemaänderung hinzufügen können. Außerdem ist es nicht möglich, einschränkbare Attribute als durchsuchbare Funktionen zu verwenden.

Das Hinzufügen einer Suchfunktion erfordert eine erneute Erfassung.

Hinzufügen/Entfernen eines Alias

Sie können Aliase hinzufügen oder entfernen und sie für Ihre Suchabfragen verwenden.

Beachten Sie, dass Sie den ursprünglichen Alias einer einschränkbaren Eigenschaft, die automatisch vom System erstellt wurde, nicht entfernen können.

Hinzufügen/Entfernen einer semantischen Bezeichnung

Das Hinzufügen einer semantischen Bezeichnung kann sich auf Umgebungen wie Relevanz und Viva Topics auswirken.

Nächste Schritte

• Hinzufügen von Elementen zur Verbindung
• Überprüfen der API-Referenz für Microsoft Graph-Connectors
• Durchsuchen benutzerdefinierter Typen (externalItem)
• Erstellen Ihres ersten benutzerdefinierten Microsoft Graph-Connectors