Integration von Barcodesoft in Workday Extend
Nutzen Sie Workday Orchestrations und benutzerdefinierte UI-Komponenten, um dynamische Barcodes direkt in Ihren Workday-Apps zu generieren.
Voraussetzungen
Nach Abschluss Ihrer Bestellung erhalten Sie eine automatische E-Mail mit Ihrer User_id, Ihrem Secret und Ihrem Scope. Diese Zugangsdaten sind erforderlich, um sich am Endpunkt https://www.barcodesoft.com/api/auth/token zu authentifizieren.
Integrations-Architektur
1. Orchestration
Eine Workday Orchestration verwaltet den OAuth 2.0 Token-Handshake und den anschließenden REST-Aufruf an den Barcode-Service.
2. Sicherer Speicher
Token werden innerhalb der App-Sitzung zwischengespeichert, um die Leistung zu optimieren und API-Rate-Limits einzuhalten.
3. UI-Komponente
Der generierte SVG- oder PNG-Barcode wird an eine Bild-Komponente in der Workday App-UI gebunden.
Schritt-für-Schritt Implementierung
1 Bearer-Token sichern
Konfigurieren Sie einen External Service in Workday Extend und verwenden Sie die folgenden Parameter, um ein Token zu erhalten:
POST https://www.barcodesoft.com/api/auth/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
&client_id=[IHRE_USER_ID]
&client_secret=[IHR_SECRET]
&scope=[IHR_SCOPE]
2 Dynamischer Barcode-Endpunkt Aufruf
Erstellen Sie die URL in Ihrer Orchestration dynamisch. Beispiel für die Generierung eines linearen GS1-128 Barcodes:
| Parameter | Wert | Zweck |
|---|---|---|
data | (02)12345... | Die zu kodierenden Daten |
width | 3in | Physische Breite |
imageformat | svg | Vektorformat (empfohlen) |
dpi | 300 | Druckauflösung |
3 UI-Präsentation (PMD)
Verknüpfen Sie die von Ihrer Orchestration zurückgegebene Bild-URL mit einem Image-Widget in Ihrem Workday Extend-Seitencode:
{
"type": "image",
"label": "Asset-Tag Barcode",
"sourceUrl": "${orchestrationResponse.barcodeUrl}"
}
Optimierungs-Tipps
- SVG für Zoom nutzen: SVG wird in Workday Extend nativ unterstützt und bietet die beste Qualität beim mobilen Scannen.
- Token-Ablauf: Implementieren Sie einen "Try-Catch"-Block in Ihrer Orchestration. Wenn der Barcode-Aufruf einen 401-Fehler liefert, erneuern Sie das Token.
- URL-Kodierung: Kodieren Sie alle Parameter (besonders das Feld
data), um sicherzustellen, dass Sonderzeichen wie()den REST-Aufruf nicht unterbrechen.
Technischer Support
Unser Team bietet individuelle Unterstützung bei Workday Studio- und Extend-Integrationen.
Support kontaktieren