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[cite: 3, 4].
Technical Architecture
1. Authentication
Workday Integration Cloud initiates an OAuth 2.0 handshake using your unique credentials to secure a Bearer Token[cite: 3, 4].
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[cite: 3, 4].
3. Image Rendering
The Cloud API renders the barcode in the requested format (SVG/PNG) and streams the image directly back to Workday[cite: 3, 4].
Step 1: Get Access Token
Exchange your credentials for a Bearer Token via the OAuth 2.0 endpoint[cite: 3, 4].
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[cite: 3, 4] |
client_secret | Your Secret[cite: 3, 4] |
scope | Your Scope[cite: 3, 4] |
Step 2: Endpoint Parameters
| Parameter | Description | Supported Values |
|---|---|---|
data |
The information to encode (Asset ID, SSN, etc.) | Alphanumeric, GS1 AI (01, 10, etc.)[cite: 3, 4] |
imageformat |
The output file type | SVG, PNG, JPeg, WebP[cite: 3, 4] |
orientation |
Rotation of the image | Original, Rotate90, Rotate180, Rotate270[cite: 3, 4] |
dpi |
Resolution for printed quality | 96, 300, 600[cite: 3, 4] |
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[cite: 3, 4]. - Invoke the GET request to the specific endpoint (e.g.,
/barcode/v1/qrcode/)[cite: 3, 4]. - Use a Store Step to capture the binary content[cite: 3, 4].
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[cite: 3, 4].
- REST Transport: Map the transformation result to the REST endpoint destination[cite: 3, 4].
Instant Access to Barcodesoft Cloud
A subscription provides unlimited access to GS1-128, QR Code, DataMatrix, and Code 128 generation for your Workday integration. Credentials delivered immediately via email[cite: 3, 4].
Troubleshooting & Tips
(01) are URL encoded to %2801%29 if you encounter "Invalid Data" errors[cite: 3, 4].Implementation Tips
- Always use
imageformat=svgfor pixel-perfect printing in PDF reports[cite: 3, 4]. - Ensure data strings are URL encoded (especially brackets in GS1-128)[cite: 3, 4].