Entwickler-Leitfaden

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
width3inPhysische Breite
imageformatsvgVektorformat (empfohlen)
dpi300Druckauflö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}"
}

Erhalten Sie Ihre Integrations-Zugangsdaten

Bestellen Sie ein Abonnement, um vollen Zugriff auf die Cloud Barcode API freizuschalten. Die Zugangsdaten (User_id, Secret, Scope) werden sofort per E-Mail zugestellt.

Unterstützt GS1-128 & QR Code Formate: PNG, SVG, WebP Sicher via OAuth 2.0

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