Intégration Workday & Cloud Barcode Barcodesoft
Un guide complet pour générer des codes-barres haute résolution dans l’écosystème Workday.
User_id, Secret et Scope par e-mail immédiatement après le traitement de votre commande.
Architecture technique
1. Authentification
Workday Integration Cloud initie une négociation OAuth 2.0 à l’aide de vos identifiants uniques afin d’obtenir un jeton Bearer sécurisé.
2. Requête REST
Workday Studio ou EIB envoie une requête GET avec des paramètres de données (par exemple, ID d’actif ou ID employé) vers le Cloud Barcodesoft.
3. Génération d’image
L’API Cloud génère le code-barres dans le format demandé (SVG/PNG) et transmet directement l’image à Workday.
Étape 1 : Obtenir un jeton d’accès
Échangez vos identifiants contre un jeton Bearer via le point de terminaison OAuth 2.0.
Configuration de la requête POST
https://www.barcodesoft.com/api/auth/token
| En-tête / Clé du corps | Valeur / Source |
|---|---|
Content-Type | application/x-www-form-urlencoded |
grant_type | client_credentials |
client_id | Votre User_id |
client_secret | Votre Secret |
scope | Votre Scope |
Étape 2 : Paramètres du point de terminaison
| Paramètre | Description | Valeurs prises en charge |
|---|---|---|
data |
Les informations à encoder (ID d’actif, NAS, etc.) | Alphanumérique, GS1 AI (01, 10, etc.) |
imageformat |
Le type de fichier de sortie | SVG, PNG, JPeg, WebP |
orientation |
Rotation de l’image | Original, Rotate90, Rotate180, Rotate270 |
dpi |
Résolution pour une qualité d’impression optimale | 96, 300, 600 |
Workday Studio
Utilisez le HTTP Outbound Connector dans votre assemblage afin de récupérer l’image. Si vous utilisez des codes-barres dans des rapports BIRT, assurez-vous de suivre les étapes suivantes :
- Définissez l’en-tête
Authorizationavec votre jeton Bearer. - Appelez la requête GET vers le point de terminaison spécifique (par exemple,
/barcode/v1/qrcode/). - Utilisez une étape Store afin de capturer le contenu binaire.
Workday EIB
Idéal pour la génération simple de cartes d’identité ou d’étiquettes d’actifs. Configurez le transport comme suit :
- Transformation : Créez un XSLT afin de construire dynamiquement la chaîne URL à partir de la sortie XML Workday.
- Transport REST : Associez le résultat de la transformation à la destination du point de terminaison REST.
Dépannage & Conseils
(01) sont encodées en URL sous la forme %2801%29 si vous rencontrez des erreurs « Invalid Data ».Conseils d’implémentation
- Utilisez toujours
imageformat=svgpour une impression parfaite dans les rapports PDF. - Assurez-vous que les chaînes de données sont encodées en URL (en particulier les parenthèses dans GS1-128).