diff --git a/docs/abap-cloud-9aaaf65.md b/docs/abap-cloud-9aaaf65.md index 41b3c5a..33c6a9f 100644 --- a/docs/abap-cloud-9aaaf65.md +++ b/docs/abap-cloud-9aaaf65.md @@ -2,63 +2,3 @@ # ABAP Cloud - - - - -## Overview - -The technological core of [ABAP Cloud](https://help.sap.com/docs/abap-cloud/abap-cloud/why-abap-cloud) defines the design-time and runtime architecture of all extensions, services, and applications. The main ABAP Cloud elements are: - -- ABAP Core Data Services \(CDS\) for the data model and for embedded analytics - -- The ABAP RESTful Application Programming Model \(RAP\) - -- The cloud-optimized ABAP language for the business logic - -- Mandatory public SAP APIs and extension points to allow automated cloud operations and lifecycle stable extensibility - -- ABAP Development Tools \(ADT\) in Eclipse as the ABAP integrated development environment - - -Building on these key elements, you can use ABAP Cloud to cover the following scenarios: - -- **Transactional \(OLTP\)**: With ABAP Cloud you can build business objects and expose them as services, to consume them in UIs and integration scenarios. All standard behavior is supported \(create, read, update, delete\). - -- **Analytical \(OLAP\)**: ABAP Cloud is equally equipped for creating services and UIs for data analysis, and for drilling down in multiple dimensions, like integrating the data in SAP Analytics Cloud. - -- **Integration**: Both previous aspects are complemented by strong data and application integration to cater to today’s service-oriented environments. - - -The development model has two additional two key differentiators: - -- The **reuse services and libraries** with core business services like number ranges, application jobs, an ABAP-integrated SAP Fiori launchpad, and UI repository to deploy SAPUI5 and SAP Fiori elements user interfaces. - -- The **built-in qualities** offering end-to-end extensibility in the programming model, major cloud qualities like scalability and upgrade stable APIs, and many more. - - - - - - -## Use Cases for Developing with ABAP Cloud - -With ABAP Cloud, you can cover a variety of use cases for different scenarios. The development path is structured according to the consumers: Either the consumer is a user or system, meaning either you want to create an app to manipulate or display data or you want to exchange data between systems with different protocols to create business processes with system-to-system communication. - -With ABAP Cloud, you can develop transactional and analytical apps. Transactional applications have transactional characteristics to create, update or delete data records whereas analytical applications only read and display data in charts or dashboards. - -All applications and services developed with ABAP Cloud are by default multitenant enabled. Partners can use the [SAP BTP, ABAP environment](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/abap-environment) Software-as-a-Service tooling to easily build, deploy, and operate Software-as-a-Service solutions on their own. - -Integration services enable system-to-system communication for different protocols. In ABAP Cloud, integration services can be used for process integration or data integration. With process integration, the communication is structured along a predefined business process like, for example, order-to-cash. Data integration in contrast focuses on transferring raw data without any relation to a business process. - -**Related Information** - - -[Design](design-314ae3e.md "") - -[Develop](develop-c8906e4.md "") - -[Deploy](deploy-d7aec3c.md "") - -[Operate with SAP Cloud ALM](operate-with-sap-cloud-alm-f7f2977.md "") - diff --git a/docs/abap-cloud-roadmap-48150e1.md b/docs/abap-cloud-roadmap-48150e1.md new file mode 100644 index 0000000..b54f109 --- /dev/null +++ b/docs/abap-cloud-roadmap-48150e1.md @@ -0,0 +1,4 @@ + + +# ABAP Cloud Roadmap + diff --git a/docs/add-user-interface-9f1d42e.md b/docs/add-user-interface-9f1d42e.md new file mode 100644 index 0000000..deaa7b2 --- /dev/null +++ b/docs/add-user-interface-9f1d42e.md @@ -0,0 +1,98 @@ + + +# Add User Interface + +SAPUI5 has guidelines for a wide range of developers and SAP Fiori is a set of design and guideline choices using SAPUI5. + +If it is a new standard project, use SAPUI5 or SAP Fiori as it has the complete set of controls and provides the best support. + +If a project is using HTML or an External framework for example it is a UI that has been part of a company that was acquired, use a micro frontend framework like Luigi to integrate with other pages, Launchpad, and others, and slowly migrate to SAPUI5. To ease the migration or if the UI will not be further developed, then SAPUI5 Provides CSS Libraries, reusable web components and guidance for a few frameworks to match the visual style and guidelines. + + + + + +## Recommendations When Using SAPUI5 + +When usign SAPUI5, consider the following recommendations: + +- [When to Use SAPUI5 and OpenUI5](https://sdk.openui5.org/topic/5982a9734748474aa8d4af9c3d8f31c0) + +- [Reusing UI Parts: Fragments](https://sdk.openui5.org/topic/36a5b130076e4b4aac2c27eebf324909) + +- [Folder Structure of Your UI Project: Where to Put Your Files](https://sdk.openui5.org/topic/003f755d46d34dd1bbce9ffe08c8d46a) + +- [Modules for Reusing JavaScript Code](https://sdk.openui5.org/topic/91f23a736f4d1014b6dd926db0e91070) + +- [Development Model: Model View Controller](https://sdk.openui5.org/topic/91f233476f4d1014b6dd926db0e91070) + +- [Communicating Between Model and View: Data Binding](https://sdk.openui5.org/topic/68b9644a253741e8a4b9e4279a35c247) + +- [Providing Error, Warning, and Info Messages](https://sdk.openui5.org/topic/62b1481d3e084cb49dd30956d183c6a0) + +- [Routing and Navigation](https://sdk.openui5.org/topic/3d18f20bd2294228acb6910d8e8a5fb5) + +- [Optimizing Applications](https://sdk.openui5.org/topic/2f492c438a16427e8f84d8436ea9cf77), [Speeding Up Applications](https://sdk.openui5.org/topic/408b40efed3c416681e1bd8cdd8910d4), and [Avoiding Common Performance Issues](https://sdk.openui5.org/topic/966d67c8cc5046419d1b35556cd9e447) + +- [Testing UI Applications](https://sdk.openui5.org/topic/7cdee404cac441888539ed7bfe076e57) + +- [Accessibility Features](https://sdk.openui5.org/topic/322f55d0cf1e4b459cc1911c899b7a5f), [Stable IDs](https://sdk.openui5.org/topic/f51dbb78e7d5448e838cdc04bdf65403), and [Accessibility Aspects for Application Development](https://sdk.openui5.org/topic/03b914b46e624b138a6fb1b7cf2049ae) + +- [Theming](https://sdk.openui5.org/topic/497c27a8ee26426faacd2b8a1751794a) + +- Avoing [Coding Issues](https://sdk.openui5.org/topic/387787232c214b42954f18c93a28560a) and [Security Issues](https://sdk.openui5.org/topic/91f3d8706f4d1014b6dd926db0e91070) + + + + + + +## Issues When Not Using SAPUI5 + +These are the issues that you have to consider if you are not using SAPUI5: + +- Custom controls break consistency. + +- Extensibility is defined for SAPUI5 and would be different for other frameworks and may require knowledge of these frameworks. + +- Support and stable releases for a longer duration are provided by SAPUI5 compared to the other frameworks. + +- SAPUI5 ensures a product standard support on application level. The Web Components and Component Toolkits for the different Web UI Frameworks ensure a product standard compliance on UI element level. + +- For LC/NC support, only SAPUI5 is supported. + + + + + + +## SAP Fiori Guidelines + +Use the following guidelines when designing and implementing your UI appication: + +- [Which UI Technology Supports Your Platform](https://experience.sap.com/fiori-design-web/sap-fiori/) + +- [SAP Fiori Design Principles](https://experience.sap.com/fiori-design-web/design-principles/), [Guidelines for Designing Cross-Platform User Interfaces](https://experience.sap.com/fiori-design-web/responsiveness-adaptiveness/), and [Guidelines for Different Platforms](https://experience.sap.com/fiori-design/) + +- [Accessibility Guidelines](https://experience.sap.com/fiori-design-web/accessibility-in-sap-fiori/) + +- [Develop SAP Fiori Applications with SAP Fiori Tools](https://help.sap.com/docs/SAP_FIORI_tools/17d50220bcd848aa854c9c182d65b699/f09752ebcf63473e9194ea29ca232e56.html) + + + + + + +## Reference Information + +For more information, use the following resources: + +- [SAPUI5 Demokit](https://sapui5.hana.ondemand.com/sdk/#/topic) + +- [SAP BTP UI Technology Guideline](https://sap.sharepoint.com/teams/UIGuideline/Shared%20Documents/Forms/AllItems.aspx?id=%2Fteams%2FUIGuideline%2FShared%20Documents%2FGeneral%2FUITechnologyGuideline%2Epdf&parent=%2Fteams%2FUIGuideline%2FShared%20Documents%2FGeneral) + +- [SAP Fiori tools](https://help.sap.com/docs/SAP_FIORI_tools) + +- [SAP Fiori for Web](https://experience.sap.com/fiori-design-web/) + + diff --git a/docs/analytical-application-b845c85.md b/docs/analytical-application-b845c85.md new file mode 100644 index 0000000..0c0fa27 --- /dev/null +++ b/docs/analytical-application-b845c85.md @@ -0,0 +1,4 @@ + + +# Analytical Application + diff --git a/docs/building-blocks-03139be.md b/docs/building-blocks-03139be.md deleted file mode 100644 index 1bd82e4..0000000 --- a/docs/building-blocks-03139be.md +++ /dev/null @@ -1,38 +0,0 @@ - - -# Building Blocks - -In the SAP BTP Developer’s Guide you can find more about the standards that you should follow when developing cloud applications, an overview of the basic SAP BTP concepts, a list of important services you can use, and what is the optimal and fast way to set up your development environment depending on the technologies you are using. - - - - - -## Business Application Services - -As business applications are having common characteristics, you can benefit from an open architecture with as few as possible, but well documented, technology choices. - -The architecure blueprint outlines ABAP Cloud and SAP Cloud Application Programming Model \(CAP\) as the best architecture styles to implement business applications. Both programming models integrate with SAP BTP services. - -See [Business Application Services](business-application-services-f3641a5.md). - - - - - -## Basic Platform Setup - -SAP Business Technology Platform \(SAP BTP\) is an integrated offering comprised of five technology portfolios: application development, automation, integration, data and analytics, and AI. The platform offers users the ability to turn data into business value, compose end-to-end business processes, and build and extend SAP applications quickly. Access all SAP BTP resources on the product page: [SAP Business Technology Platform \(SAP BTP\)](https://help.sap.com/docs/btp?version=Cloud). - -Learn about basic concepts, such as setting up the correct organizational structure to creating an account and managing users and members. See [Basic Platform Setup](basic-platform-setup-3b774f8.md). - - - - - -## Development Environment - -SAP BTP supports Cloud Foundry, Kyma, and ABAP runtimes. It features a number of tools and programming languages that increase your flexibility and freedom when developing applications. You can choose the runtime that best suits your use cases and skill set and get to work. You also have the possibility to integrate applications you’ve built with other solutions by SAP. - -See [Software Development and Delivery](software-development-and-delivery-511cac8.md). - diff --git a/docs/business-application-services-f3641a5.md b/docs/business-application-services-f3641a5.md index 9f94174..13a0266 100644 --- a/docs/business-application-services-f3641a5.md +++ b/docs/business-application-services-f3641a5.md @@ -607,7 +607,7 @@ Use Data Privacy Integration service to make your SAP BTP application compliant Workflow - + [SAP Task Center](https://help.sap.com/docs/task-center/sap-task-center/what-is-sap-task-center?version=Cloud) @@ -615,13 +615,12 @@ SAP Task Center service enables integration with SAP applications to provide a s Use SAP Task Center as a unified inbox for tasks across multiple applications with integrated user experience. Tasks from multiple SAP solutions are gathered in one list and ready to be processed in just one click, shortening the completion time for business-critical tasks. For example, business users can process all their tasks from the connected systems, without the need to switch and log in separately into different inboxes. -[SAP Build Process Automation](https://help.sap.com/docs/build-process-automation/sap-build-process-automation/what-is-sap-build-process-automation?version=Cloud) - -SAP Build Process Automation provides a simpler and faster way to adapt, improve, and innovate business processes with drag-and-drop simplicity. + + -The solution combines workflow management, SAP Intelligent Robotic Process Automation \(SAP Intelligent RPA\) functionality, decision management, process visibility, and embedded AI capabilities into one intuitive low-code experience. +[Proxy API for the Workflow Capability](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/proxy-api-for-workflow-capability) -You can jumpstart automation projects with hundreds of process content packages, SAP Intelligent RPA bots and connectors designed specifically to enhance the capabilities of the SAP solutions you are using. It provides a unified development experience for users of all skill levels enabling fusion teams of business experts and developers to work together and solve challenges faster. +There is a released local ABAP API to use the SAP BTP Workflow capabilities. @@ -726,9 +725,11 @@ Low Code/No Code -[SAP Build](https://help.sap.com/docs/SAP%20Build/9d385a1842594230993661ca78dce150/7e50fa5e724c49d1a4352848275fd3cc.html?version=Cloud) +[SAP Build Process Automation](https://help.sap.com/docs/build-process-automation/sap-build-process-automation/what-is-sap-build-process-automation?version=Cloud) + +The solution combines workflow management, SAP Intelligent Robotic Process Automation \(SAP Intelligent RPA\) functionality, decision management, process visibility, and embedded AI capabilities into one intuitive low-code experience. -SAP Build is a low-code offering to accelerate development and automation. It enables you to create enterprise apps \(SAP Build Apps\), automate processes \(SAP Build Process Automation\), and design business sites \(SAP Build Work Zone\) without writing code. Accelerate development with prebuilt connectors and business content for SAP and third-party systems to integrate seamlessly. SAP Build fosters collaboration between business and development teams with built-in governance and lifecycle management. +You can jumpstart automation projects with hundreds of process content packages, SAP Intelligent RPA bots and connectors designed specifically to enhance the capabilities of the SAP solutions you are using. It provides a unified development experience for users of all skill levels enabling fusion teams of business experts and developers to work together and solve challenges faster. diff --git a/docs/deploy-d7aec3c.md b/docs/deploy-d7aec3c.md index bf4f07a..dbd04ff 100644 --- a/docs/deploy-d7aec3c.md +++ b/docs/deploy-d7aec3c.md @@ -2,61 +2,3 @@ # Deploy - - - - -## Common Setup - -The deployment of developed ABAP Cloud objects and entire applications is supported by administration apps delivered with SAP BTP, ABAP environment. The respective ABAP systems run on Gardener or Kubernetes-based infrastructure, but such technical details are hidden for developers and administrators. The important part of the deployment strategy is the definition and setup of the respective System Landscape. A typical system landscape consists of three ABAP systems for development, test and productive use. See [System Landscape/Account Model](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/concepts#loio4ca756395fc24e56a42b77632a6bd862). - -The basic entity for the deployment is a software components. Software components are maintained with the administrators app Manage Software Components. A hidden Git repo is automatically managed per software component based on gCTS for transport management. Software components can be imported into test and productive systems. This process can be automated via Piper pipelines including steps like automated test using ABAP Test Cockpit \(ATC\). You can also use SAP Cloud Transport Management to handle the propagation of your changes in SAP BTP, ABAP environment. - -The common setup is sufficient for customers to run their own applications. - -For more information, see: - -- [Software Components](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/software-components) - -- [Manage Software Components](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/manage-software-components) - -- [ABAP Environment Pipeline](https://www.project-piper.io/pipelines/abapEnvironment/introduction/) - - - - - - -## Additional Considerations for Partners - -There are two different models how to offer and deploy your solution. - -1. As a multitenant SaaS solution: - - - You offer a cloud service - - - Your customers can subscribe to your service and getting an own tenant in your central provider system - - - The application monitoring is in your responsibility and also managing the infrastructure costs - - - Even for this scenario, Field Extensibility and Custom Logic is offered for key users on customer side \(tenant-aware\) - - -2. As an installable product: - - - You offer the product as an Add-on; the product can also be an SDK - - - Your customers need to have an own SAP BTP, ABAP environment instance - - - The installation of the product and patches is in the responsibility of your customers - - - The installation will be possible via Landscape Portal on customer side - - - The customer can extend your product via ADT. See the developer extensibility option in the [Development Use Cases](development-use-cases-4efd0bc.md) page. - - - -For both models, partners can build solutions based on software components with the help of the Landscape Portal to set up multitenant SaaS solutions or to offer installable products like SDKs for other customers and partners. - -The Landscape Portal is a collection of administrator apps and is part of the SAP BTP, ABAP environment. See [Landscape Portal](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/landscape-portal). - diff --git a/docs/design-dcdc2d9.md b/docs/design-dcdc2d9.md index 84a3f56..7b1901c 100644 --- a/docs/design-dcdc2d9.md +++ b/docs/design-dcdc2d9.md @@ -2,68 +2,3 @@ # Design - - - - -## CAP Design Principles - -SAP Cloud Application Programming Model \(CAP\) focuses on the domain of the application, by capturing domain knowledge and intent instead of imperative coding. This means: - -- Close collaboration of developers and domain experts in domain modeling. - -- Out-of-the-box implementations for best practices and recurring tasks. - -- Platform-agnostic approach to avoid lock-ins, hence protecting investments. - - - - - - -## Agnostic Design - -CAP avoids technology lock-ins through higher-level concepts and APIs, which abstract low-level platform features and protocols to a large extent. In particular, this applies to: - -- Platform-specific deployment approaches and techniques - -- Platform-specific identity providers and authentication strategies - -- Onboarding and offboarding of tenants in Software-as-a-Service \(SaaS\) solutions and tenant isolation - -- Synchronous protocols like REST, OData, or GraphQL - -- Asynchronous channels and brokers like SAP Event Mesh, Message Queue, or Kafka  - -- Different database technologies including SQL and NoSQL - - -These abstractions allow CAP to quickly adapt to new emerging technologies or platforms, without affecting the application code. - - - - - -## Open and Opinionated Design - -While CAP certainly gives opinionated guidance, it does this without sacrificing openness and flexibility. You as a developer stay in control of which tools or technologies to choose, or which architecture patterns to follow. - -- All abstractions follow a glass-box pattern that allows unrestricted access to lower-level things, if necessary. - -- Best Practices served out of the box with generic solutions for many recurring tasks. - -- Out-of-the-box support for SAP Fiori and SAP HANA. - -- Dedicated tools support provided in SAP Business Application Studio, and Visual Studio Code or Eclipse. - - - - - - -## Domain-Driven Design - -CAP uses Core Data Services as its ubiquitous modelling language, with Core Data Service Aspects separating core domain aspects from generic aspects.Core Data Service's human-readable nature fosters collaboration of developers and domain experts. - -As Core Data Service models are used to fuel generic providers — the database as well as application services — CAP ensures that the models are applied in the implementation. And as coding is minimized you can more easily refine and revise their models, without having to refactor large boilerplate code bases. - diff --git a/docs/develop-58df1d6.md b/docs/develop-58df1d6.md index f494598..7820f90 100644 --- a/docs/develop-58df1d6.md +++ b/docs/develop-58df1d6.md @@ -2,217 +2,128 @@ # Develop -Learn more about developing applications using SAP Cloud Application Programming Model \(CAP\). +Learn more about developing applications on the SAP BTP, Cloud Foundry environment. +> ### Note: +> Direct reuse from [SAP BTP Core documentation](https://help.sap.com/docs/btp/sap-business-technology-platform/development-in-cloud-foundry-environment?version=Cloud). - -## SAP Cloud Application Programming Model \(CAP\) - -SAP Cloud Application Programming Model \(CAP\) is a framework of languages, libraries, and tools for building enterprise-grade services and applications. It guides you along the best practices you can use to develop your applications on SAP BTP. - -Core Data and Services can be used as business level data definition source, and to generate the artifacts at the persistence layer, generate the application service layer and also be used to define visual aspects relating to the data, with those definitions \(annotations\) defining the UI layer. See [Core Data and Services \(CDS\) Language Reference Documentation](https://help.sap.com/docs/btp/sap-business-technology-platform/core-data-and-services-cds-language-reference-documentation?version=Cloud). - -CAP framework provides strong support for programming languages like Node.js and Java allowing you to build server-side logic, handle requests and responses. - -The following is the list of the most prominent tasks within scope of developing a full-stack application using CAP. - -- Domain modeling - - Most projects start with capturing the essential objects of their domain in a respective domain model. Find here an introduction to the basics of domain modeling with Core Data and Services, complemented with recommended best practices. See [Domain Modeling](https://cap.cloud.sap/docs/guides/domain-modeling). - -- Providing services - - This learn how to define and implement services, leveraging generic implementations provided by the CAP runtimes, complemented by domain-specific custom logic, see [Providing Services](https://cap.cloud.sap/docs/guides/providing-services). - -- Development of user interface - - To learn how to create applications with rich user interfaces for modern Web business applications, responsive across browsers and devices, based on HTML5, see [Developing Apps](https://sapui5.hana.ondemand.com/#/topic/23cfd955f58142389fa7c9097e11559c). - -- Consuming services - - To learn how to use uniform APIs to consume local or remote services, see [Consuming Services](https://cap.cloud.sap/docs/guides/using-services). - -- Databases - - To learn how to use databases with CAP applications, see [Using Databases](https://cap.cloud.sap/docs/guides/databases). - - Out of the box-support is provided for SAP HANA, SQLite, H2 \(Java only\), and PostgreSQL. - -- Messaging - - CAP provides intrinsic support for emitting and receiving events. This is complemented by the messaging services connecting to message brokers to exchange event messages across remote services. See [Events and Messaging](https://cap.cloud.sap/docs/guides/messaging/). - -- Authentication - - Authenticating users on incoming HTTP requests is achieved by authentication middleware which is then used in authorization enforcement decisions. See [Authentication](https://cap.cloud.sap/docs/node.js/authentication). - -- Authorization - - To restrict access to data by adding respective declarations to the models of the Core Data and Services, which are then enforced in service implementations, see [Authorization and Access Control](https://cap.cloud.sap/docs/guides/authorization). - -- Localization, and internationalization - - To internationalize your application to provide localized versions with respect to both Localized Models as well as Localized Data, see [Localization, i18n](https://cap.cloud.sap/docs/guides/i18n). - -- Localized data - - To localize and internationalize static content, such as labels or messages, and to serve localized versions of actual application data, see [Localized Data](https://cap.cloud.sap/docs/guides/localized-data). - -- Temporal data - - CAP provides out-of-the-box support for declaring and serving date-effective entities with application-controlled validity, in particular to serve as-of-now and time-travel queries. See [Temporal Data](https://cap.cloud.sap/docs/guides/temporal-data). - -- Media data + - CAP provides out-of-the-box support for serving media and other binary data. See [Serving Media Data](https://cap.cloud.sap/docs/guides/media-data). +## Overview -- Data privacy +SAP BTP, Cloud Foundry environment is an open Platform-as-a-Service \(PaaS\) targeted at microservice development and orchestration. - CAP helps application projects to comply with data privacy regulations using SAP BTP services. See [Managing Data Privacy](https://cap.cloud.sap/docs/guides/data-privacy/). -- Security +
+
- To develop, deploy and operate CAP applications in a secure way, see [CAP Security Guide](https://cap.cloud.sap/docs/guides/security/). +Develop polyglot applications -- Multitenancy +
+
- Get to know the fundamental concepts of multitenancy, underpinning SaaS solutions in CAP. To learn how to run and test applications in multitenancy mode with minimized setup and overhead, see [Multitenancy](https://cap.cloud.sap/docs/guides/multitenancy/). +Build on open standards with SAP Java, Node.js, and Python buildpacks or bring your own language with community buildpacks for PHP, Ruby, Go. -- Extensibility - Learn about the intrinsic capabilities to extend your applications in verticalization and customization scenarios. See [Extensibility](https://cap.cloud.sap/docs/guides/extensibility/). -- Test +
- To learn how to test a CAP application, see [Testing with cds.test](https://cap.cloud.sap/docs/node.js/cds-test). +Manage the lifecycle of applications +
+
+Start, stop, scale, and configure distributed cloud applications using standard Cloud Foundry tools, our web-based administration user interface for SAP BTP, and dev-ops capabilities. - -## Runtimes +
-**** +Optimize development and operations +
+
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+Use the rich set of SAP BTP services including messaging, persistence, and many other capabilities, such as built-in security, compliance, elastic scale, and high-availability setup. - +
-Cloud Foundry +Use the application programming model -
 + +
-Kyma +Use programming languages, libraries, and APIs tailored for full-stack application development. -
+
-
 +Manage Cloud Foundry orgs and spaces -SAP BTP, Cloud Foundry environment is an open Platform-as-a-Service \(PaaS\) targeted at microservice development and orchestration. + +
-
 +Create and delete Cloud Foundry orgs and spaces and add members. Create, assign, and change space quota plans. -SAP BTP, Kyma runtime is a fully managed Kubernetes-based runtime that enables the development and operation of cloud-native, enterprise-garde applications that can seamlessly consume Multi-Cloud Foundation Services. -
-Develop polyglot applications +
-
 +Use built-in cloud-native capabilities -Build on open standards with SAP Java, Node.js, and Python buildpacks or bring your own language with community buildpacks for PHP, Ruby, Go. + +
-
 +Utilize cloud-native principles built into the platform, such as containerization and multitenancy, to create resilient, portable, and efficient applications. -With Kyma, you can choose any preferred language or application that can be containerized. The available Kyma modules reduce the development effort and the application time to market. -
-Manage the lifecycle of applications + + - -Start, stop, scale, and configure distributed cloud applications using standard Cloud Foundry tools, our web-based administration user interface for SAP BTP, and dev-ops capabilities. - +The following graphic is designed to help you find the information you need for your programming purposes. The bottom row represents the tools, frameworks, services, and deployment options recommended by SAP. If you want full flexibility you can also bring your own development tools and languages, as shown in the top row. -Deploy and upgrade applications and take advantage of the native autoscaling functionality of Kubernetes that manages the scaling for you. Get familiar with our user interface, Kyma Dashboard, or automate with standard CI/CD tools most of which support Kubernetes. -
-Optimize development and operations + - +## Development Options Overview -Use the rich set of SAP BTP services including messaging, persistence, and many other capabilities. +![](images/Image_Map_Development_Options_Overview_d716bab.png) - -As Kyma is fully managed, upgrades for your Kubernetes cluster and base images are handled for you to save you time. -
+ -Use the application programming model +## The Recommended Path - +This development approach offers guidance for important development decisions and features proven best practices recommended by SAP. You can follow a model path for application and service development that is based on the Cloud Application Programming Model \(CAP\). When working with CAP, we recommend using Java and Node.js because they receive the highest level of tool support and are well suited for most use cases. This path provides you with a list of key aspects to consider, but the order shown in these steps isn't mandatory. You can adapt the steps as you wish to better fit your use case. -Use programming languages, libraries, and APIs tailored for full-stack application development. -
+ +## Choose Your Own Path - +You're not forced to use one language exclusively, but can choose between Java, Node.js, and Python. -## Development Options Overview +For more information on the supported programming languages, see: -The following graphic is designed to help you find the information you need for your programming purposes. The bottom row represents the tools, frameworks, services, and deployment options recommended by SAP. If you want full flexibility you can also bring your own development tools and languages, as shown in the top row. +- [Developing Java in the Cloud Foundry Environment](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Validation/en-US/a3f90069d6cd41da82f34a6123d82ce6.html "Find selected information for Java development on SAP BTP, Cloud Foundry and references to more detailed sources.") :arrow_upper_right: -![](images/Image_Map_Development_Options_Overview_d716bab.png) +- [Developing Node.js in the Cloud Foundry Environment](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Validation/en-US/3a7a0bece0d044eca59495965d8a0237.html "This section offers selected information for Node.js development on SAP BTP, Cloud Foundry and references to more detailed sources.") :arrow_upper_right: +- [Developing Python in the Cloud Foundry Environment](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Validation/en-US/acf8f49356d047fbb1a4d04dcec3fd36.html "This section offers selected information for Python development on the SAP BTP, Cloud Foundry environment and references to more detailed sources.") :arrow_upper_right: - -## The Recommended Path -This development approach offers guidance for important development decisions and features proven best practices recommended by SAP. You can follow a model path for application and service development that is based on the Cloud Application Programming Model \(CAP\). When working with CAP, we recommend using Java and Node.js because they receive the highest level of tool support and are well suited for most use cases. This path provides you with a list of key aspects to consider, but the order shown in these steps isn't mandatory. You can adapt the steps as you wish to better fit your use case. +If you already have monolithic applications running on SAP BTP and are looking for a way to run them in the Cloud Foundry environment, read our migration best practice guide. See [Migrating from the Neo Environment to the Multi-Cloud Foundation for SAP BTP (Cloud Foundry and Kyma)](https://help.sap.com/viewer/b017fc4f944e4eb5b31501b3d1b6a1f0/Validation/en-US/aae4e0ae1cdf434b908c3c8cf3ea942a.html "Learn why and how to migrate scenarios from the Neo environment to the multi-cloud foundation for SAP BTP. This guide is for SAP Business Technology Platform (SAP BTP) customers with scenarios in the Neo environment that need to move to the multi-cloud foundation, including the Cloud Foundry environment or the Kyma environment.") :arrow_upper_right:. diff --git a/docs/develop-a-transactional-application-373046e.md b/docs/develop-a-transactional-application-373046e.md deleted file mode 100644 index eac783b..0000000 --- a/docs/develop-a-transactional-application-373046e.md +++ /dev/null @@ -1,300 +0,0 @@ - - -# Develop a Transactional Application - -Transactional applications in ABAP Cloud provide a robust and scalable solution for managing business processes and data. The ABAP RESTful Application Programming Model \(RAP\) defines how transactional applications are built. The following graphic shows the big picture: - -![](images/ABAP_Cloud_-_the_Big_Picture_5d4a7c9.png) - -To build a transactional application, you define data models and implement business logic using a declarative approach. The data models as well as the behavior definition make up the ABAP RESTful Application Programming Model business object \(RAP BO\). The data model implemented with ABAP Core Data Services defines the structure of the data. The behavior definition is implemented with ABAP and the Entity Manipulation Language. - - - - - -## Develop Behavior - -With RAP the standard create, update and delete operations must only be specified in the behavior definition to obtain a ready-to-run business object. In addition, the provisioning and handling of the transactional buffer is automatically done for you. The technical implementation aspects are taken over by the managed RAP BO provider. The interaction phase and the save sequence are implemented generically. For more information, see [Business Object Implementation Types](https://help.sap.com/docs/abap-cloud/abap-rap/business-object-implementation-types?version=abap_cross_product). - -The application developer can then focus on business logic that is implemented using actions, validations, determinations, and user interaction. To define which consumers are allowed to read or change data of a business object, RAP offers an authorization concept to restrict access to the business object. - -- Actions - - To develop custom modify operations for example to set a specific field value, you can use actions. See [Operations](https://help.sap.com/docs/abap-cloud/abap-rap/operations?version=abap_cross_product). - -- Validations - - To define which consumers are allowed to read or change data of a business object. To check your data for consistency and against certain conditions based on business or process requirements, you can implement validations. A validation is implicitly invoked by the business object’s framework if a trigger condition of the validation is fulfilled. See [Validations](https://help.sap.com/docs/abap-cloud/abap-rap/validations?version=abap_cross_product). - -- Determinations - - To trigger modify operations based on trigger conditions, for example when another field is changed, you can implement determinations. A determination is implicitly invoked by the business object’s framework if the trigger condition of the determination is fulfilled. See [Determinations](https://help.sap.com/docs/abap-cloud/abap-rap/determinations?version=abap_cross_product). - - - - - - -## Develop Authorization Control - -You can define authorization checks for update operations like creates or custom operations like actions for a business object on global and instance level. For more information, see [Authorization Control](https://help.sap.com/docs/abap-cloud/abap-rap/authorization-control?version=abap_cross_product). - -If your service is to be consumed by other applications, you can define a privileged mode to allow consumers to circumvent authorization checks. For this the consumer must implement the respective checks in their authorization control implementation. For more information, see [RAP – with priviledged mode](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenbdl_privileged_mode.htm). - - - - - -## Develop Concurrency Control - -Concurrency control prevents concurrent and interfering database access of different users. This ensures that data can only be changed if data consistency is assured. In RAP, you can either implement optimistic or pessimistic concurrency control: - -- Optimistic concurrency control relies on the concept that every change on a data set is logged by a specified ETag field. Most often, the ETag field contains a timestamp, a hash value, or any other versioning that precisely identifies the version of the data set. Optimistic concurrency control is only relevant when consuming business objects via OData. See[Optimistic Currency Control](https://help.sap.com/docs/abap-cloud/abap-rap/optimistic-concurrency-control?version=abap_cross_product). - -- Pessimistic concurrency control is done by exclusively locking data sets. The data set that is being modified by one user cannot be changed by another user at the same time. Technically, locking is ensured by using enqueue locks and global lock table entries. See [Pessimistic Concurrency Control \(Locking\)](https://help.sap.com/docs/abap-cloud/abap-rap/pessimistic-concurrency-control-locking?version=abap_cross_product). - - - - - - -## Develop User Interfaces - -UIs create an intuitive and user-friendly interface for users to interact with the business processes. In ABAP Cloud, SAP Fiori ensures a consistent user experience when developing UIs. SAP Fiori applications can be developed for OData services that are exposed as a UI service. SAP Fiori applications, following the SAP Fiori design principles, can be built using a combination of SAPUI5 and SAP Fiori elements. For more information on SAP Fiori Elements and SAPUI5, see [Developing Apps with SAP Fiori Elements](https://sapui5.hana.ondemand.com/#/topic/03265b0408e2432c9571d6b3feb6b1fd) and [SAPUI5](https://help.sap.com/docs/SAPUI5?version=External). - -While SAPUI5 is a development framework that allows you to build freestyle front-end applications, SAP Fiori elements is a framework that includes commonly used floor plan templates. - -SAP Fiori elements applications are generated based on domain-specific annotations that define the layout, data binding, and behavior of a UI. You can define the overall layout for standard floor plans, define labels, implement value helps or define navigation on the UI to just name a few examples. The rendering of the UI is then handled by SAP Fiori elements, which interprets the annotations to create the final user interface. - -Back-end features that are closely related to the UI like draft, feature control, and side effects: - -- Draft - - Applications with draft capabilities let users save their changes in the system and resume their work later, even on a different device, or after an unplanned shutdown. We recommend that you use a draft for your UI use cases to improve the user experience. RAP business objects need to be draft enabled. See [Draft](https://help.sap.com/docs/abap-cloud/abap-rap/draft?version=abap_cross_product). - -- Feature Control - - You can provide information on how data should be displayed for consumption in an SAP Fiori UI, for example if fields are mandatory or read-only. See [Feature Control](https://help.sap.com/docs/abap-cloud/abap-rap/feature-control?version=abap_cross_product). - -- Side Effects - - You can make a Fiori Elements UI aware that data changes of defined fields require the recalculation of other data values, permissions, or messages on the UI in case of UI scenarios based on draft-enabled RAP business objects. See [Side Effects](https://help.sap.com/docs/abap-cloud/abap-rap/side-effects?version=abap_cross_product). - - -For more information about UI development, see: - -- [SAP BTP, ABAP Environment UI Development](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/ui-development-overview) - -- [SAP Fiori Element Feature Showcase Application for the ABAP RESTful Application Programming Model](https://github.com/SAP-samples/abap-platform-fiori-feature-showcase) - - - - - - -## Develop Events or Include Reuse Services - -With RAP, you can implement asynchronous process integration using remote or local events. Events allow you to implement a publisher – subscriber pattern with different consumers. Reuse services offer general capabilities that are required by multiple services, applications and business areas. You can choose from a variety of reuse services that are ready-to-run, ranging from applications jobs over logging, forms, and emails up to change documents or the workflow. - -For more information, see [Business Events for Process Integration](https://help.sap.com/docs/btp/sap-abap-restful-application-programming-model/creating-rap-business-events?version=Cloud). - - - - - -## Define or Develop Extensions for a RAP Business Object - -RAP offers the possibility to develop semantically rich, upgrade-safe, and lifecycle-stable extensions for business objects. An original business object developed by an extensibility-enabler is extended with additional functionality to extend the functional scope of the original RAP business object. Using well-defined extension points enabled in the original business object, an extension provider can then extend the original data model and behavior in accordance with the business requirements or create their own business service based on a RAP business object interface. - -**** - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- -Extensibility Use Case - - - -Extensibility Persona - - - -More Information - -
- -Data Model Extension - -Build full-stack data model extensions by adding new fields and associations including corresponding behavior characteristics and authorization control. - - - -Extensibility-Enabler - -Adds annotations and extension include structures to the original RAP business object to enable data model extensions. - - - -- For more information about enabling full-stack data extensibility, see [Extensibility-Enablement for CDS Data Model Extensions](https://help.sap.com/docs/abap-cloud/abap-rap/extensibility-enablement-for-cds-data-model-extensions?version=abap_cross_product). - -- For an implementation example, see [Enabling Data Model Extensions](https://help.sap.com/docs/abap-cloud/abap-rap/enabling-data-model-extensions?version=abap_cross_product). - - - - -
- -Extension Provider - -Extends the original RAP business object with new fields or associations including field characteristics depending on the options defined by the extensibility-enabler. - - - -- For more information about how to develop data model extensions, see [CDS Data Model Extensions](https://help.sap.com/docs/abap-cloud/abap-rap/cds-data-model-extensions?version=abap_cross_product). - -- For an implementation example, see [Develop Data Model Extensions](https://help.sap.com/docs/abap-cloud/abap-rap/develop-data-model-extensions?state=DRAFT&version=abap_cross_product). - - - - -
- -Behavior and Field-Related Behavior Extensions - -Build additional behavior like new validations, determinations, or actions including dynamic feature control and other field-related behavior. - - - -Extensibility-Enabler - -Enables data model extensibility and behavior extensibility on the original RAP business object. - - - -- For more information about enabling your business object for behavior extensions, see [Extensibility-Enablement for Behavior Extensions](https://help.sap.com/docs/abap-cloud/abap-rap/extensibility-enablement-for-behavior-extensions?version=abap_cross_product). - -- For an implementation example, see: - - - [Enabling Non-Standard Behavior and Field-Related Behavior](https://help.sap.com/docs/abap-cloud/abap-rap/enabling-non-standard-behavior-and-field-related-behavior?version=abap_cross_product) - - - [Enabling Standard Behavior Extensions](https://help.sap.com/docs/abap-cloud/abap-rap/enabling-standard-behavior-extensions?version=abap_cross_product) - - - - - -
- -Extension Provider - -Extends the original RAP business object with new validations, determinations, or actions depending on the options defined by the extensibility-enabler. - - - -- For more information about how to develop different behavior extensions, see [Behavior Extensions](https://help.sap.com/docs/abap-cloud/abap-rap/behavior-extensions?version=abap_cross_product). - -- For an implementation example, see [Develop Behavior Extensions](https://help.sap.com/docs/abap-cloud/abap-rap/develop-behavior-extensions?version=abap_cross_product). - - - - -
- -Node Extensibility - -Build additional business object nodes with own behavior and data model with node extensibility. - - - -Extensibility-Enabler - -Enables node extensibility on the original RAP business object. - - - -- For more information about node extensibility enabling, see [Extensibility-Enablement for Node Extensibility](https://help.sap.com/docs/abap-cloud/abap-rap/extensibility-enablement-for-node-extensibility?version=abap_cross_product). - -- For an implementation example, see [Enabling Node Extensions](https://help.sap.com/docs/abap-cloud/abap-rap/enabling-node-extensions?version=abap_cross_product). - - - - -
- -Extension Provider - -Extend the original business object with new nodes that have their own data model and behavior. - - - -For more information about how to develop node extension, see [Node Extensions](https://help.sap.com/docs/abap-cloud/abap-rap/node-extensions?version=abap_cross_product). - -
- - - - - -## Develop Tests - - - -### Develop Unit Test for the Transactional Services - -You can use the CDS test double framework to implement unit tests for the data model of transactional Services. With the RAP business object test double framework, you can manage the dependencies in the RAP business object behavior implementation and develop unit tests for RAP business object behavior like actions or determinations. - -For an example, see: - -- [Developing Unit Tests for a CDS View](https://help.sap.com/docs/abap-cloud/abap-rap/developing-unit-tests-for-cds-view?version=abap_cross_product) - -- [Developing Unit Tests for a Behavior Implementation](https://help.sap.com/docs/abap-cloud/abap-rap/developing-unit-tests-for-behavior-implementation?version=abap_cross_product) - - - - -### Develop Integration Tests for Transactional Services - -With the OData Client Proxy and the RAP business object TDF, you can implement integration tests to test use cases via EML and OData, where multiple functional units are involved. Reading or creating instances from outside, for example, make use of the whole RAP application and involve dependent operations, such as determinations and validations. The Integration tests validate whether the interaction between the involved functional units works as expected. - -For an example, see: - -- [EML Integration Tests](https://help.sap.com/docs/abap-cloud/abap-rap/eml-integration-tests?version=abap_cross_product) - -- [OData Integration Tests](https://help.sap.com/docs/abap-cloud/abap-rap/odata-integration-tests?version=abap_cross_product) - - -For more information about the OData Client Proxy, see [OData Client Proxy-Consumption Types](https://help.sap.com/docs/btp/sap-business-technology-platform/client-proxy-instance-types?version=Cloud#consumption-types). - diff --git a/docs/develop-an-analytical-application-b845c85.md b/docs/develop-an-analytical-application-b845c85.md deleted file mode 100644 index 357488a..0000000 --- a/docs/develop-an-analytical-application-b845c85.md +++ /dev/null @@ -1,209 +0,0 @@ - - -# Develop an Analytical Application - -Embedded analytics allows you to build complex analytical data models to evaluate and analyze business data in your ABAP system. In embedded analytics, the ABAP analytical engine is part of the software stack and operates on the same data persistence as the transactional applications. The analytical queries operate directly on the business data without data replication to an external data warehouse system. Instead, the real-time business data is queried to always evaluate the most recent changes and trends in your business data. - -Analytical applications require a multidimensional data model that focuses on a minimal join depth and a semantically rich data model that is easy to understand. You can build multidimensional data models with: - -- **Dimensions** with master-data like information to provide the context for an analytical report. A typical example for a dimension is time or location information. - -- **Hierarchies** that allow you to navigate different data granularity levels in the different dimensions. An example for navigation a time dimensions would be a drill-down from year – to quarter – to month or vice versa. - -- **Cubes** that represent the multidimensional data model, consisting of different dimensions and measures. - -- **Analytical queries** that define the initial report layout that is displayed, select the initial data, and can calculate measures that weren’t included in the underlying cube. - - -![](images/Develop_an_Analytical_Application_a994982.png) - - - - - -## Calculate Measures and KPIs - -Calculating KPIs for forecasts or decision-making is an integral task for analytical reports. To calculate numeric fields like measures or KPIs you can aggregate data based on different rule sets, like, for example, sum or average. In ABAP Cloud, the standard aggregation behavior is summation \(SUM\), minimum \(MIN\), and maximum \(MAX\). - -These standard aggregations can be further refined on query level with calculated measures. To define additional calculations and queries for additional KPIs. With restricted measures, you can exclude certain values from the aggregation. This enables you to filter the measure result set based on conditions of your choice. - -For more information, see: - -- [Standard Aggregations](https://help.sap.com/docs/abap-cloud/abap-analytics/standard-aggregations?version=abap_cross_product) - -- [Calculated Measures](https://help.sap.com/docs/abap-cloud/abap-analytics/calculated-measures?version=abap_cross_product) - -- [Restricted Measures](https://help.sap.com/docs/abap-cloud/abap-analytics/restricted-measures?version=abap_cross_product) - - - - - - -## Define or Develop Extensions for Analytical Applications - -In an analytical data model, each part of the data model can be extended individually using predefined extension points in the original analytical data model. As extensibility-enabler, you can make your own analytical data models extensible. All parts of the analytical provider can be extended. You can, for example, add new dimensions to a cube to enhance the reporting depth or you can add additional hierarchies to enable additional navigation throughout the data set. The following graphics show you where analytical data models can be enabled for extensibility. - -**** - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- -Extensibility Use Case - - - -Extensibility Tasks - -
- -Dimension Extension - -Add new hierarchies to a dimension or add new fields or associations to the dimension to diversify the data model. - - - -Extensibility-Enabler - -Add annotations and extension include structures to the original dimension to enable data model extensions like fields or associations. - -
- -Extension Provider - -- Add new hierarchy - - To extend a dimension with a new hierarchy, create a new hierarchy and add it as an association to the corresponding dimension. - -- Add new field extension - - Extend the original dimension with additional fields. - - - - -
- -Cube Extension - -Add new dimensions to a cube to extend the scope of the data analysis or add new measures to the cube to calculate additional values. - - - -Extensibility-Enabler - -Add annotations and extension include structures to the original data model to enable data model extensions, like fields or additional dimensions. - -
- -Extension Provider - -- Add new dimension - - To extend a cube with a new extension, create a new dimension, or use a predelivered SAP dimension and add it as an association to the corresponding dimension. - -- Add new field \(measure\) - - Extend the original cube with additional measures for new calculations. - - - - -
- -Analytical Query Extensions - -Add new numeric fields to the query to extend the scope of the data analysis. - - - -Extensibility-Enabler - -Add annotations and extension include structures to the original data model to enable data model extensions, like additional numeric fields for calculations in queries. - -
- -Extension Provider - -Add new fields to extend the scope of the data analysis. - -
- -Service Definition Extension - -Create a new UI based on a released query or extend the service definition to add new queries to a service definition. - - - -Extensibility-Enabler - -Enable the service definition for extensibility to add additional queries to a service. - -
- -Extension Provider - -- Create a custom UI based on a released UI to adapt the UI to your business requirements. - -- Add a new query to a service definition to extend the original service definition with additional queries. - - - - -
- - - - - -## Develop Unit Test for the Analytical Applications - -You can use the CDS test double framework to implement unit tests for the multidimensional data model and the standard aggregations. For the analytical query, manual tests ensure that all additional calculations and measures work as expected. - -For an example, see [Developing Unit Tests for a CDS View](https://help.sap.com/docs/abap-cloud/abap-rap/developing-unit-tests-for-cds-view?version=abap_cross_product). - - - - - -## Develop UIs for Analytical Applications - -Analytical services use the Analytics Details annotations to specify the analytical query layout and to specific aggregation and planning behavior of the data. - -With the annotation `@AnalyticsDetails.query.axis:'’`, you can position the elements of a query on the different axis to define the basic layout for the report. - -For more information, see [AnalyticsDetails Annotations](https://help.sap.com/docs/abap-cloud/abap-rap/analyticsdetails-annotation?version=abap_cross_product). - diff --git a/docs/develop-an-integration-service-c079f33.md b/docs/develop-an-integration-service-c079f33.md deleted file mode 100644 index 20fb27c..0000000 --- a/docs/develop-an-integration-service-c079f33.md +++ /dev/null @@ -1,278 +0,0 @@ - - -# Develop an Integration Service - -Integration services allow you to create connections to other systems using different protocols. This enables seamless communication and data exchange between services and applications, as well as the ability to build end-to-end business processes across system boundaries. ABAP Cloud supports integration with various integration partners such as SAP cloud products, SAP BTP services, customer extensions, and external services. - -There are SAP-managed integration scenarios for out-of-the-box integration, for example, to integrate the SAP BTP, ABAP environment with other SAP products like SAP S/4HANA Cloud, public edition. In addition, you can expose and consume custom integration services to implement your own integration use cases. For an overview of SAP-managed integration scenarios, see [Overview of Communication Scenarios Managed by SAP](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/overview-of-communication-scenarios-managed-by-sap). - -The following sections focus on exposing and consuming custom integration services and event-based integration for process and data integration. - - - - - -## Process and Data Integration - -ABAP Cloud offers various possibilities to integrate with other systems using the OData, SOAP, HTTP, RFC, and SQL protocols. In addition, you can use the SAP Event Mesh to expose and consume business events: - -- Integration Services Exposure: The development model for exposing integration services depends on the respective protocol. OData, SQL, and business events interfaces can be created using the RAP programming model. The domain-specific logic of SOAP, HTTP, and RFC services is implemented with ABAP. - -- Integration Service Consumption: The consumption of services and events from other systems is simplified by using metadata to generate an Event Consumption Model or a Service Consumption Model. Service Consumption Models are available for OData, SOAP, RFC, and business events. For HTTP and RFC, you can define the consumption requests directly in ABAP. - - -![](images/Develop_an_Integration_Service_f020fb8.png) - -ABAP Cloud supports two main integration use cases: - -- Data Integration - - Addresses the data exchange between two or more communication partners without a relation to a business process. One of the main use cases for data integration is cross-system analytics. In data integration scenarios, the raw data is exchanged without leveraging the domain-specific logic. - -- Process Integration - - Structures the communication on app or service level along a predefined business process, for example, order-to-cash. For process integration, the implemented domain-specific logic for a service is considered. The communication between the communication partners for point-to-point integration is bidirectional, meaning that information is exchanged in both directions. There are both synchronous and asynchronous process integration patterns, for example, event-based integration follows an asynchronous approach. - - -ABAP Cloud offers several different protocols for integrations such as OData, SOAP, Remote Function Calls \(RFCs\), HTTP, SQL, and business events for asynchronous integration. This ensures compatibility between SAP products or third-party services which usually expose a functionality only via a dedicated protocol. The different protocols have different advantages depending on your use case. For example, business events for asynchronous communication require a dedicated integration pattern. - -For more information, see: - -- Develop Integration Services - -- Decide on Integration Use Case: a use case overview - -- Choose and Integration Protocol and Communication Pattern: a protocol and communication pattern overview - - - - - - -## Expose Integration Services - -ABAP Cloud enables the exposure of business services to other systems via inbound communication. To make an integration service externally available, you must: - -- Develop an integration service for process or data integration - - Create an integration service to process the incoming request and to create the response for the communication partner. - -- Set up communication management - - Prepare administrative setup for the administrator by creating, for example, a communication scenario. - - - - - - -## Develop Integration Services for Process Integration - -ABAP Cloud supports various protocols like HTTP, remote function calls or services published via service bindings, such as OData for process integration. - - - - - -## Develop OData Web APIs - -An OData API is an OData service whose metadata doesn't entail any UI-specific annotations that are defined for the data model. An OData API facilitates the exchange of business information between an application and any client. OData APIs are defined with the ABAP RESTful Application Programming Model. - -For more information, see [Develop Web APIs](https://help.sap.com/docs/abap-cloud/abap-rap/develop-web-apis?version=abap_cross_product). - - - - - -## Develop HTTP Services - -You can develop an HTTP service by creating an HTTP service object. The required handler class to handle the HTTP request is automatically created with the HTTP service object. The interface IF\_HTTP\_SERVICE\_EXTENSION with HTTP request/response parameters, enables you to build an HTTP service with full flexibility. - -For more information, see: - -- [HTTP Service Development](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/http-service-development) - -- [Working with the HTTP Service Editor \(ABAP Development Tools: User Guide\)](https://help.sap.com/docs/btp/sap-abap-development-user-guide/working-with-http-service-editor?version=Cloud) - - - - - - -## Develop RFC Services - -You can create an RFC service based on a remote-enabled functions module. You've full flexibility regarding the implementation details. - -For more information, see [RFC - Inbound Communication](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/inbound-communication-rfc). - - - - - -## Develop SQL Services for Data Integration - -You can access CDS view entities in an ABAP system using SQL and the open database connectivity \(ODBC\), a standard API for accessing databases. As a result, you can use SQL statements in external analytical tools to access data in database tables that reside in an ABAP system. - -For an example, see: - -- [Developing and Exposing an SQL Service in the ABAP System](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/developing-and-exposing-sql-service-in-abap-system) - -- [Exposing the SQL Service for Privileged Access](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/exposing-sql-service-for-privileged-access) - -- [Exposing the SQL Service for Business User Access](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/exposing-sql-service-for-business-user-access) - - - - - - -## Setting up the Communication Management for Inbound Communication - -You have to create a communication scenario with inbound services for the exposed endpoints of the communication partner. This enables the administrator of the system to set up the integration, for example, by creating credentials for the authentication of the communication partner and assigning corresponding authorizations to the communication user in the Communication Management applications. - -For more information, see [Consuming Services in the Context of API with Communication Users \(Inbound\)](https://help.sap.com/docs/btp/sap-abap-development-user-guide/consuming-services-in-ui?version=Cloud). - - - - - -## Consume Integration Services - -Not all data that is consumed in ABAP Cloud is read from the SAP HANA database. Instead, data can be consumed using outbound communication via many protocols from remote integration partners, both from cloud services and from the on-premise landscape. For outbound communication, you must: - -- Implement the business service consumption - - Create a proxy class to create the request and process the response by the communication partner. - -- Set up the communication management - - Prepare integration setup for the administrator by creating, for example, a communication scenario. - - - - - - -## Consume Services for Process Integration - -To simplify the implementation of a remote call, you can create a service consumption model for the external service. The service consumption model creates proxies for the remote service. That way, you can access the service in a strictly typed manner without the need to compile requests and parse responses. - - - - - -## Consume OData Services - -The OData client proxy is the interface between the client \(consumer of a service\) and the service implementation \(data provisioning\) in the OData service consumption in ABAP. The OData client proxy enables you to create an OData-typed proxy to run OData requests in your ABAP implementation. - -For more information, see [OData Services](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/odata-services). - - - - - -## Consume HTTP Services - -You can implement free-style integrations without generated proxies via the HTTP client library. - -For more information, see [Enable HTTP Communication in Your ABAP Code](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/enable-http-communication-in-your-abap-code). - - - - - -## Consume Remote Function Call Services - -You can generate a typed-proxy for calling one or more remote-enabled function modules \(RFMs\) using a service consumption model or directly use the `CALL FUNCTION...DESTINATION` statement. - -For more information, see: - -- [RFC](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/rfc) - -- [Generating Proxies for Remote Function Call \(RFC\)](https://help.sap.com/docs/btp/sap-abap-development-user-guide/generating-proxies-for-remote-function-call-rfc?version=Cloud) - - - - - - -## Consume SOAP Services - -You can generate a service consumption model that is based on a Web service description language \(WSDL\) file describing your service. - -For more information, see [SOAP](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/soap). - - - - - -## Consume SQL Services for Data Integration - -After installing the ODBC driver for ABAP, the SQL service and the ODBC driver can be used to provide data access from external ODBC-based clients. - -For more information, see [Consumption of the SQL Service and the ODBC Driver for ABAP](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/consumption-of-sql-service-and-odbc-driver-for-abap). - - - - - -## Set Up Communication Management for Outbound Services - -You've to create a communication scenario with outbound services for the endpoints of the communication partner. This enables the administrator of the system to set up the integration by maintaining the credentials for authentication at the communication partner in the Communication Management apps, see [Consuming Services in the Context of API with Communication Users \(Outbound\)](https://help.sap.com/docs/btp/sap-abap-development-user-guide/consuming-services-in-context-of-api-with-communication-users-outbound?version=Cloud). - -ABAP Cloud supports complex scenarios, where the relevant integration partner is determined at runtime \(receiver determination\). In these cases, the communication scenario can be set up multiple times in each tenant by the administrator. - - - - - -## Develop Event-Based Integration - -Event-driven architecture enables asynchronous communication between an event provider and an event consumer in use cases where no direct response from the event consumer is required. Events represent a significant change of state that is relevant for follow-up processes, for example, if a new travel is created and you want to enable consuming applications to trigger additional workflows. - -This chapter focuses on remote business events. Local business events are based on the same design time but are consumed using an event handler class that is set up as a class pool, similar to a behavior pool. For more information about consuming local events, see [Local Consumption](https://help.sap.com/docs/abap-cloud/abap-rap/business-event-consumption?version=abap_cross_product). - - - - - -## Expose Business Events - -The development of business events is natively integrated with the ABAP RESTful Application Programming Model. An event, that is defined in an RAP behavior definition, can be exposed to remote consumers by assigning an event binding. The event binding defines the topic of the event. - -The administrator can connect the system to an SAP Event Mesh instance and expose this event topic in the Maintain Event Channel Binding application. Potential integration partners can then consume this event topic from the Event Mesh. - -For more information, see: - -- [Business Events](https://help.sap.com/docs/abap-cloud/abap-rap/business-events?version=abap_cross_product) - -- [Develop Business Events](https://help.sap.com/docs/abap-cloud/abap-rap/develop-business-events?version=abap_cross_product) - -- [Checking Channel Binding](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/checking-channel-binding) - - - - - - -## Extend Business Events - -You can customize the payload of an event with derived events. A derived event is defined with reference to an already implemented event and allows the definition of a payload that deviates from one of the referenced business events. When the referenced event is raised, the derived event is raised as well, and the custom payload is applied. For more information, see [Derived Business Events](https://help.sap.com/docs/abap-cloud/abap-rap/derived-business-events). - - - - - -## Consume Business Events - -To consume events from other systems remotely, you can generate an Event Consumption Model based on the AsyncAPI metadata of the event. The Event Consumption Model generates a typed handler class to process the event. - -To simplify the tasks of the administrator, multiple Event Consumption Models can be bundled into a communication scenario. The administrator can then create a communication arrangement to link a channel to an SAP Event Mesh with a communication scenario so that the list of event types is processed by a communication user. - -For more information, see: - -- [Business Event Consumption](https://help.sap.com/docs/abap-cloud/abap-rap/business-event-consumption?version=abap_cross_product) - -- [Generating an Event Consumption Model](https://help.sap.com/docs/btp/sap-abap-development-user-guide/generating-event-consumption-model?version=Cloud) - - diff --git a/docs/develop-c8906e4.md b/docs/develop-c8906e4.md index 8a54cb1..ceb93a4 100644 --- a/docs/develop-c8906e4.md +++ b/docs/develop-c8906e4.md @@ -2,22 +2,3 @@ # Develop - - - - -## Develop Applications, Extensions and Services with ABAP Cloud - -You can develop new apps and services from scratch or extend existing SAP or custom services in an upgrade-safe way. To create a new app and services, you implement the domain-specific implementation including the respective data model and business logic according to the selected use case. All domain-specific data models based on [RAP architecture](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/development-business-configuration) blueprint bring extensibility as a built-in quality. Generally, extensibility is based on an opt-in approach, meaning that the original data model or service must be enabled for the different [extensibility use cases](https://help.sap.com/docs/abap-cloud/abap-rap/extend?version=sap_btp). - -See: - -- [Develop a Transactional Application](develop-a-transactional-application-373046e.md) - -- [Develop an Analytical Application](develop-an-analytical-application-b845c85.md) - -- [Develop an Integration Service](develop-an-integration-service-c079f33.md) - -- [Develop a Multitenant Application](develop-a-multitenant-application-3151e2a.md) - - diff --git a/docs/develop-the-user-interface-9f1d42e.md b/docs/develop-the-user-interface-9f1d42e.md deleted file mode 100644 index e62be2e..0000000 --- a/docs/develop-the-user-interface-9f1d42e.md +++ /dev/null @@ -1,66 +0,0 @@ - - -# Develop the User Interface - -There are three approaches to develop the UI using SAP Fiori: - -- Freestyle SAPUI5 - -- SAPUI5 with SAP Fiori elements - -- Freestyle SAPUI5 with flexible programming model - - - - - - -## Freestyle SAPUI5 - -This is the standard, pure SAPUI5 framework that you can use to freely develop your application user interface as you wish. If your development team has experienced web developers and would want to implement a custom UI layout for your application, using SAPUI5 freestyle you have complete flexibility about how the application can look and perform. You can also specify the layout, flow, menu structure, interaction patterns, and so on. To develop SAPUI5 applications freestyle, you can start with the [Basic template](https://help.sap.com/docs/SAP_FIORI_tools/17d50220bcd848aa854c9c182d65b699/14fdcc0a9d834090a07435cfef962b01.html) in SAP Business Application Studio. - -See [Developing Apps](https://ui5.sap.com/#/topic/23cfd955f58142389fa7c9097e11559c). - - - - - -## SAPUI5 with SAP Fiori Elements - -SAP Fiori elements is a UI library that uses SAPUI5 as its foundation. Its purpose is to scale application development and maintenance by providing substantial standard functionality out of the box, for example, editing business objects. It also relieves you from some tasks in the area of non-functional requirements such as accessibility, performance optimization etc. SAP Fiori elements provides [several standard templates](https://ui5.sap.com//#/topic/797c3239b2a9491fa137e4998fd76aa7) that determine the overall layout and behavior of an SAP Fiori application. SAP Fiori elements relies on OData metadata annotations to define what information is displayed within the floorplan of the application that is generated. The templates allow you to create SAP Fiori applications that follow the SAP Fiori design standards. While SAP Fiori elements supports both OData Version 4 and OData Version 2, we recommend that you use SAP Fiori elements floorplans for OData V4. It comes with an ISO certification and provides innovations like the [flexible programming model](https://ui5.sap.com/test-resources/sap/fe/core/fpmExplorer/index.html#/overview/introduction) which makes it easier to create or [extend](https://ui5.sap.com/test-resources/sap/fe/core/fpmExplorer/index.html#/customElements/customElementsOverview) applications based on SAP Fiori elements for OData V4. - -See [Developing Apps with SAP Fiori Elements](https://ui5.sap.com/#/topic/03265b0408e2432c9571d6b3feb6b1fd). - - - - - -## Freestyle SAPUI5 with Flexible Programming Model - -This approach is a hybrid in-between pure SAPUI5 and SAP Fiori elements. You can start with the Custom Page template in SAP Business Application Studio. The Custom Page template allows you to combine freestyle SAPUI5 code with [building blocks](https://ui5.sap.com/test-resources/sap/fe/core/fpmExplorer/index.html#/buildingBlocks/buildingBlockOverview). For example, if you want a table that works with OData V4 annotations and automatically behaves like the ones in SAP Fiori elements floorplans, you can use the corresponding building block. The building blocks are provided by the flexible programming model to meet specific application requirements without needing any code to configure what they display. - - - - - -## When to Use What - -To make the right decision out of these three options, it's important for you as an application developer to understand their features and limitations. The overall recommendation would be to use as much SAP Fiori elements as possible, as much SAPUI5 freestyle as needed. - -![](images/User_Interface_116cf74.png) - - - -### When UI Design Requirements Match SAP Fiori Elements Floorplans - -If the current and foreseeable application UI design requirements comply with SAP Fiori elements patterns, then use the available standard SAP Fiori elements floorplans. The flexible programming model provides more options to use SAP Fiori elements by allowing to add custom artifacts to the application via extension points. - - - -### When UI Design Requirements Don't Match Any SAP Fiori Elements Floorplans - -- You can flexibly implement a custom layout and content by combining SAPUI5 with building blocks from the flexible programming model. - -- If there's a benefit from using building blocks in a freestyle SAPUI5 application, there's an easy path to integrate the flexible programming model when needed by following the [three-step approach](https://ui5.sap.com/test-resources/sap/fe/core/fpmExplorer/index.html#/buildingBlocks/guidance/guidanceCustomApps). If OData V4 is used and relevant annotations are being maintained in the back end, then such a benefit probably exists: - - diff --git a/docs/development-guidance-cc37b7a.md b/docs/development-guidance-cc37b7a.md index 8e7d4d0..1999b9d 100644 --- a/docs/development-guidance-cc37b7a.md +++ b/docs/development-guidance-cc37b7a.md @@ -2,23 +2,3 @@ # Development Guidance -In SAP BTP, you have the choice between several runtimes. If you want to run ABAP, you'll choose the [SAP BTP, ABAP environment](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/abap-environment). - -The non-ABAP runtime options are SAP BTP, Cloud Foundry runtime and SAP BTP, Kyma runtime. Both runtimes can be used to host and run your custom code, while at the same time being connected to SAP BTP Multi-Cloud Services and your on-premise systems. Depending on your use case and the skill set of your developers, choose the runtime that fits your needs. See [Comparison: SAP BTP, Kyma Runtime and SAP BTP, Cloud Foundry Runtime](https://help.sap.com/docs/btp/comparison-kyma-runtime-and-cloud-foundry-runtime/runtime-comparison?version=Cloud). - - - - - -## ABAP Cloud - -ABAP Cloud is designed to develop applications and services with a standardized architecture on an enterprise scale. The technological core of ABAP Cloud provides the frameworks, design time, and runtime architecture to develop and run ABAP Cloud applications, services, and extensions in all products that support ABAP Cloud with out-of-the-box qualities like scalability, multitenancy, extensibility, and upgrade stability. See [ABAP Cloud](abap-cloud-9aaaf65.md). - - - - - -## SAP Cloud Application Programming Model - -The SAP Cloud Application Programming Model \(CAP\) is a framework of languages, libraries, and tools for building enterprise-grade services and applications. It guides developers along a path of proven best practices and a great wealth of out-of-the-box solutions to recurring tasks. See [SAP Cloud Application Programming Model](sap-cloud-application-programming-model-696ec23.md). - diff --git a/docs/development-tools-48150e1.md b/docs/development-tools-48150e1.md deleted file mode 100644 index 5ca031f..0000000 --- a/docs/development-tools-48150e1.md +++ /dev/null @@ -1,235 +0,0 @@ - - -# Development Tools - -SAP BTP includes many tools to help you develop and manage applications, and connect them to your systems. The availability of tools can depend on the runtime that you are running on. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- -Tool - - - -Used For - - - -Description - -
- -SAP BTP Cockpit - - - -Account administration in SAP BTP - - - -The SAP BTP cockpit is the web-based administration interface of SAP BTP and provides access to a number of functions for configuring and managing applications, services, and subaccounts. Use the cockpit to manage resources, services, security, monitor application metrics, and perform actions on cloud applications. - -
- -[ABAP Development Tools for Eclipse](https://help.sap.com/docs/sap-btp-abap-environment/abap-environment/eclipse-tool-for-abap-environment) - - - -Programming in ABAP - - - -The ABAP Development Tools for Eclipse enables you to perform ABAP-based development tasks, when you want to build, to extend, and to run ABAP Cloud applications. It supports features like syntax check, code completion, syntax highlighting, pretty printing, navigation, search, quick fixes. - -
- -[SAP Business Application Studio](https://help.sap.com/viewer/product/SAP%20Business%20Application%20Studio/Cloud/en-US) - - - -SAP Fiori development for ABAP and non-ABAP - -CAP full-stack application development - - - -Designed and optimized for business application development in SAP ecosystems, SAP Business Application Studio enhances productivity by offering specialized tools for various scenarios, including SAP Fiori application development, SAP HANA native extensions, full-stack and mobile application development, and more. - -Central to the development environment is Code-OSS, the open-source foundation of Visual Studio Code, ensuring a familiar experience for developers when creating SAP-centric applications. SAP Business Application Studio streamlines the building, testing, and deployment of applications with integrated features for source control and testing. Furthermore, its Full-Stack Application Productivity Toolkit offers intuitive visual tools covering the entire development process, guaranteeing seamless integration with various SAP services and solutions. - -
- -[SAP Build](https://help.sap.com/docs/SAP_BUILD) - - - -Low-code, no-code - - - -SAP Build enables everyone, no matter the skill level, to create and augment enterprise applications, process automations, and business sites with drag-and-drop simplicity. - -
- -[Command Line Interface for Cloud Foundry](https://help.sap.com/docs/btp/sap-business-technology-platform/org-administration-using-cloud-foundry-cli?version=Cloud) - - - -Managing subaccounts in the SAP BTP, Cloud Foundry runtime - - - -The Cloud Foundry command line interface enables you to work with the Cloud Foundry runtime to deploy and manage your applications. - -
- -[kubectl](https://kubernetes.io/docs/reference/kubectl/) - - - -Kubernetes tool connected with SAP BTP, Kyma runtime - - - -The Kubernetes command line tool to communicate with a Kubernetes cluster's control plane, using the Kubernetes API. - -
- -[kubelogin](https://github.com/int128/kubelogin) - - - -Kubernetes tool connected with SAP BTP, Kyma runtime - - - -A `kubectl` plugin for Kubernetes OpenID Connect \(OIDC\) authentication. - -
- -[Helm](https://helm.sh/) - - - -Kubernetes tool connected with SAP BTP, Kyma runtime - - - -The package manager for Kubernetes, used for installing and managing Kubernetes applications in form of Helm charts. - -
- -[Paketo \(Pack\)](https://buildpacks.io/docs/tools/pack/) - - - -Kubernetes tool connected with SAP BTP, Kyma runtime - - - -Pack is a tool maintained by the Cloud Native Buildpacks project to support the use of buildpacks. Pack lets you build container images, which are collaboratively maintained making it easier to maintain and update. - -
- -[Docker Desktop](https://docs.docker.com/desktop/) - - - -Kubernetes tool connected with SAP BTP, Kyma runtime - - - -Docker Desktop is an application that enables you to manage \(build, push, pull, and run\) container images on your desktop and a docker-compatible command line interface. - -
- -[SAP Cloud SDK](https://help.sap.com/viewer/p/SAP_CLOUD_SDK) - - - -Programming in Java and JavaScript - - - -SAP Cloud SDK provides a layer of abstractions for features of SAP BTP such as logging, multitenancy, and connectivity. It also includes project templates for different execution environments and implementations. - -
- -Service-Specific Tools - - - -  - - - -The services that run on SAP BTP can come with service-specific tools. For an overview of the services and their tools, see the [SAP Discovery Center](https://www.discovery-center.cloud.sap/protected/index.html#/serviceCatalog). - -
- diff --git a/docs/development-use-cases-4efd0bc.md b/docs/development-use-cases-4efd0bc.md deleted file mode 100644 index 06fbe20..0000000 --- a/docs/development-use-cases-4efd0bc.md +++ /dev/null @@ -1,76 +0,0 @@ - - -# Development Use Cases - - - - - -## Typical Development Use Case Patterns - -The following use case patterns should always be implemented on the SAP BTP: - -- Automate processes across backend systems - - This pattern provides low code/no code capabilities to automate processes and is meant for business experts and developers. - -- Build web and mobile applications - - This pattern provides mobile-native and web development capabilities and is meant for business experts and developers. - -- Develop full-stack applications - - This pattern is meant for professional developers and has the following flavors: - - - Full-stack single-tenant applications - - This pattern is meant for customers and implementation partners enabling them to develop full-stack applications on SAP BTP. - - - Full-stack multitenant SaaS applications for partners that are independent software vendors - - This pattern is meant for SAP partners enabling them to develop full-stack SaaS applications on the SAP BTP and to distribute these applications to their customers. Partners can easily onboard multiple customers \(tenants\) onto a single application with strictly separated data. This approach dramatically reduces the total cost of ownership at cloud scale. - - - Hub scenario integrating with several ERP systems and/or cloud services - - This pattern provides a central hub on SAP BTP to collect and distribute data from various systems. - - - - - - - -## Extensibility Options - -Most development use cases address some sort of extension of SAP S/4HANA and SAP S/4HANA Cloud, public or private edition. Depending on the nature of the extension, different extensibility options are available. The extensibility options can be roughly divided into two categories: - -- On-stack extensibility - - A group of extensibility options that allows users to directly extend the software stack without any remote connection. The extensibility options are: - - - Key user extensibility - - - Developer extensibility - - - Classic extensibility: not recommended; it's available only in private cloud and on-premise setups. - - - For detailed explanation of the ABAP on-stack extensibility options, see [Extend SAP S/4HANA in the Cloud and On-Premise with ABAP-Based Extensions](https://www.sap.com/documents/2022/10/52e0cd9b-497e-0010-bca6-c68f7e60039b.html). - - In this document, you can also find decision tables when to use which extensibility option and how to combine these options in more complex scenarios. - -- Side-by-side extensibility - - An extensibility option that allows developers or key users to implement development projects, such as creating custom user interfaces or custom applications. The development projects are implemented on SAP BTP and integrated via released remote APIs. - - - - - - -## Building Transactional, Analytical Applications and Integration Scenarios with ABAP Cloud - -ABAP Cloud offers developers a programming model to design and implement transactional applications, analytical applications, and integration scenarios. Applications can be deployed as single tenant or multitenant SaaS applications. - -ABAP Cloud defines the technological core of the ABAP Cloud development model and consists of technologies such as ABAP, ABAP RESTful Application Programming Model \(RAP\) and Core Data Services, reuse services and libraries to implement the programming model aspects. Built-in qualities define the common quality characteristics that all ABAP Cloud implementations fulfil such as extensibility or identity and access management. - diff --git a/docs/enterprise-application-building-blocks-03139be.md b/docs/enterprise-application-building-blocks-03139be.md new file mode 100644 index 0000000..c8e5b51 --- /dev/null +++ b/docs/enterprise-application-building-blocks-03139be.md @@ -0,0 +1,6 @@ + + +# Enterprise Application Building Blocks + +![](images/Technical_Architecture_251a03a.png) + diff --git a/docs/hands-on-experience-7fa228f.md b/docs/hands-on-experience-7fa228f.md new file mode 100644 index 0000000..51be17a --- /dev/null +++ b/docs/hands-on-experience-7fa228f.md @@ -0,0 +1,4 @@ + + +# Hands-On Experience + diff --git a/docs/images/ABAP_Cloud_-_the_Big_Picture_5d4a7c9.png b/docs/images/ABAP_Cloud_-_the_Big_Picture_5d4a7c9.png deleted file mode 100644 index 25a0bad..0000000 Binary files a/docs/images/ABAP_Cloud_-_the_Big_Picture_5d4a7c9.png and /dev/null differ diff --git a/docs/images/Develop_an_Analytical_Application_a994982.png b/docs/images/Develop_an_Analytical_Application_a994982.png deleted file mode 100644 index 938a6e0..0000000 Binary files a/docs/images/Develop_an_Analytical_Application_a994982.png and /dev/null differ diff --git a/docs/images/Develop_an_Integration_Service_f020fb8.png b/docs/images/Develop_an_Integration_Service_f020fb8.png deleted file mode 100644 index 442052e..0000000 Binary files a/docs/images/Develop_an_Integration_Service_f020fb8.png and /dev/null differ diff --git a/docs/images/SAPCloudALM_operations_d378eed.jpg b/docs/images/SAPCloudALM_operations_d378eed.jpg new file mode 100644 index 0000000..b29a316 Binary files /dev/null and b/docs/images/SAPCloudALM_operations_d378eed.jpg differ diff --git a/docs/images/SAPCloudALM_operations_d378eed.png b/docs/images/SAPCloudALM_operations_d378eed.png deleted file mode 100644 index 87b505a..0000000 Binary files a/docs/images/SAPCloudALM_operations_d378eed.png and /dev/null differ diff --git a/docs/images/Technical_Architecture_251a03a.png b/docs/images/Technical_Architecture_251a03a.png index 0406823..bd10a8b 100644 Binary files a/docs/images/Technical_Architecture_251a03a.png and b/docs/images/Technical_Architecture_251a03a.png differ diff --git a/docs/images/Tutorials_and_Missions_in_Order_12092d9.png b/docs/images/Tutorials_and_Missions_in_Order_12092d9.png new file mode 100644 index 0000000..bca20b6 Binary files /dev/null and b/docs/images/Tutorials_and_Missions_in_Order_12092d9.png differ diff --git a/docs/images/User_Interface_116cf74.png b/docs/images/User_Interface_116cf74.png deleted file mode 100644 index fa7ae25..0000000 Binary files a/docs/images/User_Interface_116cf74.png and /dev/null differ diff --git a/docs/index.md b/docs/index.md index 6c42401..6b80ab4 100644 --- a/docs/index.md +++ b/docs/index.md @@ -2,18 +2,18 @@ - [What Is SAP BTP Developer’s Guide?](what-is-sap-btp-developer-s-guide-ba26ec4.md) - [What's New for SAP BTP Developer's Guide](what-s-new-for-sap-btp-developer-s-guide-7cf7a39.md) -- [Development Use Cases](development-use-cases-4efd0bc.md) +- [SAP Suite of Business Modules](sap-suite-of-business-modules-4efd0bc.md) - [From Concept to Code](from-concept-to-code-a5b8129.md) -- [Related Hands-On Experience](related-hands-on-experience-7fa228f.md) +- [Hands-On Experience](hands-on-experience-7fa228f.md) - [Tutorials for ABAP Cloud](tutorials-for-abap-cloud-fd87aaa.md) - [Tutorials for SAP Cloud Application Programming Model](tutorials-for-sap-cloud-application-programming-model-eb7420a.md) -- [Building Blocks](building-blocks-03139be.md) +- [Enterprise Application Building Blocks](enterprise-application-building-blocks-03139be.md) - [Business Application Services](business-application-services-f3641a5.md) - [Basic Platform Setup](basic-platform-setup-3b774f8.md) - - [Software Development and Delivery](software-development-and-delivery-511cac8.md) - - [Development Tools](development-tools-48150e1.md) + - [Service Cheat Sheet](service-cheat-sheet-511cac8.md) + - [ABAP Cloud Roadmap](abap-cloud-roadmap-48150e1.md) - [Automated SAP BTP Instrastructure Setup](automated-sap-btp-instrastructure-setup-6dd97e1.md) - - [Operate with SAP Cloud ALM](operate-with-sap-cloud-alm-f7f2977.md) + - [Operate](operate-f7f2977.md) - [Development Guidance](development-guidance-cc37b7a.md) - [ABAP Cloud](abap-cloud-9aaaf65.md) - [Design](design-314ae3e.md) @@ -22,16 +22,16 @@ - [Design an Integration Service](design-an-integration-service-ec2ac31.md) - [Design a Multitenant Application](design-a-multitenant-application-1ac614d.md) - [Develop](develop-c8906e4.md) - - [Develop a Transactional Application](develop-a-transactional-application-373046e.md) - - [Develop an Analytical Application](develop-an-analytical-application-b845c85.md) - - [Develop an Integration Service](develop-an-integration-service-c079f33.md) + - [Transactional Application](transactional-application-373046e.md) + - [Analytical Application](analytical-application-b845c85.md) + - [Integration Service](integration-service-c079f33.md) - [Develop a Multitenant Application](develop-a-multitenant-application-3151e2a.md) - [Deploy](deploy-d7aec3c.md) - [SAP Cloud Application Programming Model](sap-cloud-application-programming-model-696ec23.md) - [Design](design-dcdc2d9.md) - [Develop](develop-58df1d6.md) - - [Develop the User Interface](develop-the-user-interface-9f1d42e.md) + - [Add User Interface](add-user-interface-9f1d42e.md) - [Deploy](deploy-45d5acf.md) - [Continuous Integration and Continuous Delivery](continuous-integration-and-continuous-delivery-d973132.md) - - [Operate](operate-34065a4.md) + - [Reference Application](reference-application-34065a4.md) diff --git a/docs/integration-service-c079f33.md b/docs/integration-service-c079f33.md new file mode 100644 index 0000000..3789af4 --- /dev/null +++ b/docs/integration-service-c079f33.md @@ -0,0 +1,4 @@ + + +# Integration Service + diff --git a/docs/operate-34065a4.md b/docs/operate-34065a4.md deleted file mode 100644 index 6e09155..0000000 --- a/docs/operate-34065a4.md +++ /dev/null @@ -1,32 +0,0 @@ - - -# Operate - -When you seek for fully-detailed observability data of your application, your can use the SAP Cloud Logging service. SAP Cloud Logging allows you to get detailed capture of logs, metrics, and traces that can be used to analyze functional and performance problems on a deeper technical detail. - -SAP Cloud Logging can be flexibly consumed via the CPEA model where costs are charged exactly along the actual usage. See [SAP Cloud Logging in the Service Catalog](https://discovery-center.cloud.sap/index.html#/serviceCatalog/cloud-logging) in SAP Discovery Center. - -SAP Cloud Logging allows you to analyze your SAP BTP workloads in great detail regarding performance, errors, usage, and other characteristics. - -Key capabilities of SAP Cloud Logging include: - -- Ingestion, storage, and analysis of application logs, metrics, and traces - -- Ingestion from SAP BTP, Cloud Foundry runtime and SAP BTP, Kyma runtime and across multiple applications via Open Telemetry or other protocols - -- Dashboards for interactive exploration, including tailored pre-built content for SAP BTP, Cloud Foundry runtime and SAP BTP, Kyma runtime - -- Advanced analytics and data processing, such as alerting and anomaly detection - -- Configurable data retention management - -- Fine-grained access and content management - - -**Related Information** - - -[Product Page on SAP Help Portal](https://help.sap.com/docs/cloud-logging) - -[What Is SAP Cloud Logging?](https://help.sap.com/docs/cloud-logging/cloud-logging/what-is-sap-cloud-logging?version=Cloud) - diff --git a/docs/operate-with-sap-cloud-alm-f7f2977.md b/docs/operate-f7f2977.md similarity index 85% rename from docs/operate-with-sap-cloud-alm-f7f2977.md rename to docs/operate-f7f2977.md index b650b42..c96577c 100644 --- a/docs/operate-with-sap-cloud-alm-f7f2977.md +++ b/docs/operate-f7f2977.md @@ -1,16 +1,16 @@ -# Operate with SAP Cloud ALM +# Operate -SAP Cloud ALM, where ALM stands for application lifecycle management, is included in your SAP Cloud Service subscription containing Enterprise Support, cloud editions, in SAP Enterprise Support and in Product Support for Large Enterprises. +SAP Cloud ALM is included in your SAP Cloud Service subscription containing Enterprise Support, cloud editions, in SAP Enterprise Support and in Product Support for Large Enterprises. SAP Cloud ALM helps you to implement and operate intelligent cloud and hybrid business solutions. You benefit from an out-of-the-box, native cloud solution running on SAP BTP, designed as the central entry point to manage your complete SAP landscape with content-driven guided implementation and highly automated operations. -With the operations solutions in SAP Cloud ALM, you can handle both SAP BTP-based SaaS applications and your own applications. +With with the operations solutions in SAP Cloud ALM, you can handle both SAP BTP-based SaaS applications and your own applications. SAP Cloud ALM for operations provides a personalized and unified operations user experience. You can use purpose-driven different monitoring, analysis, and management use cases optimized for certain operations aspects. SAP Cloud ALM for operations empowers you to understand the health of your SAP business solutions and acts as collaboration platform between lines of business and IT. -Under [Supported Solutions](https://help.sap.com/docs/cloud-alm/setup-administration/supported-solutions), you see which monitoring capabilities are available with SAP Cloud ALM. Under *SAP Solution*, filter for SAP BTP and check the supported services from the operations area. +Under [Supported Solutions](https://help.sap.com/docs/cloud-alm/setup-administration/supported-solutions), you see which monitoring capabilities are available with SAP Cloud ALM. Under *SAP Solution*, filter for BTP and check the supported services from the operations area. Benefit from the powerful *Intelligent Event Processing*, embedded analytics, and intelligence functionality with a large variety of inbound and outbound integration. *Synthetic User Monitoring* monitors the performance and availability of web applications from a client-side perspective based on Selenium-based scripts. *Business Service Management* consolidates all operational events at business service level and shows them in a well-arranged event calendar. @@ -29,7 +29,7 @@ SAP Cloud ALM is the central place to integrate and access the monitoring of you Inbound and outbound APIs enable you to integrate data from your own applications. For more information, see the [API Guide for SAP Cloud ALM](https://help.sap.com/docs/cloud-alm/apis/api-reference). -![](images/SAPCloudALM_operations_d378eed.png) +![](images/SAPCloudALM_operations_d378eed.jpg) diff --git a/docs/reference-application-34065a4.md b/docs/reference-application-34065a4.md new file mode 100644 index 0000000..e6c5a9f --- /dev/null +++ b/docs/reference-application-34065a4.md @@ -0,0 +1,4 @@ + + +# Reference Application + diff --git a/docs/related-hands-on-experience-7fa228f.md b/docs/related-hands-on-experience-7fa228f.md deleted file mode 100644 index 417677e..0000000 --- a/docs/related-hands-on-experience-7fa228f.md +++ /dev/null @@ -1,65 +0,0 @@ - - -# Related Hands-On Experience - -You can benefit from the comprehensive development guidance provided in the SAP BTP Developer’s Guide. This guidance serves as a roadmap, helping you navigate through the complexities of the development process. It offers detailed instructions, best practices, and recommendations that can enhance your proficiency and efficiency as a developer. By following this guidance, you can avoid common pitfalls, streamline your workflow, and produce higher quality code. Furthermore, it can assist in fostering a better understanding of the underlying principles and methodologies, thus elevating your overall skill set and knowledge base. - -In addition to the development guidance, there are also sample applications that together can serve as a practical learning tool. These applications are designed to demonstrate the implementation of the recommendations in real-world business scenarios. By studying these sample applications, you can see firsthand how the guidance can be applied and what the outcomes look like. They provide tangible examples that bridge theory and practice, making it easier for you to grasp and apply the concepts. This hands-on approach not only supplements your learning experience but also prepares you better for your own development projects. - - - - - -## Hands-On Experience for ABAP Cloud - -The ABAP Cloud best practices are documented in the form of step-by-step tutorials for learning how to develop and deploy full-stack transactional and analytical applications using the ABAP RESTful Application Programming Model \(RAP\) and embedded analytics. - -The exercises are based on the Travel example of the [Flight Reference Scenario](https://github.com/SAP-samples/abap-platform-refscen-flight). - - - - - -## Hands-On Experience for SAP Cloud Application Programming Model - -The Incident Management sample application is a showcase of the SAP Cloud Application Programming Model \(CAP\) and adheres to the development recommendations set out in the SAP BTP Developer’s Guide. Best practices are documented in step-by-step tutorials based on the Incident Management application for learning how to develop, deploy, and operate a full-stack application using CAP and SAP Fiori. The tutorials also show how to use a set of important SAP BTP services in a CAP application. - -When going through the sample application, you can choose from two options to try its services and runtimes before you purchase them: - -- Free tier for SAP BTP is best for productive projects: - - - Access a productive account - - - Start with more than 30 free-tier services and upgrade from free to paid plans - - - Accelerate your ramp-up with boosters and missions that include step-by-step guidance - - - The free-tier offering is available for CPEA \(Cloud Platform Enterprise Agreement\) and Pay-As-You-Go for SAP BTP accounts. See [Using Free Service Plans](https://help.sap.com/docs/btp/sap-business-technology-platform/using-free-service-plans). - -- SAP BTP trial is best for learning purposes: - - - Gain instant and full access to a trial environment - - - Experiment with a diverse range of more than 30 trial services for free - - - Get started with a variety of learning materials, such as tutorials and missions - - - See [Start your free 90-days trial](https://www.sap.com/registration/trial.908cb719-0e03-421c-a091-daca045f0acc.html). - - -Before you start using the services or runtimes, you need to manage your entitlements and add quotas to your subaccounts. See [Entitlements and Quotas](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/00aa2c23479d42568b18882b1ca90d79.html "When you purchase an enterprise account, you’re entitled to use a specific set of resources, such as the amount of memory that can be allocated to your applications.") :arrow_upper_right:. - -Note that if you want to try out services for free, you need to select free tier service plans, if available. For a list of free services, check the Service Catalog at [SAP Discovery Center](https://discovery-center.cloud.sap/servicessearch/Free%20Tier/). - -> ### Note: -> There is also a free plan for the SAP BTP, Cloud Foundry runtime and SAP BTP, Kyma runtime. To use the free plans for these runtimes, you have to configure the entitlements in the SAP BTP cockpit. You have one free plan for each runtime per global account and you can assign it to one subaccount at a time. - -**Related Information** - - -[Tutorials for ABAP Cloud](tutorials-for-abap-cloud-fd87aaa.md "") - -[Tutorials for SAP Cloud Application Programming Model](tutorials-for-sap-cloud-application-programming-model-eb7420a.md "") - diff --git a/docs/sap-cloud-application-programming-model-696ec23.md b/docs/sap-cloud-application-programming-model-696ec23.md index 22ee932..fb31805 100644 --- a/docs/sap-cloud-application-programming-model-696ec23.md +++ b/docs/sap-cloud-application-programming-model-696ec23.md @@ -34,11 +34,11 @@ See [Grow as You Go](https://cap.cloud.sap/docs/get-started/grow-as-you-go) in t [Design](design-dcdc2d9.md "") -[Develop](develop-58df1d6.md "Learn more about developing applications using SAP Cloud Application Programming Model (CAP).") +[Develop](develop-58df1d6.md "Learn more about developing applications on the SAP BTP, Cloud Foundry environment.") [Deploy](deploy-45d5acf.md "") -[Operate](operate-34065a4.md "") +[Reference Application](reference-application-34065a4.md "") -[Operate with SAP Cloud ALM](operate-with-sap-cloud-alm-f7f2977.md "") +[Operate](operate-f7f2977.md "") diff --git a/docs/sap-suite-of-business-modules-4efd0bc.md b/docs/sap-suite-of-business-modules-4efd0bc.md new file mode 100644 index 0000000..1e21083 --- /dev/null +++ b/docs/sap-suite-of-business-modules-4efd0bc.md @@ -0,0 +1,4 @@ + + +# SAP Suite of Business Modules + diff --git a/docs/service-cheat-sheet-511cac8.md b/docs/service-cheat-sheet-511cac8.md new file mode 100644 index 0000000..853ef7e --- /dev/null +++ b/docs/service-cheat-sheet-511cac8.md @@ -0,0 +1,137 @@ + + +# Service Cheat Sheet + +**Golden Path Services for the Core Reference Application: Mid June 2023** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +Capability + + + +Service + +
+ +Development Environment + + + +There are two alternatives available: + +- Visual Studio Code and SAP Fiori tools + +- SAP Business Application Studio + + + + +
+ +Programming Model + + + +[SAP Cloud Application Programming Model](https://cap.cloud.sap/docs/) + +
+ +Programming Languages + + + +- Node.js + +- Java + + + + +
+ +User Interface + + + +[SAP Fiori](https://sapui5.hana.ondemand.com/#/topic/03265b0408e2432c9571d6b3feb6b1fd) + +
+ +Database + + + +[SAP HANA Cloud](https://help.sap.com/docs/HANA_CLOUD/f4997718ff9d45f49f90f5d01d16d5a0/2f0c5e3dc11d4eb8a1d6cb878a311f43.html) + +
+ +Runtime + + + +Choose between the following runtimes: + +- Cloud Foundry + +- Kyma + + + + +
+ +Digital Experience Portals + + + +[SAP Cloud Portal service](https://help.sap.com/docs/cloud-portal-service/sap-cloud-portal-service/sap-cloud-portal-service) + +
+ +Continuous Integration and Delivery + + + +[Hyperspace](https://hyperspace.tools.sap/docs/) + +
+ diff --git a/docs/software-development-and-delivery-511cac8.md b/docs/software-development-and-delivery-511cac8.md deleted file mode 100644 index 67e49fe..0000000 --- a/docs/software-development-and-delivery-511cac8.md +++ /dev/null @@ -1,34 +0,0 @@ - - -# Software Development and Delivery - - - - - -## Development Tools - -SAP BTP includes many tools to help you develop and manage applications, and connect them to your on-premise systems. The availability of tools can depend on the environment and cloud management tools feature set that you are running on. - -See [Development Tools](development-tools-48150e1.md). - - - - - -## Automated SAP BTP Infrastructure Setup - -With the Terraform provider for SAP BTP, you can now use this standard to create Terraform scripts that set up your SAP BTP landscapes. The Terraform provider for SAP BTP enables you to automate the provisioning, management, and configuration of resources on SAP BTP. - -See [Automated SAP BTP Instrastructure Setup](automated-sap-btp-instrastructure-setup-6dd97e1.md). - - - - - -## Operate - -SAP Cloud ALM helps you to implement and operate intelligent cloud and hybrid business solutions. You benefit from an out-of-the-box, native cloud solution running on SAP BTP, designed as the central entry point to manage your complete SAP landscape with content-driven guided implementation and highly automated operations. - -See [Operate with SAP Cloud ALM](operate-with-sap-cloud-alm-f7f2977.md). - diff --git a/docs/transactional-application-373046e.md b/docs/transactional-application-373046e.md new file mode 100644 index 0000000..fbbbe01 --- /dev/null +++ b/docs/transactional-application-373046e.md @@ -0,0 +1,4 @@ + + +# Transactional Application + diff --git a/docs/tutorials-for-sap-cloud-application-programming-model-eb7420a.md b/docs/tutorials-for-sap-cloud-application-programming-model-eb7420a.md index e061ad2..8c136b7 100644 --- a/docs/tutorials-for-sap-cloud-application-programming-model-eb7420a.md +++ b/docs/tutorials-for-sap-cloud-application-programming-model-eb7420a.md @@ -8,13 +8,21 @@ This application enables the interaction between the members of the support team The tutorials are built using the Incident Management application. Where applicable, these tutorials use the free plans of the respective services. -Before you start using the services or runtimes, you need to manage your entitlements and add quotas to your subaccounts. See [Entitlements and Quotas](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/00aa2c23479d42568b18882b1ca90d79.html "When you purchase an enterprise account, you’re entitled to use a specific set of resources, such as the amount of memory that can be allocated to your applications.") :arrow_upper_right:. +Before you start using the services or runtimes, you need to manage your entitlements and add quotas to your subaccounts. See [Entitlements and Quotas](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Validation/en-US/00aa2c23479d42568b18882b1ca90d79.html "When you purchase an enterprise account, you’re entitled to use a specific set of resources, such as the amount of memory that can be allocated to your applications.") :arrow_upper_right:. Note that if you want to try out services for free, you need to select free tier service plan, if available. For a list of free services, check the Service Catalog at [SAP Discovery Center](https://discovery-center.cloud.sap/servicessearch/Free%20Tier/). > ### Note: > There is also a free plan for the SAP BTP, Cloud Foundry runtime and SAP BTP, Kyma runtime. To use the free plan of the runtimes, you have to configure the entitlements in the SAP BTP cockpit. You have one free plan for each runtime per global account and you can assign it to one subaccount at a time. + + +This image is interactive. Click the highlighted areas so you open the respective tutorial or mission. + +![](images/Tutorials_and_Missions_in_Order_12092d9.png) + + + The tutorials are organized in the following way. - Basic groups of tutorials for the Incident Management application. See: diff --git a/docs/what-s-new-for-sap-btp-developer-s-guide-7cf7a39.md b/docs/what-s-new-for-sap-btp-developer-s-guide-7cf7a39.md index 860751d..af6cce8 100644 --- a/docs/what-s-new-for-sap-btp-developer-s-guide-7cf7a39.md +++ b/docs/what-s-new-for-sap-btp-developer-s-guide-7cf7a39.md @@ -85,6 +85,144 @@ SAP BTP Developer's Guide + + + +New Graphic Showing the Order of the Tutorials and Missions for CAP + + + + +You can now use an interactive graphic to follow the tutorials and missions related to the SAP Cloud Application Programming Model \(CAP\) and based on the Incident Management sample application. + +See [Tutorials for SAP Cloud Application Programming Model](https://help.sap.com/docs/btp/btp-developers-guide/tutorials-for-sap-cloud-application-programming-model?version=Cloud). + + + + +Info only + + + + +General Availability + + + + +Announcement + + + + +Technology + + + + +Not applicable + + + + +  + + + + +2024-08-02 + + + + +2024-08-02 + + + + + + +SAP BTP Developer's Guide + + + + +- Cloud Foundry + + + + + + +Tutorials for Consuming Remote Services Moved to Tutorial Navigator + + + + +The tutorials that show how to integrate the SAP S/4HANA Cloud Business Partner API to the Incident Management application are now moved to the Tutorial Navigator. There are two main groups depending on whether you have an SAP S/4HANA Cloud tenant, or you use a mock server: + +- [Consume Remote Services from S/4HANA Cloud in Your Full-Stack CAP Application Following the SAP BTP Developer's Guide and Deploy in SAP BTP, Cloud Foundry Runtime](https://developers.sap.com/group.sap-s4hana-consume-remote-services.html) + +- [Consume Remote Services from a Mock Server in Your Full-Stack CAP Application Following the SAP BTP Developer's Guide and Deploy in SAP BTP, Cloud Foundry Runtime](https://developers.sap.com/group.sap-mock-consume-remote-services.html) + + + + + + + +Info only + + + + +General Availability + + + + +Announcement + + + + +Technology + + + + +Not applicable + + + + +  + + + + +2024-08-01 + + + + +2024-08-01 + + + + + + +SAP BTP Developer's Guide + + + + +- Kyma +- Cloud Foundry + + +