Visão geral do módulo
O Adobe Workfront Fusion distingue cinco tipos de módulos:
- Módulos de ação
- Módulos de pesquisa
- Módulos de acionador
- Agregadores
- Iteradores
Agregadores e Iteradores são para cenários avançados.
Módulos de ação
Os módulos de ação são o tipo mais comum de módulo. Um módulo de ação típico executa uma ação e retorna um único pacote, que então passa para o próximo módulo para processamento.
Diferentemente dos módulos de acionador, os módulos de ação podem ser colocados no início, no meio ou no fim de um cenário.
Os cenários podem conter um número ilimitado de módulos de ação, embora um grande número de módulos (mais de 150) possa afetar o desempenho.
Exemplos:
- Workfront > Fazer upload de um arquivo envia um arquivo para o Workfront e retorna seu identificador.
- Imagem > Redimensionar recebe uma imagem, redimensiona-a para as dimensões especificadas e passa a imagem redimensionada para a próxima ação.
O tipo Ação tem quatro subtipos:
- Criar
- Ler
- Atualização
- Excluir
O subtipo Atualizar inclui as três operações a seguir:
-
Apagar o conteúdo de um campo. Essa operação ocorre quando o conteúdo do campo é avaliado para a palavra-chave
erase(não deve ser confundido comempty).
-
Deixe o conteúdo de um campo inalterado. Essa operação ocorre quando o campo é deixado em branco ou o conteúdo do campo é avaliado como em branco (representado por meio de nulo no JSON).
-
Substituir o conteúdo de um campo. Essa operação ocorre em todos os outros casos que não sejam os dois descritos acima.
-
Se você não vir a palavra-chave
eraseno painel de mapeamento, o módulo não será um módulo de atualização ou não foi atualizado para as especificações mais recentes do aplicativo. -
Emptynão altera o conteúdo do campo. Se for necessário apagar o campo, você poderá usar a seguinte fórmula:
-
No momento, não há suporte para manter um campo inalterado quando seu conteúdo é avaliado como em branco.
Módulos de pesquisa
Os módulos de pesquisa retornam zero, um ou mais pacotes, que passam para o próximo módulo para processamento.
Você pode colocar módulos de Pesquisa no início, no meio ou no fim de um cenário.
Os cenários podem conter um número ilimitado de módulos de pesquisa, embora um grande número de módulos (mais de 150) possa afetar o desempenho.
Exemplo:
Workfront > Ler registros relacionados lê registros que correspondem à consulta de pesquisa especificada em um determinado objeto principal.
Módulos de acionador
Os acionadores geram pacotes quando há uma alteração em um determinado serviço, como a criação ou a atualização de um registro.
Os acionadores retornam zero, um ou mais pacotes, que passam para o próximo módulo para processamento.
Como os Acionadores fazem com que os cenários comecem a ser executados, eles só podem ser colocados no início de um cenário.
Cada cenário pode conter apenas um Acionador.
O Workfront Fusion usa dois tipos de acionadores: acionadores de sondagem e acionadores instantâneos.
Acionadores de sondagem
Os acionadores de sondagem fazem regularmente a sondagem de um determinado serviço, mesmo se não houver alteração desde a execução do cenário anterior. Recomendamos agendar um cenário contendo um acionador de sondagem para ser executado em intervalos regulares. Se houver uma alteração que corresponda à configuração do acionador, ele retornará pacotes contendo informações sobre a alteração. Se não houver alteração que corresponda à configuração, o acionador não gerará nenhum pacote.
Para obter instruções sobre como agendar um cenário, consulte Agendar um cenário.
Os acionadores de sondagem permitem selecionar o primeiro pacote que devem gerar por meio de um painel que é exibido automaticamente depois que você salva um acionador ou altera as respectivas configurações. Essa seleção afeta apenas a primeira execução do módulo. Depois que o módulo for executado uma vez, as execuções subsequentes monitorarão apenas as alterações que ocorrerem após a execução mais recente.
Para obter mais informações, consulte Escolher onde um módulo de acionador inicia.
Exemplos:
-
Workfront > Monitorar registros retorna registros que foram adicionados recentemente após a última vez que o cenário foi executado.
-
Google Sheets> Monitorar linhas retorna novas linhas adicionadas após a última vez que o cenário foi executado.
Acionadores instantâneos
Os acionadores instantâneos permitem que um serviço notifique o Workfront Fusion sobre uma alteração imediatamente depois que ela ocorre. Recomendamos que você agende um cenário contendo um acionador instantâneo para ser executado imediatamente.
Para obter instruções, consulte Agendar um cenário.
Para obter detalhes sobre como os dados de entrada são tratados por um acionador instantâneo, consulte Acionadores instantâneos (webhooks).
Exemplos:
- Workfront > Monitorar eventos retorna informações quando um determinado tipo de evento ocorre no Workfront, como a criação de uma tarefa.
- Google Sheets> Monitorar alterações retorna informações sempre que uma célula é atualizada.
Agregadores
Um módulo Agregador acumula vários pacotes em um único pacote.
Os agregadores retornam apenas um pacote, que passa para o próximo módulo para processamento adicional.
Você pode colocar Agregadores somente no meio de um cenário.
Os cenários podem conter um número ilimitado de agregadores, embora um grande número de módulos (mais de 150) possa afetar o desempenho.
Exemplos:
- Arquivar > Criar um arquivo compacta vários arquivos em um arquivo zip.
- CSV > Agregar em CSV mescla várias strings de um arquivo CSV em uma única linha.
- Ferramentas > Agregador de texto combina várias strings em uma só.
Para obter mais informações, consulte Módulo Agregador.
Iteradores
Um Iterador é um tipo de módulo que divide matrizes em pacotes separados.
Os iteradores retornam um ou mais pacotes, que passam para o próximo módulo para processamento.
É possível colocar iteradores somente no meio de um cenário.
Os cenários podem conter um número ilimitado de iteradores, embora um grande número de módulos (mais de 150) possa afetar o desempenho.
Exemplo:
Email > Recuperar anexos quebra uma matriz de anexos em pacotes separados.
Para obter mais informações, consulte Módulo Iterador e Mapear uma matriz.