mirror of
https://github.com/abap2UI5/abap2UI5.git
synced 2025-04-30 09:46:17 +08:00
53b2f045fc
* Update package.devc.xml * Update package.devc.xml * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * updates renaming and cc organization * update xml view with mapcontainer * mapcontainer control * update package assignment of z2ui5_client * Update README.md * Update README.md * Update README.md
129 lines
7.8 KiB
Markdown
129 lines
7.8 KiB
Markdown
<p align="center"><a href="http://www.abap2ui5.org" target="_blank"><img src="https://github.com/abap2UI5/abap2UI5/assets/102328295/52ac0bb6-a219-4e9d-9e4f-62698dab3063" width="200"></a></p>
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/abap2ui5/abap2ui5/releases/"><img src="https://img.shields.io/github/v/release/abap2ui5/abap2ui5"></a>
|
||
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
|
||
<a href="https://abaplint.app/stats/abap2UI5/abap2UI5"><img src="https://img.shields.io/badge/tested_with-abaplint-green"></a>
|
||
<br>
|
||
<a href="https://github.com/abap2UI5/abap2UI5/issues/306"><img src="https://img.shields.io/badge/PRs-welcome-green"></a>
|
||
<a href="https://github.com/abap2UI5/abap2UI5/graphs/contributors"><img src="https://img.shields.io/github/contributors/abap2ui5/abap2ui5"></a>
|
||
<a href="https://twitter.com/abap2UI5"><img src="https://img.shields.io/twitter/follow/abap2UI5"></a>
|
||
</p>
|
||
|
||
#### Key Features
|
||
* Easy to use – implement just one interface for a standalone UI5 application
|
||
* Pure ABAP – development using 100% ABAP (no JavaScript, DDL, EML or Customizing)
|
||
* Low system footprint – based on a plain HTTP handler (no BSP, OData, CDS, BOPF or RAP)
|
||
* Cloud and on-premise ready – works with both language versions (ABAP for Cloud, Standard ABAP)
|
||
* High system compatibility – runs on all ABAP releases (from NW 7.02 to ABAP 2311)
|
||
* Easy installation – abapGit project, no additional app deployment needed
|
||
|
||
#### Compatibility
|
||
* BTP ABAP Environment (ABAP for Cloud)
|
||
* S/4 Public Cloud ABAP Environment (ABAP for Cloud)
|
||
* S/4 Private Cloud or On-Premise (ABAP for Cloud, Standard ABAP)
|
||
* R/3 NetWeaver AS ABAP 7.50 or higher (Standard ABAP)
|
||
* R/3 NetWeaver AS ABAP 7.02 to 7.42 - use the [downport repository](https://github.com/abap2UI5/abap2UI5-downport)
|
||
|
||
#### Information (Blog Series)
|
||
1. Introduction: Developing UI5 Apps in Pure ABAP [(Blog SCN - 22.02.2023)](https://blogs.sap.com/2023/02/22/abap2ui5-development-of-ui5-apps-in-pure-abap-1-3/)<br>
|
||
2. Displaying Selection Screens & Tables [(Blog SCN - 23.02.2023)](https://blogs.sap.com/2023/02/22/abap2ui5-output-of-lists-and-tables-toolbar-and-editable-2-3/)<br>
|
||
3. Popups, F4-Help, Messages & Controller Logic [(Blog SCN - 30.03.2023)](https://blogs.sap.com/2023/03/30/abap2ui5-3-4-flow-logic-pop-ups-f4-help/)<br>
|
||
4. Advanced Functionality & Demonstrations [(Blog SCN - 02.04.2023)](https://blogs.sap.com/2023/04/02/abap2ui5-4-5-additional-features-demos/)<br>
|
||
5. Extensions with XML Views, HTML, JS & CC [(Blog SCN - 12.04.2023)](https://blogs.sap.com/2023/04/12/abap2ui5-5-6-extensions-with-xml-views-html-js-custom-controls/)<br>
|
||
6. Installation, Configuration & Debugging [(Blog SCN - 14.04.2023)](https://blogs.sap.com/2023/04/14/abap2ui5-6-7-installation-configuration-debugging/)<br>
|
||
7. Technical Background: Under the Hood of abap2UI5 [(Blog SCN - 26.04.2023)](https://blogs.sap.com/2023/04/26/abap2ui5-7-7-technical-background-under-the-hood-of-abap2ui5/)<br>
|
||
8. Repository Setup with abapGit, abaplint & open-abap [(Blog SCN - 21.08.2023)](https://blogs.sap.com/2023/08/21/abap2ui5-a1-repository-setup-with-abapgit-abaplint-open-abap/)<br>
|
||
9. Community Feedback & New Features I [(Blog SCN - 11.09.2023)](https://blogs.sap.com/2023/09/11/abap2ui5-a2-community-feedback-new-features/)<br>
|
||
|
||
#### References
|
||
* Find abap2UI5 in the ABAP Open Source Projects [(dotabap.org)](https://dotabap.org/)
|
||
* Featured in the SAP Developer News [(youtube - 26.01.2023)](https://www.youtube.com/watch?v=6BDK55xYttM)
|
||
* Featured in the Boring Enterprise Nerdletter [(newsletter - 08.03.2023)](https://boringenterprisenerds.substack.com/p/34-abap2ui5-sap-cva-burnout-c2c-shortwave)
|
||
* Part of the SAP Developer Code Challenge [(community - 17.05.2023)](https://groups.community.sap.com/t5/application-development/sap-developer-code-challenge-open-source-abap-week-2/m-p/260727#M1372)
|
||
|
||
#### Apps & Extensions
|
||
* Add your apps to SAP Fiori On-Premise Launchpad [(ext-fiori_launchpad)](https://github.com/abap2UI5/ext-service_integration)
|
||
* Integrate your apps with the SAP Business Technology Platform [(ext-btp)](https://github.com/abap2UI5/ext-business_technology_platform)
|
||
* Explore abap2UI5-tools, a collection of tools & utility functions [(abap2UI5-tools)](https://github.com/abap2UI5/abap2ui5-tools)
|
||
* Add more functions with Custom Controls & External Libraries [(custom controls)](https://github.com/abap2UI5/abap2UI5-documentation/blob/main/docs/custom_controls.md)
|
||
* Discover other projects using abap2UI5 [(abap2UI5/links)](https://github.com/abap2UI5/abap2UI5-documentation/blob/main/docs/links.md)
|
||
|
||
#### More
|
||
* Try out abap2UI5 compiled to JS on open-abap under Node.js [(abap2UI5-web)](https://twitter.com/LarsHvam/status/1648575595897405446)
|
||
* Install S-RTTI to create apps with dynamically typed tables [(github/s-rtti)](https://github.com/sandraros/S-RTTI)
|
||
* Import & Export Excel files in pure ABAP with abap2xslt [(twitter/xslt)](https://twitter.com/abap2UI5/status/1703787345588162907)
|
||
* Analyse your Views & Models with this Codesandbox [(abap2UI5-debug-tools)](https://codesandbox.io/p/sandbox/abap2ui5-debug-tool-ppyfcs)
|
||
* And finally, don't forget to explore the [Samples Repository 🧭](https://github.com/abap2UI5/abap2UI5-samples)
|
||
|
||
#### Installation
|
||
Install with [abapGit](https://abapgit.org)  and create a new HTTP service with the following handler:
|
||
##### Standard ABAP 🏠
|
||
```abap
|
||
METHOD if_http_extension~handle_request.
|
||
|
||
DATA(lv_resp) = SWITCH #( server->request->get_method( )
|
||
WHEN 'GET' THEN z2ui5_cl_fw_http_handler=>http_get( )
|
||
WHEN 'POST' THEN z2ui5_cl_fw_http_handler=>http_post( server->request->get_cdata( ) ) ).
|
||
|
||
server->response->set_header_field( name = `cache-control` value = `no-cache` ).
|
||
server->response->set_cdata( lv_resp ).
|
||
server->response->set_status( code = 200 reason = `success` ).
|
||
|
||
ENDMETHOD.
|
||
```
|
||
##### ABAP for Cloud :cloud:
|
||
```abap
|
||
METHOD if_http_service_extension~handle_request.
|
||
|
||
DATA(lv_resp) = SWITCH #( request->get_method( )
|
||
WHEN 'GET' THEN z2ui5_cl_fw_http_handler=>http_get( )
|
||
WHEN 'POST' THEN z2ui5_cl_fw_http_handler=>http_post( request->get_text( ) ) ).
|
||
|
||
response->set_header_field( i_name = `cache-control` i_value = `no-cache` ).
|
||
response->set_text( lv_resp ).
|
||
response->set_status( 200 ).
|
||
|
||
ENDMETHOD.
|
||
```
|
||
#### Usage
|
||
Develop UI5 Apps by implementing the abap2UI5 interface:
|
||
```abap
|
||
CLASS z2ui5_cl_app_hello_world DEFINITION PUBLIC.
|
||
|
||
PUBLIC SECTION.
|
||
INTERFACES z2ui5_if_app.
|
||
DATA product TYPE string.
|
||
DATA quantity TYPE string.
|
||
|
||
ENDCLASS.
|
||
|
||
CLASS z2ui5_cl_app_hello_world IMPLEMENTATION.
|
||
|
||
METHOD z2ui5_if_app~main.
|
||
|
||
CASE client->get( )-event.
|
||
WHEN 'BUTTON_POST'.
|
||
client->message_toast_display( |{ product } { quantity } - send to the server| ).
|
||
ENDCASE.
|
||
|
||
client->view_display( z2ui5_cl_xml_view=>factory( client
|
||
)->page( 'abap2UI5 - Hello World App'
|
||
)->simple_form( )->content( ns = `form`
|
||
)->title( 'Input here and send it to the server...'
|
||
)->label( 'quantity'
|
||
)->input( client->_bind_edit( quantity )
|
||
)->label( 'product'
|
||
)->input( client->_bind_edit( product )
|
||
)->button( text = 'post' press = client->_event( 'BUTTON_POST' )
|
||
)->stringify( ) ).
|
||
|
||
ENDMETHOD.
|
||
ENDCLASS.
|
||
```
|
||
#### FAQ
|
||
* Check out the [documentation](https://github.com/abap2UI5/abap2UI5-documentation/) for installation & configuration guidelines
|
||
* Still have open questions? find an answer in the [FAQ](https://github.com/abap2UI5/abap2UI5-documentation/blob/main/docs/faq.md)
|
||
* Want to help out? Check out the contribution [guidelines](https://github.com/abap2UI5/abap2UI5-documentation/blob/main/CONTRIBUTING.md)
|
||
* As always - your comments, questions, wishes and bug reports are welcome, please create an [issue](https://github.com/abap2UI5/abap2UI5/issues)
|