Teilen über

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

  • Artikel

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 Zeichenfolge ✔️ ✔️
lastEditedDate DateTime ✔️ ✔️ ✔️ lastModifiedDateTime editedDate
lastEditedBy String ✔️ ✔️ ✔️ lastModifiedBy edited
workItemType String ✔️ ✔️ ticketType
priority Int64 ✔️
tags StringCollection ✔️ ✔️ ✔️ ✔️
status Zeichenfolge ✔️ ✔️
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.

Eine Suche nach

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

Der Suffixabgleich wird nicht unterstützt.

Suchvorgang nach

Suchvorgang nach "search ba" mit Ergebnissen, die diesem Präfix entsprechen.

Suchvorgang nach

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, die als Ergebnis dargestellt werden.

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.

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.

  • Die Abfrage ticketId:CTS-ce913b61 gibt das Element mit der Ticket-ID-Eigenschaft CTS-ce913b61 zurück.
  • Die Abfrage ticketId:CTS gibt das Element mit der Ticket-ID CTS-ce913b61 nicht zurück.

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

  • Die tags:contoso Abfrage gibt jedes Element mit dem Tag contoso zurück.
  • 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 keine genaue Übereinstimmung an. Wenn nichts angegeben ist, ist falseisExactMatchRequired . Die title-Eigenschaft wird basierend auf den Tokenisierungsregeln der Sprache des Elementinhalts tokenisiert.

  • Die title:Contoso Title Abfrage gibt jedes Element zurück, das oder Title in der title-Eigenschaft enthältContoso.

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 keinen Sinn ergibt. 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 Suchverwaltungsportal 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 zur Registerkarte Suche und Intelligenz .
  2. Wählen SieAnpassungs-Relevanzoptimierung> aus.

Screenshot der Registerkarte

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

Screenshot der Registerkarte

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

Screenshot der Registerkarte

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 Titel und ein Ergebnisausschnitt.

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 erneute Erfassung ist das Verhalten der Elemente inkonsistent.

Hinzufügen einer Eigenschaft

Sie können ihrem Schema eine Eigenschaft hinzufügen. Dies erfordert keine erneute Erfassung, 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änkungssuchsattribut als Schemaänderung hinzufügen können. Außerdem ist es nicht möglich, verfeinerbare 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änkungsfähigen Eigenschaft, die vom System automatisch generiert 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