Gatilho de evento do formulário

UiPath.Forms.Activities.FormTriggerActivity<UiPath.Forms.Activities.FormInfoTriggerEventArgs>

Description

Você pode usar essa atividade para disparar fluxos de trabalho com base em um evento que aconteça dentro de um formulário. Por exemplo, você pode optar por disparar um fluxo de trabalho quando um formulário é fechado, perde o foco, ou quando um determinado botão é clicado, ou um determinado campo de texto é alterado. Se você tiver a atividade Form Trigger em qualquer um dos seus fluxos de trabalho, após executar o projeto, um argumento chamado TriggerEventArgs, do tipo TextTriggerEventArgs aparecerá no painel Argumentos .

Observação:

• Esta atividade de gatilho deve ser a primeira atividade no fluxo de trabalho.
• Você só pode usar uma atividade de disparo por fluxo de trabalho.

Compatibilidade do projeto

Windows

Configuração

Painel do Designer

• Selecionar formulário - Selecione o arquivo de formulário com base no qual você deseja criar um gatilho. Você pode escolher um arquivo de formulário existente ou clicar em Criar novo formulário e começar a criar um arquivo de formulário.
• Evento - Selecione o evento no formulário com base no qual você deseja que o gatilho comece. Os eventos de formulário padrão são:
  • Formulário fechado
  • Foco do formulário perdido
  • Foco do formulário obtido
  • Estado do formulário alterado (minimizado/restaurado)
  • De acordo com o arquivo de formulário selecionado para Selecionar formulário, outros eventos específicos para os componentes de formulário usados no arquivo de formulário aparecem. Por exemplo, para componentes Botão , eventos de formulário como Botão clicado aparecem.
• ID da mensagem - A ID da mensagem enviada do formulário usando uipathApi.sendMessage. Você precisa dessa propriedade apenas se quiser criar um gatilho para um formulário HTML personalizado.

Quando você passa dados pela propriedade ID da mensagem , você está enviando eventos de formulário. Para arquivos uiform , eventos de formulário predefinidos estão disponíveis. No entanto, para formulários HTML, você deve criar os eventos do formulário usando a função JavaScript uipathApi.sendMessage . O processo requer a criação de um evento de formulário, como "Rejeitar clicado", dentro do arquivo HTML. Para criar um gatilho para esse evento, você deve especificar o nome do evento na propriedade ID da mensagem . Para obter mais informações, consulte Criar formulários usando HTML personalizado.

Painel de Propriedades

• Habilitado - Quando Habilitado está On, o gatilho começa quando o evento de formulário escolhido acontece. Quando Habilitado está Off, o gatilho começa apenas se você o habilitar explicitamente usando a atividade Enable trigger .
• Modo de agendamento – Especifica como executar as ações quando um gatilho é disparado. Escolha uma das cinco opções no menu suspenso:
  • Sequencial — as ações são executadas uma após a outra.
  • Simultânea a execução de ações pode se sobrepor.
  • OneTime – executa uma ação e encerra o monitoramento.
  • Colapso sequencial - Ignora todos os eventos futuros, exceto o mais recente, até que o evento atual termine a execução.
  • Queda sequencial - Interrompe a execução do evento anterior e inicia o próximo evento. Nos modos Sequencial e Simultânea , o monitoramento continua a menos que o usuário interrompa a execução ou uma atividade Break seja atingida.
• ID do gatilho - O identificador exclusivo desse gatilho. O ID do gatilho pode ser usado com outras atividades, como Repeat trigger.
• Nome da instância - Se você deseja executar o gatilho apenas em uma instância de um arquivo de formulário, insira o nome da instância neste campo. Se você quiser executar o gatilho para todas as instâncias de um formulário, deixe esse campo vazio.