
Sap Btp Build Work Zone Advanced
- 356 installs
- 399 repo stars
- Updated August 4, 2026
- secondsky/sap-skills
Configure and extend SAP Build Work Zone portals, workspaces, theming, and content channels for enterprise digital workplaces on SAP BTP.
About
Guides advanced SAP Build Work Zone implementation on SAP BTP: designing digital workplaces, configuring workspaces and channels, customizing portal shell and themes, wiring launchpad destinations, and governing multi-tenant enterprise access for SaaS-style employee hubs.
- SAP Build Work Zone portal architecture
- Workspace and content channel configuration
- Theming, branding, and shell extension patterns
- Launchpad integration with SAP and third-party apps
- Enterprise digital workplace governance on BTP
Sap Btp Build Work Zone Advanced by the numbers
- 356 all-time installs (skills.sh)
- +33 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #696 of 2,245 Frontend Development skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/secondsky/sap-skills --skill sap-btp-build-work-zone-advancedAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 356 |
|---|---|
| repo stars | ★ 399 |
| Last updated | August 4, 2026 |
| Repository | secondsky/sap-skills ↗ |
What it does
Configure and extend SAP Build Work Zone portals, workspaces, theming, and content channels for enterprise digital workplaces on SAP BTP.
Files
SAP Build Work Zone, Advanced Edition
Related Skills
- sap-btp-business-application-studio: Use for dev space setup and UI Integration Card development workflows
- sap-btp-cloud-platform: Use for BTP subscriptions, destinations, role collections, and runtime setup
- sapui5: Use for UI5 card/component development details
- sap-btp-connectivity: Use for destinations, Cloud Connector, and OData business-record connectivity
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
Quick Start
1. Confirm the subaccount has SAP Build Work Zone, advanced edition entitlement and subscription. 2. Assign the required administrator role collections. 3. Create or verify SAP Business Application Studio dev space support for UI Integration Cards. 4. Configure destinations for content, cards, OData business records, or external systems. 5. Use the content package and card templates in templates/ for implementation.
Table of Contents
- Platform Overview
- Core Concepts
- Development Environment Setup
- UI Integration Cards Development
- Content Packages
- Workspace Templates
- Chatbot Integration
- API Reference
- Administration Console
- Feature Management
- External Integrations
- Security
- Webhooks
- Theming and Branding
- Reports and Analytics
- Troubleshooting
- Bundled Resources
- Documentation Links
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
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
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 spaceUI Integration Cards Development
Creating a UI Card
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
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 ConsoleFor complete content package guide, see 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.
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
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
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.
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
1. Define events to monitor 2. Configure callback URLs 3. Set up authentication tokens 4. 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
- 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/ (search "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/
---
Last Updated: 2025-11-27 Documentation Version: Based on SAP documentation as of November 2025
BTP Build Work Zone Advanced Skill
Claude Code skill for SAP Build Work Zone, advanced edition digital workplace development.
Capability Index
| Capability | Status |
|---|---|
| Commands | 1: /work-zone-content-check |
| Agents | 0 |
| Hooks | No |
| MCP | No |
| LSP | No |
| Source Freshness | last_verified: 2025-11-27; Work Zone template/source freshness pending docs-only recheck. |
| Verification | npm run validate; tenant content import/export checks pending. |
Overview
This skill provides comprehensive guidance for implementing SAP Build Work Zone, advanced edition - a digital workplace platform for unified access to business applications, collaboration, and content management.
Keywords for Discovery
Primary Keywords
- SAP Build Work Zone advanced edition
- digital workplace
- SAP Work Zone
- SAP Jam
- enterprise portal
- intranet platform
Core Components
- workspaces
- workpages
- UI Integration Cards
- content packages
- workspace templates
- widgets
- feeds
- wikis
- blogs
- forums
- knowledge base
Development
- SAP Business Application Studio
- UI Card development
- SAPUI5 cards
- card types
- content package development
- workspace template development
- chatbot development
- SAP Conversational AI
Administration
- Administration Console
- user management
- role assignment
- theming
- branding
- email templates
- feature enablement
- compliance monitor
- profanity monitor
APIs
- SCIM API
- OData API
- REST API
- Workzone API Client
- webhooks
- business records
- 2-legged OAuth
Integrations
- Microsoft Teams
- Microsoft 365
- Office 365 SharePoint
- Google Drive
- SAP SuccessFactors
- SAP Cloud for Customer
- SAP Task Center
- SAP Build Process Automation
Authentication
- SAML IdP
- OAuth clients
- Single Sign-On
- SSO
- trusted certificate authority
User Management
- internal users
- external users
- user lists
- static user lists
- dynamic user lists
- imported user lists
- SCIM provisioning
Content
- content permissions
- content templates
- content administration
- file sharing
- multimedia
- video upload
- audio upload
Reports
- activity summary
- user contribution
- workspace activity
- compliance report
- engagement report
- analytics
Troubleshooting
- rate limiting
- X-RateLimit headers
- HTTP 503
- OAuth authentication
- card deployment
Skill Contents
Main Files
SKILL.md- Primary skill instructions and quick referenceREADME.md- This file with keywords
Reference Files
references/ui-integration-cards.md- Card development guidereferences/content-packages.md- Content package developmentreferences/workspace-templates.md- Template creationreferences/chatbots.md- Chatbot configurationreferences/api-reference.md- SCIM and OData APIsreferences/security.md- Security configurationreferences/administration.md- Administration and lifecycle operationsreferences/auditing.md- Audit logging and monitoringreferences/mobile-app.md- Mobile app enablementreferences/notifications.md- Notification configurationreferences/workspaces.md- Workspace managementreferences/troubleshooting.md- Error resolution
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
Use Cases
This skill should be triggered when users ask about:
- Creating workspaces and workpages
- Developing UI Integration Cards
- Building content packages
- Creating workspace templates
- Configuring chatbots
- Setting up Microsoft Teams integration
- Implementing SCIM API user provisioning
- Configuring OData business records
- Managing themes and branding
- Setting up SSO and authentication
- Working with Administration Console
- Enabling site features
- Troubleshooting deployment issues
Version Information
- Created: 2025-11-22
- Documentation Source: SAP Help Portal (November 2025)
- GitHub Docs: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
- SAP Help Portal: https://help.sap.com/docs/build-work-zone-advanced-edition
License
GPL-3.0 License
Related Skills
- sap-btp-setup
- sapui5
- sap-fiori-elements
- sap-cloud-identity
Administration Console Guide
Complete guide for administering SAP Build Work Zone, advanced edition through the Administration Console.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
---
Overview
The Administration Console provides centralized management for all aspects of SAP Build Work Zone, advanced edition including users, content, security, and integrations.
---
Core Administrative Areas
Overview & Dashboard
Key information and metrics:
- License usage statistics
- Product version information
- Daily operational metrics
- Initial setup tasks
User Management
Internal Users
- Add and edit user profiles
- Generate activity reports
- Grant admin privileges
- Manage user settings
External Users
- Configure external user access
- Manage non-company users
- Set access restrictions
User Lists
- Create imported user lists
- Invite multiple users to workspaces
- Configure dynamic user lists
- Set list attributes
Alias Accounts
- Create organizational representative accounts
- Configure system users for integrations
- Manage chatbot accounts
SCIM Provisioning
- Manage company administrators via API
- Configure automated user provisioning
---
Authentication & Authorization
SAML Configuration
Trusted Identity Providers (IDPs)
1. Navigate to Authentication > SAML Trusted IDPs 2. Add IdP metadata 3. Configure attribute mapping 4. Test SSO connection
Local Identity Provider
Configure for internal authentication needs
Local Service Provider
Setup for third-party integration
Role Collections
| Role Collection | Purpose |
|---|---|
| Workzone_Admin | Full administration access |
| Workzone_User | Standard user access |
| Workzone_Area_Admin | Area administration |
| Workzone_External_User | External user access |
| Workzone_HR_Admin | HR integration administration |
Role Types
| Type | Description |
|---|---|
| Default Roles | Auto-assigned during onboarding (cannot be removed) |
| Local Roles | Manually created for app access |
| Remote Roles | From external content providers |
---
Theming & Branding
Theme Manager
- Assign existing themes
- Create custom themes
- Configure default theme
Local Theme Designer
- Site-specific styling
- Custom CSS configuration
- Brand color settings
Email Templates
- Customize notification appearance
- Configure email branding
- Set template content
---
Area & Workspace Configuration
Administrative Areas
- Create organizational groupings
- Configure area permissions
- Manage area content
Home Page
- Design landing page
- Configure widgets and feeds
- Set announcements
- Manage quick links
User Profiles
- Customize profile fields
- Configure profile visibility
- Set profile requirements
Content Templates
- Blog templates
- Wiki templates
- Custom content types
Workspace Templates
- Install prebuilt templates
- Create custom templates
- Manage template availability
---
UI Integration
Content Packages
Location: UI Integration > Content Packages
- View available packages
- Install/uninstall packages
- Manage package versions
- Configure package content
Cards
Enable UI Integration Cards for user pages:
- Configure card availability
- Manage card permissions
- Monitor card usage
Widget Builders
Create custom HTML widgets:
- Define widget structure
- Configure widget settings
- Deploy custom widgets
---
External Integrations
Microsoft Teams
- Configure Teams connection
- Set up SSO integration
- Manage channel mappings
Mobile Apps
- Configure mobile settings
- Manage app distribution
- Set mobile policies
External Solutions
- Configure third-party integrations
- Manage API connections
- Set integration permissions
OAuth Clients
- Register OAuth clients
- Configure client scopes
- Manage client secrets
Chatbot Configuration
- Enable chatbot launcher
- Configure bot connections
- Manage bot permissions
Webhook Notifications
- Configure event triggers
- Set notification endpoints
- Manage webhook security
Extensions Catalog
- Browse available extensions
- Install extensions
- Configure extension settings
---
Feature Management
Feature Enablement
Control platform features:
- Kudos customization
- Hashtags auto-completion
- Knowledge Base categories
- Forum settings
- Feed options
Feature Settings
- Enable/disable features
- Configure feature behavior
- Set feature permissions
---
Compliance & Security
Terms of Service
- Configure external ToS
- Set custom ToS content
- Manage ToS acceptance
Content Administration
- Review flagged content
- Manage content reports
- Configure moderation rules
Compliance Dictionary
- Define compliance terms
- Configure detection rules
- Manage violations
Profanity Monitor
- Enable profanity detection
- Configure word lists
- Manage flagged content
Security Settings
- Configure HTTP headers
- Set session policies
- Manage access controls
Audit Logging
- View audit reports
- Export audit data
- Configure log retention
---
Analytics
Usage Reports
- User activity metrics
- Content engagement stats
- Workspace analytics
- Adoption metrics
Report Types
| Report | Description |
|---|---|
| Activity Summary | Weekly/monthly activity |
| Company User Detail | User-level metrics |
| Compliance Report | Compliance status |
| Content Report | Content statistics |
Third-Party Analytics
- Configure analytics integration
- Set tracking parameters
- Export analytics data
---
Best Practices
Regular Maintenance
1. Review user access - Audit permissions quarterly 2. Monitor compliance - Check flagged content regularly 3. Update themes - Keep branding current 4. Review integrations - Verify external connections
Security Recommendations
1. Enable SSO - Use SAML authentication 2. Configure audit logging - Track administrative actions 3. Review OAuth clients - Audit API access 4. Set HTTP headers - Enable security headers
---
Documentation Links:
SAP Build Work Zone API Reference
Complete API reference for SCIM, OData, and Webhook APIs in SAP Build Work Zone, advanced edition.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
Table of Contents
- API Documentation Resources
- SCIM API
- Overview
- Rate Limits
- Response Headers
- Content Type
- User Filtering
- SCIM Operations
- User Lists
- Maintenance Windows
- OData API
- Overview
- Authentication
- Key Endpoints
- Query Options
- Business Records
- Webhooks
- Overview
- Webhook URL Format
- Configuration
- Event Types
- Payload Structure
- Chatbot API
- Available Template Variables
- Webhook Actions
- Create Workspace Example
- Render Card Example
- Authentication
- OAuth 2.0 Setup
- Token Request
- API Request
- Alias Accounts
---
API Documentation Resources
| Resource | URL |
|---|---|
| SAP API Hub | https://api.sap.com/ (SAP Cloud Portal Service) |
| OData API Docs | https://jam2.sapjam.com/work_zone/ODataDocs/ui |
| Webhook Reference | https://jam2.sapjam.com/work_zone/ODataDocs/webhook_reference |
---
SCIM API
Overview {#overview-scim}
SAP Build Work Zone implements SCIM 2.0 for user provisioning.
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 |
Response Headers
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum hourly requests |
X-RateLimit-Remaining | Available requests |
X-RateLimit-Reset | Seconds until reset |
Content Type
All POST/PUT requests require:
Content-Type: application/jsonUser Filtering
Supported filter: SCIM.userName eq <value>
SCIM Operations
| Operation | Endpoint | Method |
|---|---|---|
| List Users | /api/v1/scim/Users | GET |
| Get User | /api/v1/scim/Users/{id} | GET |
| Create User | /api/v1/scim/Users | POST |
| Update User | /api/v1/scim/Users/{id} | PUT |
| Delete User | /api/v1/scim/Users/{id} | DELETE |
User Lists
| Operation | Endpoint | Method |
|---|---|---|
| List User Lists | /api/v1/scim/Groups | GET |
| Get User List | /api/v1/scim/Groups/{id} | GET |
| Create User List | /api/v1/scim/Groups | POST |
| Update User List | /api/v1/scim/Groups/{id} | PUT |
Maintenance Windows
During maintenance, API returns:
HTTP 503 Service Unavailable---
OData API
Overview {#overview-odata}
SAP Build Work Zone uses OData v2 protocol with support for OData v4 query syntax (e.g., advanced $filter, $select expressions).
Protocol: OData v2 (with v4 query operator extensions)
Format: XML (AtomPub) or JSON
Base URL: /api/v1/OData
Authentication {#authentication}
Same OAuth flow as SCIM API.
Key Endpoints
| Resource | Endpoint | Description |
|---|---|---|
| Groups | /api/v1/OData/Groups | Workspace management |
| Members | /api/v1/OData/Members | User management |
| ContentItems | /api/v1/OData/ContentItems | Content operations |
| Feeds | /api/v1/OData/Feeds | Feed operations |
| FeedEntries | /api/v1/OData/FeedEntries | Feed entries |
Query Options
| Option | Example |
|---|---|
| $select | $select=Id,Name |
| $filter | $filter=Name eq 'Value' |
| $orderby | $orderby=Created desc |
| $top | $top=10 |
| $skip | $skip=20 |
| $expand | $expand=Members |
Business Records
Configure OData annotations to display external business records:
1. Create OData metadata file with annotations 2. Register in Administration Console 3. Configure display annotations 4. Map to business record types
---
Webhooks
Overview {#overview-webhooks}
Track platform events and send notifications to external applications.
Webhook URL Format
https://<host-url>/api/v2/ai/webhookConfiguration
1. Register webhook URL in Administration Console 2. Configure events to monitor 3. Set authentication tokens 4. Test webhook delivery
Event Types
| Category | Events |
|---|---|
| Workspace | Created, updated, deleted |
| Content | Created, modified, deleted |
| User | Joined, left, updated |
| Feed | Posted, commented, liked |
Payload Structure
{
"action": "perform_actions",
"context": {
"senderId": "user_id"
},
"parameters": {
// Event-specific parameters
}
}---
Chatbot API
Available Template Variables
When configuring chatbot webhooks, the following template variables are available:
| Variable | Description |
|---|---|
{{participant_data.jamId}} | Current user's Jam/Work Zone ID |
{{participant_data.email}} | Current user's email address |
{{participant_data.firstName}} | Current user's first name |
{{participant_data.lastName}} | Current user's last name |
{{conversation_id}} | Current conversation identifier |
{{memory.variableName}} | Custom memory variable from bot |
Webhook Actions
| Action | Description |
|---|---|
perform_actions | Execute platform actions |
ui5_card | Render UI Integration Cards |
Create Workspace Example
{
"action": "perform_actions",
"context": { "senderId": "{{participant_data.jamId}}" },
"parameters": {
"actionName": "create_workspace",
"name": "Workspace Name",
"is_private": false
}
}Render Card Example
{
"action": "ui5_card",
"context": { "senderId": "{{participant_data.jamId}}" },
"parameters": {
"cardId": "sap.card.id",
"widgetType": "sapCard"
}
}---
Authentication {#authentication-main}
OAuth 2.0 Setup
1. Create OAuth client in Administration Console 2. Configure client credentials grant 3. Obtain access token 4. Include in Authorization header
Token Request
POST /oauth/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
&client_id={client_id}
&client_secret={client_secret}API Request
GET /api/v1/OData/Groups
Authorization: Bearer {access_token}---
Alias Accounts
For system-level API access:
1. Create alias account in Administration Console 2. Navigate to API Access section 3. Add OAuth2 Access Token 4. Select OAuth client 5. Use token for automated API calls
---
Documentation Links:
- SAP API Hub: https://api.sap.com/
- OData Docs: https://jam2.sapjam.com/work_zone/ODataDocs/ui
- Webhook Reference: https://jam2.sapjam.com/work_zone/ODataDocs/webhook_reference
- SAP Help Portal: https://help.sap.com/docs/build-work-zone-advanced-edition
Auditing and Logging Guide
Complete guide for auditing and logging in SAP Build Work Zone, advanced edition.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
---
Overview
SAP Build Work Zone logs security events across multiple functional areas for compliance and troubleshooting purposes.
---
Log Event Categories
Assets
Tracks asset lifecycle events:
- Asset creation
- Asset modification
- Asset deletion
- Context changes
- Tenant changes
- Change details recorded
CDM Store Service
Records data management events:
- Batch operations
- Data deletion
- Entity management
- Import operations
- Transport activities
Content Package Manager
Logs content package lifecycle:
- Package installation
- Package upgrade
- Package uninstallation
- Tenant cleanup operations
Content Repository
Monitors repository changes:
- Asset additions
- Asset removals
OData Service
Security event logging:
- Unauthorized access attempts
- Access violations
Provisioning Service
Documents provisioning events:
- Tenant offboarding operations
Role Mapping
Tracks identity management:
- Role lifecycle management
- User lifecycle management
- Role assignments
- Role deletions
- User assignments
Site Configuration & Storage
Records site changes:
- Configuration changes
- Site operations
- Settings modifications
SPC Service
Logs provisioning tasks:
- Task creation
- Task deletion
- Status updates
Work Zone HR Runtime Approuter
Captures security events:
- Origin validation failures
- HTTP method violations
---
Log Entry Structure
Each log entry captures:
| Field | Description |
|---|---|
by | Trigger user (who made the change) |
tenant | Tenant information |
timestamp | Time of change |
operation | Type and status of operation |
entity | Entity identifiers and context |
old | Before state (for modifications) |
new | After state (for modifications) |
locale | Locale information |
---
Configuration Diff Logging
Configuration changes are logged with:
- Site diff information
- Instance identifiers
- Before/after configuration values
- Enables audit trail reconstruction
---
Accessing Logs
Administration Console
Location: Administration Console → Compliance & Security → Audit Reports
Log Export
- Export audit data for analysis
- Configure log retention periods
- Filter by event type
- Filter by date range
---
Compliance Features
Content Administration
- Review flagged content
- Manage content reports
- Configure moderation rules
Compliance Dictionary
- Define compliance terms
- Configure detection rules
- Manage violations
Profanity Monitoring
- Enable profanity detection
- Configure word lists
- Review flagged content
---
Best Practices
Security Monitoring
1. Regularly review unauthorized access attempts 2. Monitor role assignment changes 3. Track configuration modifications 4. Set up alerts for critical events
Compliance
1. Configure appropriate retention periods 2. Export logs for external analysis 3. Document access patterns 4. Review audit trails periodically
---
Documentation Links:
Chatbot Integration Guide
⚠️ DEPRECATION NOTICE: SAP Conversational AI entered maintenance/sunset mode as of January 2023. Functionality may be limited or deprecated. Verify current support status before implementing custom chatbots. See SAP Product Availability Matrix for lifecycle details. Consider SAP Build Apps or other alternatives for new implementations.
Complete guide for integrating and configuring chatbots in SAP Build Work Zone, advanced edition.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced/tree/main/docs/50-Chatbots
Table of Contents
- Overview
- Built-in Capabilities
- Chatbot Types
- Implementation Process
- Webhook Configuration
- Chatbot Actions
- Rendering Cards with Chatbots
- SAP Conversational AI Integration
- Chatbot Launcher
- Fallback Handling
- Troubleshooting
---
Overview
Chatbots help users accomplish tasks through conversational interaction. They support custom training, actions, and card rendering within SAP Build Work Zone.
Built-in Capabilities
Default chatbot features include:
- Workspace creation
- Leave request processing
- Business news delivery
- Content searching
- Entertainment (jokes, weather updates)
---
Chatbot Types
SAP Build Work Zone Chatbot (Recommended)
Pre-built chatbots with built-in functionalities:
| Variant | Features |
|---|---|
| Full-featured | All capabilities enabled |
| Workspace Creation | Workspace management only |
| Business News | News delivery only |
| Search | Content search only |
| Leave Requests | Leave management only |
| Smart Talk | Conversational features |
Custom Chatbots
Build independent chatbots using SAP Conversational AI platform:
- URL: https://cai.tools.sap/
- Custom training and intents
- Organization-specific actions
Note: SAP Conversational AI is in maintenance mode since January 2023. Verify support status before starting new implementations.
---
Implementation Process
Step 1: Fork Chatbot Repository
Development begins by copying a base chatbot repository:
- Creates independent branch for customization
- Can fork entire bots or specific intents only
Step 2: OAuth Registration
Authorize chatbot to access APIs: 1. Navigate to Administration Console 2. Go to External Integrations > OAuth Clients 3. Register client credentials 4. Configure required scopes
Step 3: Alias Account Setup
Create system user account for chatbot: 1. Go to User Management > Alias Accounts 2. Create new alias account 3. Configure permissions 4. Add OAuth2 Access Token 5. Link token to chatbot
Step 4: Configure Push Notifications
Set up event-triggered notifications:
| Category | Events |
|---|---|
| Alias Account | Account-related events |
| Content | Content creation/modification |
| Workspace | Workspace activities |
| Forum | Discussion events |
---
Webhook Configuration
Webhooks enable chatbots to invoke SAP Build Work Zone services.
Webhook URL Format
https://<host-url>/api/v2/ai/webhookExample: https://dwpdev1.sapjam-integration.com/api/v2/ai/webhook
Authorization
- Add OAuth token from Alias Account in Headers tab
- Token must have appropriate scopes for desired actions
Available Template Variables
| Variable | Description |
|---|---|
{{participant_data.jamId}} | Current user's Jam/Work Zone ID |
{{participant_data.email}} | Current user's email address |
{{conversation_id}} | Current conversation identifier |
Payload Structure
All webhook payloads require three mandatory components:
{
"action": "perform_actions",
"context": {
"senderId": "{{participant_data.jamId}}"
},
"parameters": {
// Action-specific parameters
}
}---
Chatbot Actions
Supported Actions
| Action | Purpose |
|---|---|
perform_actions | Execute platform actions |
ui5_card | Render UI Integration Cards |
create_workspace | Create new workspace |
get_workspace_templates | Retrieve available templates |
Create Workspace Action
{
"action": "perform_actions",
"context": {
"senderId": "{{participant_data.jamId}}"
},
"parameters": {
"actionName": "create_workspace",
"name": "Workspace Name",
"is_private": false,
"template": "template_id"
}
}| Parameter | Required | Description |
|---|---|---|
| actionName | Yes | Fixed: "create_workspace" |
| name | Yes | AI-derived from user input |
| is_private | No | Privacy setting |
| template | No | Template ID to use |
Get Workspace Templates Action
{
"action": "perform_actions",
"context": {
"senderId": "{{participant_data.jamId}}"
},
"parameters": {
"actionName": "get_workspace_templates"
}
}---
Rendering Cards with Chatbots
Chatbots can render UI Integration Cards for enhanced user experiences.
Supported Card Types
- Leave request cards
- Business News cards
- Search result cards
- Custom cards
Card Setup Process
1. Upload Card: Administration Console → UI Integration → Cards & Widgets → Upload Card 2. Get Card ID: Copy unique card identifier from Administration Console 3. Configure Webhook: Add card ID to chatbot payload
Card Rendering Payload
{
"action": "ui5_card",
"context": {
"senderId": "{{participant_data.jamId}}"
},
"parameters": {
"cardId": "sap.dwp.test.card.searchResult",
"widgetType": "sapCard"
}
}| Parameter | Required | Values |
|---|---|---|
| cardId | Yes | Unique card identifier |
| widgetType | No | "sapCard" or "sapWidget" (default) |
---
SAP Conversational AI Integration
Note: SAP Conversational AI entered maintenance mode in January 2023. This section is provided for existing implementations only.
Connector Setup
1. Access SAP Conversational AI platform 2. Use built-in "SAP Jam Collaboration" connector 3. Configure connection to SAP Build Work Zone
Configuration Steps
1. Go to Build > [Your Bot] > Webhook Configuration 2. Enter webhook URL 3. Add OAuth token in Headers 4. Configure payload in Body tab
Configuration Location
Administration Console > External Integrations > Chatbot Configuration
---
Chatbot Launcher
Enabling Chatbot
1. Configure chatbot in Administration Console 2. Enable Chatbot Launcher feature 3. Chatbot icon appears in bottom-right corner
User Access
- Available on most pages (except Applications page)
- Multiple bots can be configured
- Users select preferred bot from list
Interface Controls
| Control | Function |
|---|---|
| Switch | Change between configured bots |
| Fullscreen | Toggle fullscreen mode |
| Close | Close chatbot window |
| Send | Submit message (Ctrl+Enter / Cmd+Enter) |
---
Fallback Handling
When chatbot cannot understand a request:
- Returns fallback message
- Indicates incomprehension
- Suggests alternative phrasing
---
Documentation Links:
- Chatbots: https://help.sap.com/docs/build-work-zone-advanced-edition
- SAP Conversational AI: https://cai.tools.sap/ (sunset/maintenance mode since Jan 2023)
- GitHub: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced/tree/main/docs/50-Chatbots
Content Packages Development Guide
Complete guide for creating, managing, and deploying content packages in SAP Build Work Zone, advanced edition.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced/tree/main/docs/30-ContentPackages
Table of Contents
- Overview
- Package Types
- Global Content Packages
- Local Content Packages
- Supported Content Items
- Creating a Content Package
- Package Manifest
- Deploying Content Packages
- Package Management
- Updating Content Packages
- Project Structure
- Post-Creation Actions
---
Overview
Content packages are collections of content artifacts bundled in a ZIP file for distribution and installation. They enable packaging and deploying UI Integration Cards, workspace templates, workflows, home pages, and workspaces.
Package Types
Global Content Packages
Pre-built packages available to all SAP Build Work Zone customers:
- Available without manual upload
- Require administrator installation
- Cannot be customized or downloaded
- Sourced from SAP or third-party providers
Examples:
- Employee Onboarding
- HR Content from SuccessFactors
- Insights: Change Management
Local Content Packages
Customer-developed packages:
- Developed internally
- Require manual upload
- Can be downloaded and customized
- Require administrator installation
---
Supported Content Items
Content packages can include:
| Item Type | Description |
|---|---|
| UI Integration Cards | SAPUI5 cards for data display |
| Workflows | Business process automation |
| Workspace Templates | Reusable workspace blueprints |
| Home Pages | Pre-configured landing pages |
| Workspaces | Complete workspace exports |
---
Creating a Content Package
Prerequisites
- SAP Business Application Studio subscription
- Dev space with "Development Tools for SAP Build Work Zone, Advanced Edition" extension
- Destination to content repository configured
- Workzone_Admin role collection
Step 1: Create Project
1. Open SAP Business Application Studio 2. Select "New Project From Template" 3. Choose "Content Package" → "Start" 4. Complete Project Details form
Alternative: Use command Content Package: Create Content Package Project
Step 2: Configure Project Details
| Field | Description |
|---|---|
| Project Name | Custom identifier for project |
| Namespace | Generates Content Package ID: <namespace>.<project_name> |
| Title | Display title |
| Subtitle | Display subtitle |
| Content Samples | Toggle to include sample artifacts |
Step 3: Add Content Items
Add artifacts to the package:
- UI Integration Cards
- Workspace templates
- Workflows
- Other supported content
---
Package Manifest
Basic Structure
{
"_version": "1.0.0",
"sap.package": {
"id": "com.company.mypackage",
"version": "1.0.0",
"title": "My Content Package",
"description": "Package description",
"vendor": "Company Name",
"icon": "sap-icon://package"
},
"contents": {
"cards": [
{
"id": "namespace.cardname",
"type": "card",
"src": "cards/cardname"
}
],
"workspaceTemplates": [
{
"id": "namespace.templatename",
"type": "workspaceTemplate",
"src": "templates/templatename"
}
]
}
}Destination Prerequisites
For remote system integration, add prerequisites section:
{
"sap.package": {
"id": "com.company.mypackage",
"prerequisites": {
"destinations": [
{
"name": "MyDestination",
"document": "https://documentation.url"
},
{
"name": "SecondDestination"
}
]
}
}
}Important: Destinations must be configured in BTP Cockpit Destinations screen before deployment.
---
Deploying Content Packages
Method 1: Direct Deployment
1. Right-click project in explorer 2. Select "Deploy to SAP Build Work Zone" 3. Package deploys directly to target system
Method 2: Manual Upload
1. Right-click project 2. Select "Package" 3. Download generated ZIP file 4. Upload in Administration Console → UI Integration → Content Packages
---
Package Management
Administration Console
Location: UI Integration > Content Packages
Package Statuses
| Status | Description |
|---|---|
| Ready to Install | Package uploaded, not installed |
| Installed | Package active in system |
| Upgrade Available | Newer version available |
Management Features
- Search packages by name
- Filter by provider source
- Filter by installation status
- View package contents
- Install/uninstall packages
---
Updating Content Packages
Version Management
1. Increment version in manifest 2. Update content items as needed 3. Redeploy package 4. Install upgrade in Administration Console
Update Workflow
1. Open existing project 2. Modify content or configuration 3. Update version number 4. Deploy updated package
Best Practices
- Use semantic versioning (major.minor.patch)
- Document changes in package description
- Test in development before production
- Maintain backward compatibility when possible
---
Project Structure
content-package-project/
├── manifest.json # Package manifest
├── cards/
│ └── cardname/
│ ├── manifest.json # Card manifest
│ └── dt/
│ └── configuration.js
├── templates/
│ └── templatename/
│ └── template.json
└── workflows/
└── workflowname/
└── workflow.json---
Post-Creation Actions
| Action | Description |
|---|---|
| Update | Modify package artifacts |
| Deploy | Push to target environment |
| Delete | Remove via right-click context menu |
---
Documentation Links:
SAP Build Work Zone Mobile App Guide
Complete guide for the SAP Build Work Zone, advanced edition mobile application.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
---
Overview
The mobile app provides access to SAP Build Work Zone features on iOS and Android devices.
Platform Requirements
| Platform | Minimum Version |
|---|---|
| iOS | 13 or later (iPhone/iPad) |
| Android | 7.x or later |
Prerequisites
- Active account in SAP Build Work Zone, advanced edition
- Network connectivity to SAP Build Work Zone instance
---
Core Features
Workspace Management
- Access all assigned workspaces
- Comment with tagging and likes
- Invite users to workspaces
- View workspace member information
Content & Documents
- Download files from workspaces
- Upload files to workspaces
- Browse various content types
- Access Knowledge Base
Search
- Search for workspaces
- Search for people
- Search for content
- Keyword-based search matching web application
Communication
- View and post to feeds
- Receive notifications
- Access inbox functionality
- View and manage tasks
Task Management
- Display tasks
- Create new tasks
- Edit existing tasks
Profile Management
- View personal profile
- Access workspace member profiles
- View contact details
---
Security Features
Passcode Protection
- Set up device passcode
- Configure passcode requirements
Biometric Authentication
- Fingerprint authentication (supported devices)
- Face scan authentication (supported devices)
---
Configuration
Language Settings
- Default: Device operating system language
- Configurable in app settings
Web Browser Integration
- "My Workspace" accessible via built-in browser
---
Administration
Mobile Apps Configuration
Location: Administration Console → External Integrations → Mobile Apps
Configuration Options
- Enable/disable mobile access
- Configure mobile policies
- Manage app distribution settings
---
Building Custom Mobile Apps
For organizations requiring customized mobile applications:
1. Access SAP documentation for custom mobile app development 2. Configure custom branding 3. Deploy through enterprise app stores
---
Documentation Links:
Notifications Guide
Complete guide for configuring and managing notifications in SAP Build Work Zone, advanced edition.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
---
Overview
SAP Build Work Zone provides multiple notification mechanisms to keep users informed about important updates, invitations, and approval requests.
---
Notification Types
Bell Notifications
- No setup required
- Alerts for important updates
- Invitation notifications
- Approval request notifications
- Accessible from top navigation bar
Email Notifications
Configured through: User Actions Menu → Settings → Advanced Settings → Email
---
Email Notification Configuration
Settings Tabs
Notifications Tab
Select events for email notifications:
- Activity that involves you
- Daily Summary Emails
- System notifications
Workspace Notifications Tab
- Configure frequency for all workspaces
- Individual workspace notification settings
- Override global settings per workspace
Collaboration Tab
- Update home feed preferences
- Select sender email address
- Configure collaboration alerts
---
Mention Notifications
@mention
Notify specific users:
- Context-aware filtering
- Workspace members
- All users (based on permissions)
- Inline mention in content
@@notify
Notify multiple users simultaneously:
- Workspace members notification
- Followers notification
- Bulk notification capability
---
Notification Categories
| Category | Description |
|---|---|
| Social Updates | Mentions, replies, likes |
| Invitations | Workspace invitations, event invitations |
| Requests | Join workspace, content approval |
| Tasks | Assignments, reminders, due dates |
| Informational | Featured status, access grants |
---
Webhook Notifications
Configuration Location
Administration Console → External Integrations → Webhook-based Notifications
Webhook Events
Configure webhooks for:
- Content events
- Workspace events
- User events
- System events
Webhook Setup
1. Navigate to External Integrations 2. Configure webhook endpoint URL 3. Select events to trigger 4. Configure authentication
---
Push Notifications
Chatbot Push Notifications
Configure event-triggered notifications for chatbots:
| Category | Events |
|---|---|
| Alias Account | Account-related events |
| Content | Content creation/modification |
| Workspace | Workspace activities |
| Forum | Discussion events |
---
Best Practices
User Experience
1. Configure appropriate notification frequency 2. Avoid notification overload 3. Use @mention for targeted notifications 4. Leverage daily summaries for non-urgent updates
Administration
1. Review notification policies 2. Configure default notification settings 3. Monitor webhook reliability 4. Test notification delivery
---
Documentation Links:
- Notifications: https://help.sap.com/docs/build-work-zone-advanced-edition/sap-build-work-zone-advanced-edition/about-notifications
- Notification Service Integration: https://help.sap.com/docs/build-work-zone-advanced-edition/sap-build-work-zone-advanced-edition/integrating-with-central-services
- SAP Learning - Notifications: https://learning.sap.com/learning-journeys/developing-with-sap-extension-suite (search "notifications")
- GitHub: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
SAP Build Work Zone Security Guide
Security configuration for SAP Build Work Zone, advanced edition.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
Table of Contents
- Authentication Methods
- SAML Identity Providers
- OAuth Clients
- Single Sign-On (SSO)
- Access Control
- Role Collections
- Workspace Permissions
- HTTP Security Headers
- Recommended Headers
- Example Configuration
- Configuration Location
- Compliance Features
- Compliance Monitor
- Profanity Monitor
- Content Administration
- Audit Logging
---
Authentication Methods
SAML Identity Providers
Configure trusted SAML IdPs for SSO:
1. Navigate to Administration Console 2. Go to Authentication > SAML Trusted IdPs 3. Add IdP metadata
OAuth Clients
Register OAuth clients for API access:
1. Go to Authentication > OAuth Clients 2. Create new client 3. Configure scopes and permissions
Single Sign-On (SSO)
SSO is enabled through:
- SAML federation
- SAP Cloud Identity Services
- Corporate IdP integration
---
Access Control
Role Collections
Key roles:
Workzone_Admin- Full administrationWorkzone_User- Standard accessWorkzone_HR_Admin- HR integration
Workspace Permissions
- Owner
- Admin
- Member
- Viewer
---
HTTP Security Headers
Configure security headers to protect against common web vulnerabilities.
Recommended Headers
| Header | Value | Protection |
|---|---|---|
| X-Frame-Options | SAMEORIGIN | Clickjacking |
| Content-Security-Policy | default-src 'self' | XSS, content injection |
| X-Content-Type-Options | nosniff | MIME-type sniffing |
| X-XSS-Protection | 1; mode=block | Cross-site scripting |
| Strict-Transport-Security | max-age=31536000 | Protocol downgrade |
Example Configuration
X-Frame-Options: SAMEORIGIN
Content-Security-Policy: default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Strict-Transport-Security: max-age=31536000; includeSubDomainsConfiguration Location
Security headers are typically configured at:
- BTP Application Router (xs-app.json)
- SAP Cloud Connector
- Load balancer/reverse proxy level
Note: For API security including OAuth flows and token handling, see references/api-reference.md.---
Compliance Features
Compliance Monitor
Flags content matching compliance dictionary terms.
Profanity Monitor
Detects and flags profanity violations.
Content Administration
Review and manage flagged content.
---
Audit Logging
Security events logged include:
- Authentication attempts
- Permission changes
- Content modifications
- Administrative actions
For detailed audit logging configuration, see references/auditing.md.
---
Documentation Links:
SAP Build Work Zone Troubleshooting Guide
Common issues and solutions for SAP Build Work Zone, advanced edition.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
Table of Contents
- API Errors
- HTTP 503 - Service Unavailable
- HTTP 429 - Too Many Requests
- OAuth Authentication Failure
- Card Issues
- Card Not Displaying
- Card Deployment Failed
- Workspace Issues
- Cannot Create Workspace
- Missing Content
- Performance Issues
- Slow Page Load
- Integration Issues
- Microsoft Teams Connection Failed
---
API Errors
HTTP 503 - Service Unavailable
Cause: Service maintenance or system overload
Solution: Wait and retry after a few minutes
HTTP 429 - Too Many Requests
Cause: Rate limit exceeded
Solution: 1. Check X-RateLimit-Remaining header 2. Wait for X-RateLimit-Reset seconds 3. Implement exponential backoff
OAuth Authentication Failure
Cause: Invalid or expired credentials
Solution: 1. Verify Workzone API Client credentials 2. Check OAuth token expiration 3. Regenerate client secret if needed
---
Card Issues
Card Not Displaying
Causes:
- SAPUI5 version incompatibility
- Invalid manifest.json
- Missing destinations
Solutions: 1. Verify SAPUI5 version (1.87.0+) 2. Validate card manifest 3. Check destination configuration
Card Deployment Failed
Causes:
- Missing permissions
- Invalid package structure
Solutions: 1. Verify Workzone_Admin role 2. Check project structure 3. Review deployment logs
---
Workspace Issues
Cannot Create Workspace
Cause: Permission restrictions
Solution: Check workspace creation settings in Features
Missing Content
Cause: Permission or visibility settings
Solution: Verify content permissions and user access
---
Integration Issues
Microsoft Teams Connection Failed
Causes:
- Invalid OAuth configuration
- Tenant mismatch
Solutions: 1. Verify Azure AD app registration 2. Check tenant configuration 3. Review consent permissions
---
Performance Issues
Slow Page Load
Solutions: 1. Reduce number of cards per page 2. Optimize card data queries 3. Enable CDN for static content
---
Documentation Links:
- Troubleshooting Guide: https://help.sap.com/docs/build-work-zone-advanced-edition
- SAP Samples: https://github.com/SAP-samples/build-workzone-integration
UI Integration Cards Development Guide
Complete guide for developing UI Integration Cards in SAP Build Work Zone, advanced edition.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced/tree/main/docs/20-UIIntegrationCards
Table of Contents
- Overview
- Prerequisites
- Creating a UI Card
- Step 1: Open SAP Business Application Studio
- Step 2: Create New Project
- Step 3: Configure Project
- Step 4: Develop Card
- Card Types
- Card Manifest Structure
- Context Values
- Available Context Paths
- Using Context in Cards
- Card Interactions
- Page Context Parameters
- updateContext Action
- Design-Time Module
- File Location
- Configuration Structure
- Form Item Properties
- Dropdown List Configuration
- Deploying Cards
- Prerequisites
- Method 1: Direct Deployment
- Method 2: Package and Manual Upload
- Updating Cards
- Mobile Support
---
Overview
UI Integration Cards are design patterns that display concise information in limited-space containers. They follow SAPUI5 specifications (version 1.87.0+).
Prerequisites
- SAP Business Application Studio subscription
- Dev space with "Development Tools for SAP Build Work Zone, Advanced Edition" extension
- Destination to content repository configured (for direct deployment)
- Workzone_Admin role collection
---
Creating a UI Card
Step 1: Open SAP Business Application Studio
Access your dev space with the Work Zone extension enabled.
Step 2: Create New Project
1. Select "New Project From Template" 2. Choose "UI Integration Card" 3. Click Next
Alternative: Use command line via View → Find Command → "UI Integration Card: Create Card Project"
Step 3: Configure Project
| Field | Description |
|---|---|
| Project Name | Your identifier |
| Card Sample | Select from available templates |
| Namespace | Used for Card ID (namespace.projectname) |
| Card Title | Display title |
| Card Subtitle | Display subtitle |
| Mobile Compatibility | Enable for mobile app support |
Step 4: Develop Card
Edit the card manifest and source files in the project structure.
---
Card Types
| Type | Use Case |
|---|---|
| List Card | Display list of items |
| Object Card | Display single object details |
| Table Card | Tabular data display |
| Timeline Card | Chronological events |
| Analytical Card | Charts and analytics |
| Calendar Card | Calendar events |
| Component Card | Custom SAPUI5 components |
---
Card Manifest Structure
{
"_version": "1.52.0",
"sap.app": {
"id": "namespace.cardname",
"type": "card",
"title": "Card Title",
"applicationVersion": { "version": "1.0.0" },
"dataSources": {
"mainService": {
"uri": "/odata/service",
"type": "OData",
"settings": { "odataVersion": "2.0" }
}
}
},
"sap.card": {
"type": "List",
"designtime": "dt/configuration",
"configuration": {
"destinations": {
"myDestination": { "name": "DestinationName" }
},
"parameters": {
"maxItems": { "value": 5, "type": "integer" }
}
},
"header": {
"title": "Card Title",
"subTitle": "Card Subtitle",
"icon": { "src": "sap-icon://list" }
},
"content": {
"data": {
"request": {
"url": "{{destinations.myDestination}}/EntitySet",
"parameters": { "$top": "{parameters>/maxItems/value}" }
},
"path": "/d/results"
},
"item": {
"title": "{Title}",
"description": "{Description}"
}
}
}
}---
Context Values
Cards can access host environment information using the sap.workzone context.
Available Context Paths
| Path | Description |
|---|---|
sap.workzone/currentUser/id | Current user's ID |
sap.workzone/currentUser/name | Current user's name |
sap.workzone/currentUser/email | Current user's email |
sap.workzone/currentCompany/id | Company ID |
sap.workzone/currentCompany/name | Company name |
sap.workzone/currentWorkspace/id | Current workspace ID |
sap.workzone/currentWorkspace/name | Current workspace name |
Using Context in Cards
Binding Syntax:
{
"parameters": {
"userId": {
"value": "{context>sap.workzone/currentUser/id}"
}
}
}Programmatic Access:
// Get card instance
var oCard = this.getOwnerComponent().getCard();
// Get host instance
var oHost = oCard.getHostInstance();
// Get context value (returns Promise)
oHost.getContextValue("sap.workzone/currentUser/id").then(function(value) {
console.log("User ID:", value);
});---
Card Interactions
Cards on the same workpage can interact through a shared page context.
Page Context Parameters
- All parameters in page context are available to cards during initialization
- When any card modifies a context parameter, all cards on the page refresh
- Users select card parameters through site context configuration
updateContext Action
The updateContext action enables card-to-card communication:
{
"sap.card": {
"content": {
"item": {
"actions": [{
"type": "Custom",
"enabled": true,
"parameters": {
"method": "updateContext",
"parameters": {
"selectedId": "{Id}"
}
}
}]
}
}
}
}---
Design-Time Module
The design-time module enables card configuration in the Work Zone editor.
File Location
Place at: dt/configuration.js
Register in manifest.json:
{
"sap.card": {
"designtime": "dt/configuration"
}
}Configuration Structure
sap.ui.define(["sap/ui/integration/Designtime"], function (Designtime) {
"use strict";
return function () {
return new Designtime({
form: { items: {} },
preview: { modes: "Abstract" }
});
};
});Form Item Properties
| Property | Type | Description |
|---|---|---|
manifestpath | string | Path to manifest value to edit |
type | string | string, integer, number, date, datetime, boolean, string[] |
label | string | Display label (supports i18n) |
defaultValue | any | Fallback when manifest empty |
required | boolean | Marks field with asterisk |
visible | boolean | Controls visibility (default: true) |
translatable | boolean | Enables translation mode |
cols | 1 or 2 | Layout control (default: 2) |
allowDynamicValues | boolean | Permits context value binding |
allowSettings | boolean | Allows admin modifications |
Dropdown List Configuration
Static Data:
"values": {
"data": {
"json": { "values": [{ "text": "Option 1", "key": "opt1" }] }
},
"path": "/values",
"item": { "text": "{text}", "key": "{key}" }
}Request Data:
"values": {
"data": { "request": { "url": "./dt/listdata.json" } },
"path": "/values",
"item": { "text": "{text}", "key": "{key}" }
}---
Deploying Cards
Prerequisites
- SAP Business Application Studio and target system in same subaccount
- Token-exchange destination configured (for direct deployment)
Method 1: Direct Deployment
1. Right-click manifest.json 2. Select "UI Integration Card: Deploy to SAP Build Work Zone, advanced edition" 3. Card deploys directly to target system
Note: For initial deployments, clear content destination in File → Settings → Open Preference → UIcarddk
Method 2: Package and Manual Upload
1. Right-click manifest.json 2. Select "UI Integration Card: Package" 3. Download generated <card-id>.zip file 4. Upload manually in Administration Console → UI Integration → Cards & Widgets
---
Updating Cards
1. Open card project in SAP Business Application Studio 2. Modify manifest.json or source files 3. Access preview via built-in editor 4. Redeploy using preferred method
---
Mobile Support
Enable mobile compatibility to allow cards in:
- SAP Build Work Zone mobile app
- Mobile responsive web UI
- iOS and Android devices
---
Documentation Links:
Widgets Development Guide
Complete guide for using and configuring widgets in SAP Build Work Zone, advanced edition.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
Table of Contents
- Overview
- Widget Management
- Adding Widgets
- Widget Operations
- Standard Widget Types
- Content Display Widgets
- Interactive Widgets
- Additional Widgets
- Widget Styling
- Style Options
- Image Widget Sizes
- Widget Limitations
- Widget Configuration
- Common Settings
- Widget-Specific Settings
- Custom Widgets
- Widget Builder
- Custom Widget Use Cases
- Best Practices
- Widget Selection
- Widget Organization
---
Overview
Widgets are containers for various content types such as video, feeds, photos, and many other content types. They are added to workpages using the workpage editor.
Widget Management
Adding Widgets
1. Open workpage in edit mode 2. Select widget type from palette 3. Configure widget content 4. Adjust style and layout settings 5. Save changes
Widget Operations
- Insert widgets
- Remove widgets
- Edit widget content
- Reposition widgets
---
Standard Widget Types (9 Official)
The following widgets are officially documented in SAP Build Work Zone, advanced edition:
Content Display Widgets
| Widget | Description |
|---|---|
| Text | Rich text content display |
| Image | Display single image with optional links |
| Feed | Activity feeds from workspaces |
| Content | Document/file display |
| Forum | Discussion threads and topics |
| Knowledge Base | Knowledge articles and wikis |
Interactive Widgets
| Widget | Description |
|---|---|
| Action | Quick action buttons |
| Event | Calendar events display |
| UI Integration Cards | SAPUI5-based data cards |
---
Additional Widgets (Widget Builder/Custom)
The following widgets may be available via Widget Builder or as custom extensions. Verify availability in your tenant:
| Widget | Availability |
|---|---|
| Multimedia | Custom/Widget Builder |
| Slideshow | Custom/Widget Builder |
| Poll | Custom/Widget Builder |
| Search | Custom/Widget Builder |
| People | Custom/Widget Builder |
| Workspaces | Custom/Widget Builder |
| Recommendation | Custom/Widget Builder |
| Recent Items | Custom/Widget Builder |
| Tag Cloud | Custom/Widget Builder |
| Name | Custom/Widget Builder |
| Business Record | Requires external integration |
| Notification | Custom/Widget Builder |
| Rotating Banner | Custom/Widget Builder |
| Tool Content | Custom/Widget Builder |
| External Content | Custom/Widget Builder |
| Application Group | Custom/Widget Builder |
Note: Widget availability depends on your SAP Build Work Zone edition and configuration. Check Administration Console → UI Integration for available widgets in your tenant.
---
Widget Styling
Style Options
| Option | Description |
|---|---|
| Follow page setting | Inherit page styling |
| Card style | Colors, borders, rounded corners |
| Without card styling | Transparent background |
| Custom color | Text widget specific |
Image Widget Sizes
Recommended widths for optimal quality:
| Columns | Recommended Width |
|---|---|
| 1 | 188 pixels |
| 2 | 396 pixels |
| 3 | 604 pixels |
| 4 | 812 pixels |
| 5 | 1020 pixels |
| 6 | 1180 pixels |
---
Widget Limitations
Feed Widget
- Only ONE feed widget per workpage
- Additional feeds require separate workpages
Performance Considerations
- Limit total widgets per page
- Consider mobile performance
- Optimize image sizes
---
Widget Configuration
Common Settings
All widgets share common configuration options:
- Title/header
- Visibility settings
- Size/dimensions
- Border/spacing
Widget-Specific Settings
Each widget type has unique configuration:
Image Widget:
- Image source
- Alt text
- Link destination
- Size constraints
Text Widget:
- Rich text formatting
- Background color
- Text alignment
- Link embedding
Feed Widget:
- Feed source
- Display count
- Refresh interval
- Filter options
---
Custom Widgets
Widget Builder
Administrators can create custom HTML widgets:
1. Navigate to Administration Console 2. Go to UI Integration > Widget Builders 3. Create new widget definition 4. Configure HTML/CSS/JS 5. Deploy widget
Custom Widget Use Cases
- Embed external dashboards
- Custom data visualizations
- Third-party integrations
- Branded content displays
---
Best Practices
Widget Selection
1. Match content to widget - Use appropriate widget for content type 2. Consider audience - Select widgets users need 3. Balance density - Don't overcrowd pages 4. Test responsiveness - Verify mobile display
Widget Organization
1. Logical grouping - Related widgets together 2. Visual hierarchy - Important content prominent 3. Consistent styling - Maintain design consistency 4. Accessibility - Consider all users
---
Documentation Links:
Workspace Templates Development Guide
Complete guide for creating and deploying workspace templates in SAP Build Work Zone, advanced edition.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced/tree/main/docs/40-WorkspaceTemplates
---
Overview
Workspace templates are reusable blueprints that enable users to create workspaces for various business scenarios with minimum modification. They promote consistency and efficiency across organizations.
Purpose and Benefits
- Operational Efficiency: Create workspaces without starting from scratch
- Standardization: Consistent workspace structure across organization
- Flexibility: Accommodate specific business needs
- Reusability: Deploy same template multiple times
---
Template Components
Workspace templates can include:
| Component | Description |
|---|---|
| Workpages | Pre-configured pages with layouts |
| Widgets | Pre-placed content containers |
| Settings | Default workspace configuration |
| Permissions | Role-based access defaults |
| Branding | Theme and styling settings |
---
Creating a Workspace Template
Prerequisites
- SAP Business Application Studio subscription
- Dev space with "Development Tools for SAP Build Work Zone, Advanced Edition" extension
- Destination to content repository configured
- Workzone_Admin role collection
Step 1: Create Project
1. Open SAP Business Application Studio 2. Select "New Project From Template" 3. Choose "Workspace Template" 4. Click Next
Step 2: Configure Template
Define template properties:
- Template name
- Template description
- Default workspace settings
Step 3: Design Template Structure
Configure the workspace structure:
- Add workpages
- Configure page layouts
- Add widget placeholders
- Set default permissions
Step 4: Deploy Template
1. Right-click project in explorer 2. Select "Deploy to SAP Build Work Zone" 3. Verify in Administration Console
---
Template Configuration
Workspace Settings
Define default settings for workspaces created from template:
- Workspace type (public/private)
- Member permissions
- Feature enablement
- Notification settings
Page Layouts
Configure workpage layouts:
- Section structure
- Column configuration (1-6 columns)
- Widget placement
Widget Defaults
Pre-configure widgets:
- Widget types
- Default content
- Styling options
---
Managing Templates
Administration Console
Templates are managed in:
- Area & Workspace Configuration > Workspace Templates
Template Operations
| Operation | Description |
|---|---|
| Install | Activate template for use |
| Update | Deploy new version |
| Disable | Remove from available templates |
| Delete | Remove template entirely |
---
Using Templates
Creating Workspace from Template
1. Navigate to Workspaces menu 2. Select "Create Workspace" 3. Choose template from list 4. Customize as needed 5. Create workspace
Template Customization
Users can modify template defaults when creating workspaces:
- Change workspace name/description
- Adjust permissions
- Modify page layouts
- Add/remove widgets
---
Best Practices
Design Guidelines
1. Keep templates focused - One template per use case 2. Use descriptive names - Clear purpose identification 3. Document customization points - Guide users on modifications 4. Test thoroughly - Verify all components work
Version Management
- Increment version for updates
- Maintain backward compatibility
- Document changes between versions
---
Documentation Links:
Workspaces and Workpages Guide
Complete guide for creating and managing workspaces and workpages in SAP Build Work Zone, advanced edition.
Source: https://github.com/SAP-docs/sap-btp-build-work-zone-advanced
Table of Contents
- Workspaces Overview
- Workspace Features
- Workspace Roles
- Navigation and Organization
- Administrative Areas
- Sub-Workspaces
- Creating Workspaces
- Workpages
- Layout Structure
- Workpage Editor
- Workspace Settings
- Business Records Integration
- Best Practices
---
Workspaces Overview
A workspace is a collaborative environment designed to encourage users to share and communicate about specific subjects, projects, events, goals, or teams.
Workspace Features
- Dedicated pages and feeds
- Member management
- Content sharing
- Task collaboration
- Business record integration
- Sub-workspaces for nested organization
---
Workspace Roles
| Role | Permissions |
|---|---|
| Owner | Full control, created automatically for workspace creator |
| Administrator | Manage members, settings, content |
| Member | Participate, create content, collaborate |
| Viewer | Read-only access |
---
Navigation and Organization
Workspaces Menu
Users can access:
- Recently viewed workspaces
- Favorite workspaces
- All available workspaces
- Managed workspaces (filter)
---
Administrative Areas
Administrative areas provide organizational grouping for workspaces.
Definition
A designated space for subject matter experts to manage content and interact within their lines of business.
Role Structure
| Role | Scope |
|---|---|
| Company Administrator | Full platform access |
| Area Administrator | Limited to specific area |
Creating Administrative Areas
1. Navigate to Administration Console 2. Select "New Area" 3. Configure area settings 4. Assign area administrators 5. Define which settings area admins can modify
Area Operations
- Ordering: Drag areas to reorder display position
- Navigation: Access via Action menu → "Go To Area"
- Deletion: Removes area; workspaces retained but dissociated
Permission Configuration
Control which administrative functions are available to area administrators at area creation time.
---
Sub-Workspaces
Sub-workspaces enable nested workspace organization.
Creation Requirements
- Only workspace administrators can create sub-workspaces
- Add "Sub-Workspaces" navigation tab to enable
Membership Rules
| Rule | Description |
|---|---|
| Subset | Sub-workspace members must be main workspace members |
| Automatic Removal | Removing from main workspace removes from sub-workspaces |
| Automatic Addition | Inviting to sub-workspace adds to main workspace |
Administration
- Delegate sub-workspace administration to other members
- Promote members to sub-workspace administrators
Configuration
When creating sub-workspaces:
- Select workspace template
- Configure settings same as main workspace
- Maintain consistent structure
---
Creating Workspaces
From Scratch
1. Navigate to Workspaces menu 2. Select "Create Workspace" 3. Configure settings:
- Name and description
- Privacy settings
- Member permissions
4. Create workspace
From Template
1. Navigate to Workspaces menu 2. Select "Create Workspace" 3. Choose template 4. Customize as needed 5. Create workspace
---
Workpages
Overview
Workpages are pages within workspaces where users add content. They use a grid layout with sections containing up to six columns.
Layout Structure
Workpage
├── Section 1
│ ├── Column 1 (widgets)
│ ├── Column 2 (widgets)
│ └── ...up to 6 columns
├── Section 2
│ └── ...
└── ...Creating Workpages
1. Navigate to workspace 2. Select "Add Page" 3. Choose template or blank layout 4. Configure sections and columns 5. Add widgets and content 6. Publish or save as draft
Nested Workpages
Workpages can be nested hierarchically:
- Exist in site menus
- Nest under other workpages
- Create logical content grouping
---
Workpage Editor
Capabilities
- Add apps, cards, and widgets
- Configure sections and columns
- Adjust widget settings
- Design styling options
Content Options
- UI Integration Cards
- Widgets (24 types)
- Applications
- Custom content
Publishing Options
| Option | Description |
|---|---|
| Publish | Make visible to workspace members |
| Save as Draft | Save for later completion |
---
Workspace Settings
Privacy Settings
| Type | Description |
|---|---|
| Public | Visible to all users |
| Private | Visible to members only |
| Secret | Hidden from non-members |
Member Management
- Add/remove members
- Assign roles
- Configure permissions
- Manage invitations
Feature Enablement
Enable/disable workspace features:
- Feeds
- Content creation
- Forums
- Knowledge base
- Events
---
Business Records Integration
If integrated with external business systems (e.g., SAP Cloud for Customer):
Supported Record Types
- Accounts
- Opportunities
- Service tickets
Capabilities
- Browse and search records
- Create dedicated workspaces for records
- Feature records in workspaces
- Post comments and create tasks
- Tag and like records
Access Requirements
Users must have appropriate access rights in integrated external systems.
External User Limitations
External users may:
- View records in authorized workspaces
- Comment on records
- Feature records in workspaces
---
Best Practices
Workspace Design
1. Clear purpose - Define workspace goal 2. Logical structure - Organize workpages logically 3. Appropriate permissions - Limit access as needed 4. Active moderation - Maintain content quality
Workpage Design
1. Grid efficiency - Use appropriate column counts 2. Widget organization - Group related content 3. Mobile consideration - Test on mobile devices 4. Performance - Limit widgets per page
Sub-Workspace Usage
1. Clear hierarchy - Logical parent-child relationships 2. Appropriate scope - Don't over-nest 3. Consistent membership - Align with main workspace
---
Documentation Links:
{
"_version": "1.52.0",
"_comment": "UI Integration Card manifest template for SAP Build Work Zone",
"sap.app": {
"id": "{{namespace}}.{{cardName}}",
"type": "card",
"title": "{{Card Title}}",
"subTitle": "{{Card Subtitle}}",
"applicationVersion": {
"version": "1.0.0"
},
"dataSources": {
"_comment": "Note: This dataSources section documents the OData service metadata. Actual data fetching uses the destinations configuration in sap.card below.",
"mainService": {
"uri": "{{OData Service URL}}",
"type": "OData",
"settings": {
"odataVersion": "2.0"
}
}
}
},
"sap.ui": {
"technology": "UI5",
"icons": {
"icon": "sap-icon://card"
}
},
"sap.card": {
"type": "List",
"designtime": "dt/configuration",
"configuration": {
"destinations": {
"_comment": "Destinations are resolved at runtime via SAP BTP destination service",
"myDestination": {
"name": "{{Destination Name}}"
}
},
"parameters": {
"maxItems": {
"value": 5,
"type": "integer",
"label": "Maximum Items"
}
}
},
"header": {
"title": "{{Card Title}}",
"subTitle": "{{Card Subtitle}}",
"icon": {
"src": "sap-icon://list"
},
"status": {
"text": "{= ${count} + ' items'}"
}
},
"content": {
"data": {
"_comment": "Data is fetched using the destination reference, not the dataSources URI",
"request": {
"url": "{{destinations.myDestination}}/{{EntitySet}}",
"parameters": {
"$top": "{parameters>/maxItems/value}",
"$orderby": "{{OrderByField}} desc"
}
},
"path": "/d/results"
},
"item": {
"title": "{{{TitleField}}}",
"description": "{{{DescriptionField}}}",
"icon": {
"src": "sap-icon://product"
},
"actions": [
{
"type": "Navigation",
"parameters": {
"url": "{{Navigation URL}}/{{{IdField}}}"
}
}
]
},
"maxItems": 5
}
}
}
{
"_version": "1.0.0",
"sap.package": {
"id": "{{company}}.{{packageName}}",
"version": "1.0.0",
"title": "{{Package Title}}",
"description": "{{Package description}}",
"vendor": "{{Company Name}}",
"icon": "sap-icon://package"
},
"contents": {
"cards": [
{
"id": "{{namespace}}.{{cardName}}",
"type": "card",
"src": "cards/{{cardName}}"
}
],
"workspaceTemplates": [
{
"id": "{{namespace}}.{{templateName}}",
"type": "workspaceTemplate",
"src": "templates/{{templateName}}"
}
],
"workflows": [
{
"id": "{{namespace}}.{{workflowName}}",
"type": "workflow",
"src": "workflows/{{workflowName}}"
}
]
},
"dependencies": {
"minSAPUI5Version": "1.87.0"
},
"metadata": {
"keywords": [
"{{keyword1}}",
"{{keyword2}}"
],
"category": "{{Category}}"
}
}
/**
* UI Integration Card Design-time Configuration
*
* This file defines the configuration editor for the card,
* allowing users to customize card settings in the Work Zone editor.
*
* Place this file at: dt/configuration.js in your card project
*
* Documentation: https://ui5.sap.com/#/topic/5b46b03f024542ba802d99d67bc1a3f4
*/
sap.ui.define(["sap/ui/integration/Designtime"], function (Designtime) {
"use strict";
return Designtime.extend("{{namespace}}.{{cardName}}.dt.Configuration", {
/**
* Create the card configuration form
*/
create: function () {
return {
form: {
items: {
// General Settings Group
generalGroup: {
type: "group",
label: "General Settings"
},
title: {
manifestpath: "/sap.card/header/title",
type: "string",
label: "Card Title",
description: "Title displayed in the card header",
required: true
},
subTitle: {
manifestpath: "/sap.card/header/subTitle",
type: "string",
label: "Card Subtitle",
description: "Subtitle displayed below the title"
},
// Data Settings Group
dataGroup: {
type: "group",
label: "Data Settings"
},
destination: {
manifestpath: "/sap.card/configuration/destinations/myDestination/name",
type: "destination",
label: "Data Destination",
description: "Select the destination for data retrieval"
},
maxItems: {
manifestpath: "/sap.card/configuration/parameters/maxItems/value",
type: "integer",
label: "Maximum Items",
description: "Maximum number of items to display",
visualization: {
type: "Slider",
settings: {
min: 1,
max: 20
}
}
},
// Display Settings Group
displayGroup: {
type: "group",
label: "Display Settings"
},
showIcon: {
manifestpath: "/sap.card/content/item/icon/visible",
type: "boolean",
label: "Show Item Icons",
description: "Display icons next to list items"
}
}
},
// Context values available from SAP Build Work Zone
// Note: Verify these paths against your tenant's Host API using getContextValue()
// Available context keys may vary by Work Zone version and configuration
context: {
"sap.workzone": {
currentUser: {
id: {
label: "Current User ID",
description: "Unique identifier of the logged-in user"
},
firstName: {
label: "Current User First Name",
description: "First name of the logged-in user"
},
lastName: {
label: "Current User Last Name",
description: "Last name of the logged-in user"
},
email: {
label: "Current User Email",
description: "Email address of the logged-in user"
}
}
// Note: currentCompany and currentWorkspace context values
// should be verified against your tenant's Host API.
// Use oHost.getContextValue("sap.workzone/...") to check availability.
}
}
};
}
});
});
{
"_version": "1.0.0",
"sap.workspaceTemplate": {
"id": "{{namespace}}.{{templateName}}",
"version": "1.0.0",
"title": "{{Template Title}}",
"description": "{{Template description for workspace creation}}",
"icon": "sap-icon://collaborate"
},
"workspace": {
"name": "{{Default Workspace Name}}",
"description": "{{Default Workspace Description}}",
"privacy": "public",
"features": {
"feeds": true,
"contentCreation": true,
"forums": true,
"knowledgeBase": true,
"events": true
}
},
"pages": [
{
"id": "overview",
"title": "Overview",
"isDefault": true,
"layout": {
"sections": [
{
"columns": 2,
"widgets": [
{
"type": "Feed",
"column": 1,
"settings": {
"title": "Recent Activity"
}
},
{
"type": "People",
"column": 2,
"settings": {
"title": "Team Members"
}
}
]
},
{
"columns": 3,
"widgets": [
{
"type": "Content",
"column": 1,
"settings": {
"title": "Documents"
}
},
{
"type": "Event",
"column": 2,
"settings": {
"title": "Upcoming Events"
}
},
{
"type": "RecentItems",
"column": 3,
"settings": {
"title": "Recent Items"
}
}
]
}
]
}
},
{
"id": "resources",
"title": "Resources",
"layout": {
"sections": [
{
"columns": 1,
"widgets": [
{
"type": "KnowledgeBase",
"column": 1,
"settings": {
"title": "Knowledge Base"
}
}
]
}
]
}
}
],
"defaultRoles": [
{
"role": "Admin",
"description": "Full workspace administration"
},
{
"role": "Member",
"description": "Standard member access"
},
{
"role": "Viewer",
"description": "Read-only access"
}
]
}