Detalles del esquema para crear una plantilla de asignación de metadatos

2025-05-22

Se aplica a: Dynamics 365 Contact Center: independiente y Dynamics 365 Customer Service

En este artículo se describen los detalles de esquema necesarios para asignar información de proveedores de datos externos a las entidades del artículo de conocimientos y cómo puede preparar su propio archivo JSON de asignación de esquema mediante varios campos y atributos.

Campos

En la tabla siguiente se enumeran los campos y los detalles de los campos que debe utilizar en el esquema JSON.

Nombre del campo	Definición	Obligatorio	Importancia
Nombre	Nombre de la definición de campo	No	Cadena que indica el nombre del campo.
NombreÚnicoDelCampoObjetivo	Identificador único o clave alternativa de la entidad del artículo de conocimiento. Normalmente, este campo es el ID en el lado del proveedor de contenido.	Sí	Cadena que indica el nombre del campo. Puede establecer el valor en "msydn_externalreferenceid"
ContentTargetFieldNameContentTargetFieldName	El valor del campo no se debe cambiar.	Sí	Establezca el valor en "contenido".
ApiPathLeafName	El valor del campo no se debe cambiar.	Sí	Establezca el valor en "knowledgearticles".
List<FieldDefinitions>	Es una lista de definiciones de campo.	Sí	Conjunto de definiciones para los campos. Consulte la siguiente tabla para ver la lista de campos admitidos para establecer definiciones de campo.

Definiciones de campo

En la tabla siguiente se enumeran los atributos obligatorios y opcionales que puede utilizar en el esquema de asignación de metadatos.

Nombre del campo	Definición	Obligatorio	Importancia
NombreDelCampoObjetivo	Es el nombre de campo logico del atributo de destino en la entidad del artículo de conocimientos.	Sí	Cualquier cadena que indique el nombre del campo de destino
TargetFieldType	Indica el tipo de campo de destino.	Sí	Cadena que indica el tipo del campo.
DocFieldSource	Indica cómo se identifica y resuelve el valor del campo de origen en tiempo de ejecución	Sí	Establezca el valor en uno de los siguientes tipos de origen: Regex Metadatos Constante URL Documento Para obtener información sobre estos tipos de datos, consulte la siguiente sección Tipos de fuentes de campo.
DocFieldPattern	Indica la naturaleza del campo de destino que se va a recuperar.	No	Establezca este valor en función del valor de DocFieldSource. Consulte los ejemplos siguientes sobre cómo establecer DocFieldPatterns.
Longitud máxima	Es la longitud máxima de la cadena que se puede almacenar en el campo de destino.	No. Se puede usar cuando el atributo TargetFieldType es de tipo String	Int
UseRegexCapture	Almacena el patrón de expresiones regulares que se puede aplicar a la dirección URL.	No. Se puede usar cuando el atributo TargetFieldType es de tipo String y el atributo DocFieldSource es de tipo Url.	URL o cadena.

Tipos de fuentes de campo

Los datos de los proveedores de búsqueda externos se pueden establecer en cualquiera de los siguientes tipos de fuentes de campo:

Regex: se utiliza para indicar un tipo de expresión regular de datos.
Meta: se utiliza para indicar que el valor del campo de destino se obtiene de una <metaetiqueta> en el artículo de origen
Constante: se utiliza para establecer un valor estático para el campo de destino.
URL: Se utiliza para indicar la URL del documento fuente externo.
Documento: Usar para indicar el contenido HTML del artículo.

Consideraciones para construir su propia plantilla de mapeo de metadatos

Cuando desarrolle su propio esquema de mapeo, debe asegurarse de configurar algunos campos obligatorios y establecer valores predeterminados para algunas definiciones de campo.

La plantilla de mapeo debe incluir:

Los campos UniqueTargetFieldName, ContentTargetFieldName y ApiPathLeafName . Estos campos deben establecerse en sus valores obligatorios de la siguiente manera:
- Establezca UniqueTargetFieldName en el campo predeterminado msdyn_externalreferenceid o en un campo personalizado. Si usas un campo personalizado, asegúrate de agregar el campo como una clave alternativa. Más información: Definir claves alternativas para hacer referencia a registros de Dynamics 365.
- Incluya el campo ContentTargetFieldName y establezca su valor en "content".
- Incluya el campo ApiPathLeafName y establezca su valor en "knowledgearticles".
- Asegúrese de proporcionar asignaciones para UniqueTargetField y ContentTargetFieldContentTargetField en la lista Definiciones de campo.
Su esquema de mapeo se vería así:
```
  {
    "Name": "{To be filled by you}",
    "UniqueTargetFieldName": "msdyn_externalreferenceid",
    "ContentTargetFieldName": "content",
    "ApiPathLeafName": "knowledgearticles"
    "FieldDefinitions": []
  }
```

Debe incluir la siguiente lista de FieldDefinitions y rellenar sus atributos, como FieldUse, DocFieldSource, TargetFieldName y TargetFieldType , con valores predeterminados. Asegúrese de incluir los siguientes campos y atributos con sus valores, "as-is", en la plantilla. Sin embargo, puede establecer Docfieldsource y Docfieldpattern para los campos de título y valor de contenido en Regex, Meta, Document, Constant o Url.


  {
    "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"
  }

Después de enumerar los campos obligatorios y la información de atributos, puede incluir asignaciones de metadatos adicionales y establecer sus propios valores personalizados para ellos. Por ejemplo, puede incluir un tipo Meta de DocFieldSource y establecer los valores personalizados para el atributo, como se indica a continuación.
```
   {
     "DocFieldSource": "Meta",
     "DocFieldPattern": "description",
     "TargetFieldName": "description",
     "TargetFieldType": "String",
     "MaxLength": 155
    }
```

Ejemplo de plantilla de mapeo de metadatos

Puede utilizar el siguiente ejemplo JSON de asignación de metadatos como plantilla para crear su propia plantilla de asignación personalizada.


   {
     "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})$"
        }
    ]
 }

Transforme, asigne datos de fuentes externas a campos de conocimiento

Cuando asigna información de proveedores de datos externos a entidades de artículos de conocimiento, si el valor de origen es de un tipo de datos diferente, tendrá que transformar el valor antes de poder asignarlo al campo de conocimiento de destino. Más información: Transformar y asignar datos de origen externo al atributo de conocimiento de destino correspondiente

Administrar proveedores de búsquedas integrados
Ver y usar información valiosa para los proveedores de búsqueda

Compartir a través de