Exibição ServiceNow Artigos de conhecimento em uma página do Adobe Experience Manager

Use os componentes de conhecimento disponíveis no Adobe Experience Manager (AEM) para acessar bases de conhecimento do ServiceNow E exiba artigos de conhecimento associados em um site baseado no AEM.

Antes de Iniciar

• Ative o plug-in da API Conhecimento (sn_km_api) para usar os endpoints da REST API da Gestão de conhecimento para artigos de conhecimento. Para obter mais informações, consulte REST API da Gestão de conhecimento .
• Defina a regra de compartilhamento de recursos de origem cruzada (CORS) para acessar a API de conhecimento da sua instância do AEM. Para obter mais informações, consulte Defina uma regra de compartilhamento de recursos de origem cruzada (CORS) para acessar ServiceNow Endpoints de API do AEM.

Função necessária: Autor do AEM

Procedimento

1. Faça login na sua instância do AEM.
2. Abra sua página do AEM em Modo de edição .
3. Abra o. navegador de componentes .
4. Em Todos , selecione ServiceNow .
5. Arraste um componente para a posição necessária na página.
   Nota:

   Se os componentes não estiverem disponíveis, atualize a configuração do modelo para incluir os componentes de conhecimento. Além disso, você deve modificar as propriedades do modelo de site e adicionar cada componente do artigo de conhecimento à lista de componentes permitidos.
6. Abra o. caixa de diálogo do componente para edição .
   Nota:

   Por padrão, os componentes de conhecimento no modo Editar de uma página no AEM não podem ser acessados por usuários públicos, que são usuários anônimos do AEM que não estão conectados. Para mudar o comportamento padrão, você deve habilitar Público propriedade para cada componente de conhecimento.
7. Defina as propriedades do componente Resultados da pesquisa para exibir resultados da pesquisa de conhecimento que incluem uma lista de artigos de conhecimento das bases de conhecimento no ServiceNow instância.

   Tabela 1. Propriedades do componente Resultados da pesquisa

   Propriedade	Descrição
   Público(a)	Opção para tornar o conteúdo do componente visível para usuários públicos. Quando selecionado, os artigos de conhecimento disponíveis para usuários não autenticados incluídos no componente ficam disponíveis para todos os usuários, incluindo usuários públicos.
   Bases de Conhecimento	Identificador do sistema (sys_id) de uma base de conhecimento que contém artigos de conhecimento associados. Clique em Adicionar campo e insira o sys_id de uma base de conhecimento. Você pode adicionar várias entradas. Nota: Se você não adicionar um valor, as bases de conhecimento das definições de configuração do OSGi serão usadas para ServiceNow componentes.
   Idioma	Habilita a exibição de resultados de pesquisa de artigos de conhecimento em diferentes idiomas. Selecione uma das seguintes opções. Selecione Configuração do ServiceNow OSGi : Artigos de conhecimento são exibidos no idioma configurado na configuração do OSGi para ServiceNow componentes. Este valor é selecionado por padrão. Restringir ao idioma do portal : Artigos de conhecimento são exibidos no idioma configurado no site do AEM. Todos os idiomas : Artigos de conhecimento são exibidos em todos os idiomas.
   Parâmetro de pesquisa	Chave de parâmetro para a consulta de pesquisa. Exemplo: kb_query
   Campos secundários	Metadados de um artigo de conhecimento que aparecem com o artigo. Os metadados incluem informações como o autor, a data em que o artigo foi atualizado pela última vez e a data em que o artigo foi exibido pela última vez. Para várias entradas, separe os campos por vírgulas. Exemplo: sys_view_count,sys_updated_on,rating
   Contagem de resultados de pesquisa	Número máximo de artigos incluídos na lista de resultados da pesquisa. Use os ícones de incremento ou diminuição para aumentar ou diminuir os valores. Você também pode inserir manualmente um valor. O valor deve ser maior que 1 .
   URL da página do artigo	URL relativa da página do artigo para redirecionar. Exemplo: /Content/NOWApp/now_article_view.html
   Classe CSS personalizada	Classe CSS personalizada para aplicar estilos personalizados a este componente. Para obter mais informações, consulte Personalizando as cores de ServiceNow Componentes no AEM.

8. Defina as propriedades do componente Caixa de pesquisa para exibir uma caixa de pesquisa para que os usuários insiram texto de pesquisa e encontrem artigos de conhecimento no ServiceNow instância correspondente ao texto de pesquisa.
   Nota:

   Acionar uma pesquisa do componente Caixa de pesquisa leva ao componente Resultados da pesquisa.

   Tabela 2. Propriedades do componente da caixa de pesquisa

   Propriedade	Descrição
   Público(a)	Opção para tornar o conteúdo do componente visível para usuários públicos. Quando selecionado, os artigos de conhecimento disponíveis para usuários não autenticados incluídos no componente ficam disponíveis para todos os usuários, incluindo usuários públicos.
   Espaço reservado	Texto de dica exibido na caixa de pesquisa para fornecer informações sobre o que os usuários podem pesquisar ou condições para o texto de pesquisa. Exemplo: Pesquisar (mínimo de três caracteres)
   Bases de Conhecimento	Identificador do sistema (sys_id) de uma base de conhecimento que contém artigos de conhecimento associados. Clique em Adicionar campo e insira o sys_id de uma base de conhecimento. Você pode adicionar várias entradas. Nota: Se você não adicionar um valor, as bases de conhecimento das definições de configuração do OSGi serão usadas para ServiceNow componentes.
   Idioma	Habilita a exibição de artigos de conhecimento em diferentes idiomas na caixa de pesquisa. Selecione uma das seguintes opções. Selecione Configuração do ServiceNow OSGi : Artigos de conhecimento são exibidos no idioma configurado na configuração do OSGi para ServiceNow componentes. Este valor é selecionado por padrão. Restringir ao idioma do portal : Artigos de conhecimento são exibidos no idioma configurado no site do AEM. Todos os idiomas : Artigos de conhecimento são exibidos em todos os idiomas.
   URL da página de pesquisa	URL relativa da página de pesquisa para a qual redirecionar. Exemplo: /Content/NOWApp/now_article_search.html
   Parâmetro de pesquisa	Chave de parâmetro para a consulta de pesquisa. Exemplo: kb_query
   Autocompletável	Opção para habilitar a pesquisa autocompletável.
   Contagem de resultados de pesquisa autocompletável	Número máximo de artigos a serem incluídos na lista de resultados da pesquisa autocompletável. Use os ícones de incremento ou diminuição para aumentar ou diminuir os valores. Você também pode inserir manualmente um valor. O valor deve ser maior que 1 .
   URL da página do artigo	URL relativa da página do artigo para redirecionar. Exemplo: /Content/NOWApp/now_article_view.html
   Classe CSS personalizada	Classe CSS personalizada para aplicar estilos personalizados a este componente. Para obter mais informações, consulte Personalizando as cores de ServiceNow Componentes no AEM.

9. Defina as propriedades do componente Exibição de artigo para exibir artigos de conhecimento e seus anexos, se disponíveis, de um ServiceNow instância.

   Tabela 3. Propriedades do componente de Exibição de artigo

   Propriedade	Descrição
   Público(a)	Opção para tornar o conteúdo do componente visível para usuários públicos. Quando selecionado, os artigos de conhecimento disponíveis para usuários não autenticados incluídos no componente ficam disponíveis para todos os usuários, incluindo usuários públicos.
   Parâmetro do artigo	Nome do parâmetro de consulta de URL do número do artigo. Exemplo: kb_article
   Campos secundários	Metadados de um artigo de conhecimento que aparecem com o artigo. Os metadados incluem informações como o autor, a data em que o artigo foi atualizado pela última vez e a data em que o artigo foi exibido pela última vez. Para várias entradas, separe os campos por vírgulas. Exemplo: sys_view_count,sys_updated_on,rating
   Parâmetro de idioma	Nome do parâmetro de consulta de URL que contém o idioma solicitado para um artigo de conhecimento. Exemplo: kb_lang
   Classe CSS personalizada	Classe CSS personalizada para aplicar estilos personalizados a este componente. Para obter mais informações, consulte Personalizando as cores de ServiceNow Componentes no AEM.

10. Defina as propriedades do componente Lista de artigos para exibir uma lista de artigos de conhecimento, dependendo dos critérios da lista.

    Tabela 4. Propriedades do componente da lista de artigos

    Propriedade	Descrição
    Público(a)	Opção para tornar o conteúdo do componente visível para usuários públicos. Quando selecionado, os artigos de conhecimento disponíveis para usuários não autenticados incluídos no componente ficam disponíveis para todos os usuários, incluindo usuários públicos.
    Título	Título correspondente à lista de artigos que aparece como o cabeçalho do componente. Exemplo: Artigos mais vistos
    Bases de Conhecimento	Identificador do sistema (sys_id) de uma base de conhecimento que contém artigos de conhecimento associados. Clique em Adicionar campo e insira o sys_id de uma base de conhecimento. Você pode adicionar várias entradas. Nota: Se você não adicionar um valor, as bases de conhecimento das definições de configuração do OSGi serão usadas para ServiceNow componentes.
    Idioma	Habilita a exibição de um artigo de conhecimento em diferentes idiomas ao exibir o artigo. Selecione uma das seguintes opções. Selecione Configuração do ServiceNow OSGi : Artigos de conhecimento são exibidos no idioma configurado na configuração do OSGi para ServiceNow componentes. Este valor é selecionado por padrão. Restringir ao idioma do portal : Artigos de conhecimento são exibidos no idioma configurado no site do AEM. Todos os idiomas : Artigos de conhecimento são exibidos em todos os idiomas.
    Campos secundários	Metadados de um artigo de conhecimento que aparecem com o artigo. Os metadados incluem informações como o autor, a data em que o artigo foi atualizado pela última vez e a data em que o artigo foi exibido pela última vez. Para várias entradas, separe os campos por vírgulas. Exemplo: sys_view_count,sys_updated_on,rating
    Critério	Lista de critérios para a lista de artigos de conhecimento. Selecione uma das seguintes opções. Em destaque : Lista de artigos de conhecimento em destaque com base nas palavras-chave configuradas no glide.knowman.default_keywordpropriedade. Para obter informações sobre artigos em destaque, consulte Adicione um artigo de conhecimento ao conteúdo em destaque e. Propriedades de conhecimento . Mais visualizados : Lista de artigos de conhecimento com mais exibições.
    Contagem de artigos	Número máximo de artigos a serem incluídos na lista de artigos. Use os ícones de incremento ou diminuição para aumentar ou diminuir os valores. Você também pode inserir manualmente um valor. O valor deve ser maior que 1 .
    URL da página do artigo	URL relativa da página do artigo para redirecionar. Exemplo: /Content/NOWApp/now_article_view.html
    Ocultar componente quando vazio	Opção para ocultar o componente quando não houver artigos de conhecimento a serem exibidos.
    Classe CSS personalizada	Classe CSS personalizada para aplicar estilos personalizados a este componente. Para obter mais informações, consulte Personalizando as cores de ServiceNow Componentes no AEM.