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、QR Code、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]。