Workday & Barcodesoft Cloud Barcode Integration
A comprehensive guide for generating high-resolution barcodes within the Workday Ecosystem.
User_id, Secret, and Scope via email immediately after your order is processed.
Technical Architecture
1. Authentication
Workday Integration Cloud initiates an OAuth 2.0 handshake using your unique credentials to secure a Bearer Token.
2. REST Request
Workday Studio or EIB sends a GET request with data parameters (e.g., Asset ID or Employee ID) to the Barcodesoft Cloud.
3. Image Rendering
The Cloud API renders the barcode in the requested format (SVG/PNG) and streams the image directly back to Workday.
Step 1: Get Access Token
Exchange your credentials for a Bearer Token via the OAuth 2.0 endpoint.
POST Request Configuration
https://www.barcodesoft.com/api/auth/token
| Header / Body Key | Value / Source |
|---|---|
Content-Type | application/x-www-form-urlencoded |
grant_type | client_credentials |
client_id | Your User_id |
client_secret | Your Secret |
scope | Your Scope |
Step 2: Endpoint Parameters
| Parameter | Description | Supported Values |
|---|---|---|
data |
The information to encode (Asset ID, SSN, etc.) | Alphanumeric, GS1 AI (01, 10, etc.) |
imageformat |
The output file type | SVG, PNG, JPeg, WebP |
orientation |
Rotation of the image | Original, Rotate90, Rotate180, Rotate270 |
dpi |
Resolution for printed quality | 96, 300, 600 |
Workday Studio
Use the HTTP Outbound Connector in your assembly to fetch the image. If using barcodes in BIRT Reports, ensure you use the following steps:
- Set the
Authorizationheader with your Bearer Token. - Invoke the GET request to the specific endpoint (e.g.,
/barcode/v1/qrcode/). - Use a Store Step to capture the binary content.
Workday EIB
Best for simple ID card generation or Asset Label exports. Configure the transport as follows:
- Transformation: Create an XSLT to build the URL string dynamically based on the Workday XML output.
- REST Transport: Map the transformation result to the REST endpoint destination.
Troubleshooting & Tips
(01) are URL encoded to %2801%29 if you encounter "Invalid Data" errors.Implementation Tips
- Always use
imageformat=svgfor pixel-perfect printing in PDF reports. - Ensure data strings are URL encoded (especially brackets in GS1-128).