Definição de configurações de integração para ServiceNow serviços e componentes no AEM

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura

    • Você precisa configurar seus ServiceNow serviços e componentes para integração com sua instância do Adobe Experience Manager (AEM).

    Configurações para habilitar o uso de serviços ServiceNow no AEM

    Você pode definir os seguintes tipos de definições de configuração para serviços ServiceNow no AEM:

    Configurações para usar componentes ServiceNow no AEM

    Para usar o endpoint da API Knowledge em sua instância do AEM, você precisa definir a regra de compartilhamento de recursos entre origens (CORS) em sua instância ServiceNow. Para obter mais informações, consulte Defina uma regra de compartilhamento de recursos entre origens para acessar ServiceNow endpoints de API do AEM.

    Definir definições de configuração do OSGi para serviços ServiceNow

    Defina as definições de configuração do OSGi para ServiceNow serviços usados por ServiceNow componentes no Adobe Experience Manager (AEM).

    Antes de Iniciar

    Função necessária: administrador do AEM

    Procedimento

    1. Acesse o console da Web no AEM usando um URL no seguinte formato: https://<AEM_hostname> :<AEM_port> /system/console/configMgr .
    2. Pesquise por Configuração da ServiceNow.
    3. Na coluna Nome, clique no link Configuração da ServiceNow.
    4. Forneça valores para as definições de configuração.
      Tabela 1. Definições de configuração da ServiceNow
      Campo Descrição
      URL da instância base URL completo da sua instância ServiceNow.
      Bases de Conhecimento Identificador do sistema (sys_id) de uma base de conhecimento que contém artigos de conhecimento associados. Para várias entradas, separe as bases de conhecimento com vírgulas.
      Nota:
      Um valor em branco indica que os artigos de todas as bases de conhecimento na sua instância ServiceNow podem ser acessados por um usuário com as permissões apropriadas.
      Mostrar Artigos em Todos os Idiomas Opção para mostrar artigos de conhecimento em todos os idiomas para componentes ServiceNow.
    5. Clique em Salvar.

    Definir configurações do arquivo de log para serviços ServiceNow no Adobe Experience Manager

    Defina as configurações do arquivo de log para serviços ServiceNow no Adobe Experience Manager (AEM) para gerar logs de depuração para ajudar a identificar problemas no processo de autenticação.

    Antes de Iniciar

    Função necessária: administrador do AEM

    Procedimento

    1. Acesse o console da Web no AEM usando um URL no seguinte formato: https://<AEM_hostname> :<AEM_port> /system/console/configMgr .
    2. Navegar até OSGi > Configuração.
    3. Pesquise e selecione logs/project-servicenow-components.log: info.
    4. Verifique os valores de campo padrão ou preencha seus próprios valores para uma configuração personalizada.
      Tabela 2. Definições de configuração do agente de log
      Campo Valor
      Nível de log Depurar
      Arquivo de log Caminho do arquivo de log ServiceNow.
      Padrão de mensagem Padrão de formato de mensagem para formatar mensagens de log.
      Agente Nome do agente de log para serviços de login ServiceNow.
      Aditividade Opção para desabilitar o envio de logs para um anexado superior na hierarquia.
    5. Clique em Salvar.

    Defina uma regra de compartilhamento de recursos entre origens para acessar ServiceNow endpoints de API do AEM

    Defina uma regra de compartilhamento de recursos de origem cruzada (CORS) em sua instância ServiceNow para acessar endpoints da REST API da Gestão de conhecimento, da API Case ou da API CSM Attachment da sua instância do Adobe Experience Manager (AEM).

    Antes de Iniciar

    Certifique-se de ter configurado a API para a qual está definindo a regra CORS.
    • 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.
    • Ative o plug-in Atendimento ao cliente (com.sn_customerservice) para usar os endpoints da API de casos para casos de atendimento ao cliente. Para obter mais informações, consulte API de caso.
    • Configure a propriedade do sistema glide.rest.attachment_csm_api.allowed_tables e inclua a tabela Caso [sn_customerservice_case] para usar os endpoints da API de anexo do CSM para anexos de caso. Para obter mais informações, consulte CSM Attachment API.

    Função necessária: web_service_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Procedimento

    1. Navegar até Todos > Serviços web do sistema > Regras CORS.
    2. Clique em Nova.
    3. No formulário Regra CORS, preencha os campos.
      Tabela 3. Formulário Regra CORS
      Campo Descrição
      Nome Nome para identificar sua regra CORS.
      REST API REST API à qual esta regra CORS se aplica.
      • Para artigos de conhecimento, selecione REST API da Gestão de conhecimento [sn_km_api/knowledge].
      • Para casos de atendimento ao cliente, selecione Caso [sn_customerservice/case].
      • Para anexos de caso, selecione a API de anexos do CSM [now/attachment_csm]
      Domínio Instância do AEM à qual esta regra CORS se aplica.
      Idade máxima Número de segundos para armazenar em cache a sessão do cliente.
    4. Na lista relacionada Métodos HTTP, selecione Métodos HTTP para enviar uma solicitação a um provedor de serviço web.
      • Para artigos de conhecimento, selecione GET.
      • Para casos de atendimento ao cliente, selecione GET, PUT, POST.
      • Para anexos de caso, selecione GET, POST, DELETE.
    5. Para a API de caso, no campo Cabeçalhos expostos da lista relacionada Cabeçalhos HTTP, insira X-Total-Count.
    6. Clique em Enviar.