Definindo configurações de integração para ServiceNowServiços e componentes no AEM

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura
  • Você precisa configurar seu ServiceNowServiços e componentes a serem integrados à sua instância do Adobe Experience Manager (AEM).

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

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

    Configurações para usar ServiceNowComponentes no AEM

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

    Defina as definições de configuração do OSGi para ServiceNowserviços

    Defina as definições de configuração do OSGi para ServiceNowserviços usados por ServiceNowComponentes 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. Pesquisar Configuração da ServiceNow .
    3. Em Nome , clique em Configuração da ServiceNow link.
    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 do seu ServiceNowinstância.
      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 artigos de todas as bases de conhecimento em seu ServiceNowas instâncias são acessíveis a um usuário com permissões apropriadas.
      Mostrar artigos em todos os idiomas Opção para mostrar artigos de conhecimento em todos os idiomas para ServiceNowcomponentes.
    5. Clique em Salvar.

    Defina as configurações do arquivo de log para ServiceNowServiços no Adobe Experience Manager

    Defina as configurações do arquivo de log para ServiceNowServiços 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-secenow-components.log: informações .
    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 ServiceNowarquivo de log.
      Padrão de mensagem Padrão de formato de mensagem para formatar mensagens de log.
      Agente Nome do agente de log para ServiceNowserviços de login.
      Aditividade Opção para desabilitar o envio de logs para um appender anexado mais alto na hierarquia.
    5. Clique em Salvar.

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

    Defina uma regra de compartilhamento de recursos entre origens (CORS) no ServiceNowPara acessar endpoints da API REST de Gestão de conhecimento, API de caso ou API de anexo de CSM da sua instância do Adobe Experience Manager (AEM).

    Antes de Iniciar

    Certifique-se de ter configurado a API para a qual você está definindo a regra de CORS.
    • Ative o plug-in da API de conhecimento (sn_km_api) para usar os endpoints da API REST da Gestão de conhecimento para artigos de conhecimento. Para obter mais informações, consulte API REST da Gestão de conhecimento .
    • Ative o plug-in de 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 o. glide.rest.attachment_csm_api.allowed_tablesE inclua a tabela do 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é Tudo > Serviços web do sistema > Regras CORS.
    2. Clique em Novo.
    3. No formulário Regra de CORS, preencha os campos.
      Tabela 3. Formulário de Regra de CORS
      Campo Descrição
      Nome Nome para identificar sua regra de CORS.
      REST API REST API à qual esta regra de CORS se aplica.
      • Para artigos de conhecimento, selecione API REST 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 API de anexo do CSM [now/attachment_csm]
      Domínio Instância do AEM à qual esta regra de 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ços web.
      • Para artigos de conhecimento, selecione OBTER .
      • Para casos de atendimento ao cliente, selecione OBTER , COLOCAR , PUBLICAÇÃO .
      • Para Anexos de caso, selecione OBTER , PUBLICAÇÃO , EXCLUIR .
    5. Para API de caso, no Cabeçalhos expostos Campo da lista relacionada Cabeçalhos HTTP, insira X-Total-Count .
    6. Clique em Enviar.