TIPOS DE MÓDULOS - TOOLZZ CONNECT

Esse é um tutorial da plataforma Toolzz Connect

Eduardo avatar
Escrito por Eduardo
Atualizado há mais de uma semana

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:

  1. Dropbox > Carregar um arquivo: envia um arquivo para uma pasta selecionada do Dropbox e retorna seu identificador.

  2. Imagem > Redimensionar: recebe uma imagem, redimensiona-a para o tamanho especificado e passa a imagem redimensionada para a próxima ação.

  3. 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:

  1. 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 ).

  2. 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):

  3. 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.

Respondeu à sua pergunta?