Pular para o conteúdo principal

Codificar em Base64

Configuração atual da tarefa Base64 Encode no Workflow Designer

A Tarefa Codificar em Base64 serve para codificar o conteúdo de um ficheiro no formato Base64. Este processo transforma dados binários (como os de uma imagem, um PDF ou qualquer outro ficheiro) numa representação textual, comumente usada para transmitir dados em contextos que suportam apenas texto, como por exemplo dentro de um ficheiro XML ou JSON.

Configuração​

Este é o painel operacional da Tarefa. É aqui que se define qual ficheiro deve ser submetido ao processo de codificação.

Ficheiro a Importar​

Neste campo, é necessário especificar o ficheiro de origem cujo conteúdo será convertido numa string Base64.

A inserção do caminho do ficheiro pode ser feita de várias maneiras:

Caminho Direto: É possível digitar manualmente o caminho absoluto do ficheiro no campo de texto.

Seleção por Parâmetro: Clicando no botão (☰) abre-se o menu "Lista de Parâmetros". Isto permite escolher dinamicamente o ficheiro a processar.

  • No menu, é possível arrastar diretamente os parâmetros disponíveis para dentro do campo Ficheiro a Importar. Os parâmetros estão organizados por categoria (ex. Parâmetros de execução, Parâmetros do fluxo de trabalho, etc.).
  • É fundamental escolher um parâmetro que termine com o sufixo .file (por exemplo, prova.file). Este tipo de parâmetro contém a referência correta ao caminho do ficheiro, por exemplo, gerado por uma tarefa anterior no fluxo de trabalho.
  • Quando um parâmetro é arrastado para o campo, será inserido com uma sintaxe especial, como por exemplo #>prova.file<#. Isto indica à tarefa para não usar o texto literal, mas sim para resolver dinamicamente o valor da variável prova.file no momento da execução.

Após a execução, a tarefa lerá o conteúdo do ficheiro especificado e produzirá em saída a string Base64 correspondente, que poderá ser utilizada nas tarefas subsequentes do Fluxo de Trabalho.

Parâmetros de Saída​

Ao final da execução, a Tarefa Codificar em Base64 expõe uma série de parâmetros de saída que podem ser utilizados nas tarefas seguintes do Diagrama:

  • result: Indica o resultado da operação, por exemplo: “File Encoded Correctly”.
  • resultJson: representa o resultado da execução da tarefa em formato JSON, incluindo informações gerais, configurações e detalhes da execução.
  • base64: a string em formato Base64 obtida do ficheiro de entrada.