sap-btp-developer-guide

SAP BTP 開発者ガイドスキル

関連スキル

• sap-btp-cloud-platform：プラットフォームの基礎、アカウント管理、ランタイム構成に使用します
• sap-btp-best-practices：アーキテクチャのガイダンス、ガバナンスモデル、本番環境のパターンに使用します
• sap-cap-capire：CAP 開発の詳細、サービス定義、データベース連携に使用します
• sap-fiori-tools：UI 開発、Fiori アプリケーションのセットアップ、フロントエンドのデプロイに使用します
• sap-abap：ABAP Cloud 開発、RAP パターン、ABAP Environment 固有の内容に使用します
• sap-btp-connectivity：オンプレミスシステムへのセキュアな接続の実装に使用します
• sap-ai-core：AI Core プラットフォームのセットアップ、モデルのデプロイ、オーケストレーションに使用します
• sap-cloud-sdk-ai：CAP アプリケーションでの SDK レベルの AI 連携に使用します

SAP Business Technology Platform 上でビジネスアプリケーションを開発、デプロイ、運用するための包括的なガイダンスです。

目次

クイックナビゲーション

• 目次
• このスキルを使用する場面
• ランタイムとプログラミングモデルの選択
• 開発ワークフロー
• 主要なサービスとツール
• セキュリティの実装
• 接続パターン
• CI/CD の実装
• 可観測性の実装
• チュートリアルとミッション
• パートナー／ISV 開発
• よくあるエラーと解決策
• 同梱リソース
• クイックリファレンスリンク
• バージョン情報

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

次の場合に使用します：

• SAP BTP（Cloud Foundry または Kyma ランタイム）で新しいアプリケーションを構築する
• SAP Cloud Application Programming Model（CAP）を使用して開発する
• SAP BTP ABAP Environment で ABAP Cloud アプリケーションを構築する
• SAP Fiori または SAPUI5 のユーザーインターフェイスをデプロイする
• アプリケーションを SAP S/4HANA、SuccessFactors、またはオンプレミスシステムに接続する
• マルチテナントの SaaS アプリケーションを構築する
• SAP ソリューション向けのサイドバイサイド拡張を実装する
• AI を活用した拡張機能（LLM 分析、ドキュメント処理、インテリジェントオートメーション）を構築する
• SAP BTP の CI/CD パイプラインをセットアップする
• SAP Cloud ALM または SAP Cloud Logging を使用して可観測性を実装する
• データの永続化に SAP HANA Cloud を使用する

ランタイムとプログラミングモデルの選択

ランタイムの詳細な比較については、references/runtimes.md を参照してください。

判断マトリックス

基準	CAP（Cloud Foundry/Kyma）	ABAP Cloud
言語	Node.js、Java、TypeScript	ABAP
最適な用途	新しいクラウドネイティブアプリ、拡張機能	ABAP の専門知識を持つ組織
ランタイム	Cloud Foundry または Kyma	SAP BTP ABAP Environment
永続化	SAP HANA Cloud、PostgreSQL	SAP HANA Cloud（ABAP 管理）
UI フレームワーク	SAP Fiori Elements、SAPUI5	SAP Fiori Elements、SAPUI5
IDE	SAP Business Application Studio、VS Code	ABAP Development Tools（Eclipse）

CAP アプリケーション開発

CAP では、次の 3 つの運用プロファイルを利用できます：

• 開発：モックサービス、最小限のセットアップ、ローカルテスト用の SQLite/H2
• ハイブリッド：ローカルアプリケーションをクラウドサービスに接続
• 本番環境：SAP HANA Cloud を使用した完全なクラウドデプロイ

主な機能：

• CDS（Core Data Services）によるドメイン駆動設計
• マルチテナントの組み込みサポート
• OData/REST サービスの自動生成
• プラットフォームに依存しない設計（ベンダーロックインなし）

CAP の詳細については、references/cap-development.md を参照してください。

CAP による AI 対応拡張機能

CAP と SAP AI Core を組み合わせて、インテリジェントなサイドバイサイド拡張機能を構築します。

1. MTA 経由で CAP アプリを AI Core にバインドします（サービス：aicore、プラン：extended）
2. CAP のイベントハンドラーでは SAP Cloud SDK for AI（@sap-ai-sdk/orchestration）を使用し、生の HTTP 呼び出しは使用しないでください
3. 非同期で処理します。LLM の呼び出しには 30～60 秒かかる場合があります。BTP ロードバランサーのタイムアウトを避けるため、202 Accepted を返し、バックグラウンド処理には cds.spawn を使用します
4. ベクトルを保存します。RAG のシナリオでは、CDS エンティティに HANA Cloud の Vector(1536) 型を使用します
5. プロンプトを外部化します。再デプロイせずに更新できるよう、JSON ファイルまたは CDS エンティティに保存します
6. メモリを割り当てます。AI SDK を使用する Node.js コンテナには、少なくとも 512MB を割り当てます

コード例については、sap-cap-capire スキル（AI Integration セクション）と sap-cloud-sdk-ai スキル（CAP Integration サブセクション）を参照してください。

ABAP Cloud 開発

ABAP Cloud は、次の 4 つの基盤技術を使用します。

1. Core Data Services（CDS） - データモデリングと分析
2. ABAP RESTful Application Programming Model（RAP） - サービス指向の開発
3. 制限付き ABAP 言語 - クラウドセーフな API アクセス
4. リリース済みパブリック API - アップグレード時の安定性を保つ拡張機能

ABAP の詳細については、references/abap-cloud.md を参照してください。

開発ワークフロー

フェーズ 1：調査と発見

1. ビジネス上の課題を特定する - ステークホルダーへのインタビューを実施します
2. ユーザーのニーズを理解する - 顧客を訪問し、ワークフローを観察します
3. セキュリティ要件を定義する - 脅威モデリングとコンプライアンス計画（GDPR、HIPAA）を行います
4. ガバナンスを確立する - 組織構造を設定します

フェーズ 2：設計

1. ユーザーエクスペリエンスの設計

   • SAP Fiori Design Guidelines に従います
   • アクセシビリティ（WCAG 2.2）を実装します
   • デザイン思考の手法を使用します

2. テクノロジー設計

   • 複雑なアプリケーション（30 以上のユースケース）には、ドメイン駆動設計を適用します
   • モジュールの境界と通信パターンを定義します
   • 必要に応じてマイクロサービスアーキテクチャを計画します

3. 設計におけるセキュリティ

   • SAP Fiori 認証でユーザーインターフェースを保護します
   • OAuth/OpenID Connect を使用して RBAC/ABAC を実装します
   • データ保護のために CDS モデルを検証します

設計パターンについては、references/design-patterns.md を参照してください。

フェーズ 3：開発

CAP 開発：

# Initialize CAP project
cds init my-project
cd my-project

# Add SAP HANA support
cds add hana

# Add authentication
cds add xsuaa

# Run locally
cds watch

主な開発ツール：

• SAP Business Application Studio（主要な IDE）
• SAP Cloud SDK（OData/OpenAPI クライアント）
• MTA Build Tool（パッケージング）

コーディング標準：

• SAPUI5 Guidelines と SAP Fiori Design Guidelines に従います
• 命名規則を定めます
• パラメーター化クエリを実装します（SQL インジェクションを防止）
• 入力検証には CDS 制約を使用します

ツール一覧については、references/tools.md を参照してください。

フェーズ 4：デプロイ

Cloud Foundry へのデプロイ：

# Build MTA archive
mbt build

# Deploy to Cloud Foundry
cf deploy mta_archives/my-project_1.0.0.mtar

Kyma へのデプロイ：

# Use Helm charts or Terraform
terraform init
terraform apply

ABAP のデプロイ：

• Manage Software Components アプリ（gCTS）を使用します
• Landscape Portal 経由でトランスポートします
• パートナー向けの選択肢：マルチテナント SaaS またはアドオン製品

デプロイの詳細については、references/deployment.md を参照してください。

フェーズ 5：実行とスケーリング

監視：

• SAP Cloud ALM（一元的な可観測性）
• SAP Cloud Logging（詳細なログ、メトリクス、トレース）
• ABAP Technical Monitoring Cockpit

スケーリング：

• Cloud Foundry：AZ 間でインスタンスを自動分散
• Kyma：Kubernetes ネイティブのスケーリング
• ABAP：ACU 単位（0.5 ACU 刻み）のエラスティックスケーリング

コスト最適化：

• システムの休止（ABAP）- 運用コストを 5% 未満に削減
• SAP HANA Cloud Native Storage Extension
• ピーク時のワークロード向け Elastic Compute Nodes

運用については、references/operations.md を参照してください。

主なサービスとツール

プラットフォームサービス

サービス	目的
SAP HANA Cloud	データベース・アズ・ア・サービス、マルチモデル
SAP Connectivity Service	Cloud Connector 経由のオンプレミス/VPC 接続
SAP Destination Service	ルーティング、認証管理
SAP Event Mesh	アプリケーション間のイベント配信
SAP Integration Suite	API 管理、Cloud Integration

開発ツール

ツール	目的
SAP Business Application Studio	主なクラウド IDE
SAP Build	ローコード／ノーコード開発
Cloud Foundry CLI	CF のデプロイと管理
kubectl/Helm	Kyma/Kubernetes の管理
Terraform Provider for SAP BTP	コードとしてのインフラストラクチャ

アーキテクチャの詳細については、references/architecture.md を参照してください。

セキュリティの実装

CAP のセキュリティ機能

• パラメーター化クエリ（SQL インジェクションの防止）
• UI アプリケーションの CSRF 保護
• 組み込みの認証／認可フレームワーク
• シークレット管理のための SAP Credential Store

セキュリティガイドライン

1. 安全な環境設定 - ネットワークアクセスを制限します
2. セキュリティテスト - 本番稼働前に侵入テストを実施します
3. 安全なデプロイパイプライン - コードスキャン、依存関係の検証を行います
4. シークレット管理 - SAP Credential Store を使用します

セキュリティの詳細については、references/security.md を参照してください。

接続パターン

クラウドからオンプレミス

• SAP Connectivity Service と Cloud Connector
• ユーザー伝播に対応
• プロトコル：HTTP、RFC、LDAP、FTP

クラウドからクラウド

• ルーティングに SAP Destination Service を使用
• OAuth トークン管理
• Kubernetes 向け SAP Transparent Proxy

接続の詳細については、references/connectivity.md を参照してください。

CI/CD の実装

SAP Continuous Integration and Delivery では、事前設定済みのパイプラインが提供されます。

• Cloud Foundry Environment ジョブ（SAP Fiori、CAP）
• SAP Fiori for ABAP Platform ジョブ
• SAP Integration Suite Artifacts ジョブ

セットアップ手順：

1. SAP BTP cockpit で有効にします
2. Administrator/Developer ロールを割り当てます
3. リポジトリの認証情報を設定します（GitHub、GitLab、Bitbucket、Azure Repos）
4. リポジトリを追加してジョブを作成します
5. 自動ビルド用の Webhook を設定します

CI/CD の詳細については、references/cicd.md を参照してください。

オブザーバビリティの実装

中央レイヤー（SAP Cloud ALM）

• 実ユーザーモニタリング
• ヘルスモニタリング
• インテグレーションおよび例外モニタリング
• 合成ユーザーモニタリング

ローカルレイヤー（SAP Cloud Logging）

• ログ分析（OpenSearch ベース）
• 分散トレーシング
• カスタムダッシュボードとアラート

OpenTelemetry は、インストルメンテーションの業界標準です。

オブザーバビリティの詳細については、references/observability.md を参照してください。

チュートリアルとミッション

CAP の学習パス

1. スターターミッション：フルスタック CAP アプリケーション
2. 拡張ミッション：サイドバイサイドの CAP ベース拡張機能
3. エンタープライズミッション：変更追跡、監査ログ、添付ファイル
4. マルチテナントミッション：SaaS アプリケーション開発
5. オブザーバビリティミッション：SAP Cloud Logging の統合

ABAP の学習パス

1. RAP100 基礎：Fiori アプリ、OData サービス、ビジネスロジック
2. RAP100 中級：アクション、動的な機能制御、ユニットテスト
3. RAP120：SAP Joule による AI 支援開発
4. アナリティクス：SAP Analytics Cloud を使用した CDS ビュー

サンプルアプリケーション：

• インシデント管理（CAP）
• フライト参照シナリオ（ABAP）
• Poetry Slam Manager（パートナー SaaS）

チュートリアルの詳細については、references/tutorials.md を参照してください。

同梱リソース

ファイル構成

sap-btp-developer-guide/
├── SKILL.md                 # This file - Main guidance
├── README.md               # Quick reference with auto-trigger keywords
└── references/             # Detailed guides (22 files)
    ├── Architecture & Setup
    │   ├── architecture.md      # Platform services and architecture
    │   ├── runtimes.md          # Runtime comparison (CF vs Kyma vs ABAP)
    │   ├── setup.md             # BTP landscape setup and Terraform
    │   └── tools.md             # Development tools catalog
    ├── Development
    │   ├── cap-development.md   # CAP development guide
    │   ├── abap-cloud.md        # ABAP Cloud development guide
    │   ├── design-patterns.md   # Design patterns and DDD
    │   ├── extensions.md        # SAP solution extensions
    │   ├── mta.md               # Multitarget applications
    │   ├── testing.md           # Testing strategies
    │   └── ux-design.md         # UX design and Fiori
    ├── Integration & Security
    │   ├── connectivity.md      # Connectivity patterns
    │   ├── security.md          # Security implementation
    │   ├── hana-cloud.md        # SAP HANA Cloud
    │   └── resilience.md        # Resilience patterns
    ├── Deployment & Operations
    │   ├── deployment.md        # Deployment options
    │   ├── cicd.md              # CI/CD pipelines
    │   ├── observability.md     # Monitoring and logging
    │   ├── operations.md        # Operations and scaling
    │   └── partners.md          # ISV/Partner development
    └── Additional Resources
        ├── tutorials.md         # Learning paths and missions
        └── whats-new.md         # Changelog and updates

カテゴリ別のリファレンスファイル

アーキテクチャとプラットフォーム（4 ファイル）

• architecture.md - プラットフォームサービスの概要とアーキテクチャパターン
• runtimes.md - ランタイムの比較と選択ガイド
• setup.md - サイジングの推奨事項を含む BTP ランドスケープのセットアップ
• tools.md - 開発ツールの完全なカタログ

開発（8 ファイル）

• cap-development.md - Node.js/Java による CAP 開発
• abap-cloud.md - RAP による ABAP Cloud 開発
• design-patterns.md - ドメイン駆動設計とパターン
• extensions.md - SAP ソリューション向けのサイドバイサイド拡張機能
• mta.md - マルチターゲットアプリケーションのパッケージ化
• testing.md - テスト戦略とフレームワーク
• ux-design.md - SAP Fiori UX のデザインガイドライン

統合とセキュリティ (4 ファイル)

• connectivity.md - クラウドからオンプレミスへの接続
• security.md - 認証、認可、セキュリティ
• hana-cloud.md - SAP HANA Cloud データベース
• resilience.md - アプリケーションのレジリエンスパターン

デプロイと運用 (5 ファイル)

• deployment.md - CF、Kyma、ABAP へのデプロイ
• cicd.md - SAP ツールを使用した CI/CD パイプライン
• observability.md - モニタリング、ロギング、トレーシング
• operations.md - 運用、スケーリング、コスト最適化
• partners.md - ISV/パートナー開発ガイドライン

学習とアップデート (2 ファイル)

• tutorials.md - ハンズオンミッションとチュートリアル
• whats-new.md - 最新機能と変更履歴

パートナー/ISV 開発

デプロイオプション

1. マルチテナント SaaS - パートナーのグローバルアカウントで運用されるクラウドサービス
2. アドオンプロダクト - 顧客の ABAP 環境にインストールされる製品

要件

• SAP PartnerEdge Build 契約
• 登録済みの ABAP 名前空間 (必須)
• ライフサイクル管理用の Landscape Portal

パートナーの詳細については、references/partners.md を参照してください。

クイックリファレンスリンク

公式ドキュメント:

• SAP BTP Help: https://help.sap.com/docs/btp
• CAP Documentation: https://cap.cloud.sap/docs/
• SAP Discovery Center: https://discovery-center.cloud.sap/
• SAP API Business Hub: https://api.sap.com/

デザインリソース:

• SAP Fiori Design: https://experience.sap.com/fiori-design-web/
• SAPUI5 SDK: https://sapui5.hana.ondemand.com/

学習:

• SAP Developers: https://developers.sap.com/
• SAP Learning: https://learning.sap.com/

ソースドキュメント:

• このスキルは以下に基づいています: https://github.com/SAP-docs/btp-developer-guide

よくあるエラーと解決策

エラー	原因	解決策
サードパーティ Cookie の問題	ブラウザによる廃止	SAP Note 3409306 を参照
XSUAA バインディングの失敗	サービスインスタンスの欠落	cf create-service xsuaa application を実行
HANA デプロイエラー	誤ったターゲットコンテナ	mta.yaml の requires を確認
ATC 優先度 1 の検出結果	クラウド非準拠のコード	ABAP_CLOUD_DEVELOPMENT_DEFAULT バリアントを使用

バージョン情報

• ソース最終更新日: 2025-11-21
• 基づいているドキュメント: SAP BTP Developer Guide (https://github.com/SAP-docs/btp-developer-guide)
• 次回レビュー: 2026-02-21