Criar uma ação personalizada para gerar um objeto a partir de um registro

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura

    • Gere um objeto a partir de um registro do usuário. Aprenda a usar uma saída Ação para criar um objeto a partir de valores de registro.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Use este exemplo para ver demonstrações dessas operações e etapas.
    • Crie entradas de ação para os campos de registro de usuário Nome, Sobrenome e E-mail.
    • Pesquisa um registro de usuário que corresponde aos valores de entrada da ação.
    • Crie uma saída de ação para um objeto de contato.
    • Salve o objeto de contato como um modelo.
    • Mapeie valores de objeto de contato para valores de campo de registro de usuário.
    • Teste a ação com um usuário de amostra.

    Procedimento

    1. Crie uma aplicação para armazenar seu trabalho.
      Use o Criador de aplicações assistido.
      Por exemplo, crie Minha aplicação.
    2. Navegar até Automação de Processo > Flow Designer.
      O sistema exibe a página principal Workflow Studio.
    3. Selecionar Novo(a) > Ação
      O sistema exibe a caixa de diálogo Propriedades da ação.
    4. Insira estes valores de amostra.
      Campo Valor
      Nome Criar objeto de contato a partir do usuário
      Aplicação Minha aplicação
      Acessível de Todos os escopos de aplicação
    5. Selecione Enviar.
      O sistema exibe a interface Workflow Studio.
    6. Em Descrição da ação, selecione Entradas > Criar Entrada
      O sistema exibe uma nova entrada de ação.
    7. Configure a entrada de ação com esses valores.
      Campo Valor
      Rótulo Nome
      Tipo Cadeia de caracteres
      Obrigatório Verdadeiro
    8. Em Descrição da ação, selecione Entradas > Criar Entrada
      O sistema exibe uma nova entrada de ação.
    9. Configure a entrada de ação com esses valores.
      Campo Valor
      Rótulo Sobrenome
      Tipo Cadeia de caracteres
      Obrigatório Verdadeiro
    10. Em Descrição da ação, selecione Entradas > Criar Entrada
      O sistema exibe uma nova entrada de ação.
    11. Configure a entrada de ação com esses valores.
      Campo Valor
      Rótulo Endereço de e-mail
      Tipo Cadeia de caracteres
      Obrigatório Falso
    12. Em Descrição da ação, selecione Saídas > Criar Saída.
      O sistema exibe uma nova saída de ação.
    13. Configure a variável de saída com esses valores.
      Rótulo Nome Tipo Obrigatório
      contato contato Objeto Falso
    14. Na linha do objeto de contato, selecione Adicionar item secundário.
    15. Configure o item secundário com esses valores.
      Rótulo Nome Tipo Obrigatório
      Nome first_name Cadeia de caracteres Verdadeiro
    16. Na linha do objeto de contato, selecione Adicionar item secundário.
    17. Configure o item secundário com esses valores.
      Rótulo Nome Tipo Obrigatório
      Sobrenome last_name Cadeia de caracteres Verdadeiro
    18. Na linha do objeto de contato, selecione Adicionar item secundário.
    19. Configure o item secundário com esses valores.
      Rótulo Nome Tipo Obrigatório
      Endereço de e-mail email_address Cadeia de caracteres Falso
    20. Na linha do objeto de contato, selecione Alternar entradas avançadas.
    21. Em Opções avançadas, selecione Salvar como modelo.
      O sistema exibe a caixa de diálogo Salvar como modelo.
    22. Em Inserir um nome, insira contato.
    23. Clique em Salvar.
    24. Selecione Sair do modo de edição.
      O sistema exibe os campos de saída que você criou.
    25. Configure as saídas com esses valores.
      Rótulo Valor
      Nome [etapa->Pesquisar registro etapa->Registro->Nome]
      Sobrenome [etapa->Pesquisar registro etapa->Registro->Sobrenome]
      Endereço de E-mail [etapa->Pesquisar registro etapa->Registro->E-mail]
      Nota:
      Você pode selecionar cápsulas de dados no painel de dados ou no botão Seletor de cápsula de dados.
    26. Selecione Save (Salvar).
    27. Selecione Testar.
      O sistema exibe a caixa de diálogo Ação de teste.
    28. Insira estes valores de teste.
      Entrada Valor
      Nome Abel
      Sobrenome Tutor
    29. Selecione Run Test (Executar teste).
      O sistema executa a ação com os valores de teste fornecidos.
    30. Selecione A ação foi executada. Para exibir a ação, clique aqui.
      O sistema exibe os detalhes da execução da ação.
    31. Revise o valor de tempo de execução dos dados de saída da ação.
      O sistema exibe os dados de saída no formato JSON.
      Por exemplo, amostra de objeto de contato JSON para o usuário Abel Tuter.
      {
    "contact": {
        "email_address": "abel.tuter@example.com",
        "last_name": "Tuter",
        "first_name": "Abel"
    }
}

    Resultado

    Você tem uma ação personalizada que pesquisa um registro de usuário e o converte em um objeto de contato.

    O que Fazer Depois

    Personalize a ação para usar sua própria lógica.