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. 创建或确认 SAP Business Application Studio 开发空间支持 UI Integration Card。
4. 为内容、卡片、OData 业务记录或外部系统配置目标。
5. 使用 templates/ 中的内容包和卡片模板进行实施。

目录

• 平台概览
• 核心概念
• 开发环境设置
• UI Integration Card 开发
• 内容包
• 工作区模板
• 聊天机器人集成
• API 参考
• Administration Console
• 功能管理
• 外部集成
• 安全性
• Webhook
• 主题和品牌标识
• 报告和分析
• 故障排除
• 捆绑资源
• 文档链接

平台概览

SAP Build Work Zone，advanced edition 是一款数字化工作场所平台，可：

• 提供统一入口，访问 SAP 和第三方业务应用
• 支持带有动态消息、博客、维基和论坛的协作工作区
• 支持采用单点登录（SSO）的基于角色的导航
• 适用于 Web 浏览器、移动应用和响应式 Web UI
• 与云端、混合云和本地应用集成

核心概念

工作区

包含专属页面和动态消息的独立分区，供特定用户组进行团队沟通与协作。

工作页面

可自定义的页面，可配置小组件、卡片和应用。

UI Integration Card

一种设计模式，用于在有限空间的容器中显示简明信息。请遵循 SAPUI5 卡片规范（最低版本为 1.87.0；支持较新版本，并建议使用较新版本以获取最新功能）。

内容包

打包在 ZIP 文件中用于分发的工件集合（卡片、工作流、工作区模板）。

工作区模板

可直接使用的框架，能够以最少的修改创建工作区。

开发环境设置

前提条件

1. 订阅 SAP BTP 上的 SAP Build Work Zone，advanced edition
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 集成卡片
• 工作流
• 工作区模板
• 导出的工作区配置
• 主页配置

包类型

• 集中提供：自动向所有客户提供，无法自定义
• 本地包：由管理员上传的自定义包

开发流程

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. 在管理控制台中注册 OAuth 客户端
4. 为机器人发帖配置别名账户
5. 设置推送通知和 Webhook

聊天机器人配置指南请参阅 references/chatbots.md。

API 参考

SCIM API

端点：/api/v1/scim

身份验证：使用“Workzone API Client”进行双腿 OAuth 身份验证

速率限制：

限制类型	值
每小时限制	10,000 个请求/租户
突发限制	200 个请求/分钟

标头：

• X-RateLimit-Limit：每小时最大请求数
• 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	HR 集成
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 行）- Administration Console 指南
• 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 文档：https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
• SAP API Hub：https://api.sap.com/（搜索 “SAP Cloud Portal Service”）
• OData API 文档：https://jam2.sapjam.com
• SAPUI5 卡片浏览器：https://ui5.sap.com/test-resources/sap/ui/integration/demokit/cardExplorer/

---

最后更新：2025-11-27 文档版本：基于截至 2025 年 11 月的 SAP 文档