Integrando Barcodesoft com Workday Extend
Aproveite as Orquestrações do Workday e componentes de UI personalizados para gerar códigos de barras dinâmicos diretamente em seus apps Workday.
Pré-requisitos
Ao concluir seu pedido, você receberá um e-mail automático contendo seu User_id, Secret e Scope. Essas credenciais são necessárias para se autenticar no endpoint https://www.barcodesoft.com/api/auth/token.
Arquitetura de Integração
1. Orquestração
Uma Orquestração do Workday gerencia o handshake do token OAuth 2.0 e a subsequente chamada REST para o serviço de código de barras.
2. Armazenamento Seguro
Os tokens são armazenados em cache na sessão do app para otimizar o desempenho e respeitar os limites de taxa da API.
3. Componente de UI
O código de barras SVG ou PNG gerado é vinculado a um Componente de Imagem na interface do usuário do App Workday.
Implementação Passo a Passo
1 Obtenha o Bearer Token
Configure um Serviço Externo no Workday Extend e use os seguintes parâmetros para obter um token:
POST https://www.barcodesoft.com/api/auth/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
&client_id=[SEU_USER_ID]
&client_secret=[SEU_SECRET]
&scope=[SEU_SCOPE]2 Chamada Dinâmica ao Endpoint
Em sua Orquestração, construa a URL dinamicamente. Por exemplo, para gerar um código de barras linear GS1-128:
| Parâmetro | Valor | Finalidade |
|---|---|---|
data | (02)12345... | O conteúdo a ser codificado |
width | 3in | Largura física |
imageformat | svg | Formato vetorial (recomendado) |
dpi | 300 | Resolução de impressão |
3 Apresentação na UI (PMD)
Mapeie a URL da imagem retornada pela sua Orquestração para um widget de imagem no código da página do Workday Extend:
{
"type": "image",
"label": "Código de Barras de Ativo",
"sourceUrl": "${orchestrationResponse.barcodeUrl}"
}Obtenha suas Credenciais de Integração
Assine um plano para desbloquear o acesso total à Cloud Barcode API. As credenciais (User_id, Secret, Scope) são entregues imediatamente via e-mail.
Dicas de Otimização
- Use SVG para Zoom: O SVG é suportado nativamente no Workday Extend e oferece a melhor experiência para escaneamento móvel.
- Expiração do Token: Implemente um bloco "Try-Catch" em sua Orquestração. Se a chamada do código de barras retornar 401, atualize o token.
- URL Encoding: Codifique todos os parâmetros (especialmente o campo
data) para garantir que caracteres especiais como()não quebrem a chamada REST.
Suporte Técnico
Nossa equipe oferece assistência individual para integrações com Workday Studio e Extend.
Contatar Suporte