267 lines
6.5 KiB
Markdown
267 lines
6.5 KiB
Markdown
# 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](https://github.com/SAP-docs/sap-btp-build-work-zone-advanced/tree/main/docs/30-ContentPackages)
|
|
|
|
## Table of Contents
|
|
|
|
- [Overview](#overview)
|
|
- [Package Types](#package-types)
|
|
- [Global Content Packages](#global-content-packages)
|
|
- [Local Content Packages](#local-content-packages)
|
|
- [Supported Content Items](#supported-content-items)
|
|
- [Creating a Content Package](#creating-a-content-package)
|
|
- [Package Manifest](#package-manifest)
|
|
- [Deploying Content Packages](#deploying-content-packages)
|
|
- [Package Management](#package-management)
|
|
- [Updating Content Packages](#updating-content-packages)
|
|
- [Project Structure](#project-structure)
|
|
- [Post-Creation Actions](#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
|
|
|
|
```json
|
|
{
|
|
"_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:
|
|
|
|
```json
|
|
{
|
|
"sap.package": {
|
|
"id": "com.company.mypackage",
|
|
"prerequisites": {
|
|
"destinations": [
|
|
{
|
|
"name": "MyDestination",
|
|
"document": "[https://documentation.url"](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**:
|
|
- Content Packages: [https://help.sap.com/docs/build-work-zone-advanced-edition](https://help.sap.com/docs/build-work-zone-advanced-edition)
|
|
- GitHub: [https://github.com/SAP-docs/sap-btp-build-work-zone-advanced/tree/main/docs/30-ContentPackages](https://github.com/SAP-docs/sap-btp-build-work-zone-advanced/tree/main/docs/30-ContentPackages)
|