Configurar la asignación de esquemas de artículos de conocimientos

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í

Como parte de agregar un proveedor de búsqueda integrado en Customer Service, debe indicarle al servicio cómo ingerir los artículos de conocimiento que recibe del proveedor. Para ello, seleccione y configure un esquema de artículo de conocimiento. No se puede cambiar el esquema una vez guardada la configfuración.

Si aplicó un filtro de idioma en la sección Autenticación y prueba, debe mantener la asignación para la configuración regional del idioma en el Esquema JSON o en la sección Asignación de esquemas de artículos de conocimiento. Para obtener más información sobre los valores de configuración regional de idioma, vaya a: Referencia de entidad/tabla de idioma (LanguageLocale).

Seleccione una opción en la sección Esquema del artículo de conocimiento:

• Asignación de campos
• Esquema JSON

Asignación de campos

Seleccione y cargue el archivo para la selección de metadatos y luego seleccione las metaetiquetas que desea usar en el mapeo. Con la asignación de campos, asigna un artículo de conocimientos recibido del proveedor de búsqueda (la propiedad de origen) a un atributo de la entidad del artículo de conocimientos (el destino), en función de un tipo de operación.

Seleccione y cargue el archivo para la selección de metadatos

1. Guarde el artículo localmente como un archivo de página web, solo HTML. Asegúrese de que el nombre de archivo tenga menos de 99 caracteres.

2. En el mapa del sitio del centro de administración de Customer Service o del centro de administración del centro de contacto, en la sección Esquema de artículo de conocimiento>Asignación de campo, cargue el archivo seleccionando Elija el archivo.

   Todas las metaetiquetas que se encuentran en su archivo HTML se enumeran en la sección Configuración de metaetiquetas.

3. Seleccione Seleccione todas las metaetiquetas a continuación o seleccione solo las metaetiquetas que necesita asignar.

   Las etiquetas meta que selecciona aquí se convierten en atributos que puede seleccionar como propiedades de origen en la sección Asignación. Si no selecciona ninguna, solo estarán disponibles las propiedades de origen predeterminadas HTML-Title y HTML-Body para asignar.

4. Para ir a la sección Asignación, seleccione Siguiente. Si desea detenerse y volver a este punto más tarde, seleccione Guardar como borrador.

Asignar atributos de artículo

Utilice un tipo de operación para asignar la propiedad de origen al destino.

• Atributos del artículo: los valores de campo de destino del artículo de conocimiento.
• Tipos de operación: los patrones de asignación que asignan el artículo de origen a los atributos del artículo de la entidad del artículo de conocimiento. Obtenga más información sobre las opciones de asignación de tipo de operación.
• Propiedad de origen: el valor que define para cada tipo de operación. Por ejemplo, si selecciona el tipo de operación Directa, debe seleccionar entre las etiquetas meta previamente seleccionadas, o la etiqueta HTML-Title.

1. En el mapa del sitio del centro de administración servicio al cliente o del centro de administración del centro de contacto, sección Asignación, los atributos obligatorios del artículo de conocimiento son Contenido, ID de referencia externa, y Título. Para cada uno, seleccione un Tipo de operación y una Propiedad de origen.

   Asegúrese de que el valor Id. de referencia externa sea único.

2. Para agregar más atributos de artículo, seleccione Agregar fila y luego seleccione un Atributo de artículo, Tipo de operación y Propiedad de origen.

   También puede seleccionar Eliminar para eliminar un atributo de artículo si es necesario.

3. Seleccione Validar asignación.

   El servicio usa los valores que ingresó para determinar los valores de los atributos contra el archivo HTML que cargó. Valida entradas en la tabla de mapeo y patrones Regex. No hay validaciones para RegexUrl.

   Si la validación tiene éxito, verá un mensaje de confirmación. Si falla la validación, verá un mensaje de error. Según el mensaje de error, verifique las entradas en la tabla de mapeo o los patrones de expresiones regulares que ingresó.

4. Seleccione Siguiente para ir a la siguiente sección. Si desea detenerse y volver a este punto más tarde, seleccione Guardar como borrador.

Opciones de asignación de tipo de operación

Seleccione alguna de las siguientes opciones de asignación de tipos de operación:

• Regex: utiliza patrones de expresión regular para extraer valores del sitio web de origen. La propiedad de origen es un campo de texto donde puede ingresar el patrón de expresión regular. La cadena del HTML de su sitio web que coincide con este patrón se asigna al campo del artículo de conocimientos correspondiente.

  Los patrones regex deben tener un grupo de captura entre paréntesis que le permita extraer una parte específica del texto coincidente. El texto se extrae del primer grupo no vacío de la primera coincidencia.

  Estos son algunos ejemplos de patrones de expresiones regulares para extraer contenido de una etiqueta div específica:

  • Basado en la identificación de la etiqueta div: <div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
  • Basado en la clase de la etiqueta div: <div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
  • Para el contenido dentro de la etiqueta del cuerpo: <body[^>]*>([\s\S]*)<\/body>
  • Para el contenido dentro de la etiqueta del encabezado: <head[^>]*>([\s\S]*)<\/head>

• Direct: asigna el valor de cualquier metaetiqueta desde su sitio web de origen directamente a cualquier campo de artículo de conocimiento. La lista Propiedad de origen muestra todas las metaetiquetas extraídas del sitio web de muestra junto con las propiedades de origen HTML-Title y HTML-Body, que están disponibles de forma predeterminada.

  Si selecciona Directa como tipo de operación y og: url como propiedad de origen, entonces el valor de la metaetiqueta de la propiedad de origen og: url se asigna al atributo del artículo de conocimiento correspondiente.

• Constant: ingrese un valor constante en cualquier campo de artículo de conocimiento. La propiedad de origen es un campo de texto donde puede ingresar el valor constante.

• RegexUrl: como Regex, pero busca coincidencias solo en la URL del sitio web de origen. Para asignar toda la URL del sitio web de origen a un campo de atributo de conocimiento, seleccione Regexurl en el tipo de operación y use el patrón (. *) en la propiedad de origen.

A continuación se muestra un ejemplo que explica cómo asignar los atributos del artículo.

Ejemplo

HTML de ejemplo:

<html>
<head>
	<meta charset="utf-8" />
	<meta name="viewport" content="width=device-width, initial-scale=1.0" />
	<meta property="og:type" content="website" />
	<meta property="og:url" content="https://contoso.com/en-us/id/2911cacd-efa5-4593-ae22-e09ae14c6698/ee734739(v=msdn.10)" />
	<meta name="ms.keywords" content="XML Reader, WS-Trust" />
</head>	
<title>WSTrustRequestSerializer.CanRead Method (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn</title>
<body lang="en-us" dir="ltr">
	<div id="ms-descriptionArticle">
	 Checks if an XML reader is positioned at a WS-Trust RequestSecurityToken element. This is crucial for handling security token requests in .NET applications using Windows Identity Foundation (WIF).
	</div>
	<div id="ms--content-well-notifications" data-bi-name="content-well-notification">
	</div>
	<p>Starting with the .NET Framework 4.5, Windows Identity Foundation (WIF) has been fully integrated into the .NET Framework. The version of WIF addressed by this topic, WIF 3.5, is deprecated and should only be used when developing against the .NET Framework 3.5 SP1 or the .NET Framework 4. For more information about WIF in the .NET Framework 4.5, also known as WIF 4.5</p>
	<p>When implemented in a derived class, checks if the specified XML reader is positioned at a WS-Trust RequestSecurityToken element.</p>
	<p><strong>Namespace:</strong> Microsoft.IdentityModel.Protocols.WSTrust<br/>
	<strong>Assembly:</strong> Microsoft.IdentityModel (in Microsoft.IdentityModel.dll)</p>
	<h2 id="usage">Usage</h2>
	<pre><code class="lang-vb">'Usage
	Dim instance As WSTrustRequestSerializer
	Dim reader As XmlReader
	Dim returnValue As Boolean

	returnValue = instance.CanRead(reader)
	</code></pre>
	<h4 id="parameters">Parameters</h4>
	<ul>
	<li><strong>reader</strong><br/>
	The XmlReader object from which to read.</li>
	</ul>
	<h4 id="return-value">Return Value</h4>
	<p><strong>true</strong> if the reader is positioned at an RST element that the serializer can read; otherwise, <strong>false</strong>.</p>
</body>
</html>

Utilice los siguientes tipos de operación para asignar la propiedad de origen al destino en el archivo html de muestra:

donde,

• Atributo del artículo: Contenido
• Tipo de operación: expresión regular
• Propiedad de origen: <body[^>]>([\s\S])</body>

expresión regular de muestra extrae todo el contenido dentro de la etiqueta del cuerpo del archivo HTML.

• Atributo del artículo: Identificación de referencia externa
• Tipo de operación: RegexUrl
• Propiedad de origen: ^https://.?/id/(.?)/.*$

RegexUrl extrae la identificación - 2911cacd-efa5-4593-ae22-e09ae14c6698 del archivo HTML.

• Atributo de artículo: Título
• Tipo de operación: Directa
• Propiedad de origen: HTML-Title

Direct extrae el contenido dentro del campo Título del archivo HTML, por ejemplo, WSTrustRequestSerializer.CanRead Method (Microsoft .IdentityModel.Protocols.WSTrust) | Microsoft Learn

• Atributo del artículo: Descripción
• Tipo de operación: expresión regular
• Propiedad de origen: <div\b[^>]id="ms-descriptionArticle"[^>]>([\s\S]*?)</div>

La expresión regular de muestra extrae contenido de una etiqueta div específica según el ID. Aquí, ms-desciptionArticle es la identificación de la etiqueta div en el html.

• Atributo del artículo: Palabras clave
• Tipo de operación: Directa
• Propiedad de origen: ms.keywords

Direct extrae el contenido dentro del campo ms.keywords del archivo HTML, por ejemplo XML Lector, WS -Confiar.

Esquema de JSON

Obtenga más información sobre los detalles del esquema para crear una plantilla de asignación de metadatos.

1. En el centro de administración de Customer Service o en el mapa del sitio del centro de administración del centro de contacto, sección Esquema de artículo de conocimiento>Esquema JSON , copie y pegue las propiedades y el esquema de su artículo JSON en el campo que se le proporcionó.

2. Seleccione Validar JSON.

   Si la validación tiene éxito, verá un mensaje de confirmación. Si falla la validación, verá un mensaje de error que identifica el parámetro que tiene un valor incorrecto.

3. Seleccione Siguiente para ir a la siguiente sección. Si desea detenerse y volver a este punto más tarde, seleccione Guardar como borrador.

Pasos siguientes

Administrar proveedores de búsquedas integrados