Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

Esta documentação é para a versão 4 e posterior do App Builder, o novo nome do Vinyl. Acesse a documentação do Vinyl aqui.

Codificação Base64 e APIs no Jitterbit App Builder

Base64 é uma maneira 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 se origina de uma codificação de transferência de conteúdo MIME específica. Os esquemas de codificação Base64 são comumente usados quando há necessidade de codificar dados binários que precisam ser armazenados e transferidos por mídias projetadas para lidar com dados textuais. A codificação Base64 pode ser usada para muitos arquivos e tipos de dados diferentes sendo transferidos, incluindo (mas não limitado 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 do outro lado do fio sem corrupção.

No App Builder, a codificação Base64 é usada para armazenar App Builder API Keys 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 há um único padrão 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 App Builder API Keys para Autenticação, elas assumem o formato Base64 url-encoded, 128 bit integer. 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 para 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 manualmente para ou decodificar de Base64, há muitos utilitários online que fornecem 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 sintaxe adequada para executar 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 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 Binary Column Photo em um Email como uma imagem:

Você pode codificar em Base64 a coluna Binary usando SQL com 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)')}

Então 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, veja o artigo do Mozilla.org Codificação e decodificação Base64