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

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

    • Você precisa configurar seus serviços ServiceNow 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 ServiceNow serviços 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 de origem cruzada (CORS) em sua instância ServiceNow. Para obter mais informações, consulte Definir uma regra de compartilhamento de recursos de origem cruzada 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 componentes ServiceNow 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 da 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
      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 appender anexado superior na hierarquia.
    5. Clique em Salvar.

    Definir uma regra de compartilhamento de recursos de origem cruzada 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 Knowledge Management REST API, Case API ou CSM Attachment API 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 do Knowledge Management REST API para artigos de conhecimento. Para obter mais informações, consulte Knowledge Management REST API.
    • Ative o plug-in Atendimento ao cliente (com.sn_customerservice) para usar os endpoints da API do caso para casos de atendimento ao cliente. Para obter mais informações, consulte API do 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 API de anexo do CSM.

    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 Knowledge Management REST API [sn_km_api/knowledge].
      • Para casos de atendimento ao cliente, selecione Caso [sn_customerservice/case].
      • Para anexos de caso, selecione API de anexo 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 OBTER.
      • Para casos de atendimento ao cliente, selecione GET, PUT, POST.
      • Para anexos de caso, selecione GET, POST, DELETE.
    5. Para a API do caso, no campo Cabeçalhos expostos da lista relacionada Cabeçalhos HTTP, insira X-Total-Count.
    6. Clique em Enviar.