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

  • Versão de lançamento: Washingtondc
  • Atualizado 3 de ago. de 2023
  • 6 min. de leitura
  • Use os componentes de caso disponíveis no Adobe Experience Manager (AEM) para acessar casos de atendimento ao cliente da 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 do caso e a API do anexo do CSM da sua instância do AEM. Para obter mais informações, consulte Definir uma regra de compartilhamento de recursos de origem cruzada 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 do caso permite criar, recuperar e atualizar registros de caso do atendimento ao cliente. Para obter mais informações, consulte API do caso.

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

    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. Abre 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:column . Em que rótulo é exibido no componente e 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 do 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 houver casos a serem exibidos.
      Classe CSS personalizada Classe CSS personalizada para aplicar estilos personalizados a este componente. Para obter mais informações, consulte 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 em sua instância ServiceNow da página do AEM.
      Tabela 2. Propriedades do novo componente do 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 de 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

      Nota:
      Você precisa inserir um valor para esta propriedade para navegar até a página da lista de casos a partir da janela Caso criado.
      URL da página de exibição do caso URL relativo da página de exibição do 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 do caso a partir da janela Caso criado.
      Limite de tamanho de arquivo de anexo em MB Limite máximo de tamanho 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 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:column . Em que rótulo é exibido no componente e 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 de arquivo de anexo em MB Limite máximo de tamanho 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 relativo 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 do artigo de conhecimento do caso.
      Classe CSS personalizada Classe CSS personalizada para aplicar estilos personalizados a este componente. Para obter mais informações, consulte 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:column . Em que rótulo é exibido no componente e 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 criação de caso Opção para exibir o botão para criar um caso no componente.
      Criar rótulo de 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 do 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 Personalizar as cores dos componentes ServiceNow no AEM.