Arquivos e Pastas
Use o gatilho de arquivos e pastas (Watcher) quando o bot deve reagir à chegada ou alteração de um arquivo, por exemplo processar cada PDF salvo em uma pasta de entrada. O watcher é executado pelo agente escolhido: ele monitora o caminho configurado e dispara o bot sempre que detecta uma alteração, como a criação ou modificação de um arquivo.
Watchers Cadastrados
A tela de watchers lista todos os monitoramentos configurados.
| Coluna | Descrição |
|---|---|
| Bot | Bot executado quando o watcher é disparado. |
| Versão | Versão do bot especificada para a execução. |
| Modo | Modo de execução (headless, parallel, headed). |
| Agente | Agente responsável pelo monitoramento. |
| Caminho | Caminho da pasta ou do arquivo monitorado. |
| Status | Indica se o monitoramento está ativo ou inativo. |
| Ações | Ícones para editar ou remover o watcher. |
Novo Watcher
Para configurar esse tipo de gatilho Watcher Arquivos/Pastas, siga os passos abaixo:
- Navegue para a página https://sinfonia.live/watchers e selecione a opção para
Novo Watcher. - Escolha entre os 2 tipos de gatilhos
FolderouFile.
Tipos de Watcher
Existem dois tipos de configurações para o Watcher:
- Folder: Configuração para monitoramento de arquivos em uma pasta específica.
- File: Configuração para monitoramento individual dos arquivos.
Folder
O tipo Folder é utilizado para monitorar todos os arquivos com uma extensão específica dentro de uma pasta. Sempre que um arquivo com a extensão definida for criado ou modificado, o bot configurado será acionado.
| Campo | Descrição | Notas |
|---|---|---|
| Bot | Bot que será executado quando o gatilho for disparado. | Deve estar previamente criado e disponível na plataforma para seleção. |
| Versão | Versão específica do bot a ser utilizada. | Aceita X.Y.Z (exemplo: 1.0.0) ou release, que sempre usa a mais recente disponível. |
| Label | Identificador opcional para o gatilho. | Pode ser usado para organização ou filtragem. |
| Agente | Define o agente responsável pela execução do bot. | O agente deve estar ativo e conectado. É possível selecionar múltiplos agentes, evitando gargalos de execução. |
| Parâmetros (JSON) | Parâmetros adicionais enviados ao bot, em formato JSON. | Chegam ao código como variáveis de ambiente. Exemplo: {"arg1": "1366", "arg2": "768"} |
| Descrição | Texto livre para descrever a finalidade do gatilho. | Facilita a identificação em telas de listagem. |
Extensão
- Descrição: Define o tipo de arquivo que será monitorado (extensão).
- Valores disponíveis:
pdf,txt,docx.
Recursivo
- Descrição: Indica se o monitoramento será realizado de forma recursiva em subpastas.
- Valores disponíveis:
trueoufalse.
Caminho da pasta
- Descrição: Define o diretório a ser monitorado.
- Exemplo:
C:\Users\@user\Downloads\
File
O tipo File é utilizado para monitorar um arquivo específico. Sempre que esse arquivo for criado ou modificado, o bot configurado será acionado.
| Campo | Descrição | Notas |
|---|---|---|
| Bot | Bot que será executado quando o gatilho for disparado. | Deve estar previamente criado e disponível na plataforma para seleção. |
| Versão | Versão específica do bot a ser utilizada. | Aceita X.Y.Z (exemplo: 1.0.0) ou release, que sempre usa a mais recente disponível. |
| Label | Identificador opcional para o gatilho. | Pode ser usado para organização ou filtragem. |
| Agente | Define o agente responsável pela execução do bot. | O agente deve estar ativo e conectado. É possível selecionar múltiplos agentes, evitando gargalos de execução. |
| Parâmetros (JSON) | Parâmetros adicionais enviados ao bot, em formato JSON. | Chegam ao código como variáveis de ambiente. Exemplo: {"arg1": "1366", "arg2": "768"} |
| Descrição | Texto livre para descrever a finalidade do gatilho. | Facilita a identificação em telas de listagem. |
Caminho do arquivo
- Descrição: Define o arquivo específico a ser monitorado.
- Exemplo:
C:\Users\@user\Downloads\file.txt - Tipos de arquivo suportados:
xls,xlsx,xlsm,txt.
Editar Watcher
Para editar um watcher existente, clique no ícone de edição na coluna Ações. Os campos são os mesmos da criação, descritos em Novo Watcher.
Remover Watcher
Para remover um watcher, clique no ícone de lixeira na coluna Ações.
Dica
Será solicitado um modal de confirmação.