Este artigo oferece um guia completo sobre subfluxos no Workflow Builder (WFB) da Gelato, detalhando sua finalidade, criação e aplicação em processos de preflight de pré-impressão. Os subfluxos são componentes reutilizáveis que simplificam os fluxos de trabalho, permitindo que os usuários definam verificações e processos uma única vez e os utilizem em diferentes workflows, aumentando a eficiência e a consistência na produção gráfica.
Entendendo os subfluxos
Os subfluxos são componentes de workflow modulares e reutilizáveis que podem ser incorporados a qualquer workflow principal no Workflow Builder (WFB) da Gelato. Eles funcionam como blocos de construção independentes, permitindo que você defina um subfluxo uma vez, publique-o e o referencie em múltiplos workflows sem duplicar a lógica.
O principal caso de uso dos subfluxos no lançamento é o Preflight de pré-impressão, que envolve verificações automatizadas para validar e preparar os arquivos de arte antes do início da produção. Este artigo explica o que são os subfluxos, como criá-los e testá-los, e como as equipes de pré-impressão podem usá-los para padronizar as verificações de qualidade em todas as linhas de produtos gráficos.
💡 Dica: Se você ainda não conhece o canvas do Workflow Builder, leia o artigo Começando com o Workflow Builder antes de continuar com este guia.
Conceitos-chave dos subfluxos
Conceito | Adicionar Etapa |
Subfluxo | Um workflow incorporado dentro de outro workflow. Ele aceita entradas definidas, executa operações e retorna os resultados ao workflow principal. |
Workflow principal | O workflow principal que chama um ou mais subfluxos em etapas específicas. |
Preflight | Um processo de validação de pré-impressão que verifica se os arquivos de arte estão prontos para impressão antes da produção (por exemplo, modo de cor, sangria, resolução, versão do PDF). |
Atividade | Uma etapa única no canvas do workflow. "Subfluxo" é agora um novo tipo de atividade que pode ser adicionado a qualquer workflow. |
Template principal | Uma definição de subfluxo gerenciada de forma centralizada. Clientes e equipes vinculam ou copiam a partir de templates principais para manter a lógica consistente. |
Contexto | O objeto de dados compartilhado que percorre um workflow. As entradas e saídas são gravadas e lidas a partir desse contexto. |
Estado publicado | Um subfluxo deve ser publicado antes de poder ser usado dentro de um workflow principal. |
A importância do preflight de pré-impressão
Na produção gráfica, o preflight é o processo de inspecionar um arquivo digital — geralmente um PDF ou um arquivo de imagem — para garantir que ele atenda aos requisitos técnicos do método de impressão pretendido, antes que as chapas sejam feitas ou o trabalho seja enviado para a impressora. Erros identificados no preflight economizam tempo e custos significativos em comparação com reimpressões ou interrupções na produção.
Verificações comuns de preflight
Modo de cor — CMYK obrigatório; cores RGB ou especiais devem ser convertidas ou sinalizadas.
Resolução — As imagens devem atender ao DPI mínimo (normalmente 300 dpi para offset; 150 dpi para grande formato).
Sangria e marcas de borda — A arte deve se estender além da linha de borda pela sangria especificada (geralmente 3 mm ou 0,125").
Área de segurança — O conteúdo essencial deve estar dentro da área de segurança para evitar ser cortado.
Incorporação de fontes — Todas as fontes devem estar incorporadas ou convertidas em curvas para evitar substituições.
Conformidade com a versão do PDF — O trabalho pode exigir PDF/X-1a, PDF/X-3 ou PDF/X-4.
Configurações de sobreimpressão — Textos em preto e traços finos devem sobreimprimir corretamente.
Cobertura de tinta — A Cobertura Total de Área (TAC) não deve ultrapassar o limite da impressora.
Dimensões da página — O tamanho final deve corresponder à especificação do produto solicitado.
⚠️ Observação: Diferentes linhas de produtos têm regras de preflight distintas. Um subfluxo é o mecanismo ideal para encapsular a lógica de preflight específica de cada produto em um único lugar e reutilizá-la em todos os workflows relacionados.
Mapeando o preflight de pré-impressão para subfluxos no WFB
Com o recurso de subfluxo, a lógica de preflight de pré-impressão é definida uma única vez como um subfluxo e, em seguida, integrada a qualquer workflow de pedido — impressão digital, offset, grande formato, embalagem — como uma única atividade de subfluxo. O workflow principal simplesmente passa a URL do arquivo de arte e aguarda o resultado do preflight para decidir como prosseguir.
Etapas para criar um subfluxo
Abrir o canvas do subfluxo
Acesse o Workflow Builder e abra ou crie um workflow.
No canvas de atividades, clique em Adicionar atividade e selecione Subfluxo na lista de tipos de atividade.
No painel de subfluxo que se abre, escolha Criar novo subfluxo ou selecione um subfluxo existente na biblioteca de templates principais.
Dê ao seu subfluxo um nome claro e descritivo (por exemplo,
Preflight — Cartões de visita CMYK).
Definir entradas
Os subfluxos recebem dados do workflow principal por meio de parâmetros de entrada. Defina cada entrada na Atividade de entrada no início do canvas do subfluxo.
artwork_url— URL do arquivo de arte a ser verificado (obrigatório, tipo: string).product_sku— Identificador do produto usado para consultar as regras de especificação (obrigatório, tipo: string).expected_page_count— Número de páginas esperado (opcional, tipo: inteiro).bleed_mm— Sangria necessária em milímetros (opcional, tipo: número; padrão: 3).
💡 Dica: Para subfluxos de pré-impressão, aceite uma URL de arquivo em vez de um upload direto — a plataforma de subfluxos atualmente exige que os arquivos estejam hospedados em um repositório compartilhado antes de serem usados como entradas de teste.
Criar a lógica de preflight
Adicione atividades ao canvas do subfluxo para implementar as verificações de preflight. Um subfluxo típico de pré-impressão contém:
Atividade de download — Recupera o arquivo de arte de
artwork_url.Atividade de verificação preflight — Executa a inspeção automatizada do arquivo (modo de cor, DPI, sangria, versão do PDF, etc.).
Atividade de caminho — Ramifica com base no resultado do preflight: aprovado / aviso leve / falha crítica.
Atividade de saída — Retorna o
preflight_status(pass | warning | fail) e uma URL depreflight_reportpara o fluxo principal.
💡 Dica: Use uma atividade de caminho para lidar com os três padrões comuns de envio: arquivo único (capa + miolo combinados), dois arquivos (capa e miolo separados) ou arquivos mistos. Isso mantém o fluxo principal organizado enquanto o subfluxo cuida de todas as variações internamente.
Definir saídas
As saídas são gravadas no contexto compartilhado e retornadas ao fluxo principal. Defina no mínimo:
preflight_status— Resultado enumerado:pass,warningoufail.preflight_report_url— Link para um relatório de preflight completo e legível.error_codes— Array de códigos de erro da verificação (opcional, mas recomendado).
Publicar o subfluxo
Um subfluxo precisa ser publicado antes de poder ser usado dentro de um fluxo principal.
Clique em Save Draft para salvar seu trabalho a qualquer momento.
Quando estiver pronto, clique em Publish. O subfluxo ficará disponível no seletor de atividades para todos os fluxos de trabalho da sua organização.
Ao republicar, uma nova versão é criada; os fluxos principais existentes continuam referenciando a versão anterior até serem atualizados explicitamente.
Testar um subfluxo de forma isolada
É possível testar um subfluxo de forma independente, sem incorporá-lo a um fluxo principal. Essa é a abordagem recomendada durante o desenvolvimento.
Simular entradas
Abra o subfluxo no editor de canvas.
Clique em Test Subflow na barra de ferramentas.
No painel de simulação de entrada, forneça valores de exemplo para cada parâmetro de entrada definido.
Os arquivos de entrada precisam ser fornecidos como URLs que apontem para um arquivo hospedado — o upload direto de arquivos não é compatível durante testes isolados.
Clique em Run Test para executar o subfluxo com as entradas simuladas.
Inspecione o painel de saída para verificar se os valores de contexto retornados correspondem ao esperado.
Depuração de contexto de ponta a ponta
Para uma depuração mais avançada, é possível substituir a atividade de entrada pelo contexto de uma execução real do fluxo principal:
Execute o fluxo de trabalho pai com um pedido real para gerar um snapshot de contexto ao vivo.
Abra o painel de teste do subfluxo e ative Use Parent Context.
Cole ou selecione o snapshot de contexto — o subfluxo será executado usando valores reais do fluxo de trabalho pai em vez das entradas simuladas.
Revise a entrada/saída de cada atividade para identificar onde ocorre um comportamento inesperado.
Usando um subfluxo dentro de um fluxo de trabalho pai
Adicionando a atividade de subfluxo
Abra o canvas do fluxo de trabalho pai.
No ponto do fluxo em que o preflight deve ser executado, clique em Add Activity → Subflow.
Pesquise ou selecione o subfluxo de preflight publicado no seletor.
Mapeie as variáveis de contexto do fluxo de trabalho pai para os parâmetros de entrada esperados pelo subfluxo (ex.: mapeie
order.artwork_url→artwork_url).Clique em Salvar.
Agindo com base na saída do subfluxo
Após a conclusão da atividade de subfluxo, as saídas são gravadas de volta no contexto pai. Use uma atividade de caminho imediatamente após a atividade de subfluxo para ramificar com base em preflight_status:
pass→ continuar para o agendamento de produção.warning→ encaminhar para uma fila de revisão humana para problemas menores (ex.: baixa resolução em áreas não críticas).fail→ interromper o fluxo de trabalho, notificar o cliente para reenviar a arte corrigida e registrar oserror_codes.
💡 Dica: Centralizar o preflight em um único subfluxo significa que, quando uma regra de preflight muda (ex.: um novo requisito de versão PDF/X), você atualiza o subfluxo uma vez e todos os fluxos de trabalho pai que o referenciam se beneficiam imediatamente.
Templates principais e compartilhamento de subfluxos
Os subfluxos armazenados em uma biblioteca de templates principais ficam acessíveis a todos os membros da equipe. Isso garante padrões de preflight consistentes entre unidades de negócio e contas de clientes.
Vinculação vs. cópia
| Vinculando ao template principal | Copiando do template principal |
Comportamento de sincronização | Permanece sincronizado — atualizações no template principal são aplicadas automaticamente a todos os fluxos de trabalho vinculados | Cópia independente — alterações no template principal não afetam a cópia |
Ideal para | Regras de preflight padronizadas para toda a organização | Variações específicas por cliente ou linha de produto |
Risco | Uma alteração no template principal afeta todos os fluxos de trabalho vinculados de uma vez | Divergência ao longo do tempo se a cópia não for atualizada manualmente |
⚠️ Observação: A decisão de vincular ou copiar é importante para a governança. Converse com sua equipe de design de fluxos de trabalho antes de implantar subfluxos em contas de clientes em produção. As diretrizes formais sobre essa estratégia estão sendo finalizadas.