Guía del Desarrollador

Integración de Barcodesoft con Workday Extend

Aproveche las orquestaciones de Workday y los componentes de interfaz de usuario personalizados para generar códigos de barras dinámicos directamente en sus aplicaciones de Workday.

Prerrequisitos

Al completar su pedido, recibirá un correo electrónico automático que contiene su User_id, Secret y Scope. Estas credenciales son necesarias para autenticarse con el endpoint https://www.barcodesoft.com/api/auth/token.

Arquitectura de Integración

1. Orquestación

Una orquestación de Workday gestiona el intercambio de tokens OAuth 2.0 y la posterior llamada REST al servicio de códigos de barras.

2. Almacenamiento Seguro

Los tokens se almacenan en caché dentro de la sesión de la aplicación para optimizar el rendimiento y respetar los límites de velocidad de la API.

3. Interfaz de Componente

El código de barras SVG o PNG generado se vincula a un componente de imagen en la interfaz de usuario de la aplicación Workday.

Implementación Paso a Paso

1 Obtener el Token de Portador (Bearer Token)

Configure un Servicio Externo en Workday Extend y utilice los siguientes parámetros para obtener un token:

POST https://www.barcodesoft.com/api/auth/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=[SU_USER_ID]
&client_secret=[SU_SECRET]
&scope=[SU_SCOPE]
2 Llamada Dinámica al Endpoint de Código de Barras

En su orquestación, construya la URL dinámicamente. Por ejemplo, para generar un código de barras lineal GS1-128:

Parámetro Valor Propósito
data(02)12345...La carga útil a codificar
width3inAncho físico
imageformatsvgFormato vectorial (recomendado)
dpi300Resolución de impresión
3 Presentación en la Interfaz (PMD)

Vincule la URL de la imagen devuelta por su orquestación a un widget de imagen en el código de su página de Workday Extend:

{
  "type": "image",
  "label": "Código de Barras de Activo",
  "sourceUrl": "${orchestrationResponse.barcodeUrl}"
}

Obtenga sus Credenciales de Integración

Solicite una suscripción para desbloquear el acceso completo a la API de Cloud Barcode. Las credenciales (User_id, Secret, Scope) se entregan de inmediato por correo electrónico.

Soporta GS1-128 y Código QR Formatos PNG, SVG, WebP Seguro con OAuth 2.0

Consejos de Optimización

  • Use SVG para Zoom: El formato SVG es compatible de forma nativa en Workday Extend y ofrece la mejor experiencia para el escaneo móvil.
  • Expiración de Token: Implemente un bloque "Try-Catch" en su orquestación. Si la llamada al código de barras devuelve un error 401, refresque el token.
  • Codificación de URL: Codifique todos los parámetros (especialmente el campo data) para asegurar que los caracteres especiales como () no interrumpan la llamada REST.

Soporte Técnico

Nuestro equipo ofrece asistencia personalizada para integraciones con Workday Studio y Extend.

Contactar a Soporte