Pular para o conteúdo principal

Converter para XLSX

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

A Tarefa Converter para XLSX executa a operação inversa à tarefa Converter para CSV: recebe um ficheiro de dados em formato CSV e converte-o para uma folha de cálculo Excel (.xlsx). É particularmente útil para gerar relatórios ou ficheiros que precisam de ser facilmente consultáveis, formatáveis e manipuláveis por utilizadores finais com software como o Microsoft Excel.

Configuração​

A configuração da Tarefa requer a especificação do ficheiro CSV de origem e do separador que utiliza, além do destino opcional para o ficheiro Excel.

  • File to Import: Neste campo, deve ser inserido o caminho completo do ficheiro CSV a converter. Pode ser um valor estático ou um parâmetro dinâmico.
  • Input CSV Separator: Este campo é crucial para a correta interpretação do ficheiro de origem. Aqui deve ser inserido o caractere que o ficheiro CSV de entrada usa para separar os seus valores.
  • O valor padrão é a vírgula (,).
  • Se o ficheiro de origem usar um separador diferente (ex. ponto e vírgula), é fundamental configurá-lo corretamente neste campo. Uma configuração incorreta causará a falha da conversão ou a geração de um ficheiro Excel com todos os dados incorretamente agrupados numa única coluna.
  • File Path (Checkbox): Ao selecionar esta opção, é possível especificar um destino personalizado para o ficheiro de saída; caso contrário, será utilizada uma destinação padrão. Ao selecioná-la, serão exibidos os seguintes campos:
  • Path output: Aqui deve ser inserido o caminho da pasta onde se deseja guardar o ficheiro Excel convertido.
  • Crea percorso se non esiste: Se ativado, cria automaticamente a pasta de destino se não existir. Se desativado, a Tarefa falhará se a pasta não estiver presente.

Destinação Padrão​

O comportamento padrão depende de como o ficheiro de origem é fornecido:

  • Caso 1: Entrada através de Parâmetro do tipo "File" 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 XLSX convertido é guardado numa diretório gerido pelo sistema.
  • Caso 2: Entrada através de Caminho Escrito Manualmente Quando no campo "File to Import" é escrito diretamente o caminho completo de um ficheiro existente (ex. /dados/entrada/relatorio.csv), o ficheiro XLSX convertido é guardado por defeito no mesmo diretório do ficheiro de origem (ou seja, em /dados/entrada/).

Parâmetros de Saída​

Após a conclusão da conversão, a Tarefa expõe os seguintes parâmetros:

  • file: Retorna o caminho completo do ficheiro XLSX recém-criado (ex. /caminho/saida/dados_convertidos.xlsx). Este parâmetro é ideal para passar o ficheiro a Tarefas subsequentes, como por exemplo um enviar email com anexo.
  • filename: Retorna apenas o nome do ficheiro XLSX gerado (ex. dados_convertidos.xlsx).
  • 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.