Pular para o conteúdo principal

Converter para PDF

Configuração atual da tarefa Converter para PDF no Workflow Designer

A Tarefa Converter para PDF tem como objetivo receber um ficheiro de entrada (como um documento de texto, uma imagem ou uma folha de cálculo) e convertê-lo para um documento no formato PDF, tornando-o disponível para as Tarefas subsequentes.

Configuração​

A configuração da Tarefa permite especificar o ficheiro de origem e, opcionalmente, o destino do PDF gerado.

  • Ficheiro a importar: Neste campo deve ser inserido o caminho completo do ficheiro a converter. Pode ser um valor estático ou, mais comummente, um parâmetro dinâmico proveniente de um Tarefa anterior ou dos parâmetros do Workflow.

Personalização do Caminho de Saída​

O comportamento padrão do Caminho de Saída depende de como o ficheiro de origem é fornecido:

  • Caso 1: Entrada através de Parâmetro do tipo "Ficheiro" Quando o ficheiro de origem é passado através de um parâmetro dinâmico proveniente de uma Tarefa anterior ou dos parâmetros do Fluxo de Trabalho, o PDF convertido é guardado numa diretório gerido pelo sistema.
  • Caso 2: Entrada através de Caminho Escrito Manualmente Quando no campo "Ficheiro a importar" é escrito diretamente o caminho completo de um ficheiro existente (ex: /dados/entrada/relatorio.docx), o PDF convertido é guardado por defeito no mesmo diretório do ficheiro de origem (ou seja, em /dados/entrada/).

Em vez de selecionar a caixa de seleção Caminho do ficheiro, é possível especificar um destino personalizado. Serão mostrados os seguintes campos:

  • Caminho de saída: Aqui deve ser inserido o caminho da pasta onde se deseja guardar o ficheiro PDF convertido. Este campo também pode conter um valor estático ou um parâmetro dinâmico.
  • Criar caminho se não existir: Se esta opção estiver ativada, a Tarefa criará automaticamente a estrutura de pastas especificada em "Caminho de saída" caso não exista. Se estiver desativada, a Tarefa falhará se o diretório de destino não estiver presente.

Parâmetros de Saída​

Assim que a Tarefa concluir a conversão, expõe os seguintes parâmetros de saída:

  • file: Retorna o caminho completo do ficheiro PDF recém-criado (ex: /caminho/saida/documento.pdf). Este parâmetro é ideal para passar o ficheiro para Tarefas subsequentes, como por exemplo um enviar email com anexo.
  • filename: Retorna apenas o nome do ficheiro PDF gerado (ex: documento.pdf).
  • result: Indica o estado geral da operação de conversão (ex: "Success" ou uma mensagem de erro).
  • resultJson: Representa o resultado da execução da tarefa em formato JSON, incluindo informações gerais, configurações e detalhes da execução.