Skip to content

Latest commit

 

History

History
68 lines (45 loc) · 2.82 KB

README.md

File metadata and controls

68 lines (45 loc) · 2.82 KB

SAP Work Zone - Home Page Project

Using this template

Create a new git project and copy the content of this folder into the repository.

Project Structure

  • / folder contains the general project files for for building the artifact
  • /src folder contains the homepage manifest.json, the template zip and translations
  • /src/i18n folder contains the homepage translations text properties. Use UTF-8 encoding for translations.
  • /src/homepage.zip downloaded homepage from a SAP Work Zone

Adapt package.json

  • Change the name of the package json. This name is used to create a bundle (zip) for the homepage artifact.
    from name: sap-workzone-cpkg-homepage-sample
    to name: company-department-homepage-name

Adapt src/manifest.json

  • Manifest sap.artifact/id needs to be in your namespace, example company.department.workspace.template.name
  • Manifest sap.artifact/artifactVersion/version needs to be increased if necessary

Translations of texts

Translated texts of a homepage should be maintained in /src/i18n folder. Those will appear in a content package manager application to describe the homepage.
The .properties files should use suffix below and be UTF-8 encoded. _language_REGION.
Example i18n_en_US.properties

Create and export a Home Page from SAP Work Zone

Steps to export a Home Page

  • Open SAP Work Zone as a Company Administrator
  • Create or edit company tabs
  • Go to Administraton Console - Area & Workspace Configuration - Home page
  • Click Import and Export Home Page button and got to Export Tab
  • Choose the tabs you want to export and click Export Button and save the file.
  • Save (Replace) the file in this project under src/homepage.zip
  • If you like to deliver the home page, commit this change to git.

Import the Home Page to SAP Work Zone for testing

As a company administrator in SAP Work Zone, you can import a homepage. During Content Package installation from the customer, the import will be done automatically.

Steps to import a Home Page

  • Open SAP Work Zone as a Company Administrator
  • Go to Administraton Console - Area & Workspace Configuration - Homepage
  • Click Import and Export Home Page button and goto Import tab
  • Click Import Home Page button to upload the zip file src/homepage.zip from previous step

Usage of this project's homepage for a Content Package

SAP Work Zone will be able to install Content Packages that can contain Home Pages. To create a Content Package you should use following template provided by SAP Work Zone:

https://github.com/SAP-samples/workzone-content-package-templates/tree/main/content-package

While creating a Content Package, the build step of the content package will call

npm install
npm run-script build

of this project to create the corresponding zip bundle and include it into the content package.