企业级集成
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]