企業級整合
SAP BTP 與 Cloud Barcode RESTapi
利用 SAP BTP Integration Suite 提升您的條碼標籤管理策略。本指南涵蓋了從連線配置到基於腳本的資料轉換的全流程技術生命週期。
OAuth 2.0 安全認證
透過 BTP Key Store 管理 Bearer 權杖，無需在 S/4HANA 中硬編碼 API 金鑰。
Groovy 腳本處理
根據 S/4HANA OData 負載動態計算條碼尺寸與格式。
多格式輸出
直接為 Fiori Web 應用程式生成 SVG 流，或為倉庫熱感式印表機生成高解析度 PNG。
1
子帳戶連線配置 (Connectivity)
在您的 SAP BTP 子帳戶 (Subaccount) 中，前往 Connectivity > Destinations。定義一個新的 HTTP 目標，以便透過 SAP 雲端骨幹網路由流量。
| 屬性 | 值 |
|---|---|
| 名稱 (Name) | BARCODESOFT_CLOUD |
| URL | https://www.barcodesoft.com |
| 身份驗證 (Authentication) | NoAuthentication (權杖在 iFlow 中管理) |
2
動態請求處理 (Groovy)
在您的 SAP Integration Suite iFlow 中，使用 Groovy 腳本確保條碼資料在呼叫端點之前已進行 URL 編碼並符合 GS1 標準。
import com.sap.gateway.ip.core.customdev.util.Message;
import java.util.HashMap;
def Message processData(Message message) {
def map = message.getHeaders();
def rawData = map.get("S4_Material_Batch"); // 來自 S/4HANA 的資料
// 格式化 GS1 資料: (01)GTIN(10)BATCH
def encodedData = java.net.URLEncoder.encode(rawData, "UTF-8");
message.setHeader("EncodedBarcodeData", encodedData);
return message;
}
3
企業級錯誤處理
健壯的整合方案必須處理過期的權杖或無效的資料輸入。配置您的 iFlow **Exception Subprocess** 來捕捉這些狀態：
HTTP 401 (未授權)
觸發 "Auth" 本地整合流程以自動刷新 Bearer 權杖。
HTTP 400 (錯誤請求)
在 MPL (消息處理日誌) 中記錄負載，以識別非法的 GS1 字元。
整合最佳實踐
- 快取機制： 將存取權杖存儲在 BTP 變數中，有效期為 3600 秒。
- SVG 優於 PNG： 在 Fiori UI 中使用 SVG，以確保在行動裝置上獲得清晰的縮放效果。
- DPI 設定： 在 Adobe Forms 中列印小型 2D DataMatrix 碼時，請使用
dpi=600。 - API 管理： 應用配額策略，防止在批次任務期間過度呼叫 API。
即時存取 Barcodesoft 雲端服務
訂閱可為您的 SAP 整合提供 GS1-128、QR Code、DataMatrix 與 Code 128 的無限制產生能力。 憑證將立即透過電子郵件寄送[cite: 3, 4]。
即時設定
OAuth 2.0 安全[cite: 3, 4]
支援 600 DPI[cite: 3, 4]