6.8 KiB
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
- 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
- Navigate to Administration Console
- Select "New Area"
- Configure area settings
- Assign area administrators
- 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
- Navigate to Workspaces menu
- Select "Create Workspace"
- Configure settings:
- Name and description
- Privacy settings
- Member permissions
- Create workspace
From Template
- Navigate to Workspaces menu
- Select "Create Workspace"
- Choose template
- Customize as needed
- 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
- Navigate to workspace
- Select "Add Page"
- Choose template or blank layout
- Configure sections and columns
- Add widgets and content
- 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
- Clear purpose - Define workspace goal
- Logical structure - Organize workpages logically
- Appropriate permissions - Limit access as needed
- Active moderation - Maintain content quality
Workpage Design
- Grid efficiency - Use appropriate column counts
- Widget organization - Group related content
- Mobile consideration - Test on mobile devices
- Performance - Limit widgets per page
Sub-Workspace Usage
- Clear hierarchy - Logical parent-child relationships
- Appropriate scope - Don't over-nest
- Consistent membership - Align with main workspace
Documentation Links: