Schemadetails zum Erstellen einer Vorlage zur Metadatenzuordnung

Artikel
08/14/2024

Anmerkung

Die Informationen zur Verfügbarkeit des Features lauten wie folgt.

Dynamics 365 Contact Center – eingebettet	Dynamics 365 Contact Center – eigenständig	Dynamics 365 Customer Service
Nein	Ja	Ja

Dieser Artikel beschreibt die Schemadetails, die erforderlich sind, um Informationen von externen Datenanbietern den Entitäten des Wissensartikels zuzuordnen, und wie Sie mithilfe verschiedener Felder und Attribute Ihre eigene Schemazuordnungs-JSON-Datei erstellen können.

Felder

Die folgende Tabelle enthält die Felder und Felddetails, die Sie in Ihrem JSON-Schema verwenden müssen.

Feldname	Definition	Erforderlich	Wert
Name des Dataflows	Name der Felddefinition	Nein	Eine Zeichenfolge, die den Namen des Felds angibt.
UniqueTargetFieldName	Der eindeutige Bezeichner oder alternative Schlüssel der Wissensartikelentität. Typischerweise ist dieses Feld die ID auf der Inhaltsanbieterseite.	Ja	Eine Zeichenfolge, die den Namen des Felds angibt. Sie können den Wert auf „msydn_externalreferenceid“ setzen
ContentTargetFieldName	Dieser Feldwert sollte nicht geändert werden.	Ja	Legen Sie den Wert auf „Inhalt“ fest.
ApiPathLeafName	Dieser Feldwert sollte nicht geändert werden.	Ja	Legen Sie den Wert auf „Wissensartikel“ fest.
List<FieldDefinitions>	Ist eine Liste von Felddefinitionen.	Ja	Eine Reihe von Definitionen für die Felder. Die folgende Tabelle enthält eine Liste der zum Festlegen von Felddefinitionen unterstützten Felder.

Felddefinitionen

In der folgenden Tabelle sind die erforderlichen und optionalen Attribute aufgeführt, die Sie in Ihrem Schema für die Metadatenzuordnung verwenden können.

Feldname	Definition	Erforderlich	Wert
TargetFieldName	Ist in der Wissensartikelentität der logische Feldname auf dem Zielattribut.	Ja	Jede Zeichenfolge, die den Namen des Zielfelds angibt
TargetFieldType	Gibt den Typ des Zielfelds an.	Ja	Eine Zeichenfolge, die den Typ des Felds angibt.
DocFieldSource	Gibt an, wie der Quellfeldwert zur Runtime identifiziert und aufgelöst wird	Ja	Legen Sie den Wert auf einen der folgenden Quelltypen fest: RegEx Meta Konstante Url Dokument Informationen zu diesen Datentypen finden Sie im folgenden Abschnitt „Feldquelltypen“.
DocFieldPattern	Gibt die Art des Zielfelds an, das abgerufen werden soll.	Nein	Legen Sie diesen Wert ausgehend vom DocFieldSource-Wert fest. In den folgenden Beispielen erfahren Sie, wie Sie DocFieldPatterns festlegen.
MaxLength	Die maximale Länge der Zeichenfolge, die im Zielfeld gespeichert werden kann.	Nein. Kann verwendet werden, wenn das Attribut TargetFieldType den Typ „Zeichenfolge“ hat	Int
UseRegexCapture	Speichert das RegEx-Muster, das auf die URL angewendet werden kann.	Nein. Kann verwendet werden, wenn das Attribut TargetFieldType den Typ „Zeichenfolge“ und das Attribut DocFieldSource den Typ „URL“ hat.	URL oder Zeichenfolge.

Feldquelltypen

Die Daten in den externen Suchanbietern können auf einen der folgenden Feldquellentypen festgelegt werden:

RegEx: Wird verwendet, um einen Datentyp eines regulären Ausdrucks anzugeben.
Meta: Wird verwendet, um anzugeben, dass der Zielfeldwert von einem <Meta>-Tag im Quellartikel abgerufen wird
Konstante: Wird verwendet, um einen statischen Wert für das Zielfeld festzulegen.
URL: Wird verwendet, um die URL des externen Quelldokuments anzugeben.
Dokument: Wird verwendet, um den HTML-Inhalt des Artikels anzugeben.

Überlegungen zum Erstellen Ihrer eigenen Vorlage zur Metadatenzuordnung

Wenn Sie Ihr eigenes Zuordnungsschema entwickeln, müssen Sie einige Pflichtfelder konfigurieren und Standardwerte für einige Felddefinitionen festlegen.

Ihre Zuordnungsvorlage muss Folgendes enthalten:

Die Felder UniqueTargetFieldName, ContentTargetFieldName und ApiPathLeafName. Diese Felder müssen wie folgt auf die erforderlichen Werte gesetzt werden:
- Legen Sie UniqueTargetFieldName auf das sofort einsatzbereite Feld msdyn_externalreferenceid oder auf ein benutzerdefiniertes Feld fest. Wenn Sie ein benutzerdefiniertes Feld verwenden, stellen Sie sicher, dass Sie das Feld als Alternativschlüssel hinzufügen. Weitere Informatinen: Alternativschlüsseln für den Verweis auf Dynamics 365-Datensätze definieren
- Nehmen Sie das Feld ContentTargetFieldName mit auf und legen Sie seinen Wert auf „Inhalt“ fest.
- Nehmen Sie das Feld ApiPathLeafName mit auf und legen Sie seinen Wert auf „Wissensartikel“ fest.
- Stellen Sie sicher, dass Sie für die Felder UniqueTargetField und ContentTargetField in der Liste FieldDefinitions Zuordnungen bereitstellen.
Ihr Zuordnungsschema sieht wie folgt aus:
```
  {
    "Name": "{To be filled by you}",
    "UniqueTargetFieldName": "msdyn_externalreferenceid",
    "ContentTargetFieldName": "content",
    "ApiPathLeafName": "knowledgearticles"
    "FieldDefinitions": []
  }
```

Sie müssen die folgende FieldDefinitions-Liste aufnehmen und Standardwerte in ihre Attribute wie FieldUse, DocFieldSource, TargetFieldName und TargetFieldType eintragen. Stellen Sie sicher, dass Sie die Werte der folgenden Felder und Attribute unverändert in Ihre Vorlage aufnehmen. Docfieldsource und Docfieldpattern für den Titel und die Inhaltswertfelder können jedoch entweder auf RegEx, Meta, Dokument, Konstante oder URL festgelegt werden.


  {
    "FieldUse": "Create",
    "DocFieldSource": "ArticlePublicNumber",
    "TargetFieldName": "articlepublicnumber",
    "TargetFieldType": "String"
  },
  {
     "DocFieldSource": "Constant",
     "DocFieldPattern": "true",
     "TargetFieldName": "msdyn_isingestedarticle",
     "TargetFieldType": "Boolean"
  },
  {
     "DocFieldSource": "Url",
     "TargetFieldName": "msdyn_ingestedarticleurl",
     "TargetFieldType": "String"
  },
  {
     "DocFieldSource": "DataProvider",
     "TargetFieldName": "msdyn_integratedsearchproviderid@odata.bind",
     "TargetFieldType": "String"
  },
  {
     "DocFieldSource": "Regex",
     "DocFieldPattern": "<title>(.*?)</title>",
     "TargetFieldName": "title",
     "TargetFieldType": "String"
  },
  {
     "DocFieldSource": "Url",
     "TargetFieldName": "msdyn_externalreferenceid",
     "TargetFieldType": "String",
     "UseRegexCapture": "^https://.*?/(.*?)/.*/.*?([0-9A-F]{8}[-](?:[0-9A-F]{4}[-]){3}[0-9A-F]{12})$"
 }, 
  {
     "DocFieldSource": "Document",
     "TargetFieldName": "content",
     "TargetFieldType": "String"
  }

Nachdem Sie die obligatorischen Felder und Attributinformationen aufgelistet haben, können Sie zusätzliche Metadatenzuordnungen mitaufnehmen und Ihre eigenen benutzerdefinierten Werte dafür festlegen. Sie können beispielsweise einen Metatyp von DocFieldSource einfügen und benutzerdefinierte Werte für das Attribut wie folgt festlegen.
```
   {
     "DocFieldSource": "Meta",
     "DocFieldPattern": "description",
     "TargetFieldName": "description",
     "TargetFieldType": "String",
     "MaxLength": 155
    }
```

Beispiel einer Vorlage für die Metadatenzuordnung

Sie können das folgende JSON-Beispiel für die Metadatenzuordnung als Vorlage verwenden, um Ihre eigene benutzerdefinierte Zuordnungsvorlage zu erstellen.


   {
     "Name": "Integrated Search Data Provider Name",
     "UniqueTargetFieldName": "msdyn_externalreferenceid",
     "ContentTargetFieldName": "content",
     "ApiPathLeafName": "knowledgearticles",
     "FieldDefinitions": [
     {
       "FieldUse": "Create",
       "DocFieldSource": "ArticlePublicNumber",
       "TargetFieldName": "articlepublicnumber",
       "TargetFieldType": "String"
      },
      {
        "DocFieldSource": "Constant",
        "DocFieldPattern": "true",
        "TargetFieldName": "msdyn_isingestedarticle",
        "TargetFieldType": "Boolean"
      },
      {
        "DocFieldSource": "Url",
        "TargetFieldName": "msdyn_ingestedarticleurl",
        "TargetFieldType": "String"  
      },
      {
        "DocFieldSource": "DataProvider",
        "TargetFieldName": "msdyn_integratedsearchproviderid@odata.bind",
        "TargetFieldType": "String"
      },
      {
        "DocFieldSource": "Regex",
        "DocFieldPattern": "<title>(.*?)</title>",
        "TargetFieldName": "title",
        "TargetFieldType": "String"
       },
       {
          "DocFieldSource": "Meta",
          "DocFieldPattern": "description",
          "TargetFieldName": "description",
          "TargetFieldType": "String",
          "MaxLength": 155
       },
       {
          "DocFieldSource": "Document",
          "TargetFieldName": "content",
          "TargetFieldType": "String"
        },
        {
          "DocFieldSource": "Url",
          "TargetFieldName": "msdyn_externalreferenceid",
          "TargetFieldType": "String",
          "UseRegexCapture": "^https://.*?/(.*?)/.*/.*?([0-9A-F]{8}[-](?:[0-9A-F]{4}[-]){3}[0-9A-F]{12})$"
        }
    ]
 }

Externe Quelldatenwissensfeldern transformieren und zuordnen

Wenn Sie Informationen von externen Datenanbietern Wissensartikelentitäten zuordnen und der Quellwert einen anderen Datentyp hat, müssen Sie den Wert transformieren, bevor Sie ihn dem Zielwissensfeld zuordnen können. Weitere Informationen: Externe Quelldaten transformieren und dem entsprechenden Zielwissensattribut zuordnen

Siehe auch

Integrierte Suchanbieter verwalten
Erkenntnisse für Suchanbieter anzeigen und verwenden

Freigeben über