| name | sap-btp-build-work-zone-advanced |
| description | Develops and administers SAP Build Work Zone, advanced edition digital workplace solutions. Use when creating workspaces, workpages, and collaborative sites, developing UI Integration Cards in SAP Business Application Studio, building content packages and workspace templates, integrating with Microsoft 365/Teams/SharePoint/Google Drive, configuring chatbots and webhooks, implementing SCIM API user provisioning, setting up OData business records, managing themes and branding, configuring role-based access and SSO, troubleshooting deployment issues, or working with the Administration Console.
Keywords: SAP Build Work Zone advanced edition, digital workplace, UI Integration Cards, content packages, workspace templates, SAP Business Application Studio, SAP Conversational AI, SCIM API, OData, Microsoft Teams integration, SSO, theming, Administration Console
|
| license | GPL-3.0 |
| metadata | {"version":"1.1.0","last_verified":"2025-11-27"} |
SAP Build Work Zone, Advanced Edition
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.
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
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
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
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).
Content Packages
Collections of artifacts (cards, workflows, workspace templates) bundled in ZIP files for distribution.
Workspace Templates
Pre-built frameworks enabling workspace creation with minimum modification.
Development Environment Setup
Prerequisites
- SAP BTP subscription to SAP Build Work Zone, advanced edition
- SAP Business Application Studio subscription
- Workzone_Admin role collection assignment
- Destination to content repository configured
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
UI Integration Cards Development
Creating a UI Card
- Open SAP Business Application Studio
- Select "New Project From Template"
- Choose "UI Integration Card"
- 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
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.
Content Packages
Supported Artifacts
- UI Integration Cards
- Workflows
- Workspace templates
- Exported workspace configurations
- Homepage configurations
Package Types
- Centrally-provided: Auto-available to all customers, non-customizable
- Local packages: Custom packages uploaded by administrators
Development Flow
Create in BAS → Build package → Deploy → Install in Admin Console
For complete content package guide, see references/content-packages.md.
Workspace Templates
Templates enable users to create workspaces with predefined layouts and widgets.
Creating Templates
- Design workspace structure
- Define widget layouts
- Configure default settings
- Package and deploy
For template development, see 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.
Options
- Custom chatbots: Build using SAP Conversational AI (https://cai.tools.sap/) - ⚠️ Maintenance Mode
- Pre-built chatbot: Fork and configure the SAP Build Work Zone chatbot - ⚠️ Not recommended for new projects
Configuration Steps (for existing implementations)
- Fork chatbot in SAP Conversational AI
- Connect using SAP Jam Collaboration connector
- Register OAuth client in Admin Console
- Configure alias account for bot posting
- Set up push notifications and webhooks
For chatbot configuration, see references/chatbots.md.
API Reference
SCIM API
Endpoint: /api/v1/scim
Authentication: 2-legged OAuth using "Workzone API Client"
Rate Limits:
| Limit Type | Value |
|---|
| Hourly limit | 10,000 requests/tenant |
| Burst limit | 200 requests/minute |
Headers:
X-RateLimit-Limit: Maximum hourly requestsX-RateLimit-Remaining: Available requestsX-RateLimit-Reset: Seconds until reset
Content-Type: application/json (required for POST/PUT)
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.
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
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
Content Features
- File sharing, feed sharing
- Content rating
- Wikis, blogs, knowledge bases
- Video/audio uploads
- PDF viewing
Integration Features
- API access
- Microsoft Teams integration
- Office 365 SharePoint integration
- Google Drive integration
External Integrations
| Integration | Purpose |
|---|
| Microsoft Teams | Collaboration, notifications |
| Office 365 SharePoint | Document sharing, sites |
| Google Drive | Cloud storage |
| SAP SuccessFactors | HR integration |
| SAP Cloud for Customer | CRM integration |
| SAP Task Center | Unified task management |
| SAP Build Process Automation | Workflow automation |
Security
Authentication
- SAML Identity Providers
- OAuth 2.0 clients
- Single Sign-On (SSO)
- Trusted Certificate Authorities
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.
Webhooks
Track platform events and send notifications to third-party applications.
Configuration
- Define events to monitor
- Configure callback URLs
- Set up authentication tokens
- Handle push notifications
Theming and Branding
Options
- Assign themes to site
- Customize email templates
- Local themes (partial UI coverage)
- Theme Manager for custom branding
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
| Issue | Solution |
|---|
| HTTP 503 | Service maintenance, retry later |
| Rate limit exceeded | Check X-RateLimit headers, wait for reset |
| OAuth authentication failure | Verify Workzone API Client credentials |
| Card not displaying | Check SAPUI5 version compatibility |
For troubleshooting guide, see references/troubleshooting.md.
Bundled Resources
Reference Documentation
references/ui-integration-cards.md (331 lines) - Complete UI Integration Cards development guidereferences/content-packages.md (266 lines) - Content package creation and deploymentreferences/workspace-templates.md (159 lines) - Workspace template developmentreferences/chatbots.md (297 lines) - Chatbot configuration (maintenance mode notice included)references/api-reference.md (306 lines) - SCIM and OData API documentationreferences/security.md (128 lines) - Security configuration best practicesreferences/administration.md (299 lines) - Administration Console guidereferences/auditing.md (176 lines) - Audit and compliance featuresreferences/mobile-app.md (124 lines) - Mobile app configurationreferences/notifications.md (147 lines) - Notification system setupreferences/troubleshooting.md (124 lines) - Common error resolutionreferences/widgets.md (213 lines) - Widget development guidereferences/workspaces.md (295 lines) - Workspace management
Templates
templates/card-manifest.json - UI Integration Card manifest templatetemplates/content-package-manifest.json - Content package manifest templatetemplates/dt-configuration.js - Deployment configuration templatetemplates/workspace-template-config.json - Workspace template configuration
Documentation Links
Last Updated: 2025-11-27
Documentation Version: Based on SAP documentation as of November 2025
