Ir para o conteúdo

Codificação Base64 e APIs no Jitterbit App Builder

Base64 é uma forma de codificar dados binários em um conjunto de caracteres ASCII conhecido pela maioria dos sistemas computacionais, para transmitir dados sem perda ou modificação do conteúdo em si. O termo Base64 origina-se de uma codificação de transferência de conteúdo MIME específica. Esquemas de codificação Base64 são comumente usados quando há necessidade de codificar dados binários que precisam ser armazenados e transferidos por meios projetados para lidar com dados textuais. A codificação Base64 pode ser usada para muitos arquivos e tipos de dados diferentes que estão sendo transferidos, incluindo (mas não se limitando a): PDFs, XLS, DOC, TXT, JPG, PNG, GIF, etc.

Por que usar a codificação Base64?

A codificação Base64 é útil porque você pode geralmente contar com os mesmos 64 caracteres presentes em muitos conjuntos de caracteres, e pode ter uma confiança razoável de que seus dados chegarão do outro lado da conexão sem corrupção.

No App Builder, a codificação Base64 é usada para armazenar Chaves de API do App Builder e também pode ser usada para transferir e armazenar arquivos trocados por APIs. Lembre-se sempre de codificar sua string Base64 no formato UTF-8. Como não existe um padrão único de API, você deve verificar a documentação da API com a qual está trabalhando para determinar se os arquivos devem ser transportados com codificação Base64.

Chaves de API do App Builder e codificação Base64

Ao trabalhar com Chaves de API do App Builder para Autenticação, estas assumem a forma de um inteiro de 128 bits codificado em URL Base64. Por exemplo: DLOo9sPS5slJEMHpXBFt3g.

A aplicação mais comum é para cabeçalhos de autenticação HTTP, onde o nome de usuário e a senha são combinados e codificados para produzir um 'token'. Este token é passado para um endpoint HTTP para autorizar a solicitação.

Para mais informações sobre como configurar a Autenticação de Chave de API no App Builder, veja Chave de API.

Como codificar e decodificar arquivos para/de Base64

Se você precisar codificar manualmente ou decodificar de Base64, existem muitas utilidades online que fornecem conversões para arquivos ou informações de string. Aqui está uma utilidade online que oferece codificação e decodificação:

https://www.base64decode.org/

É possível codificar e decodificar dados para Base64 sem usar uma ferramenta online. Você pode, por exemplo, usar comandos de linha de comando e a sintaxe adequada para realizar a transformação de dados.

Utilitários Base64 do SQL Server

O SQL Server possui suporte embutido para codificação e decodificação de arquivos em Base64.

Atalho do App Builder para renderizar foto de coluna binária em um email como imagem

Todos os dados de mensagens de email transmitidos pela internet são traduzidos como Base64. Aqui está um atalho útil para renderizar uma Foto de Coluna Binária em um Email como uma Imagem:

Você pode codificar em Base64 a coluna Binária usando SQL escapado e inserir a string codificada em Base64 em uma coluna. Por exemplo:

${cast('' as xml).value('xs:base64Binary(sql:column("ECL.Photo"))', 'varbinary(max)')}

Em seguida, você pode adicionar qualquer formatação de imagem ao seu modelo de fluxo de trabalho como CSS inline. Por exemplo:

<img src="data:image/png;base64,{{Photo}}"  width="20%" style="display: block; margin: 0 auto;">

Recursos

Para mais informações, consulte o artigo da Mozilla.org Codificação e Decodificação Base64