Componentes

Um componente é um passo reaproveitável de automação, como "Fazer login", "Criar pedido" ou "Consultar CEP". Ele é cadastrado uma vez e usado em quantas automações precisarem.

Em Automações > Componente, os componentes aparecem em árvore, por sistema.

O componente e o código

O nome do componente é o mesmo no Proton e no código da automação: o código acha o componente pelo nome, sem registro em lugar nenhum. Nos projetos modelo:

• Python: o arquivo automacao/componentes/<nome>.py. FazerLogin vira fazer_login.py.
• Java: a classe <Nome>.java no pacote dos componentes. Fazer login vira FazerLogin.

Os parâmetros também: o código lê cada entrada (in_) e devolve cada saída (out_) pelo nome cadastrado. Ver Parâmetros.

A árvore

• Cada sistema mostra os componentes dele. Clicar no sistema mostra o resumo e Novo componente neste sistema.
• Um ponto laranja marca o componente sem documentação.
• A busca acha pelo nome do componente, pelo nome de um parâmetro ou pelo sistema.
• O chip de componentes sem documentação filtra a árvore: bom para achar o que falta documentar.

Criar um componente

1. Use Novo componente (ou Novo componente neste sistema).
2. Preencha o Componente (o nome, sem espaço, até 100 caracteres, único na organização) e o Sistema.
3. Se quiser, já preencha O que faz, a documentação e os parâmetros.
4. Salvar.

Documentação

A documentação do componente entra no documento de todas as automações que o usam:

Campo	O que escrever
O que faz	A ação que o componente executa no sistema.
Objetivo	Por que o passo existe: a regra de negócio que ele atende.
Resultado esperado	O que tem de acontecer para o passo estar certo. Cada dataset pode complementar.
Pré-condições	O que precisa estar pronto antes.
Observações	Detalhes para quem mantém o componente.

Um componente conta como documentado quando tem o objetivo ou o resultado esperado.

Sugerir com IA

Na edição de um componente, Sugerir com IA propõe a documentação a partir do nome, do sistema, dos parâmetros e de onde o componente é usado (o passo anterior e o seguinte em cada dataset). Você escolhe o que usar, revisa no formulário e salva: nada é gravado sem Salvar.

Cada sugestão consome créditos de IA, e o botão mostra quantos. Exige o módulo de IA no plano.

Parâmetros do componente

A seção Parâmetros lista as entradas e saídas do componente.

• Adicionar parâmetros liga parâmetros que já existem na organização.
• Criar parâmetro cria um parâmetro novo (de entrada ou de saída) e o liga ao componente. Se já existe um parâmetro com o mesmo nome ou parecido, o Proton oferece usar o existente.
• O lápis renomeia o parâmetro ou muda a descrição.
• O x tira o parâmetro do componente (na edição).

O vínculo vale depois de Salvar o componente.

Análise de impacto e histórico

• Análise de impacto mostra o que uma mudança no componente afeta: os datasets que o usam, as automações, os processos de negócio (com a criticidade) e os grupos de automação. Avisa também quando datasets afetados falharam na última execução.
• Histórico mostra cada mudança: quem fez, quando, por onde (pela tela, pela API ou pela IA) e os campos alterados.

Apagar

Um componente só pode ser apagado quando nenhum dataset o usa. Use a Análise de impacto para achar onde ele está e tire-o desses datasets antes.

Permissões

Ver, criar, alterar e apagar componentes têm permissões próprias no perfil (Componente). Criar e renomear parâmetros exigem as permissões de Parâmetro.