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 を直接出力可能です。
サブアカウントの接続設定
SAP BTP サブアカウントで、Connectivity > Destinations に移動します。SAP クラウドバックボーン経由でトラフィックをルーティングするための新しい HTTP Destination を定義します。
| プロパティ | 値 |
|---|---|
| Name | BARCODESOFT_CLOUD |
| URL | https://www.barcodesoft.com |
| Authentication | NoAuthentication (トークンは iFlow 内で管理) |
動的リクエスト処理 (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;
}
エンタープライズエラーハンドリング
堅牢な統合には、期限切れトークンや無効なデータ入力への対応が不可欠です。iFlow の **Exception Subprocess** を構成して、以下の状態をキャプチャします：
HTTP 401 (Unauthorized)
「Auth」ローカル統合プロセスをトリガーし、Bearer トークンを自動的にリフレッシュします。
HTTP 400 (Bad Request)
不正な GS1 文字を特定するために、ペイロードを MPL (Message Processing Log) に記録します。
統合のベストプラクティス
- キャッシュ: アクセストークンは、有効期間（3600秒）の間 BTP 変数に保存します。
- PNG より SVG: Fiori UI では、モバイル端末での鮮明なスケーリングを保証するために SVG を使用します。
- DPI 設定: Adobe Forms で小さな 2D DataMatrix コードを使用する場合は
dpi=600を指定します。 - API Management: 割り当てポリシー（Quota Policy）を適用し、バッチジョブ実行時の API 過剰利用を防止します。
Barcodesoft Cloud への即時アクセス
サブスクリプションにより、SAP連携向けにGS1-128、QRコード、DataMatrix、Code 128の無制限生成が可能です。 認証情報はメールですぐに送信されます[cite: 3, 4]。
テクニカルアシスタンス
当社のエンジニアリングチームは、SAP BTP、Integration Suite (CPI)、ABAP シナリオを専門としており、複雑な統合のトラブルシューティングをサポートします。
サポートに問い合わせる本稼働の準備はできていますか？
事前構成済みの iFlow テンプレートと本稼働用デプロイメントチェックリストを使用して、プロジェクトを加速させましょう。