Configurar modais ServiceNowSlack na instância []

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

    • Crie o modal e especifique os campos que devem ser exibidos no modal Slack. A IU modal pode ser gerada de duas maneiras; automaticamente usando uma tabela da ServiceNow e manualmente usando uma carga de exibiçãopersonalizada.

    Antes de Iniciar

    Função necessária: administrador.

    Por Que e Quando Desempenhar Esta Tarefa

    Por exemplo, se você quiser criar um incidente usando o modal em Slack, o modal Criar incidente exigirá os campos Prioridade, Categoriae Descrição resumida.
    Nota:
    Os modais podem ser acionados a partir destes componentes Slack interativos:
    • Comando,
    • Bloquear ação,
    • Atalho global e
    • Atalho de mensagem.

    Procedimento

    1. Para criar um modal com IU que é gerado automaticamente usando uma tabela ServiceNow :
      1. Navegar até Slack > Configurações do modal do Slack.
      2. Clique em Nova.
      3. No formulário Configuração modal do Slack, preencha estes valores.
        Tabela 1. Formulário Configuração modal do Slack
        Campo Descrição
        Nome Nome para identificar o registro. Por exemplo, Modal para criar incidente.
        Título do modal Título modal que é exibido em Slack. Por exemplo, Criar incidente.
        Tabela ServiceNow tabela correspondente aos campos modais. Por exemplo, Incidente [incidente].
        Modal personalizado Opção para configurar um modal personalizado.
        Campos de entrada Campos de entrada que devem ser exibidos em Slack. Por exemplo, selecione Prioridade, CategoriaeDescrição resumida. Certifique-se de que esses campos modais correspondam à tabela ServiceNow selecionada. Por exemplo, você não pode exibir campos relacionados à tarefa em um modal que cria um incidente.
        Nota:
        Somente os tipos de campo cadeia de caracteres, data e opção são compatíveis.
        Ativo Opção para usar ativamente o registro.
        Validação do script Script para validar entradas fornecidas pelo usuário no modal. Para validar as entradas fornecidas pelo usuário, certifique-se de estar ciente do formato no qual os valores são recuperados do modal e analise a resposta de Slack.
        A carga de amostra quando o usuário fornece valores para os campos Prioridade, Categoriae Descrição resumida no modal Criar incidente é:
        {"priority":{"4gk":{"type":"static_select","selected_option":{"text":{"type":"plain_text","text":"1 - Critical","emoji":true},"value":"1"}}},"category":{"iV7":{"type":"static_select","selected_option":{"text":{"type":"plain_text","text":"Software","emoji":true},"value":"software"}}},"short_description":{"XS/Q=":{"type":"plain_text_input","value":"hemanth"}}}

        Para exibir erros de validação no modal, configure o script para retornar chaves, status e errorObject de um objeto. errorObject deve ter um valor de objeto que será exibido no Slack. O objeto deve ter response_action e erro.

        Além disso, configure o script para retornar um objeto com chaves de status e statusMessage quando não houver erros de validação. statusMessage é opcional e você pode configurá-lo de acordo com seus requisitos.

        Validação de script.
      4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
        O modal Criar incidente é criado em Slack.
        Modal do Slack.
    2. Para criar um modal com IU gerada manualmente usando uma carga de exibiçãopersonalizada:
      1. Navegar até Slack > Configurações do modal do Slack.
      2. Clique em Nova.
      3. No formulário Configuração modal do Slack, preencha estes valores.
        Tabela 2. Formulário Configuração modal do Slack
        Campo Descrição
        Nome Nome para identificar o registro. Por exemplo, Modal para criar incidente.
        Modal personalizado Opção para configurar um modal personalizado. Marque esta caixa de seleção.
        Exibir carga Carga gerada pelo Slack Construtor de kit de bloco que define a IU modal. Para obter mais informações, consulte Kit de bloco e Como criar com o kit de bloco.
        Ativo Opção para usar ativamente o registro.
        Validação do script Script para validar entradas fornecidas pelo usuário no modal. Para validar as entradas fornecidas pelo usuário, certifique-se de estar ciente do formato no qual os valores são recuperados do modal e analise a resposta de Slack.
        A carga de amostra quando o usuário fornece valores para os campos Prioridade, Categoriae Descrição resumida no modal Criar incidente é:
        {"priority":{"4gk":{"type":"static_select","selected_option":{"text":{"type":"plain_text","text":"1 - Critical","emoji":true},"value":"1"}}},"category":{"iV7":{"type":"static_select","selected_option":{"text":{"type":"plain_text","text":"Software","emoji":true},"value":"software"}}},"short_description":{"XS/Q=":{"type":"plain_text_input","value":"hemanth"}}}

        Para exibir erros de validação no modal, configure o script para retornar chaves, status e errorObject de um objeto. errorObject deve ter um valor de objeto que será exibido no Slack. O objeto deve ter response_action e erro.

        Além disso, configure o script para retornar um objeto com chaves de status e statusMessage quando não houver erros de validação. statusMessage é opcional e você pode configurá-lo de acordo com seus requisitos.

        Validação de script.
      4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
        O modal Criar incidente é criado em Slack.
    3. Especifique condições para definir quando os modais devem ser exibidos:
      1. Navegar até Slack > Decisões de entrada para modais .
      2. No formulário Decisão, preencha estes valores.
        Tabela 3. Formulário de decisão
        Campo Descrição
        Rótulo Nome para identificar a decisão do modal de entrada.
        Resposta Modal que deve ser exibido quando as condições especificadas forem atendidas. Certifique-se de selecionar o registro necessário na tabela Configuração modal do Slack [sn_slack_ah_v2_slack_modal_configuration].
        Resposta padrão Opção para especificar se este é o modal padrão. O modal padrão é aplicável quando as condições não são atendidas.
        Condição Condições a serem atendidas na aplicação Slack para exibir o modal.
        Nota:
        • Copie e registre o valor de sys_id. Você pode usar este sys_id como o valor exclusivo no ID de retorno de chamada ao configurar o atalho ou o atalho de mensagem no aplicativo Slack.
          sys_id do registro de política de entrada do modal.
          Nota:
          Duas propriedades do sistema são adicionadas para lidar com as comunicações de entrada:
          Tabela 4. Propriedades do sistema
          Categoria Nome da propriedade Descrição Exemplo
          Comandos de barra sn_slack_ah_v2.command.special_characters Os caracteres codificados usando o método encodeURIComponent são tratados internamente. Para substituir quaisquer caracteres especiais adicionais usados em comandos de barra na aplicação Slack por seus caracteres URI codificados, adicione os caracteres em um formato JSON.

          {

          "~": "%7E",

          "\(" : "%28",

          }
          Interatividade e atalhos: sn_slack_ah_v2.interactivity.special_characters

          Os caracteres codificados usando o método encodeURIComponent e os seguintes caracteres são tratados internamente: !, ', (, ), *, ~

          Preencha a propriedade para substituir quaisquer caracteres especiais adicionais usados na Interatividade e Atalhos do Slack na aplicação Slack pelos caracteres URI codificados em um formato JSON.

          {

          "~": "%7E",

          "\(" : "%28",

          }
          Para exibir modais para o atalho necessário, em Condição, forneça o sys_id do registro de política de entrada do modal.
          Exibir modais para atalhos do Slack.
        • Para exibir modais para os comandos Slack necessários, em Condição, forneça o comando necessário para o qual o modal deve ser exibido.
          Exibir modais para comandos do Slack.
        • Para exibir modais para a ação de bloco Slack necessária, em Condição, forneça o ID da ação de bloco necessária para a qual o modal deve ser exibido.
          Exibir modais para ações de bloco do Slack.
      3. Clique em Enviar.
        Quando os eventos em Slack atendem às condições especificadas na política, o modal associado é exibido.
        Nota:
        Essas decisões de entrada são salvas nas tabelas de decisão. Os usuários são alertados para não atualizar ou modificar diretamente os dados dessas tabelas.
    4. Especifique as tarefas a serem executadas quando o usuário fornecer valores nos modais criando uma política de entrada:
      1. Navegar até Slack > Decisões de entrada.
      2. Clique em Nova.
      3. No formulário Decisão, preencha estes valores.
        Tabela 5. Formulário de decisão
        Campo Descrição
        Rótulo Nome para identificar a decisão de entrada.
        Resposta Subfluxo que deve ser acionado quando as condições especificadas são atendidas.
        Resposta padrão Opção para especificar se esta é a resposta padrão. A resposta padrão é aplicável quando as condições não são atendidas.
        1. Clique no ícone de pesquisa ( ícone de pesquisa).
        2. Selecione o subfluxo necessário na lista Documento.
          Nota:
          Certifique-se de que o nome da tabela seja Fluxo [sys_hub_flow].
        Certifique-se de ter configurado o subfluxo para processar a carga de resposta de Slack para automatizar tarefas.
        Condição Condições a serem atendidas para executar tarefas na instância ServiceNow.
        Especifique o registro modal na condição.
        Condição para acionar o subfluxo.
        Nota:
        Acondição deve ter uma condição específica somente para o registro modal.
      4. Clique em Enviar.
        Quando o usuário do Slack fornece entradas no modal, o subfluxo associado é acionado após a validação das entradas. Dependendo das automações configuradas em seu subfluxo, as tarefas são executadas.