Arquivos/Pastas
Esta documentação descreve o processo de configuração e uso do gatilho Watcher Arquivos/Pastas na plataforma. Este gatilho permite monitorar alterações em arquivos ou diretórios específicos, iniciando a execução de bots automaticamente quando tais mudanças são detectadas.
O que é o Gatilho Watcher Arquivos/Pastas?
O gatilho Watcher Arquivos/Pastas é uma funcionalidade que monitora continuamente um arquivo ou diretório específico em busca de alterações, como criação, modificação ou exclusão de arquivos. Quando uma mudança é detectada, o gatilho aciona a execução de um bot previamente configurado para lidar com essa alteração.
Configuração do Gatilho
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
Folder
ouFile
.
Tipos de Gatilhos
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.
Bot
- Valor padrão: Primeiro da lista de bots disponíveis
- Descrição: Bot que será executado quando o gatilho for disparado.
- Importante: O bot deve estar previamente criado e disponível na plataforma para seleção.
Versão
- Valor esperado:
X.Y.Z
(exemplo:1.0.0
) - Descrição: Versão específica do bot a ser utilizada.
- Importante: Existe a opção de selecionar a versão
release
do bot, que sempre utilizará a versão mais recente disponível.
Label
- Descrição: Identificador opcional para o gatilho. Pode ser usado para organização ou filtragem.
Agente
- Valor atual: Selecione um agente da lista
- Descrição: Define o agente responsável pela execução do bot.
- Importante: O agente deve estar ativo e conectado para realizar seleção durante o agendamento. Possibilidade de definir múltiplos agentes para o mesmo agendamento, evitando gargalos de execução.
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:
true
oufalse
.
Caminho da pasta
- Descrição: Define o diretório a ser monitorado.
- Exemplo:
C:\Users\@user\Downloads\
Parâmetros (JSON)
- Descrição: Permite informar parâmetros adicionais para o bot, em formato JSON.
- Exemplo:
{
"arg1": "1366",
"arg2": "768"
}
File
O tipo File é utilizado para monitorar um arquivo específico. Sempre que esse arquivo for criado ou modificado, o bot configurado será acionado.
Bot
- Valor padrão: Primeiro da lista de bots disponíveis
- Descrição: Bot que será executado quando o gatilho for disparado.
Versão
- Valor esperado:
X.Y.Z
(exemplo:1.0.0
) - Descrição: Versão específica do bot a ser utilizada.
Label
- Descrição: Identificador opcional para o gatilho. Pode ser usado para organização ou filtragem.
Agente
- Valor atual: Selecione um agente da lista
- Descrição: Define o agente responsável pela execução do bot.
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
.
Parâmetros (JSON)
- Descrição: Permite informar parâmetros adicionais para o bot, em formato JSON.
- Exemplo:
{
"arg1": "1366",
"arg2": "768"
}
Descrição
- Descrição: Campo para fornecer uma descrição detalhada do gatilho, facilitando a identificação e o entendimento de sua finalidade.