sap-btp-integration-suite

SAP BTP Integration Suite の開発

関連スキル

• sap-btp-cloud-platform：BTP サブアカウント、サブスクリプション、エンタイトルメント、ロールの設定に使用します
• sap-btp-connectivity：宛先、Cloud Connector、ハイブリッド接続の依存関係に使用します
• sap-api-style：API プロキシのドキュメント、OpenAPI の品質、API ライフサイクルの標準に使用します
• sap-btp-cloud-transport-management：ランドスケープ間で統合アーティファクトを移送する際に使用します

このスキルを使用する場面

Cloud Integration の iFlow、API Management プロキシ、Event Mesh のトピック／キュー、Edge Integration Cell のデプロイ、Integration Advisor のマッピング、Trading Partner Management のフローを構築またはトラブルシューティングする場合や、Process Orchestration からの移行を評価する場合に、このスキルを使用します。

目次

• クイックリファレンス
• 機能の概要
• Cloud Integration の開発
• API Management の開発
• Event Mesh
• Edge Integration Cell
• Integration Advisor
• Trading Partner Management
• 移行評価
• 同梱リソース

クイックリファレンス

機能	目的	主要なアーティファクト
Cloud Integration	A2A／B2B／B2G の統合	Integration Flow（iFlow）
API Management	API のライフサイクルとガバナンス	API Proxy
Event Mesh	イベント駆動型アーキテクチャ	トピックとキュー
Edge Integration Cell	ハイブリッドデプロイ	Kubernetes ランタイム
Integration Advisor	B2B マッピングの自動化	MIG／MAG
Trading Partner Management	パートナーのオンボーディング	契約
Graph	統合データ API	Business Data Graph
Integration Assessment	テクノロジーの選定	ISA-M
Migration Assessment	PO 移行の計画	抽出と分析

---

機能の概要

Cloud Integration

A2A、B2B、B2G のシナリオに対応し、クラウド、オンプレミス、ハイブリッドのランドスケープ全体で統合フローを構築して実行します。80 種類以上のアダプターとリアルタイムのメッセージ処理をサポートします。

主要コンポーネント：

• Integration Flows（iFlows） - ビジュアルなメッセージ処理パイプライン
• アダプター - プロトコル／アプリケーション用コネクター（SFTP、HTTP、OData、RFC、AMQP、Kafka など）
• メッセージマッピング - グラフィカル／XSLT／Groovy による変換
• データストアと変数 - ステートフル処理のための永続化
• セキュリティマテリアル - キーストア、認証情報、PGP キー

API Management

セキュリティ、トラフィック制御、開発者エンゲージメントを備えた、API ライフサイクルの包括的な管理を提供します。

主要コンポーネント：

• API プロキシ - バックエンドサービス向けのファサード層
• ポリシー（34 種類） - セキュリティ、トラフィック、仲介のルール
• Developer Hub - 開発者向け API ポータル
• Products - アクセス制御付き API バンドル
• 分析 - 使用状況の指標とインサイト

Event Mesh

イベント駆動型アーキテクチャに対応し、企業のエコシステム全体でビジネスイベントを発行および利用します。

Edge Integration Cell

クラウドで設計しながら、プライベートなランドスケープ内でデータを処理するハイブリッドランタイムです。Kubernetes（EKS、AKS、GKE、OpenShift、RKE2）にデプロイします。

Integration Advisor

UN/EDIFACT、SAP IDoc、ASC X12 に対応した、AI を活用する B2B コンテンツ開発機能です。Message Implementation Guidelines（MIG）と Mapping Guidelines（MAG）を作成します。

Trading Partner Management

パートナープロファイル、契約テンプレート、自動化されたランタイムアーティファクトの生成により、B2B 関係を効率化します。AS2、SFTP、FTP プロトコルに対応しています。

---

Cloud Integration の開発

インポート可能な iFlow の生成

ユーザーから iFlow パッケージ、ZIP、インポート可能なアーカイブ、.iflw、または完全な Cloud Integration アーティファクトの生成を依頼された場合は、ファイルを書き込む前に references/iflow-package-authoring.md を参照してください。XML のみのフラットなパッケージを作成しないでください。

HTTPS から SFTP へのシナリオでは、templates/https-to-sftp-iflow-package/ をベースにし、そのディレクトリ構造を維持してください。

.project
META-INF/MANIFEST.MF
metainfo.prop
src/main/resources/parameters.prop
src/main/resources/parameters.propdef
src/main/resources/scenarioflows/integrationflow/HTTPS_to_SFTP_Template.iflw

ユーザーから異なる設計を求められない限り、外部化されたプレースホルダーのみをカスタマイズしてください。

• {{HTTPS_ENDPOINT_PATH}}
• {{SFTP_HOST}}
• {{SFTP_PORT}}
• {{SFTP_DIRECTORY}}
• {{SFTP_FILENAME}}
• {{SFTP_CREDENTIAL_ALIAS}}

認証情報、テナント URL、非公開のホスト名、証明書、デプロイ済みのランタイム状態を生成アーティファクトに含めないでください。インポートテストに使用できる SAP Cloud Integration テナントがない場合は、ローカルでのパッケージ構造と XML の検証は完了していますが、テナントへのインポートは未完了であると伝えてください。

Integration Flow の構造

Sender → [Adapter] → Integration Process → [Adapter] → Receiver
                           ↓
              ┌────────────┴────────────┐
              │  Message Processing     │
              │  - Content Modifier     │
              │  - Router/Filter        │
              │  - Mapping              │
              │  - Splitter/Aggregator  │
              │  - Script               │
              │  - External Call        │
              └─────────────────────────┘

一般的なフローステップ

カテゴリ	ステップ
ルーティング	Router, Filter, Multicast, Recipient List
変換	Content Modifier, Mapping, Converter, Script
分割	General Splitter, Iterating Splitter, EDI Splitter
永続化	Data Store, Write Variable, JMS Send
外部	Request Reply, Send, Poll Enrich, Content Enricher
セキュリティ	Encryptor, Decryptor, Signer, Verifier
エラー処理	Exception Subprocess, Escalation Event

アダプターのカテゴリ

プロトコルアダプター：HTTP、HTTPS、SFTP、FTP、AMQP、JMS、Kafka、AS2、AS4、SOAP、OData アプリケーションアダプター：SuccessFactors、Ariba、Salesforce、ServiceNow、Workday データベースアダプター：JDBC（Oracle、SQL Server、PostgreSQL、HANA、DB2） クラウドアダプター：AWS（S3、SQS、SNS）、Azure（Service Bus、Storage）、Google Cloud

スクリプトのガイドライン

スクリプトより標準ステップを優先してください。スクリプトが必要な場合：

// Access message body
def body = message.getBody(String.class)

// Access headers
def header = message.getHeader("HeaderName", String.class)

// Access properties
def prop = message.getProperty("PropertyName")

// Modify body
message.setBody(newBody)

// Add header
message.setHeader("NewHeader", "value")

// Logging (use SLF4J)
def log = org.slf4j.LoggerFactory.getLogger("script")
log.info("Processing message")

ベストプラクティス：

• 大きなペイロードには parseText(String) ではなく XmlSlurper.parse(Object) を使用してください
• 文字列の連結には StringBuilder を使用してください
• TimeZone.setDefault() は使用しないでください（VM 全体に影響します）
• 認証情報をヘッダーに書き込まないでください（トレースで公開されます）

---

API Management の開発

API プロキシの構造

Client → Proxy Endpoint → [Policies] → Target Endpoint → Backend
              ↓                              ↓
         PreFlow                        PreFlow
         Conditional Flows              Conditional Flows
         PostFlow                       PostFlow
              ↓                              ↓
         Fault Rules                    Fault Rules

ポリシーのカテゴリ

カテゴリ	ポリシー
セキュリティ	OAuth 2.0、Verify API Key、Basic Auth、SAML、Access Control
トラフィック	Quota、Spike Arrest、Concurrent Rate Limit、Response Cache
メディエーション	Assign Message、Extract Variables、JSON/XML Transform、XSL Transform
拡張	JavaScript、Python Script、Service Callout
脅威対策	JSON/XML Threat Protection、Regular Expression Protection
ログ記録	Message Logging、Statistics Collector

一般的なポリシー属性

<PolicyName enabled="true" continueOnError="false" async="false">
  
</PolicyName>

---

メッセージの Quality of Service

Exactly-Once 処理

重複を防ぐ必要がある場合に使用します。

1. JMS キュー - トランザクション対応のメッセージストレージ
2. 冪等性のあるプロセス呼び出し - ID マッピングによる重複検出
3. Data Store - メッセージの永続的な追跡

冪等性パターン

Sender → [ID Mapping] → Check Duplicate → Process → [ID Mapping Complete]
                              ↓ (duplicate)
                         Return Cached Response

---

Edge Integration Cell

デプロイ要件

• Kubernetes クラスター（EKS、AKS、GKE、OpenShift、RKE2）
• 最小要件：ワーカーノード 4 台、各 4 vCPU、16GB RAM
• ストレージ：100GB 以上の永続ボリューム
• ネットワーク：Ingress コントローラー、DNS 構成

ワークフロー

1. Integration Suite で Edge Integration Cell を有効化する
2. Kubernetes クラスターを準備する（プラットフォーム固有）
3. Edge Lifecycle Management Bridge をデプロイする
4. Edge Integration Cell ソリューションをデプロイする
5. キーストアの同期を構成する
6. インテグレーションコンテンツをデプロイする

---

トラブルシューティング

よくある問題

問題	解決方法
アダプターの接続に失敗しました	認証情報、ファイアウォール、Cloud Connectorを確認します
メッセージのマッピングエラー	送信元と送信先の構造を検証し、XPathを確認します
タイムアウト	アダプターのタイムアウトを延長し、マッピングを最適化します
メモリの問題	大きなペイロードをストリーミングし、ログ記録を減らします
メッセージの重複	冪等性のある処理を実装します
キーストアの同期に失敗しました	証明書の有効性を確認し、権限を確認します

監視階層

Integration Suite → Monitor → Integrations and APIs
    ├── Message Processing → All Integration Flows
    ├── Manage Integration Content → Deployed Artifacts
    ├── Manage Security → Keystores, Credentials
    └── Manage Stores → Data Stores, Variables, Queues

---

制限事項のリファレンス

リソース	制限
テナントあたりの統合フロー	プランによって異なります
JMS キュー	テナントあたり30（標準）
データストア	合計ストレージ容量100MB
メッセージ処理ログの保持期間	30日
添付ファイルのサイズ	40MB
API プロキシ（APIM）	サービスプランに基づきます
ビジネスデータグラフ	アカウントあたり500、サブアカウントあたり50

---

同梱リソース

リファレンスドキュメント

詳細なガイドは references/ ディレクトリにあります。

コア開発：

• cloud-integration.md - iFlowの開発、ステップ、パターン、ベストプラクティス
• iflow-package-authoring.md - インポート可能なiFlowパッケージの構造とHTTPSからSFTPへの生成ルール
• adapters.md - 80種類以上のすべてのアダプター設定（HTTP、SFTP、OData、RFCなど）
• scripting.md - Groovy／JavaScriptのパターン、API、テンプレート
• api-management.md - APIプロキシの開発、34のポリシー、Developer Hub
• security.md - 認証、キーストア、証明書、認証情報

機能：

• edge-integration-cell.md - ハイブリッドKubernetesのデプロイガイド
• event-mesh.md - トピック、キュー、ブローカー、Webhook、EDAパターン
• integration-advisor-tpm.md - B2B統合、MIG、MAG、パートナー管理
• graph-odata.md - ビジネスデータグラフ、ODataのプロビジョニング
• data-space-integration.md - Catena-X、EDC、主権データ交換
• migration-assessment.md - PO移行、ISA-M、テクノロジーマッピング

運用：

• operations-monitoring.md - メッセージの監視、ストア、接続テスト
• content-transport.md - TMS、CTS+、MTAR、手動でのエクスポート／インポート
• troubleshooting.md - エラー解決、診断、HTTPエラーカタログ

テンプレート

すぐに使えるテンプレートは templates/ ディレクトリにあります。

• https-to-sftp-iflow-package/ - HTTPS送信元からSFTP受信先へのシナリオ向けの、レビュー可能な非圧縮インポート用iFlowテンプレート
• groovy-script-template.groovy - 一般的なスクリプトパターン
• api-policy-template.xml - ポリシー設定テンプレート

---

ドキュメントへのリンク

公式情報源

• GitHubリポジトリ：https://github.com/SAP-docs/sap-btp-integration-suite
• SAP Help Portal：https://help.sap.com/docs/integration-suite
• SAP Community：https://community.sap.com/topics/cloud-platform-integration-suite
• SAP Business Accelerator Hub：https://api.sap.com/

機能別

• Cloud Integration：https://help.sap.com/docs/cloud-integration
• API Management：https://help.sap.com/docs/sap-api-management
• Event Mesh：https://help.sap.com/docs/event-mesh
• Integration Advisor：https://help.sap.com/docs/integration-advisor

リリースノート

• 新機能：ドキュメント内の what-s-new-for-sap-integration-suite-79cd682.md を確認してください
• パッチリリース：patch-release-notes-for-sap-integration-suite-58595b5.md を確認してください