Pular para o conteúdo principal

Converter para DOCX

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

A Tarefa Converter para DOCX tem como objetivo receber um ficheiro de entrada (não aceita ficheiros pdf) e convertê-lo para um documento no formato Microsoft Word (.docx), 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 ficheiro DOCX 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 depende de como o ficheiro de origem é fornecido:

  • Caso 1: Entrada através de Parâmetro Dinâmico Quando o ficheiro de origem é passado através de um parâmetro dinâmico proveniente de uma Tarefa anterior ou dos parâmetros do Workflow, o ficheiro DOCX 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.txt), o ficheiro DOCX convertido é guardado por defeito no mesmo diretório do ficheiro de origem (ou seja, em /dados/entrada/).

Em vez disso, ao 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 DOCX 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 DOCX recém-criado (ex: /caminho/saida/documento.docx). 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 DOCX gerado (ex: documento.docx).
  • 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.