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[cite: 3, 4].
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[cite: 3, 4].
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[cite: 3, 4].
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[cite: 3, 4].
Etapa 1: Obter o Token de Acesso
Troque suas credenciais por um token Bearer através do endpoint OAuth 2.0[cite: 3, 4].
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[cite: 3, 4] |
client_secret | Seu Secret[cite: 3, 4] |
scope | Seu Scope[cite: 3, 4] |
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.)[cite: 3, 4] |
imageformat |
O tipo do arquivo de saída | SVG, PNG, JPeg, WebP[cite: 3, 4] |
orientation |
Rotação da imagem | Original, Rotate90, Rotate180, Rotate270[cite: 3, 4] |
dpi |
Resolução para qualidade de impressão | 96, 300, 600[cite: 3, 4] |
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[cite: 3, 4]. - Execute a requisição GET para o endpoint específico (por exemplo,
/barcode/v1/qrcode/)[cite: 3, 4]. - Use um Store Step para capturar o conteúdo binário[cite: 3, 4].
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[cite: 3, 4].
- Transporte REST: Mapeie o resultado da transformação para o destino do endpoint REST[cite: 3, 4].
Acesso Instantâneo à Barcodesoft Cloud
Uma assinatura fornece acesso ilimitado à geração de códigos GS1-128, QR Code, DataMatrix e Code 128 para sua integração com o Workday. As credenciais são entregues imediatamente por e-mail[cite: 3, 4].
Solução de Problemas & Dicas
(01) estejam codificados na URL como %2801%29 caso encontre erros de "Invalid Data"[cite: 3, 4].Dicas de Implementação
- Use sempre
imageformat=svgpara impressão perfeita em relatórios PDF[cite: 3, 4]. - Certifique-se de que as strings de dados estejam codificadas na URL (especialmente parênteses em GS1-128)[cite: 3, 4].