Workday 与 Barcodesoft Cloud Barcode 集成
在 Workday 生态系统中生成高分辨率条码的完整指南。
前提条件： 订单处理完成后，您的
User_id、Secret 和 Scope 将立即通过电子邮件发送给您[cite: 3, 4]。
技术架构
1. 身份验证
Workday Integration Cloud 使用您的专属凭据启动 OAuth 2.0 身份验证流程，以获取安全的 Bearer Token[cite: 3, 4]。
2. REST 请求
Workday Studio 或 EIB 向 Barcodesoft Cloud 发送包含数据参数（例如资产 ID 或员工 ID）的 GET 请求[cite: 3, 4]。
3. 图像生成
Cloud API 以请求的格式（SVG/PNG）生成条码，并将图像直接返回给 Workday[cite: 3, 4]。
步骤 1：获取访问令牌
通过 OAuth 2.0 端点将您的凭据交换为 Bearer Token[cite: 3, 4]。
POST 请求配置
https://www.barcodesoft.com/api/auth/token
| 请求头 / 请求体键 | 值 / 来源 |
|---|---|
Content-Type | application/x-www-form-urlencoded |
grant_type | client_credentials |
client_id | 您的 User_id[cite: 3, 4] |
client_secret | 您的 Secret[cite: 3, 4] |
scope | 您的 Scope[cite: 3, 4] |
步骤 2：端点参数
| 参数 | 说明 | 支持的值 |
|---|---|---|
data |
需要编码的信息（资产 ID、社会保险号等） | 字母数字、GS1 AI（01、10 等）[cite: 3, 4] |
imageformat |
输出文件类型 | SVG、PNG、JPeg、WebP[cite: 3, 4] |
orientation |
图像旋转方向 | Original、Rotate90、Rotate180、Rotate270[cite: 3, 4] |
dpi |
打印质量分辨率 | 96、300、600[cite: 3, 4] |
Workday Studio
在您的程序集成中使用 HTTP Outbound Connector 获取图像。如果您在 BIRT 报表 中使用条码，请确保执行以下步骤：
- 使用您的 Bearer Token 设置
Authorization请求头[cite: 3, 4]。 - 调用特定端点的 GET 请求（例如
/barcode/v1/qrcode/）[cite: 3, 4]。 - 使用 Store Step 捕获二进制内容[cite: 3, 4]。
Workday EIB
最适用于简单的员工卡生成或资产标签导出。请按以下方式配置传输：
- 转换： 创建 XSLT，根据 Workday XML 输出动态构建 URL 字符串[cite: 3, 4]。
- REST 传输： 将转换结果映射到 REST 端点目标[cite: 3, 4]。
即时访问 Barcodesoft Cloud
订阅后，您可以无限制生成 GS1-128、二维码、DataMatrix 和 Code 128 条码，用于您的 Workday 集成。 凭据将立即通过电子邮件发送[cite: 3, 4]。
即时设置
OAuth 2.0 安全保护[cite: 3, 4]
支持 600 DPI[cite: 3, 4]
故障排除与提示
对于基于 BIRT 的 Workday 报表，强烈建议使用 SVG。它在缩放时能够保持清晰边缘，从而避免高密度条码的扫描失败[cite: 3, 4]。
发送 GS1-128 数据时，请确保将类似
(01) 的括号进行 URL 编码为 %2801%29，以避免出现 “Invalid Data” 错误[cite: 3, 4]。实施提示
- 始终使用
imageformat=svg以获得 PDF 报表中的高质量打印效果[cite: 3, 4]。 - 确保数据字符串已经进行 URL 编码（特别是 GS1-128 中的括号）[cite: 3, 4]。