Pular para o conteúdo principal

Converter para CSV

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

A Tarefa Converter para CSV tem o objetivo de converter um ficheiro de dados estruturados, tipicamente uma folha de cálculo Excel (.xlsx), para um ficheiro de texto no formato CSV (Comma-Separated Values). Esta operação é fundamental para transformar dados de um formato legível e formatado para um formato universal e facilmente processável por outros sistemas automáticos ou Tarefas subsequentes (como "CSV para Tabela").

Configuração​

A configuração da Tarefa permite especificar o ficheiro de origem, o separador para a saída e, opcionalmente, o destino do ficheiro CSV gerado.

  • File to Import: Neste campo deve ser inserido o caminho completo do ficheiro a converter (ex: um ficheiro .xlsx). Pode ser um valor estático ou um parâmetro dinâmico proveniente de um Tarefa anterior ou dos parâmetros do Workflow.
  • CSV Output Separator: Este campo permite especificar o caractere que será utilizado para separar os valores nas colunas do ficheiro CSV de saída. É uma configuração crucial para garantir a compatibilidade com o sistema que deverá ler o ficheiro.
  • O valor padrão é a vírgula (,).
  • Pode ser personalizado com outros separadores comuns, como o ponto e vírgula (;) ou o pipe (|).
  • 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 selecionar, serão exibidos os seguintes campos:
  • Path output: Aqui deve ser inserido o caminho da pasta onde se deseja guardar o ficheiro CSV 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.

Destino 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 ficheiro CSV convertido é guardado numa diretório gerido pelo sistema.
  • Caso 2: Entrada através de Caminho Escrito Manualmente Quando no campo "File da importação" é escrito diretamente o caminho completo de um ficheiro existente (ex: /dados/entrada/relatorio.xlsx), o ficheiro CSV 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 CSV recém-criado (ex: /caminho/saida/relatorio.csv). 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 CSV gerado (ex: relatorio.csv).
  • 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.