Editar fluxos

A tela de edição

Você abre o editor de três formas, todas a partir da tela inicial:

• Novo fluxo — botão flutuante + (canto inferior direito), para começar do zero.
• Editar — botão de lápis em um cartão, para alterar um fluxo existente.
• Importar — botão flutuante de importação, para carregar um fluxo de um arquivo .json.

A tela de edição reúne, de cima para baixo: a barra de ferramentas, o campo Nome do fluxo, o campo Descrição, a lista de Passos e o botão + Adicionar Passo.

Barra de ferramentas

No topo do editor, a barra de ferramentas concentra as ações sobre o fluxo:

Durante a execução em modo de depuração, surgem ainda os controles de Pausar/Continuar e Parar ao lado dos demais botões.

Anatomia de um passo

Cada passo é um cartão na lista. No cabeçalho do cartão você encontra:

• Alça de arrastar — segure e arraste para reordenar o passo.
• Passo N — a posição do passo na sequência.
• Executar até aqui, Testar passo e Executar a partir daqui — ferramentas de teste (veja Testar e depurar).
• Mover para cima / baixo — reordena sem arrastar.
• Remover passo — exclui o passo.

No corpo do cartão ficam os campos que definem a ação:

Tipos de passo

A ação define o que o passo faz. A coluna Seletor indica se o passo precisa de um elemento-alvo na página, e Valor, se precisa de um conteúdo.

Como criar um passo

Para montar um passo do zero:

1. Adicione o passo com + Adicionar Passo (no fim da lista) ou pelo botão + que aparece entre dois passos, para inserir no meio.
2. Escolha a Ação no menu suspenso — os campos do corpo se ajustam ao tipo escolhido (consulte os Tipos de passo).
3. Defina o alvo, se a ação usa seletor: clique em Selecionar elemento e aponte o elemento direto na página do SEI (veja a seção a seguir).
4. Informe o Valor, quando aplicável — o texto a digitar, a opção, a mensagem da pausa, o texto a copiar, etc.
5. Ajuste Timeout e Opcional conforme a necessidade (telas lentas pedem timeout maior; passos não essenciais podem ser marcados como opcionais).
6. Escreva a Descrição — é o texto que o executor verá na linha do tempo.
7. Teste o passo para confirmar que funciona (veja Testar e depurar).
8. Salve o fluxo na barra de ferramentas.

Para reordenar, arraste pela alça ou use as setas; para remover, use a lixeira do passo.

Selecionar elemento na página

Para passos que agem sobre a página (clicar, digitar, selecionar, aguardar elemento), você não precisa escrever o seletor à mão — basta apontar:

1. No passo, clique em Selecionar elemento. O botão passa a piscar, indicando o modo de seleção.
2. Vá até a aba do SEI e clique no elemento desejado (botão, campo, opção).
3. O SEI Fácil captura um seletor estável e o preenche para você. Quando faz sentido, ele também ajusta o tipo de ação (por exemplo, detecta uma lista ou um botão de rádio) e sugere a descrição.

Para sair do modo de seleção sem escolher nada, pressione Esc.

Parâmetros e interpolação

O passo Definir parâmetros torna o fluxo reutilizável sem edição: ao ser executado, ele pausa e exibe um formulário pedindo valores variáveis — número de processo, data, valor monetário, ou qualquer dado que mude a cada execução. Esses valores ficam disponíveis nos passos de Digitar seguintes por meio de tokens, texto entre chaves que é substituído automaticamente pelo que o executor informou.

Criando parâmetros no editor

Ao escolher a ação Definir parâmetros, o cartão do passo substitui os campos de seletor e valor por um painel de parâmetros. Clique em + Adicionar parâmetro para incluir um parâmetro; clique na lixeira ao lado de cada um para removê-lo. Um mesmo passo pode ter quantos parâmetros forem necessários.

Para cada parâmetro, você define:

Os formatos disponíveis são:

Usando os valores em passos de Digitar

Em qualquer passo de Digitar que venha depois do passo de parâmetros, escreva o nome do parâmetro entre chaves no campo Valor:

{numero_processo}

Durante a execução, o SEI Fácil substitui cada token pelo valor que o executor informou. Você pode combinar vários tokens com texto fixo no mesmo valor:

Ref.: processo {numero_processo}, competência {mes_referencia}

Testar e depurar

O editor traz várias formas de validar o fluxo sem sair da edição. Todas salvam o fluxo automaticamente antes de rodar: