Pular para o conteúdo principal

Exportar Texto

Configuração atual da tarefa Exportar Texto no Workflow Designer

A tarefa Exportar Texto permite escrever um conteúdo textual dentro de um ficheiro num caminho especificado.

Configuração​

A configuração da tarefa define o nome do ficheiro, o local de salvamento, o conteúdo e o comportamento de escrita em caso de o ficheiro já existir. Os campos de configuração da Tarefa podem ser preenchidos manualmente ou através de parâmetros e variáveis do fluxo de trabalho.

  • Nome do Ficheiro: Especifica o nome que terá o ficheiro de saída, incluindo a sua extensão.
  • Exemplo: report.txt
  • Caminho do ficheiro: Indica o diretório (pasta) onde o ficheiro será salvo. O administrador deve disponibilizar um destino gravável.
  • Modo de escrita se o ficheiro existir: Menu que define o comportamento da tarefa quando o destino já contém um ficheiro com o mesmo nome. As opções disponíveis são:
  • Sobrescrever: O conteúdo do ficheiro existente é completamente apagado e substituído pelo novo conteúdo.
  • Anexar: O novo conteúdo é adicionado ao final do ficheiro existente, sem interrupções.
  • Anexar com quebra de linha: O novo conteúdo é adicionado ao final do ficheiro existente, mas primeiro é inserido um caractere de "quebra de linha" para separar o conteúdo antigo do novo.
  • Erro: A execução da Tarefa falha se o ficheiro já existir, impedindo sobrescrições acidentais.
  • Criar caminho se não existir: Se esta opção estiver ativada, a Tarefa criará automaticamente a estrutura de pastas especificada em "Caminho do ficheiro" caso não exista. Se estiver desativada, a Tarefa irá falhar se o diretório de destino não estiver presente.
  • Texto: A área de texto onde se define o conteúdo que será escrito no ficheiro

Parâmetros de Saída​

Assim que a Tarefa concluir a operação de escrita, expõe os seguintes parâmetros de saída que podem ser utilizados em tarefas subsequentes.

  • out.file: Retorna a referência completa ao ficheiro escrito.
  • out.filename: Retorna apenas o nome do ficheiro gerado (ex. “report.txt”).
  • out.filepath: Retorna a referência ao diretório onde o ficheiro foi salvo.
  • result: Indica o estado geral da operação de escrita (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.

Notas Importantes​

  • É fundamental garantir que o sistema onde o Workflow está a correr tenha permissões de escrita no caminho especificado em "Caminho do ficheiro".
  • Se a opção “Criar caminho se não existir” não estiver ativada, a Tarefa falhará se o diretório não estiver presente.