Atividade Atualizar registro

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura

    • Atualize um registro com os valores de campo especificados.

    Funções e disponibilidade

    • Esta atividade está disponível como uma atividade comum. Usuários com admin, playbook.admin ou pd_author podem adicionar esta atividade a um playbook.

    Entradas

    Abra o painel de propriedades da atividade e configure sua atividade para adicionar valores para as seguintes entradas. Se o valor de entrada variar, use o seletor de cápsula para mostrar onde obter o valor. Para saber mais sobre o seletor de cápsula, consulte Dot-walking examples.
    Entrada Tipo Descrição
    Rótulo Cadeia de caracteres Título a ser exibido como atividade e cartão do playbook.
    Descrição Cadeia de caracteres Informações a serem exibidas sobre o uso ou o resultado da atividade.
    Executar condição Construtor de condições Condições que devem ser atendidas para executar uma atividade ou fase. Você pode usar dados de atividades anteriores para criar condições.
    Nota:
    Mostrar opções adicionais para ver este campo.
    Regra de Início Escolha Em Agendamento > Regra de Início, selecione uma regra de início para quando sua fase deve começar a ser executada:
    • Quando o processo é iniciado : Sua fase começa a ser executada assim que o playbook é iniciado.
    • Após fases específicas : Sua fase começa a ser executada depois que as fases especificadas terminam a execução.
    Em Programação > Regra de início, selecione uma regra de início para quando sua atividade deve começar a ser executada:
    • Quando a fase começa : Sua atividade começa a ser executada assim que a fase começa a ser executada. Sua fase começa a ser executada quando o playbook é acionado.
    • Após atividades específicas : Sua atividade começa a ser executada após a conclusão da execução das atividades especificadas.
    Iniciar com atraso Verdadeiro/Falso Opção para aguardar um período de tempo antes de executar uma atividade ou fase. Quando habilitada, esta entrada exibe Iniciar com propriedades de entrada de atraso.
    Nota:
    Mostrar opções adicionais para ver este campo.
    Tabela Nome da tabela Tabela que contém o registro a ser atualizado.
    Registro Referência Referência ao registro que você deseja atualizar.
    Campos Valor do Modelo Valores de campo a serem alterados durante a atualização do registro.
    Aguardar entrada do usuário Escolha Opção para pausar o playbook até que o usuário final conclua ou ignore manualmente a atividade. Somente usuários com a função playbook.admin podem editar este campo. Por padrão, a atividade aguarda a ação do usuário ou os dados antes de ser concluída.

    Entradas avançadas

    Depois de configurar as entradas necessárias para sua atividade, você também pode optar por configurar entradas adicionais. No painel lateral, selecione Mostrar opções adicionais para exibir essas entradas avançadas. Para obter mais informações, consulte Experiência de atividade.
    Entrada Tipo Descrição
    Grupo de Atribuição Grupo.Referência [sys_user_group] Grupo responsável por concluir a tarefa associada à atividade.
    Nota:
    Mostrar opções adicionais para ver este campo.
    Atribuição a Referência.Usuário [sys_user] Usuário responsável por concluir a tarefa associada à atividade.
    Nota:
    Mostrar opções adicionais para ver este campo.
    Campos a serem exibidos após a atualização Cadeia de caracteres Lista separada por vírgulas de campos a serem exibidos para um registro atualizado.

    Saídas

    Essas saídas podem fornecer dados para outras atividades em seu playbook. Você pode acessar esses dados como entradas de atividade ao configurar sua atividade:
    Saída Tipo Descrição
    Tabela Nome da tabela Tabela que contém o registro atualizado.
    Registro ID do documento Referência ao registro atualizada.

    Considerações de design

    Crie exibições de formulário para as atividades que você deseja renderizar em um playbook
    Use uma exibição de formulário para exibir somente os campos de que seus usuários precisam para atualizar um registro. Sua exibição deve exibir campos obrigatórios ou aqueles campos validados por outra lógica de negócios. Consulte Gestão de exibição .
    Execute atividades não interativas antes das atividades interativas
    Se uma atividade Atualizar registro coletar dados interativamente de usuários, ela impedirá playbook a partir do início de qualquer atividade dependente. Por exemplo, uma atividade Atualizar registro impediria a inicialização Anterior que podem estar em outras fases. Sempre que possível, projete seus playbooks para executar atividades não interativas antes de atividades interativas que possam bloqueá-las.