Back to Details

sap-btp-build-work-zone-advanced

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SAP Build Work Zone, Advanced Edition

SAP Build Work Zone（高级版）

This skill provides comprehensive guidance for implementing SAP Build Work Zone, advanced edition - a digital workplace platform for unified access to business applications, processes, and collaboration.
本技能为实施SAP Build Work Zone（高级版）提供全面指导——这是一款用于统一访问业务应用、流程和协作功能的数字工作区平台。

When to Use This Skill

何时使用此技能

Use this skill when:
  • Creating workspaces, workpages, and collaborative sites
  • Developing UI Integration Cards in SAP Business Application Studio
  • Building and deploying content packages
  • Creating workspace templates
  • Integrating with Microsoft 365, Teams, SharePoint, or Google Drive
  • Configuring chatbots using SAP Conversational AI
  • Implementing webhooks for event notifications
  • Setting up SCIM API for user provisioning
  • Configuring OData-based business records
  • Managing themes and branding
  • Configuring role-based access and SSO
  • Working with the Administration Console
在以下场景中使用本技能：
  • 创建工作区、工作页面和协作站点
  • 在SAP Business Application Studio中开发UI Integration Cards
  • 构建并部署内容包
  • 创建工作区模板
  • 集成Microsoft 365、Teams、SharePoint或Google Drive
  • 使用SAP Conversational AI配置聊天机器人
  • 实现用于事件通知的webhooks
  • 设置SCIM API进行用户配置
  • 配置基于OData的业务记录
  • 管理主题与品牌
  • 配置基于角色的访问权限和SSO
  • 使用Administration Console

Table of Contents

目录

Platform Overview

平台概述

SAP Build Work Zone, advanced edition is a digital workplace platform that:
  • Provides unified access to SAP and third-party business applications
  • Enables collaborative workspaces with feeds, blogs, wikis, and forums
  • Supports role-based navigation with Single Sign-On (SSO)
  • Works across web browsers, mobile apps, and responsive web UI
  • Integrates with cloud, hybrid, and on-premise applications
SAP Build Work Zone（高级版）是一款数字工作区平台，具备以下能力：
  • 提供对SAP及第三方业务应用的统一访问
  • 支持包含动态信息流、博客、维基和论坛的协作工作区
  • 支持带Single Sign-On（SSO）的基于角色的导航
  • 可在网页浏览器、移动应用和响应式Web UI中使用
  • 支持与云、混合和本地部署的应用集成

Core Concepts

核心概念

Workspaces

工作区

Separate sections with dedicated pages and feeds for team communication and collaboration within specific user groups.
为特定用户组内的团队沟通和协作提供的独立区域，包含专属页面和信息流。

Workpages

工作页面

Customizable pages that can be configured with widgets, cards, and applications.
可自定义的页面，可配置小部件、卡片和应用。

UI Integration Cards

UI Integration Cards

Design patterns displaying concise information in limited-space containers. Follow SAPUI5 card specifications (minimum version 1.87.0; newer versions supported and recommended for latest features).
在有限空间容器中展示简洁信息的设计模式。遵循SAPUI5卡片规范（最低版本1.87.0；推荐使用更新版本以获取最新功能）。

Content Packages

内容包

Collections of artifacts (cards, workflows, workspace templates) bundled in ZIP files for distribution.
将工件（卡片、工作流、工作区模板）打包为ZIP文件以便分发的集合。

Workspace Templates

工作区模板

Pre-built frameworks enabling workspace creation with minimum modification.
预构建的框架，可通过最少修改创建工作区。

Development Environment Setup

开发环境搭建

Prerequisites

前提条件

  1. SAP BTP subscription to SAP Build Work Zone, advanced edition
  2. SAP Business Application Studio subscription
  3. Workzone_Admin role collection assignment
  4. Destination to content repository configured
  1. 订阅SAP BTP上的SAP Build Work Zone（高级版）
  2. 订阅SAP Business Application Studio
  3. 分配Workzone_Admin角色集合
  4. 配置到内容仓库的目标地址

Dev Space Setup

开发空间设置

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
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 Cards Development

UI Integration Cards开发

Creating a UI Card

创建UI卡片

  1. Open SAP Business Application Studio
  2. Select "New Project From Template"
  3. Choose "UI Integration Card"
  4. Configure:
    • Project Name: Your identifier
    • Card Sample: Template selection
    • NameSpace: Used for Card ID (namespace.projectname)
    • Card Title/Subtitle: Display text
    • Mobile Compatibility: Enable for mobile support
  1. 打开SAP Business Application Studio
  2. 选择“从模板创建新项目”
  3. 选择“UI Integration Card”
  4. 配置：
    • Project Name: 您的标识符
    • Card Sample: 模板选择
    • NameSpace: 用于Card ID（namespace.projectname）
    • Card Title/Subtitle: 显示文本
    • Mobile Compatibility: 启用以支持移动设备

Card Types

卡片类型

  • List Cards
  • Object Cards
  • Table Cards
  • Timeline Cards
  • Analytical Cards
  • Calendar Cards
  • Component Cards
For complete card development, see 
references/ui-integration-cards.md
.
  • 列表卡片
  • 对象卡片
  • 表格卡片
  • 时间线卡片
  • 分析卡片
  • 日历卡片
  • 组件卡片
如需完整的卡片开发指南，请查看
references/ui-integration-cards.md
。

Content Packages

内容包

Supported Artifacts

支持的工件

  • UI Integration Cards
  • Workflows
  • Workspace templates
  • Exported workspace configurations
  • Homepage configurations
  • UI Integration Cards
  • 工作流
  • 工作区模板
  • 导出的工作区配置
  • 首页配置

Package Types

包类型

  • Centrally-provided: Auto-available to all customers, non-customizable
  • Local packages: Custom packages uploaded by administrators
  • Centrally-provided: 自动对所有客户可用，不可自定义
  • Local packages: 由管理员上传的自定义包

Development Flow

开发流程

Create in BAS → Build package → Deploy → Install in Admin Console
For complete content package guide, see 
references/content-packages.md
.
Create in BAS → Build package → Deploy → Install in Admin Console
如需完整的内容包指南，请查看
references/content-packages.md
。

Workspace Templates

工作区模板

Templates enable users to create workspaces with predefined layouts and widgets.
模板允许用户通过预定义布局和小部件创建工作区。

Creating Templates

创建模板

  1. Design workspace structure
  2. Define widget layouts
  3. Configure default settings
  4. Package and deploy
For template development, see 
references/workspace-templates.md
.
  1. 设计工作区结构
  2. 定义小部件布局
  3. 配置默认设置
  4. 打包并部署
如需模板开发指南，请查看
references/workspace-templates.md
。

Chatbot Integration

聊天机器人集成

Important Notice

重要通知

SAP Conversational AI is in maintenance mode since January 2023. While existing chatbots may continue to function, SAP does not recommend creating new implementations. Consider alternative solutions for chatbot functionality.
SAP Conversational AI自2023年1月起进入维护模式。现有聊天机器人可能仍可正常运行，但SAP不建议创建新的实现。请考虑替代方案来实现聊天机器人功能。

Options

选项

  1. Custom chatbots: Build using SAP Conversational AI (https://cai.tools.sap/) - ⚠️ Maintenance Mode
  2. Pre-built chatbot: Fork and configure the SAP Build Work Zone chatbot - ⚠️ Not recommended for new projects
  1. 自定义聊天机器人: 使用SAP Conversational AI构建（https://cai.tools.sap/）- ⚠️ 维护模式
  2. 预构建聊天机器人: 复刻并配置SAP Build Work Zone聊天机器人 - ⚠️ 不推荐用于新项目

Configuration Steps (for existing implementations)

配置步骤（针对现有实现）

  1. Fork chatbot in SAP Conversational AI
  2. Connect using SAP Jam Collaboration connector
  3. Register OAuth client in Admin Console
  4. Configure alias account for bot posting
  5. Set up push notifications and webhooks
For chatbot configuration, see 
references/chatbots.md
.
  1. 在SAP Conversational AI中复刻聊天机器人
  2. 使用SAP Jam Collaboration连接器连接
  3. 在Admin Console中注册OAuth客户端
  4. 配置机器人发布的别名账户
  5. 设置推送通知和webhooks
如需聊天机器人配置指南，请查看
references/chatbots.md
。

API Reference

API参考

SCIM API

SCIM API

Endpoint: 
/api/v1/scim
Authentication: 2-legged OAuth using "Workzone API Client"
Rate Limits:
Limit TypeValue
Hourly limit10,000 requests/tenant
Burst limit200 requests/minute
Headers:
  • X-RateLimit-Limit
    : Maximum hourly requests
  • X-RateLimit-Remaining
    : Available requests
  • X-RateLimit-Reset
    : Seconds until reset
Content-Type: 
application/json
(required for POST/PUT)
Endpoint: 
/api/v1/scim
Authentication: 使用"Workzone API Client"的双腿OAuth
Rate Limits:
限制类型数值
每小时限制10,000请求/租户
突发限制200请求/分钟
Headers:
  • X-RateLimit-Limit
    : 每小时最大请求数
  • X-RateLimit-Remaining
    : 可用请求数
  • X-RateLimit-Reset
    : 重置剩余秒数
Content-Type: 
application/json
（POST/PUT请求必填）

OData API

OData API

SAP Build Work Zone uses OData v2 with v4 extensions.
Format: XML (AtomPub) or JSON
For complete API reference, see 
references/api-reference.md
.
SAP Build Work Zone使用带有v4扩展的OData v2。
Format: XML（AtomPub）或JSON
如需完整的API参考，请查看
references/api-reference.md
。

Administration Console

Administration Console

Access via: User Actions menu → Administration
访问方式：用户操作菜单 → 管理

Key Sections

关键板块

  • Users: Manage internal/external users, user lists
  • Authentication: SAML IdP, OAuth clients, SSO
  • Theming: Assign themes, customize email templates
  • Areas & Workspaces: Home pages, workspace settings
  • Integrations: Microsoft Teams, mobile apps, chatbots
  • Features: Enable/disable site features
  • Compliance: Content administration, monitoring
  • Analytics: Usage reports, adoption metrics
  • Users: 管理内部/外部用户、用户列表
  • Authentication: SAML身份提供商、OAuth客户端、SSO
  • Theming: 分配主题、自定义邮件模板
  • Areas & Workspaces: 首页、工作区设置
  • Integrations: Microsoft Teams、移动应用、聊天机器人
  • Features: 启用/禁用站点功能
  • Compliance: 内容管理、监控
  • Analytics: 使用报告、采用指标

Feature Management

功能管理

Compliance Features

合规功能

  • Compliance Monitor: Flags content with compliance dictionary terms
  • Profanity Monitor: Marks items with profanity violations
  • Unscannable Filter: Flags non-scannable files
  • Compliance Monitor: 标记包含合规词典术语的内容
  • Profanity Monitor: 标记存在脏话违规的内容
  • Unscannable Filter: 标记无法扫描的文件

Content Features

内容功能

  • File sharing, feed sharing
  • Content rating
  • Wikis, blogs, knowledge bases
  • Video/audio uploads
  • PDF viewing
  • 文件共享、信息流共享
  • 内容评分
  • 维基、博客、知识库
  • 视频/音频上传
  • PDF查看

Integration Features

集成功能

  • API access
  • Microsoft Teams integration
  • Office 365 SharePoint integration
  • Google Drive integration
  • API访问
  • Microsoft Teams集成
  • Office 365 SharePoint集成
  • Google Drive集成

External Integrations

外部集成

IntegrationPurpose
Microsoft TeamsCollaboration, notifications
Office 365 SharePointDocument sharing, sites
Google DriveCloud storage
SAP SuccessFactorsHR integration
SAP Cloud for CustomerCRM integration
SAP Task CenterUnified task management
SAP Build Process AutomationWorkflow automation
集成项用途
Microsoft Teams协作、通知
Office 365 SharePoint文档共享、站点
Google Drive云存储
SAP SuccessFactorsHR集成
SAP Cloud for CustomerCRM集成
SAP Task Center统一任务管理
SAP Build Process Automation工作流自动化

Security

安全

Authentication

认证

  • SAML Identity Providers
  • OAuth 2.0 clients
  • Single Sign-On (SSO)
  • Trusted Certificate Authorities
  • SAML身份提供商
  • OAuth 2.0客户端
  • Single Sign-On（SSO）
  • 可信证书颁发机构

Key Considerations

关键注意事项

  • Role-based access control
  • HTTP security headers (clickjacking, XSS protection)
  • Content provider security guidelines
  • Audit logging for security events
For security configuration, see 
references/security.md
.
  • 基于角色的访问控制
  • HTTP安全头（点击劫持防护、XSS防护）
  • 内容提供商安全指南
  • 安全事件审计日志
如需安全配置指南，请查看
references/security.md
。

Webhooks

Webhooks

Track platform events and send notifications to third-party applications.
跟踪平台事件并向第三方应用发送通知。

Configuration

配置

  1. Define events to monitor
  2. Configure callback URLs
  3. Set up authentication tokens
  4. Handle push notifications
  1. 定义要监控的事件
  2. 配置回调URL
  3. 设置认证令牌
  4. 处理推送通知

Theming and Branding

主题与品牌定制

Options

选项

  • Assign themes to site
  • Customize email templates
  • Local themes (partial UI coverage)
  • Theme Manager for custom branding
  • 为站点分配主题
  • 自定义邮件模板
  • 本地主题（部分UI覆盖）
  • 使用主题管理器进行自定义品牌定制

Reports and Analytics

报告与分析

Available Reports

可用报告

  • Activity Summary (week/month)
  • User Contribution
  • Workspace Activity
  • Content Views
  • Compliance Report
  • Kudo Details
  • Search Summary
  • Expertise Report
  • 活动摘要（周/月）
  • 用户贡献
  • 工作区活动
  • 内容浏览量
  • 合规报告
  • 点赞详情
  • 搜索摘要
  • 专业技能报告

Third-Party Analytics

第三方分析

Integration with external analytics platforms supported.
支持与外部分析平台集成。

Troubleshooting

故障排查

Common Issues

常见问题

IssueSolution
HTTP 503Service maintenance, retry later
Rate limit exceededCheck X-RateLimit headers, wait for reset
OAuth authentication failureVerify Workzone API Client credentials
Card not displayingCheck SAPUI5 version compatibility
For troubleshooting guide, see 
references/troubleshooting.md
.
问题解决方案
HTTP 503服务维护中，稍后重试
超出速率限制查看X-RateLimit请求头，等待重置
OAuth认证失败验证Workzone API Client凭证
卡片未显示检查SAPUI5版本兼容性
如需故障排查指南，请查看
references/troubleshooting.md
。

Bundled Resources

捆绑资源

Reference Documentation

参考文档

  • references/ui-integration-cards.md
    (331 lines) - Complete UI Integration Cards development guide
  • references/content-packages.md
    (266 lines) - Content package creation and deployment
  • references/workspace-templates.md
    (159 lines) - Workspace template development
  • references/chatbots.md
    (297 lines) - Chatbot configuration (maintenance mode notice included)
  • references/api-reference.md
    (306 lines) - SCIM and OData API documentation
  • references/security.md
    (128 lines) - Security configuration best practices
  • references/administration.md
    (299 lines) - Administration Console guide
  • references/auditing.md
    (176 lines) - Audit and compliance features
  • references/mobile-app.md
    (124 lines) - Mobile app configuration
  • references/notifications.md
    (147 lines) - Notification system setup
  • references/troubleshooting.md
    (124 lines) - Common error resolution
  • references/widgets.md
    (213 lines) - Widget development guide
  • references/workspaces.md
    (295 lines) - Workspace management
  • 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

模板

  • templates/card-manifest.json
    - UI Integration Card manifest template
  • templates/content-package-manifest.json
    - Content package manifest template
  • templates/dt-configuration.js
    - Deployment configuration template
  • templates/workspace-template-config.json
    - Workspace template configuration
  • templates/card-manifest.json
    - UI Integration Card清单模板
  • templates/content-package-manifest.json
    - 内容包清单模板
  • templates/dt-configuration.js
    - 部署配置模板
  • templates/workspace-template-config.json
    - 工作区模板配置

Documentation Links

文档链接

Last Updated: 2025-11-27 Documentation Version: Based on SAP documentation as of November 2025
最后更新：2025-11-27 文档版本：基于2025年11月的SAP文档