Intégration de Barcodesoft avec Workday Extend
Exploitez les orchestrations Workday et les composants d'interface utilisateur personnalisés pour générer des codes-barres dynamiques directement dans vos applications Workday.
Prérequis
Une fois votre commande terminée, vous recevrez un e-mail automatisé contenant votre User_id, votre Secret, et votre Scope. Ces identifiants sont nécessaires pour s'authentifier auprès du point de terminaison https://www.barcodesoft.com/api/auth/token.
Architecture d'Intégration
1. Orchestration
Une orchestration Workday gère la poignée de main (handshake) du jeton OAuth 2.0 et l'appel REST suivant vers le service de code-barres.
2. Stockage Sécurisé
Les jetons sont mis en cache dans la session de l'application pour optimiser les performances et respecter les limites de débit de l'API.
3. Interface Composant
Le code-barres SVG ou PNG généré est lié à un composant Image dans l'interface utilisateur de l'application Workday.
Mise en Œuvre Étape par Étape
1 Obtenir le Jeton Porteur (Bearer Token)
Configurez un Service Externe dans Workday Extend et utilisez les paramètres suivants pour obtenir un jeton :
POST https://www.barcodesoft.com/api/auth/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
&client_id=[VOTRE_USER_ID]
&client_secret=[VOTRE_SECRET]
&scope=[VOTRE_SCOPE]2 Appel Dynamique du Point de Terminaison
Dans votre orchestration, construisez l'URL de manière dynamique. Par exemple, pour générer un code-barres linéaire GS1-128 :
| Paramètre | Valeur | Objectif |
|---|---|---|
data | (02)12345... | Les données à encoder |
width | 3in | Largeur physique |
imageformat | svg | Format vectoriel (recommandé) |
dpi | 300 | Résolution d'impression |
3 Présentation UI (PMD)
Mappez l'URL de l'image renvoyée par votre orchestration à un widget d'image dans le code de votre page Workday Extend :
{
"type": "image",
"label": "Code-barres étiquette d'actif",
"sourceUrl": "${orchestrationResponse.barcodeUrl}"
}Obtenez vos Identifiants d'Intégration
Commandez un abonnement pour débloquer l'accès complet à l'API Cloud Barcode. Les identifiants (User_id, Secret, Scope) sont livrés immédiatement par e-mail.
Conseils d'Optimisation
- Utilisez le format SVG : Le SVG est supporté nativement dans Workday Extend et offre la meilleure expérience pour le balayage mobile.
- Expiration du Jeton : Implémentez un bloc "Try-Catch" dans votre orchestration. Si l'appel au code-barres renvoie une erreur 401, rafraîchissez le jeton.
- Encodage d'URL : Encodez tous les paramètres (particulièrement le champ
data) pour vous assurer que les caractères spéciaux comme()n'interrompent pas l'appel REST.
Support Technique
Notre équipe fournit une assistance personnalisée pour les intégrations Workday Studio et Extend.
Contacter le Support