sap-btp-build-work-zone-advanced

SAP Build Work Zone, Advanced Edition

関連スキル

• sap-btp-business-application-studio：開発スペースのセットアップと UI Integration Card の開発ワークフローに使用します
• sap-btp-cloud-platform：BTP のサブスクリプション、宛先、ロールコレクション、ランタイムのセットアップに使用します
• sapui5：UI5 カード／コンポーネントの開発に関する詳細に使用します
• sap-btp-connectivity：宛先、Cloud Connector、OData の業務レコード接続に使用します

このスキルでは、業務アプリケーション、プロセス、コラボレーションへの統合アクセスを実現するデジタルワークプレイスプラットフォームである SAP Build Work Zone, advanced edition の実装に関する包括的なガイダンスを提供します。

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

次のような場合に、このスキルを使用してください。

• ワークスペース、ワークページ、コラボレーションサイトを作成する場合
• SAP Business Application Studio で UI Integration Card を開発する場合
• コンテンツパッケージを構築してデプロイする場合
• ワークスペーステンプレートを作成する場合
• Microsoft 365、Teams、SharePoint、Google Drive と統合する場合
• SAP Conversational AI を使用してチャットボットを設定する場合
• イベント通知用の Webhook を実装する場合
• ユーザープロビジョニング用の SCIM API をセットアップする場合
• OData ベースの業務レコードを設定する場合
• テーマとブランディングを管理する場合
• ロールベースアクセスと SSO を設定する場合
• Administration Console を使用する場合

クイックスタート

1. サブアカウントに SAP Build Work Zone, advanced edition の使用権とサブスクリプションがあることを確認します。
2. 必要な管理者ロールコレクションを割り当てます。
3. UI Integration Card をサポートする SAP Business Application Studio の開発スペースを作成するか、確認します。
4. コンテンツ、カード、OData 業務レコード、または外部システム用の宛先を設定します。
5. 実装には templates/ のコンテンツパッケージとカードテンプレートを使用します。

目次

• プラットフォームの概要
• 主要な概念
• 開発環境のセットアップ
• UI Integration Card の開発
• コンテンツパッケージ
• ワークスペーステンプレート
• チャットボットの統合
• API リファレンス
• Administration Console
• 機能管理
• 外部統合
• セキュリティ
• Webhook
• テーマとブランディング
• レポートと分析
• トラブルシューティング
• バンドルリソース
• ドキュメントへのリンク

プラットフォームの概要

SAP Build Work Zone, advanced edition は、次の機能を備えたデジタルワークプレイスプラットフォームです。

• SAP およびサードパーティの業務アプリケーションへの統合アクセスを提供します
• フィード、ブログ、Wiki、フォーラムを備えたコラボレーションワークスペースを実現します
• シングルサインオン（SSO）によるロールベースのナビゲーションをサポートします
• Web ブラウザー、モバイルアプリ、レスポンシブ Web UI で動作します
• クラウド、ハイブリッド、オンプレミスのアプリケーションと統合します

主要な概念

ワークスペース

特定のユーザーグループ内でのチームのコミュニケーションとコラボレーションのために、専用のページとフィードを備えた個別のセクションです。

ワークページ

ウィジェット、カード、アプリケーションを使用して設定できるカスタマイズ可能なページです。

UI Integration Cards

限られたスペースのコンテナに簡潔な情報を表示するデザインパターンです。SAPUI5 カード仕様（最小バージョン 1.87.0。新しいバージョンもサポートされており、最新機能を利用するには推奨されます）に従ってください。

コンテンツパッケージ

配布用に ZIP ファイルにまとめられたアーティファクト（カード、ワークフロー、ワークスペーステンプレート）のコレクションです。

ワークスペーステンプレート

最小限の変更でワークスペースを作成できる、事前構築済みのフレームワークです。

開発環境のセットアップ

前提条件

1. SAP Build Work Zone, advanced edition の SAP BTP サブスクリプション
2. SAP Business Application Studio のサブスクリプション
3. Workzone_Admin ロールコレクションの割り当て
4. 設定済みのコンテンツリポジトリへの宛先

開発スペースのセットアップ

1. Open SAP Business Application Studio
2. Create new dev space
3. Select "Development Tools for SAP Build Work Zone, Advanced Edition" extension
4. Start the dev space

UI Integration Card の開発

UI カードの作成

1. SAP Business Application Studio を開きます
2. 「New Project From Template」を選択します
3. 「UI Integration Card」を選択します
4. 次の項目を設定します：
   • Project Name：識別子
   • Card Sample：テンプレートの選択
   • NameSpace：カード ID に使用されます（namespace.projectname）
   • Card Title/Subtitle：表示テキスト
   • Mobile Compatibility：モバイル対応を有効にします

カードの種類

• リストカード
• オブジェクトカード
• テーブルカード
• タイムラインカード
• 分析カード
• カレンダーカード
• コンポーネントカード

カード開発の詳細については、references/ui-integration-cards.md を参照してください。

コンテンツパッケージ

サポートされるアーティファクト

• UI Integration Cards
• ワークフロー
• ワークスペーステンプレート
• エクスポートしたワークスペース設定
• ホームページ設定

パッケージの種類

• 中央提供：すべての顧客が自動的に利用でき、カスタマイズできません
• ローカルパッケージ：管理者がアップロードしたカスタムパッケージ

開発フロー

Create in BAS → Build package → Deploy → Install in Admin Console

コンテンツパッケージの詳細なガイドについては、references/content-packages.md を参照してください。

ワークスペーステンプレート

テンプレートを使用すると、ユーザーは定義済みのレイアウトとウィジェットを備えたワークスペースを作成できます。

テンプレートの作成

1. ワークスペースの構造を設計します
2. ウィジェットのレイアウトを定義します
3. デフォルト設定を構成します
4. パッケージ化してデプロイします

テンプレートの開発については、references/workspace-templates.md を参照してください。

チャットボットの統合

重要なお知らせ

SAP Conversational AI は 2023 年 1 月以降、メンテナンスモードです。既存のチャットボットは引き続き動作する可能性がありますが、SAP は新規実装を推奨していません。チャットボット機能には、代替ソリューションの利用をご検討ください。

選択肢

1. カスタムチャットボット：SAP Conversational AI（https://cai.tools.sap/）を使用して構築します - ⚠️ メンテナンスモード
2. 構築済みチャットボット：SAP Build Work Zone チャットボットをフォークして設定します - ⚠️ 新規プロジェクトには推奨されません

設定手順（既存の実装向け）

1. SAP Conversational AI でチャットボットをフォークします
2. SAP Jam Collaboration コネクタを使用して接続します
3. Admin Console で OAuth クライアントを登録します
4. ボットの投稿用にエイリアスアカウントを設定します
5. プッシュ通知と Webhook を設定します

チャットボットの設定については、references/chatbots.md を参照してください。

API リファレンス

SCIM API

エンドポイント：/api/v1/scim

認証：「Workzone API Client」を使用した 2-legged OAuth

レート制限：

制限の種類	値
1 時間あたりの制限	テナントあたり 10,000 リクエスト
バースト制限	1 分あたり 200 リクエスト

ヘッダー：

• X-RateLimit-Limit：1 時間あたりの最大リクエスト数
• X-RateLimit-Remaining：利用可能なリクエスト数
• X-RateLimit-Reset：リセットまでの秒数

Content-Type：application/json（POST/PUT に必須）

OData API

SAP Build Work Zone は、v4 拡張機能を備えた OData v2 を使用します。

形式：XML（AtomPub）または JSON

API リファレンスの詳細については、references/api-reference.md を参照してください。

管理コンソール

アクセス方法：ユーザーアクションメニュー → 管理

主なセクション

• ユーザー：内部ユーザー／外部ユーザー、ユーザーリストを管理します
• 認証：SAML IdP、OAuth クライアント、SSO
• テーマ設定：テーマの割り当て、メールテンプレートのカスタマイズ
• エリアとワークスペース：ホームページ、ワークスペース設定
• 統合：Microsoft Teams、モバイルアプリ、チャットボット
• 機能：サイト機能の有効化／無効化
• コンプライアンス：コンテンツ管理、監視
• 分析：使用状況レポート、導入指標

機能管理

コンプライアンス機能

• コンプライアンスモニター：コンプライアンス辞書の用語を含むコンテンツにフラグを付けます
• 不適切な表現のモニター：不適切な表現の違反がある項目にマークを付けます
• スキャン不可フィルター：スキャンできないファイルにフラグを付けます

コンテンツ機能

• ファイル共有、フィード共有
• コンテンツ評価
• Wiki、ブログ、ナレッジベース
• 動画／音声のアップロード
• PDF の表示

統合機能

• API アクセス
• Microsoft Teams との統合
• Office 365 SharePoint との統合
• Google Drive との統合

外部連携

連携先	目的
Microsoft Teams	コラボレーション、通知
Office 365 SharePoint	ドキュメント共有、サイト
Google Drive	クラウドストレージ
SAP SuccessFactors	人事連携
SAP Cloud for Customer	CRM 連携
SAP Task Center	タスク管理の一元化
SAP Build Process Automation	ワークフローの自動化

セキュリティ

認証

• SAML アイデンティティプロバイダー
• OAuth 2.0 クライアント
• シングルサインオン（SSO）
• 信頼できる認証局

主な考慮事項

• ロールベースのアクセス制御
• HTTP セキュリティヘッダー（クリックジャッキング、XSS 対策）
• コンテンツプロバイダーのセキュリティガイドライン
• セキュリティイベントの監査ログ

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

Webhook

プラットフォームのイベントを追跡し、サードパーティアプリケーションに通知を送信します。

設定

1. 監視するイベントを定義します
2. コールバック URL を設定します
3. 認証トークンを設定します
4. プッシュ通知を処理します

テーマとブランディング

オプション

• サイトにテーマを割り当てます
• メールテンプレートをカスタマイズします
• ローカルテーマ（一部の UI のみ対応）
• カスタムブランディング用の Theme Manager

レポートと分析

利用可能なレポート

• アクティビティサマリー（週／月）
• ユーザーの貢献
• ワークスペースのアクティビティ
• コンテンツの閲覧数
• コンプライアンスレポート
• Kudo の詳細
• 検索サマリー
• 専門知識レポート

サードパーティ分析

外部の分析プラットフォームとの連携に対応しています。

トラブルシューティング

よくある問題

問題	解決策
HTTP 503	サービスのメンテナンス中です。後でもう一度お試しください
レート制限超過	X-RateLimit ヘッダーを確認し、リセットされるまで待ちます
OAuth 認証の失敗	Workzone API Client の認証情報を確認します
カードが表示されない	SAPUI5 のバージョンとの互換性を確認します

トラブルシューティングガイドについては、references/troubleshooting.md を参照してください。

バンドルされているリソース

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

• references/ui-integration-cards.md（331 行）- UI Integration Cards の開発ガイド全般
• references/content-packages.md（266 行）- コンテンツパッケージの作成とデプロイ
• references/workspace-templates.md（159 行）- ワークスペーステンプレートの開発
• references/chatbots.md（297 行）- チャットボットの設定（メンテナンスモードに関する通知を含む）
• references/api-reference.md（306 行）- SCIM および OData API のドキュメント
• references/security.md（128 行）- セキュリティ設定のベストプラクティス
• references/administration.md（299 行）- 管理コンソールガイド
• references/auditing.md（176 行）- 監査およびコンプライアンス機能
• references/mobile-app.md（124 行）- モバイルアプリの設定
• references/notifications.md（147 行）- 通知システムの設定
• references/troubleshooting.md（124 行）- よくあるエラーの解決
• references/widgets.md（213 行）- ウィジェット開発ガイド
• references/workspaces.md（295 行）- ワークスペースの管理

テンプレート

• templates/card-manifest.json - UI Integration Card のマニフェストテンプレート
• templates/content-package-manifest.json - コンテンツパッケージのマニフェストテンプレート
• templates/dt-configuration.js - デプロイ設定テンプレート
• templates/workspace-template-config.json - ワークスペーステンプレートの設定

ドキュメントへのリンク

• SAP Help Portal：https://help.sap.com/docs/build-work-zone-advanced-edition
• GitHub Docs：https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
• SAP API Hub：https://api.sap.com/（「SAP Cloud Portal Service」で検索）
• OData API Docs：https://jam2.sapjam.com
• SAPUI5 Card Explorer：https://ui5.sap.com/test-resources/sap/ui/integration/demokit/cardExplorer/

---

最終更新日：2025-11-27
ドキュメントのバージョン：2025年11月時点のSAPドキュメントに基づく