Configurar o mapeamento de esquema do artigo de conhecimento

Como parte da adição de um provedor de pesquisa integrada no Customer Service, você precisa informar ao serviço como ingerir os artigos de conhecimento recebidos do provedor. Você faz isso selecionando e configurando um esquema do artigo de conhecimento. Você não poderá alterar o esquema depois de salvar a configuração.

Se tiver aplicado um filtro de idioma na seção Autenticação e testes, você deverá manter o mapeamento da localidade do idioma no Esquema JSON ou na seção Mapeamento de esquema do artigo de conhecimento. Para obter mais informações sobre valores de localidade de idioma, acesse: Referência de tabela/entidade de idioma (LanguageLocale).

Selecione uma opção na seção Esquema do artigo de conhecimento:

• Mapeamento de campos
• Esquema JSON

Mapeamento de campos

Selecione e carregue o arquivo para seleção de metadados e, em seguida, selecione as marcas meta que você deseja usar no mapeamento. Com o mapeamento de campos, você mapeia um artigo de conhecimento recebido do provedor de pesquisa (a propriedade de origem) para um atributo da entidade do artigo de conhecimento (o destino), com base em um tipo de operação.

Selecione e carregue o arquivo para seleção de metadados

1. Salve o artigo localmente como um arquivo Página da Web, Somente HTML. Verifique se o nome do arquivo tem menos de 99 caracteres.

2. No mapa do site do Centro de administração do Customer Service, seção Esquema do artigo de conhecimento>Mapeamento de Campo, carregue o arquivo selecionando Escolher arquivo.

   Todas as marcas meta encontradas no arquivo HTML estão listadas na seção Configurações de marcas meta.

3. Escolha Selecionar todas as marcas meta abaixo ou só selecione as marcas meta que você precisa mapear.

   As marcas meta selecionadas aqui se tornam atributos que você pode selecionar como propriedades de origem na seção Mapeamento. Se você não selecionar nenhuma, somente as propriedades de origem padrão HTML-Title e HTML-Body estão disponíveis para serem mapeadas.

4. Para ir até a seção Mapeamento, selecione Avançar. Se quiser parar e voltar a esse ponto mais tarde, selecione Salvar como rascunho.

Mapear atributos de artigo

Use um tipo de operação para mapear a propriedade de origem para o destino.

• Atributos do artigo: os valores do campo de destino do artigo de conhecimento.
• Tipos de operação: os padrões de mapeamento que mapeiam o artigo de origem para os atributos de artigo da entidade do artigo de conhecimento. Saiba mais sobre opções de mapeamento do tipo de operação.
• Propriedade fonte: o valor definido para cada tipo de operação. Por exemplo, se selecionar o tipo de operação Direta, você deverá selecionar uma das metamarcas selecionadas anteriormente ou a marca HTML-Title.

1. No mapa do site do Centro de administração do Customer Service, na seção Mapeamento, os atributos do artigo de conhecimento obrigatórios são Conteúdo, ID de Referência Externa e Título. Para cada um, selecione um Tipo de Operação e uma Propriedade de Origem.

   Verifique se o valor ID de Referência Externa é exclusivo.

2. Para adicionar mais atributos de artigo, selecione Adicionar Linha, um Atributo de Artigo, Tipo de Operação e Propriedade de Origem.

   Você também pode selecionar Excluir para excluir um atributo de artigo, se necessário.

3. Selecione Validar mapeamento.

   O serviço usa os valores inseridos para determinar os valores dos atributos em relação ao arquivo HTML carregado. Ele valida entradas na tabela de mapeamento e padrões Regex. Não há nenhuma validação para RegexUrl.

   Se a validação for bem-sucedida, você verá uma mensagem de confirmação. Se a validação falhar, você verá uma mensagem de erro. Dependendo da mensagem de erro, verifique as entradas na tabela de mapeamento ou os padrões regex inseridos.

4. Selecione Avançar a fim de ir para a próxima seção. Se quiser parar e voltar a esse ponto mais tarde, selecione Salvar como rascunho.

Opções de mapeamento de tipo de operação

Selecione uma das seguintes opções do mapeamento do tipo de operação:

• Regex: usa padrões regex para extrair valores do site de origem. A propriedade de origem é um campo de texto no qual você pode inserir o padrão regex. A cadeia de caracteres do HTML do site correspondente a esse padrão é mapeada para o campo do artigo de conhecimento correspondente.

  Os padrões regex devem ter um grupo de captura entre parênteses que permite extrair uma parte específica do texto correspondente. O texto é extraído do primeiro grupo não vazio da primeira correspondência.

  Aqui estão alguns exemplos de padrões regex para extrair conteúdo de uma marca div específica:

  • Com base na ID da marca div: <div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
  • Com base na classe da marca div: <div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
  • Para conteúdo dentro da marca body: <body[^>]*>([\s\S]*)<\/body>
  • Para conteúdo dentro da marca head: <head[^>]*>([\s\S]*)<\/head>

• Direto: mapeia o valor de qualquer marca meta do site de origem diretamente para qualquer campo do artigo de conhecimento. A lista Propriedade de Origem mostra todas as marcas meta extraídas do site de amostra com as propriedades de origem HTML-Title e HTML-Body, disponíveis por padrão.

  Se você selecionar Direto como o tipo de operação e og: url como a propriedade de origem, o valor da marca meta og: url da propriedade de origem será mapeada para o atributo do artigo de conhecimento correspondente.

• Constante: insira um valor constante em qualquer campo do artigo de conhecimento. A propriedade de origem é um campo de texto no qual você pode inserir o valor constante.

• RegexUrl: funciona como o Regex, mas só procura correspondências na URL do site de origem. Para mapear toda a URL do site de origem para um campo do atributo de conhecimento, selecione Regexurl no tipo de operação e use o padrão (. *) na propriedade de origem.

Aqui está um exemplo que explica como mapear os atributos do artigo.

Exemplo

HTML de amostra:

<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>

Use os seguintes tipos de operação para mapear a propriedade de origem para o destino no arquivo html de amostra:

em que,

• Atributo do Artigo: Conteúdo
• Tipo de operação: Regex
• Propriedade de Origem: <body[^>]>([\s\S])</body>

Regex de amostra extrai todo o conteúdo dentro da marca body do arquivo HTML.

• Atributo do Artigo: ID de Referência Externa
• Tipo de operação: RegexUrl
• Propriedade da Origem: ^https://.?/id/(.?)/.*$

RegexUrl extrai a ID – 2911cacd-efa5-4593-ae22-e09ae14c6698 do arquivo HTML.

• Atributo do Artigo: Título
• Tipo de operação: Direta
• Propriedade de Origem: HTML-Título

Direta extrai o conteúdo dentro do campo Título do arquivo HTML; por exemplo, WSTrustRequestSerializer.CanRead Method (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn

• Atributo do Artigo: Descrição
• Tipo de operação: Regex
• Propriedade de Origem: <div\b[^>]id="ms-descriptionArticle"[^>]>([\s\S]*?)</div>

Regex de amostra extrai conteúdo de uma marca div específica com base na ID. Aqui, ms-desciptionArticle está a ID da marca div no html.

• Atributo do Artigo: palavras-chave
• Tipo de operação: Direta
• Propriedade de Origem: ms.keywords

Direta extrai o conteúdo dentro do campo ms.keywords do arquivo HTML, por exemplo XML Reader, WS-Trust.

Esquema do JSON

Saiba mais sobre os detalhes do esquema para compilar um modelo de mapeamento de metadados.

1. No mapa do site do Centro de administração do Customer Service, seção Esquema do artigo de conhecimento>Esquema JSON, copie e cole as propriedades do artigo e o esquema JSON no campo fornecido para você.

2. Selecione Validar JSON.

   Se a validação for bem-sucedida, você verá uma mensagem de confirmação. Se a validação falhar, você verá uma mensagem de erro que identifica o parâmetro que apresenta um valor incorreto.

3. Selecione Avançar a fim de ir para a próxima seção. Se quiser parar e voltar a esse ponto mais tarde, selecione Salvar como rascunho.

Próximas etapas

Gerenciar provedores de pesquisa integrada