Exemplo de definição de atividade: Enviar e-mail

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 7 min. de leitura
  • A seguir está um exemplo de definição de atividade Enviar e-mail.

    Básico

    Os detalhes básicos capturam o nome (rótulo), a aplicação, a descrição, a tabela e de todas as aplicações a partir das quais ele pode ser acessado.

    Adicione o plano de automação, a experiência de atividade e o envio. Depois de enviar, edite o documento para adicionar mais detalhes em cada guia.

    Plano de Automação

    O Plano de automação associa a ação de back-end ou os subfluxos criados usando o Flow Designer. Este exemplo usa: Enviar e-mail - Atividade ESCM subfluxo.

    Este subfluxo permite o envio de um e-mail. Ele tem a lógica principal para enviar um e-mail. Todos os campos de entrada e de saída estão definidos.

    Todos os campos de entrada são mostrados na seção do plano de automação. Cada campo de entrada pode ser habilitado para ficar visível somente para o administrador, no modal padrão, no modal padrão e no painel de configuração:

    • Somente visibilidade do administrador : quando definido como administrador, somente o administrador pode exibi-lo.
    • Incluir no modelo padrão : quando definido para exibir no modal padrão, ele aparece somente no modal de propriedades.
    • Incluir no modelo padrão e no painel de configuração : Quando definido para exibir no modal padrão e no painel de configuração, ele aparece no painel de configuração DO BLOCO, bem como no modal de propriedades. Para obter mais informações, consulte Definições de atividade

    Você pode definir os campos de entrada no momento da própria definição da atividade, desde que não seja necessário alterar esses valores no momento da configuração. Isso ajuda o responsável pelo processo de negócios a economizar tempo ao configurar uma atividade em um processo.

    Experiência de Atividade

    A guia Experiência de atividade define como o cartão de atividade é renderizado no tempo de execução. O sistema de base fornece os seguintes tipos de experiência:

    • Aprovação
    • Item do catálogo
    • Criar Registro
    • Instrutivo
    • Conhecimento
    • Lista
    • Notificação
    • Registro

    Com base no tipo de experiência selecionado, os campos adicionais são preenchidos. Para obter mais informações, consulte ServiceNow AI Platform documentação.

    Neste exemplo, Registro o tipo está selecionado.
    Nota:
    Por exemplo, se você quiser renderizar uma tabela, poderá escolher a lista como o tipo de experiência.

    Registro Associado

    Use este registro para armazenar os dados associados pertencentes à atividade atual. Isso capturaria os dados de tempo de execução, bem como o status da experiência.
    • Tabela associada: Dados de fluxo
    • Registro associado: Vl
    • Tabela de status da experiência: Dados de fluxo
    • Registro de status da experiência: Vl
    Neste exemplo, a tabela de dados de fluxo é usada para capturar os dados de tempo de execução. Os dados de tempo de execução podem variar com base no caso de uso. Neste exemplo, os dados de tempo de execução são campos como Para, Cc, Assunto e corpo. Para cada caso de uso, uma definição de dados de fluxo precisa ser criada para definir o tipo de dados de tempo de execução.
    1. Navegue até o painel esquerdo e insira sys_flow_data_definition.list . Ele exibe a lista de definições criadas para a tabela de dados de fluxo.
      Figura 1. Registro associado
      Este é um registro associado
    2. Aberto Definição de e-mail - Definição do SCM para exibir a definição relacionada a este exemplo.
      Figura 2. Definição de e-mail - Definição do SCM
      Definição de e-mail - Definição do SCM
      Esta definição de dados de fluxo deve ser usada pelo subfluxo ou pela ação associada a esta definição de atividade (consulte o plano de automação) para capturar os dados de tempo de execução.
      Figura 3. Definições de Atividades
      Plano de Automação
    3. Neste exemplo, abra o subfluxo: Enviar e-mail - Atividade ESCM . Em Criar dados de fluxo etapa, a definição de dados de fluxo que você criou é mapeada em relação a. Definição campo. Este registro de dados de fluxo é usado no subfluxo. Neste exemplo, o status do cartão de atividades (status da experiência) é capturado na tabela de dados de fluxo.
      Figura 4. Enviar e-mail - Atividade ESCM
      Criar dados de fluxo
    Nota:
    Se você quiser capturar os dados de tempo de execução em um registro de tabela diferente da tabela de dados de fluxo, digamos, por exemplo, em uma tarefa de resposta. Você pode selecionar a tabela associada como Tabela de tarefas de resposta. O registro associado deve ser definido como o registro de tarefa de resposta criado pelo subfluxo.

    Da mesma forma, a tabela de status da experiência captura o status do cartão de atividades. No sistema de base, o campo estado da tabela de dados de fluxo é mapeado para o status do cartão de atividades. Portanto, quando a tabela de dados de fluxo é usada para capturar o status da experiência, ela atualiza automaticamente o status do cartão de atividades. Você também pode usar uma tabela diferente da tabela de dados de fluxo para capturar o status da experiência.

    Por exemplo, se você quiser mapear o status da tarefa de resposta para o status do cartão de atividades, isso será possível. Para fazer isso:
    1. Navegar até Tudo > Playbook Experiences.
      Figura 5. Playbook Experiences
      Playbook Experiences
    2. Aberto SIR Playbook Experience .
    3. Aberto Mapeamento de status lista relacionada.
      Figura 6. Playbook Experience
      SIR Playbook Experience
    4. Insira Tarefa de resposta Em relação ao campo Tabela de status da experiência.
    5. Insira Estado No campo Status da experiência.
      Figura 7. Status da experiência
      Mapeamento de status do Playbook Experience
    6. Clique em Enviar. O registro é criado.
      Figura 8. Mapeamento de status da Playbook Experience
      Status de experiência para estado de atividade
    7. Em Status da experiência para Estado da atividade, mapeie os estados da tarefa de resposta para o status do cartão de atividade.
    8. O lado esquerdo mostra os estados da tarefa de resposta e o lado direito mostra o status do cartão de atividades.
      Figura 9. Mapeamento de status da Playbook Experience
      Status do Playbook Experience para Mapa de estado da atividade
    9. O mapeamento pode ser bidirecional. Na lista relacionada Estado de atividade para experiência, mapeie os status corretamente. Esta etapa é o inverso da etapa anterior. Nesse caso, o lado esquerdo mostra o status do cartão de atividades e o lado direito mostra o status da tarefa de resposta.
      Figura 10. Mapeamento de status da Playbook Experience
      Estado de atividade do Playbook Experience para o mapa de status da experiência

    Detalhes

    • Marcador: Enviar e-mail
    • Ícone: Contorno do envelope (não mostrado na interface do usuário)
    • Título: Atividade > Instância de atividade > Rótulo. Aqui, selecionamos o rótulo da instância da atividade. Esta referência com pontos substituirá o valor do rótulo como o título dinamicamente no tempo de execução.
    • Descrição: Atividade > Instância de atividade > Descrição. Aqui, selecionamos a descrição da instância da atividade. Esta referência com pontos substituirá o valor do rótulo como o título dinamicamente no tempo de execução.
    • Estado pendente: Envie uma notificação por e-mail. Este é o título quando a atividade está no status Pendente.
    • Descrição do estado pendente: Solicita a confirmação do assunto e do corpo do e-mail antes de enviar. Esta é a descrição do cartão de atividade quando o status é campos de registro pendentes: Há campos de registro selecionados neste exemplo.

      Campos de registro são uma lista separada por vírgulas de nomes de campos a serem exibidos para o registro associado em uma lista de pares nome-valor. Os dados são obtidos previamente no servidor, a referência com pontos é compatível com e.  CanRead()  as permissões são avaliadas em cada campo.

    • Rodapé: Não há rodapé definido para este exemplo.

      Rodapé é um texto em uma área cinza do rodapé do cartão. Você pode adicionar qualquer informação significativa à mostrada.

      Figura 11. Definição de atividade - Enviar e-mail
      Página Enviar e-mail - Definição de atividade

    Formulário

    • Exibição do formulário: Collect_data
    • Campos de formulário:
    Este exemplo usa a exibição collect_data para mostrar os campos que devem ser apresentados ao usuário para inserir entradas. A exibição collect_data é uma exibição fornecida pela plataforma correspondente à tabela de dados de fluxo. Como alternativa, você pode deixar a Exibição de formulário como vazia e selecionar Variáveis na lista de valores disponíveis em Campos de formulário. (clique no ícone de cadeado para abrir a lista de valores disponíveis).
    Figura 12. Visualização do formulário
    Formulário

    Anexos

    Neste exemplo:
    • A origem do anexo está vazia.
    • Anexo Somente leitura não selecionado.
    1. Origem do anexo - menu suspenso. Que anexos mostrar no cartão: Aqueles anexados ao registro primário, ao registro associado ou a nenhum.
    2. Anexo somente leitura - Verdadeiro ou Falso. Impedir que o usuário renomeie ou exclua os anexos existentes.
    Figura 13. Definição de atividade - Enviar e-mail
    Página Enviar e-mail - Definição de atividade

    Recursos

    Neste exemplo,
    • Mostrar ANS - Desmarcado
    • Mostrar check-list - Desmarcado
    • Automatizado - Desmarcado
    Mostrar ANS: Verdadeiro/Falso. Renderiza um temporizador de ANS no cabeçalho do cartão para o registro associado. O ANS é escolhido de acordo com o registro de Configuração de ANS especificado na configuração do Playbook.
    1. Mostrar check-list - Verdadeiro ou Falso. Renderiza qualquer check-list anexada ao registro associado. A check-list é editável e as mudanças são salvas sem exigir uma ação declarativa.
    2. É automatizado - Verdadeiro ou Falso. Se verdadeiro, então  slogan  e.  ícone  será substituído pelo texto Tarefa automatizada e um ícone automatizado.
    Figura 14. Definição de atividade - Formulário Enviar e-mail
    Página Enviar formulário de definição de atividade - Enviar e-mail

    Ações do Playbook na Definição de atividade

    Esta seção tem as ações que serão renderizadas no cartão de atividade. Este exemplo tem Ignorar e Enviar e-mail como ações.
    Para adicionar uma nova ação ao cartão de atividade, você deve criar um registro no Ações do Playbook lista relacionada presente na parte inferior da página.
    Figura 15. Ações do Playbook
    Ações do Playbook
    1. Clique em Nova.
    2. Selecione a ação de atividade existente no campo Atribuição de ação.
    3. Selecione SIR Playbook Experience No campo Playbook Experience.