Atividade Atualizar registro

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 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, pd_admin, pd_author ou pd_content_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 entradas a seguir. 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.
    Regra de Início Opção Em Programação > Regra de Início, selecione uma regra de início para quando sua fase deve começar a ser executada:
    • Quando o processo começa: sua fase começa a ser executada assim que o playbook é iniciado.
    • Após fases específicas: sua fase começa a ser executada após a conclusão da(s) fase(s) especificada(s).
    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. 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 das atividades especificadas.
    Iniciar com atraso Verdadeiro/Falso Opção de aguardar um determinado período de tempo antes de executar uma atividade ou fase. Quando habilitada, esta entrada exibe o Propriedades de entrada Iniciar com atraso.
    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 Opção Opção para pausar o playbook até que o usuário final conclua ou ignore a atividade manualmente. Somente usuários com a função pd_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 Referência.Grupo [sys_user_group] Grupo responsável pela conclusão da tarefa associada à atividade.
    Nota:

    Use qualificadores para restringir os dados disponíveis no campo.

    Compatível com qualificadores de referência e avançados. Para obter mais informações, consulte Qualificadores de referência.

    Retorna todos os resultados correspondentes (sem máximo).
    Atribuído a Usuário.Referência [sys_user] Usuário responsável por concluir a tarefa associada à atividade.
    Nota:

    Use qualificadores para restringir os dados disponíveis no campo.

    Compatível com qualificadores de referência e avançados. Para obter mais informações, consulte Qualificadores de referência.

    Retorna todos os resultados correspondentes (sem máximo).
    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 atualizado.

    Considerações de design

    Crie exibições de formulário para atividades que você deseja renderizar em um playbook
    Use uma exibição de formulário para exibir somente os campos que seus usuários precisam para atualizar um registro. Sua exibição deve exibir os campos obrigatórios ou os campos validados por outra lógica de negócios. Consulte Gerenciamento de exibição.
    Executar atividades não interativas antes das atividades interativas
    Se uma atividade Atualizar registro coletar dados de usuários de forma interativa, isso impedirá que playbook inicie quaisquer atividades dependentes. Por exemplo, uma atividade Atualizar registro impediria o início Após as atividades anteriores, 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á-los.