isabella232 / cloud-samples-itelo

A sample business application for the application programming model for SAP Cloud Platform showcasing a CDS extension scenario.

Important Notice

This public repository is read-only and no longer maintained.

Samples for the Application Programming Model for SAP Cloud Platform

The following samples give you more hands-on practice with the application programming model for SAP Cloud Platform:

• Part 1 - Foundation
• Part 2 - Product Catalog
• Part 3 - ITelO Catalog (current repository)

Part 3: ITelO Catalog (Extension Scenario)

The ITelO Catalog shows a sample business application implemented by a team of the fictitious company ITelO. This team needed to implement a product catalog. Looking through available CDS reuse models, they found the Product Catalog. As an extra requirement, the team needed to include product reviews as an additional source of information for the editor of the product catalog. Unfortunately, reviews are not modeled in the Product Catalog. Thanks to the application programming model for SAP Cloud Platform they could solve this issue by simply extending the service with additional review entities.

Technically the sample consists of:

• a CDS model (find more information here)
• an automatic Java OData V2 exposure extended by individual business logic (find more information here)
• a UI based on SAP Fiori elements (find more information here).

This application is only an example and not intended for productive use.

Component Overview

Requirements

SAP Web IDE Full-Stack access is needed. For more information, see Open SAP Web IDE.

Development in SAP Cloud Platform Web IDE

Read the getting started tutorial to learn more about working with SAP Cloud Platform Web IDE.

Now clone your fork of this repository (File -> Git -> Clone Repository).

Develop, Build, Deploy

To build and deploy your application or modify it and redeploy, use any of the following options:

• Build and deploy the DB module by choosing Build from the context menu of the db folder.

• Build and deploy the Java service by choosing Run -> Run as -> Java application from the context menu of the srv folder. To test the service, click the URL displayed in the Run Console. Use the endpoint of the service clouds.products.CatalogService to call $metadata or CRUD requests.

• Test the UI by choosing Run -> Run as -> SAP Fiori Launchpad Sandbox from the context menu of the app folder. Click on the app tile to launch the application.

Known Issues

• The read only field Availability is enabled occasionally when creating a new Product.

• Requesting reviews on the product object page causes a CDSRuntimeException.INTERNAL_ERROR when using SAP HANA 2.0 SPS 0.

• When running the module "srv" as Java Application the log shows "CfDeployException: Failed to deploy application". In the file "mta.yaml", change all occurrences of "itelo-java" to "srv". Repeat build and run.

Support

This project is being maintained. Please log any issues in the GitHub issues tracking system.

There are no new releases planned at this time.

License

Copyright (c) 2018 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, Version 2.0 except as noted otherwise in the LICENSE file.