Exibir ServiceNow casos em uma página do Adobe Experience Manager

  • Versão de lançamento: Xanadu
  • Atualizado 3 de ago. de 2023
  • 6 min. de leitura
  • Componentes de caso de uso disponíveis no Adobe Experience Manager (AEM) para acessar casos de atendimento ao cliente na instância ServiceNow e exibi-los em um site baseado em AEM.

    Antes de Iniciar

    Defina a regra de compartilhamento de recursos de origem cruzada (CORS) para acessar a API de caso e a API de anexo de CSM 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

    Por Que e Quando Desempenhar Esta Tarefa

    A REST API de caso permite criar, recuperar e atualizar registros de casos de atendimento ao cliente. Para obter mais informações, consulte API de caso.

    A API CSM Attachment permite carregar, baixar e remover anexos associados a casos de atendimento ao cliente e recuperar metadados de anexo. Para obter mais informações, consulte CSM Attachment API.

    Procedimento

    1. Faça login na sua instância do AEM.
    2. Abra sua página do AEM no modo de edição.
    3. Abra o navegador de componentes.
    4. Na lista 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 do caso. Além disso, você deve modificar as propriedades do modelo de site e adicionar cada componente de caso à lista de componentes permitidos.
    6. Abra a caixa de diálogo do componente para edição.
      Nota:
      Os componentes de caso no modo de edição de uma página no AEM podem ser acessados por todos os usuários, incluindo usuários públicos. Usuários públicos são usuários anônimos do AEM que não estão conectados.
    7. Defina as propriedades do componente Cartões de caso para exibir todos os casos de atendimento ao cliente em aberto da sua instância ServiceNow como cartões de coluna.
      Tabela 1. Propriedades do componente de cartões de caso
      Propriedade Descrição
      Título Título deste componente que aparece na página do AEM.
      Parâmetros de rótulo Parâmetros de rótulo separados por vírgulas para colunas da tabela Caso [sn_customerservice_case]. Cada parâmetro é especificado no rótulode formato:coluna . Em que o rótulo é exibido no componente e a coluna é o nome de uma coluna da tabela Caso [sn_customerservice_case].

      Exemplo: Número:número,Prioridade:prioridade,Produto:produto

      URL da página da lista de casos URL relativo da página da lista de casos para a qual redirecionar.

      Exemplo: /content/servicenow/en/now_case_list.html

      URL da página de exibição do caso URL relativo da página de exibição de caso para a qual redirecionar.

      Exemplo: /content/servicenow/en/now_case_view.html

      Ocultar componente para nenhum caso Opção para ocultar o componente quando não há casos 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.
    8. Defina as propriedades do componente Novo caso para que os usuários criem um caso de atendimento ao cliente na instância ServiceNow da página do AEM.
      Tabela 2. Novas propriedades do componente de caso
      Propriedade Descrição
      Título Título deste componente que aparece na página do AEM.
      Rótulo de descrição resumida Rótulo do campo para inserir uma breve descrição do caso.
      Rótulo de descrição Rótulo do campo para inserir uma descrição do caso.
      Rótulo do produto Parâmetros separados por ponto e vírgula para definir o rótulo e o texto do espaço reservado para a lista de produtos.
      Rótulo do ativo Parâmetros separados por ponto e vírgula para definir o rótulo e o texto de exemplo para a lista de ativos
      Número de itens de lista Número máximo de itens a serem incluídos nas listas de produtos e ativos.

      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.

      Mostrar ativos Opção para exibir a lista de ativos no componente.
      URL da página da lista de casos URL relativo da página da lista de casos para a qual redirecionar.

      Exemplo: /content/servicenow/en/now_case_list.html

      URL da página de exibição do caso URL relativo da página de exibição de caso para a qual redirecionar.

      Exemplo: /content/servicenow/en/now_case_view.html

      Nota:
      Você precisa inserir um valor para esta propriedade para navegar até a página de exibição de caso na janela Caso criado.
      Limite de tamanho do arquivo de anexo em MB Limite de tamanho máximo para um arquivo de anexo que pode ser adicionado a um caso.
      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.
    9. Defina as propriedades do componente Exibição de caso para exibir casos de atendimento ao cliente e quaisquer comentários e anexos, se disponíveis, de uma instância ServiceNow.
      Tabela 3. Propriedades do componente de exibição de caso
      Propriedade Descrição
      Parâmetro de caso Nome do parâmetro de consulta de URL para o número do caso.

      Exemplo: case_no

      Parâmetros de rótulo Parâmetros de rótulo separados por vírgulas para colunas da tabela Caso [sn_customerservice_case]. Cada parâmetro é especificado no rótulode formato:coluna . Em que o rótulo é exibido no componente e a coluna é o nome de uma coluna da tabela Caso [sn_customerservice_case].

      Exemplo: Número:número,Prioridade:prioridade,Produto:produto

      Contagem de atividades Número máximo de atividades, como comentários e anexos, a serem exibidas na guia Atividade.

      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.

      Limite de tamanho do arquivo de anexo em MB Limite de tamanho máximo para um arquivo de anexo que pode ser adicionado a um caso.

      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/servicenow/en/now_article_view.html
      Nota:
      Se um link de artigo estiver incluído em um caso, você precisará inserir um valor para esta propriedade para navegar até a página de exibição de artigos de conhecimento do caso.
      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.
    10. Defina as propriedades do componente Lista de casos para exibir uma lista de casos de atendimento ao cliente.
      Tabela 4. Propriedades do componente da lista de casos
      Propriedade Descrição
      Título Título deste componente que aparece na página do AEM.
      Parâmetros de rótulo Parâmetros de rótulo separados por vírgulas para colunas da tabela Caso [sn_customerservice_case]. Cada parâmetro é especificado no rótulode formato:coluna . Em que o rótulo é exibido no componente e a coluna é o nome de uma coluna da tabela Caso [sn_customerservice_case].

      Exemplo: Número:número,Prioridade:prioridade,Produto:produto

      Contagem de casos Número máximo de casos a serem exibidos no componente.

      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.

      O valor máximo que você pode inserir para este campo é 50.

      Mostrar criar caso Opção para exibir o botão para criar um caso no componente.
      Criar rótulo do botão de caso Rótulo do botão para criar um caso.
      URL da página de criação de caso URL relativo da página de criação de caso para a qual redirecionar.

      Exemplo: /content/servicenow/en/now_case_create.html

      URL da página de exibição do caso URL relativo da página de exibição de caso para a qual redirecionar.

      Exemplo: /content/servicenow/en/now_case_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.