Exibir ServiceNow artigos de conhecimento em uma página do Adobe Experience Manager

Versão de lançamento: Yokohama

Atualizado 30 de jan. de 2025

8 min. de leitura

Use os componentes de conhecimento disponíveis no Adobe Experience Manager (AEM) para acessar bases de conhecimento na instância ServiceNow e exibir artigos de conhecimento associados em um site baseado em AEM.

Antes de Iniciar

Ative o plug-in Knowledge API (sn_km_api) para usar os endpoints de 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 entre origens (CORS) para acessar a API Knowledge da sua instância do AEM. Para obter mais informações, consulte Defina uma regra de compartilhamento de recursos entre origens para acessar ServiceNow endpoints de API do AEM.

Função necessária: autor do AEM

Procedimento

Faça login na sua instância do AEM.
Abra sua página do AEM no modo de edição.
Abra o navegador de componentes.
Na lista Todos, selecione ServiceNow.
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 de artigo de conhecimento à lista de componentes permitidos.
Abra a caixa de diálogo do componente para edição.

Nota:
Por padrão, os componentes de conhecimento no modo de edição 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 a propriedade Pública para cada componente de conhecimento.

Defina as propriedades do componente Resultados da pesquisa para exibir resultados de pesquisa de conhecimento que incluem uma lista de artigos de conhecimento das bases de conhecimento na instância ServiceNow.

Tabela 1. Propriedades do componente de resultados 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 selecionados, os artigos de conhecimento disponíveis para usuários não autenticados incluídos no componente estão 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 componentes ServiceNow.
Idioma	Habilita a exibição de resultados de pesquisa de artigos de conhecimento em diferentes idiomas. Selecione uma das seguintes opções. Selecione na configuração do OSGi da ServiceNow: os artigos de conhecimento são exibidos no idioma configurado na configuração do OSGi para componentes ServiceNow. Este valor é selecionado por padrão. Restringir ao idioma do portal: os artigos de conhecimento são exibidos no idioma configurado no site do AEM. Todos os idiomas: os 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: `autor,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 decremento para aumentar ou diminuir os valores. Você também pode inserir um valor manualmente. O valor deve ser maior que `1`.
URL da página do artigo	URL relativa da página do artigo para a qual 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 Como personalizar as cores dos componentes ServiceNow no AEM.

Defina as propriedades do componente Caixa de pesquisa para exibir uma caixa de pesquisa para que os usuários insiram o texto de pesquisa e localizem artigos de conhecimento na instância ServiceNow que correspondam ao texto de pesquisa.

Nota:

O acionamento de 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 selecionados, os artigos de conhecimento disponíveis para usuários não autenticados incluídos no componente estão 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: `pesquisa (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 componentes ServiceNow.
Idioma	Habilita a exibição de artigos de conhecimento em diferentes idiomas na caixa de pesquisa. Selecione uma das seguintes opções. Selecione na configuração do OSGi da ServiceNow: os artigos de conhecimento são exibidos no idioma configurado na configuração do OSGi para componentes ServiceNow. Este valor é selecionado por padrão. Restringir ao idioma do portal: os artigos de conhecimento são exibidos no idioma configurado no site do AEM. Todos os idiomas: os artigos de conhecimento são exibidos em todos os idiomas.
URL da página de pesquisa	URL relativo 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 de pesquisa autocompletável. Use os ícones de incremento ou decremento para aumentar ou diminuir os valores. Você também pode inserir um valor manualmente. O valor deve ser maior que `1`.
URL da página do artigo	URL relativa da página do artigo para a qual 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 Como personalizar as cores dos componentes ServiceNow no AEM.

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

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 selecionados, os artigos de conhecimento disponíveis para usuários não autenticados incluídos no componente estão disponíveis para todos os usuários, incluindo usuários públicos.
Parâmetro de artigo	Nome do parâmetro de consulta de URL para o 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: `autor,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 Como personalizar as cores dos componentes ServiceNow no AEM.

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 selecionados, os artigos de conhecimento disponíveis para usuários não autenticados incluídos no componente estão 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 componentes ServiceNow.
Idioma	Habilita a exibição de um artigo de conhecimento em diferentes idiomas ao exibir o artigo. Selecione uma das seguintes opções. Selecione na configuração do OSGi da ServiceNow: os artigos de conhecimento são exibidos no idioma configurado na configuração do OSGi para componentes ServiceNow. Este valor é selecionado por padrão. Restringir ao idioma do portal: os artigos de conhecimento são exibidos no idioma configurado no site do AEM. Todos os idiomas: os 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: `autor,sys_view_count,sys_updated_on,rating`
Critérios	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 na propriedade glide.knowman.default_keyword. Para obter informações sobre artigos em destaque, consulte Como adicionar um artigo de conhecimento a conteúdo em destaque e Propriedades de conhecimento. Mais exibidos: 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 decremento para aumentar ou diminuir os valores. Você também pode inserir um valor manualmente. O valor deve ser maior que `1`.
URL da página do artigo	URL relativa da página do artigo para a qual 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 para exibir.
Classe CSS personalizada	Classe CSS personalizada para aplicar estilos personalizados a este componente. Para obter mais informações, consulte Como personalizar as cores dos componentes ServiceNow no AEM.