Integração Workday & Barcodesoft Cloud Barcode
Um guia completo para gerar códigos de barras de alta resolução dentro do ecossistema Workday.
User_id, Secret e Scope por e-mail imediatamente após o processamento do seu pedido.
Arquitetura Técnica
1. Autenticação
O Workday Integration Cloud inicia um processo OAuth 2.0 usando suas credenciais exclusivas para obter um token Bearer seguro.
2. Requisição REST
O Workday Studio ou EIB envia uma requisição GET com parâmetros de dados (por exemplo, ID do ativo ou ID do funcionário) para a Barcodesoft Cloud.
3. Renderização da Imagem
A API Cloud gera o código de barras no formato solicitado (SVG/PNG) e transmite a imagem diretamente de volta para o Workday.
Etapa 1: Obter o Token de Acesso
Troque suas credenciais por um token Bearer através do endpoint OAuth 2.0.
Configuração da Requisição POST
https://www.barcodesoft.com/api/auth/token
| Cabeçalho / Chave do Corpo | Valor / Origem |
|---|---|
Content-Type | application/x-www-form-urlencoded |
grant_type | client_credentials |
client_id | Seu User_id |
client_secret | Seu Secret |
scope | Seu Scope |
Etapa 2: Parâmetros do Endpoint
| Parâmetro | Descrição | Valores Suportados |
|---|---|---|
data |
As informações a serem codificadas (ID do ativo, CPF, etc.) | Alfanumérico, GS1 AI (01, 10, etc.) |
imageformat |
O tipo do arquivo de saída | SVG, PNG, JPeg, WebP |
orientation |
Rotação da imagem | Original, Rotate90, Rotate180, Rotate270 |
dpi |
Resolução para qualidade de impressão | 96, 300, 600 |
Workday Studio
Use o HTTP Outbound Connector em sua montagem para recuperar a imagem. Se estiver usando códigos de barras em Relatórios BIRT, siga as etapas abaixo:
- Defina o cabeçalho
Authorizationcom seu token Bearer. - Execute a requisição GET para o endpoint específico (por exemplo,
/barcode/v1/qrcode/). - Use um Store Step para capturar o conteúdo binário.
Workday EIB
Ideal para geração simples de crachás ou etiquetas de ativos. Configure o transporte da seguinte forma:
- Transformação: Crie um XSLT para construir dinamicamente a string da URL com base na saída XML do Workday.
- Transporte REST: Mapeie o resultado da transformação para o destino do endpoint REST.
Solução de Problemas & Dicas
(01) estejam codificados na URL como %2801%29 caso encontre erros de "Invalid Data".Dicas de Implementação
- Use sempre
imageformat=svgpara impressão perfeita em relatórios PDF. - Certifique-se de que as strings de dados estejam codificadas na URL (especialmente parênteses em GS1-128).