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 de computador, para transmitir dados sem perda ou modificação do conteúdo em si. O termo Base64 origina-se de uma codificação MIME específica para transferência de conteúdo. Os esquemas de codificação Base64 são comumente usados quando há a necessidade de codificar dados binários que precisam ser armazenados e transferidos em mídias projetadas para lidar com dados textuais. A codificação Base64 pode ser usada para diversos arquivos e tipos de dados 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 geralmente você pode confiar que os mesmos 64 caracteres estarão presentes em muitos conjuntos de caracteres e pode ter certeza razoável de que seus dados chegarão ao outro lado do fio sem serem corrompidos.

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 para API, você deve consultar 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, elas assumem o formato de um inteiro de 128 bits codificado em URL em 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". Esse token é passado a um endpoint HTTP para autorizar a solicitação.

Para obter mais informações sobre como configurar a autenticação de chave de API no App Builder, consulte Chave de API.

Como codificar e decodificar arquivos de/para Base64

Se você precisar codificar ou decodificar manualmente de Base64, existem muitos utilitários online que oferecem conversões para arquivos ou informações de string. Aqui está um utilitário online que oferece codificação e decodificação:

https://www.base64decode.org/

É possível codificar e decodificar dados para Base64 sem usar um utilitário online. Você pode, por exemplo, usar prompts de linha de comando e a sintaxe adequada para realizar a transformação de dados.

Utilitários SQL Server Base64

O próprio SQL Server possui suporte integrado para arquivos de codificação e decodificação Base64.

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

Todos os dados de mensagens de e-mail 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 a coluna Binary em Base64 usando SQL de escape 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 workflow como CSS inline. Por exemplo:

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

Recursos

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