SAP Build Work Zone (Advanced Edition)

Central entry point for SAP business applications — unified shell for Fiori, CAP, custom UIs, and external content.

Prerequisites

• SAP BTP subaccount with SAP Build Work Zone, advanced edition entitlement
• Admin role assigned: AuthGroup_SpaceAdmin
• Content manager role: SAP_APP_FND_LAUNCHPAD_CONTENT_MANAGER
• BTP destinations configured to backend systems (S/4HANA, CAP apps, etc.)
• Principal propagation enabled on destinations for federated content

Steps

1. Federate S/4HANA Fiori Apps

1. Open Work Zone Admin Console → Content → Content Providers
2. Click Add Content Provider → Type: SAP S/4HANA or SAP BTP ABAP
3. Select the BTP destination pointing to your S/4HANA backend
4. Configure: Destination with PrincipalPropagation authentication
5. Click Fetch Content → catalogs and groups auto-discovered
6. Navigate to Content Manager → assign catalogs/groups to roles

2. Federate CAP Applications

1. Content Provider → Type: SAP BTP
2. Enter CAP app URL (e.g., https://my-app.cfapps.us10.hana.ondemand.com)
3. Ensure CAP app has Fiori launchpad plugin manifest in app/ directory
4. Fetch content → apps appear in Content Manager

3. Create a UI Integration Card

Create a card manifest JSON file:

{
  "sap.app": { "id": "my.card", "type": "card" },
  "sap.card": {
    "type": "List",
    "header": {
      "title": "Open Purchase Orders",
      "icon": { "src": "sap-icon://purchase-order" }
    },
    "content": {
      "data": {
        "request": {
          "url": "{{destinations.s4}}/sap/opu/odata/sap/Z_PO_SRV/PO_HEADER?$top=5"
        }
      },
      "item": {
        "title": "{PurchaseOrder}",
        "description": "{Supplier}",
        "info": { "value": "{NetAmount}" }
      }
    }
  }
}

Deploy via:

# Upload card via Admin Console → UI Integration Cards → Import
# Or deploy via MTA with card resource type
mbt build && cf deploy mta_archives/my-workzone-content.mtar

4. Configure Workspace Templates

1. Admin Console → Workspace Templates → Create
2. Select template type:
   • Project Workspace: tasks + documents + team
   • Department Workspace: KPIs + apps + news
   • Process Workspace: workflow steps + approvals
3. Add widgets and apps to the template layout
4. Save and assign to roles for self-service workspace creation

5. Enable SAP Mobile Start

1. Admin Console → Settings → SAP Mobile Start
2. Ensure Work Zone content is published (apps, cards visible in Content Manager)
3. Configure push notifications via SAP Notification service binding
4. Mobile users: install SAP Mobile Start app → scan QR code from Work Zone
5. Offline-capable cards require marking them as offline-enabled in card manifest

6. Configure Role-Based Homepage

1. Admin Console → Home Page → Edit Layout
2. Add sections: visualizations, cards, app launcher tiles
3. Assign visibility by role (e.g., Sales_Manager sees different tiles than Employee)
4. Save → users see personalized homepage based on their role assignment

Pitfalls

Verification

# Check content provider status
curl -s https://<workzone-host>/api/v1/contentproviders \
  -H "Authorization: Bearer $TOKEN" | jq '.[].status'

# Verify card endpoint resolves
curl -s "{{destinations.s4}}/sap/opu/odata/sap/Z_PO_SRV/PO_HEADER?\$top=1" \
  -H "Authorization: Bearer $TOKEN" | jq '.d.results[0]'

# Confirm workspace template is active
curl -s https://<workzone-host>/api/v1/workspacetemplates \
  -H "Authorization: Bearer $TOKEN" | jq '.[].status'

Checklist:

• Content providers show status ACTIVE in Admin Console
• Federated Fiori apps appear in Content Manager and are assigned to roles
• UI Integration Cards render data correctly in preview
• Workspace template is published and self-service creation works
• Mobile Start app shows Work Zone homepage after QR scan
• Role-based homepage shows correct tiles for each test role