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

Artículo
06/02/2024

Nota

La información sobre la disponibilidad de funciones es la siguiente.

Dynamics 365 Contact Center - insertado	Dynamics 365 Contact Center—independiente	Dynamics 365 Customer Service
No	Sí	Sí

Este artículo describe los detalles del esquema necesarios para asignar información de proveedores de datos externos a las entidades del artículo de conocimiento y cómo puede preparar su propio archivo JSON de asignación de esquema utilizando varios campos y atributos.

Campos

La siguiente tabla enumera los campos y los detalles de los campos que debe usar en su esquema JSON.

Nombre de campo	Definición	Obligatorio	valor
Name	Nombre de la definición de campo	No	Una cadena que indica el nombre del campo.
UniqueTargetFieldName	Es el identificador único o la clave alternativa de la entidad del artículo de conocimientos. Normalmente, este campo es el ID del lado del proveedor de contenido.	Sí	Una 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 "content".
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í	Un 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

La siguiente tabla enumera los atributos requeridos y opcionales que puede usar en su esquema de mapeo de metadatos.

Nombre de campo	Definición	Obligatorio	valor
TargetFieldName	Es el nombre de campo logico del atributo de destino en la entidad del artículo de conocimientos.	Sí	Cualquier cadena que indica el nombre del campo de destino
TargetFieldType	Indica el tipo del campo de destino.	Sí	Una cadena que indica el tipo del campo.
DocFieldSource	Indica cómo se identificará y resolverá 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 conocer estos tipos de datos, consulte la siguiente sección Tipos de fuente 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. Vea los ejemplos a continuación sobre cómo configurar DocFieldPatterns.
MaxLength	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 expresión regular que se puede aplicar a la URL.	No. Se puede usar cuando el atributo TargetFieldType es del tipo String y el atributo DocFieldSource es del tipo Url.	URL o cadena.

Tipos de origen de campo

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

Regex: se utiliza para indicar un tipo de datos de expresión regular.
Meta: se usa para indicar que el valor del campo de destino se obtiene de una etiqueta <meta> en el artículo de origen
Constante: se utiliza para establecer un valor estático para el campo de destino.
Url: Sirve para indicar la URL del documento fuente externo.
Documento: Sirve 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.

Su plantilla de mapeo debe incluir:

Los campos UniqueTargetFieldName, ContentTargetFieldName y ApiPathLeafName. Estos campos deben establecerse en sus valores requeridos de la siguiente manera:
- Establezca UniqueTargetFieldName en el campo listo para usar msdyn_externalreferenceid o un campo personalizado. Si está utilizando un campo personalizado, asegúrese de agregar el campo como clave alternativa. Más información: Definir claves alternativas para hacer referencia a registros de Dynamics 365.
- Incluya el campo ContentTargetFieldNameContentTargetFieldName 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 lista FieldDefinitions siguiente 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, "tal cual", en su plantilla. Sin embargo, el origen del campo de documento y el patrón de campo de documento para los campos de título y valor de contenido se pueden configurar en Regex, Meta, Documento, Constante 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"
  }

Una vez que haya enumerado 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 establezca cualquier valor personalizado para el atributo, de la siguiente manera.
```
   {
     "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: Transforme y asigne datos de origen externo al atributo de conocimiento de destino correspondiente

Consulte también

Administrar proveedores de búsquedas integrados
Vea y use información valiosa para los proveedores de búsqueda

Compartir a través de