Nesse artigo você encontrará as seguintes informações:
Ações
Pesquisas
Gatilhos
Agregadores
Iteradores
Sobre:
O Toolzz Connect distingue cinco tipos de módulos: Actions, Searches, Triggers, Aggregators e Iterators. Os dois últimos são destinados a cenários avançados.
Actions (ações)
As ações são o tipo de módulo mais comum.
Um módulo de ação típico retorna apenas um único pacote que é passado para o próximo módulo para processamento.
Os módulos de ação podem ser colocados no início, meio ou fim de um cenário.
Os cenários podem conter um número ilimitado de módulos de ação.
Exemplos:
Dropbox > Carregar um arquivo: envia um arquivo para uma pasta selecionada do Dropbox e retorna seu identificador.
Imagem > Redimensionar: recebe uma imagem, redimensiona-a para o tamanho especificado e passa a imagem redimensionada para a próxima ação.
Google Analytics > Criar um relatório: obtém informações sobre o tráfego da web e as repassa para processamento posterior.
Update (atualizar)
O tipo Ação possui quatro subtipos: Criar, Ler, Atualizar e Excluir. O subtipo Update habilita as três operações a seguir:
Apague o conteúdo de um campo.
Esta operação ocorre quando o conteúdo do campo é avaliado como palavra-chave "Erase" (não confundir com empty ).
Deixe o conteúdo de um campo inalterado. Esta operação ocorre quando o campo é deixado em branco ou o conteúdo do campo é avaliado como empty/vazio (representado por null em JSON):
Substituir o conteúdo de um campo. Esta operação ocorre em todos os outros casos além dos dois descritos acima.
❗ Observação
Se não aparecer palavra-chave "erase" no painel de mapeamento, o módulo não é de atualização ou ainda não foi atualizado para a especificação de aplicativos mais recente.
Razão pela qual "empty" resultará em nenhuma alteração do conteúdo do campo é que, se houver necessidade de agir de maneira diferente e apagar o campo, isso é facilmente alcançável com a seguinte fórmula:
Sendo que não é possível deixar o conteúdo do campo inalterado quando o conteúdo do campo é avaliado como empty.
Searches (pesquisas)
Um módulo de pesquisa típico retorna zero, um ou mais pacotes, que são então passados para o próximo módulo para processamento.
Os módulos de pesquisa podem ser colocados no início, no meio ou no final de um cenário.
Os cenários podem conter um número ilimitado de módulos de pesquisa.
Exemplos:
Segunda-feira > Listar pulsos em todos os quadros, retorna todos os pulsos da conta.
Triggers (gatilhos)
Módulos acionadores geram pacotes quando houver alteração em um determinado serviço. A alteração pode ser a criação de um novo registro(s), a exclusão de um(s) registro(s), a atualização de um(is) registro(s), etc. Faça distinção entre dois tipos de acionadores: gatilhos de pesquisa e gatilhos instantâneos.
Cada gatilho pode retornar zero, um ou mais pacotes que são passados para o próximo módulo para processamento.
Os gatilhos podem ser colocados apenas no início de um cenário.
Cada cenário pode conter apenas um gatilho.
Gatilhos de sondagem
Os gatilhos de sondagem são projetados para sondar regularmente um determinado serviço se houve uma alteração desde a execução anterior. Portanto, você normalmente agendará um cenário contendo um módulo acionador de pesquisa para ser executado periodicamente selecionando, por exemplo, a opção "Em intervalos regulares" no painel de configuração "Agendamento". Se houver uma alteração, o gatilho retornará pacotes contendo informações sobre a alteração. Se não houver alteração, o gatilho não produzirá pacotes.
Os acionadores de pesquisa permitem que você selecione o primeiro pacote que eles devem enviar. O painel é exibido automaticamente depois que você salva um acionador ou quando faz uma alteração substancial nas configurações do acionador. Você também pode exibir o painel clicando com o botão direito do mouse no módulo e escolhendo "Escolher por onde começar" no menu de contexto.
❗ Observação
As configurações feitas no painel afetam apenas a primeira execução do módulo. Assim que o módulo for executado, ele se lembrará do último pacote gerado e as configurações feitas no painel serão anuladas.
Exemplos:
Dropbox > Monitorar arquivos: retorna os arquivos adicionados recentemente, desde a última vez que o cenário foi executado.
Twitter > Assistir Tweets: retorna novos Tweets postados pelo usuário desde a última vez que o cenário foi executado.
Tumblr > Assistir postagens: retorna novas postagens adicionadas a um blog selecionado desde a última vez que o cenário foi executado.
Gatilhos instantâneos
Os gatilhos instantâneos permitem que o serviço notifique o Toolzz Connect sobre a alteração imediatamente. Eles possuem a tag "Instant".
Normalmente, você desejará agendar um cenário contendo um acionador instantâneo para ser executado imediatamente, selecionando a opção "Imediatamente" no painel de configuração "Agendamento". Consulte também Webhooks para obter mais detalhes sobre como os dados recebidos são tratados.
Exemplos:
Paypal > Nova notificação: retorna novas notificações de pagamento.
Aggregators (agregadores)
Agregadores são módulos que acumulam vários pacotes em um único pacote.
Cada agregador retorna apenas um pacote que é passado para o próximo módulo para processamento posterior.
Os agregadores podem ser colocados apenas no meio de um cenário.
Os cenários podem conter um número ilimitado de agregadores.
Exemplos:
Arquivar > Criar um arquivo: compacta os arquivos recebidos em um arquivo zip.
CSV > Agregar a CSV: mescla várias strings de um arquivo CSV em uma única linha.
Ferramentas > Agregador de texto: combina várias strings em uma única string.
Iterators (iteradores)
Iteradores são módulos que dividem matrizes em vários pacotes separados.
Cada iterador retorna um ou mais pacotes que são passados para o próximo módulo para processamento.
Os iteradores podem ser colocados apenas no meio de um cenário.
Os cenários podem conter um número ilimitado de iteradores.
Exemplos:
E- mail > Recuperar anexos: divide uma matriz de anexos em pacotes separados.
Pronto! Agora você já sabe tudo sobre tipos de módulos do Toolzz Connect.