From 4cebd3b49a43493961efdbd8169169e7a639cbb3 Mon Sep 17 00:00:00 2001 From: danrega <16720986+danrega@users.noreply.github.com> Date: Wed, 20 Sep 2023 15:27:20 +0200 Subject: [PATCH] Update --- 19_ABAP_for_Cloud_Development.md | 189 ++++ README.md | 1 + files/release_contract.png | Bin 0 -> 56975 bytes files/released_APIs.png | Bin 0 -> 18652 bytes files/standard.png | Bin 0 -> 2991 bytes src/zcl_demo_abap_cloud_excursion.clas.abap | 1106 +++++++++++++++++++ src/zcl_demo_abap_cloud_excursion.clas.xml | 16 + 7 files changed, 1312 insertions(+) create mode 100644 19_ABAP_for_Cloud_Development.md create mode 100644 files/release_contract.png create mode 100644 files/released_APIs.png create mode 100644 files/standard.png create mode 100644 src/zcl_demo_abap_cloud_excursion.clas.abap create mode 100644 src/zcl_demo_abap_cloud_excursion.clas.xml diff --git a/19_ABAP_for_Cloud_Development.md b/19_ABAP_for_Cloud_Development.md new file mode 100644 index 0000000..fb100a0 --- /dev/null +++ b/19_ABAP_for_Cloud_Development.md @@ -0,0 +1,189 @@ + + +# ABAP for Cloud Development + +- [ABAP for Cloud Development](#abap-for-cloud-development) +- [Terms](#terms) +- [Excursions](#excursions) +- [More Information](#more-information) +- [Executable Example](#executable-example) + + +This ABAP cheat sheet briefly touches on the terms ABAP Cloud and classic ABAP to set the context for [ABAP for Cloud Development](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenabap_for_cloud_dev_glosry.htm). +It provides references to more detailed information on the topic. + +# Terms + +- ABAP Cloud + - progamming paradigm for state-of-the-art, cloud-ready and upgrade-stable solutions + - Based on a usage type of the [ABAP Platform](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenabap_platform_glosry.htm), where the following restrictions apply: + - [ABAP language version](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenabap_version_glosry.htm): + - The available ABAP language version is [ABAP for Cloud Development](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenabap_for_cloud_dev_glosry.htm) that presents a [restricted ABAP language version](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenrestricted_version_glosry.htm) (for example, dynpro-related statements are not allowed). + - [Released APIs](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenreleased_api_glosry.htm): + - Access to SAP-delivered repository objects is restricted to objects released for ABAP for Cloud Development + - For example, most of the database tables provided by SAP cannot be read directly (although there are abstractions for many that can be accessed). + - Libraries are available with predefined functionality. + - Note that repository objects can be classified by a [release contract](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenrelease_contract_glosry.htm) (e.g. C0, C1 etc.). + - Tools: + - [ABAP development tools for Eclipse (ADT)](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenadt_glosry.htm) are the only supported tools + - There is no access to SAP GUI (transactions `SE80`, `SE24` etc. you may know from classic ABAP) + - The [ABAP RESTful Application Programming Model (RAP)](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenarap_glosry.htm) is the transactional programming model for ABAP Cloud. + - Supported in both [SAP BTP ABAP Environment](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abensap_btp_abap_env_glosry.htm) and [ABAP Platform Cloud](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenabap_platform_cloud_glosry.htm). +- Classic ABAP + - Progamming paradigm for legacy solutions + - Based on a ABAP Platform without restrictions regarding ABAP language versions (i.e. you can use [Standard ABAP](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenstandard_abap_glosry.htm) - the unrestricted ABAP language version - and also ABAP for Cloud Development there), usage of tools (ADT and/or SAP GUI) or access to repository objects (also objects provided by SAP). + - Supported in [SAP S/4HANA](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abensap_s4hana_glosry.htm) + + +> **💡 Note**
+> - See more information in the topic [ABAP Language Versions, Release Contracts and Released APIs](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenabap_versions_and_apis.htm). +> - See the topic [Language Elements in ABAP Versions](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenrestricted_abap_elements.htm) that provides a table showing which ABAP language elements are allowed in which ABAP language version +> - Note the following differentiations: +> - [ABAP Platform Cloud](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenabap_platform_cloud_glosry.htm) and [ABAP Platform](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenabap_platform_glosry.htm) +> - [ABAP for Cloud Development](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenabap_for_cloud_dev_glosry.htm) and [Standard ABAP](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenstandard_abap_glosry.htm) + +

(⬆️ back to top)

+ +# Excursions + +1) If available to you, you have accessed an SAP BTP ABAP environment using ADT. + + Access to SAP-provided repository objects is restricted to objects that have been released for ABAP for Cloud Development (released APIs). You can find the released APIs in the *Project Explorer* view in ADT under *Released Objects*: + + ![Released APIs](./files/released_APIs.png) + + As an example of a released API, consider the `CL_ABAP_RANDOM_INT` class (computes random integers). In ADT, once you have opened the class, check the *Properties* tab. Click *API State* on the left to display information about the release contracts. In this case, it is C1. As mentioned above, see [here](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenabap_versions_and_apis.htm#@@ITOC@@ABENABAP_VERSIONS_AND_APIS_2) for more information on C1, and so on. This is also true for ABAP Repository objects in on-premises systems. + + ![Release contract](./files/release_contract.png) + + For deprecated and invalid syntax, see the following code. + For example, create a demo class and insert the code contained in the implementation into the `if_oo_adt_classrun~main` method. You will see several syntax errors. + + > **💡 Note**
+ > - The `IF_OO_ADT_CLASSRUN` interface is a released API. As the name implies, you can implement this interface to run an ABAP class. In ADT you can do this with *F9*. Of course, the example below will not run. The class cannot be activated because of the syntax errors. Note: To output the content of data objects, you can use `out->write( ... ).` in the `main` method. + > - About the errros/warnings: + > - The first two ABAP SQL statements select from demo database tables. The first is a demo table provided by SAP. This table is not directly accessible in ABAP Cloud (unlike in on-premise systems) and therefore cannot be used as a data source to select from. The second one is a database table from the ABAP cheat sheet GitHub repository. If you have imported the repository into the system, you can use it as a data source. + > - The next set of ABAP SQL statements are dynamic statements. This is just to emphasize that you should be careful with dynamic statements. You will not get a syntax error at compile time. You can try out the following: Comment out all code except the lines with the dynamic statements, activate the code and run the class with `F9`. The result is a [runtime error](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenruntime_error_glosry.htm) because you cannot select from the data source. + > - The examples for deprecated and invalid syntax in ABAP for Cloud Development include the invalid statement `MOVE ... TO` and others. To set breakpoints in ADT, double-click the area to the left of the code line number. + + ```abap + CLASS zcl_demo_abap_temp DEFINITION + PUBLIC + FINAL + CREATE PUBLIC . + + PUBLIC SECTION. + INTERFACES if_oo_adt_classrun. + ENDCLASS. + + CLASS zcl_demo_abap_temp IMPLEMENTATION. + METHOD if_oo_adt_classrun~main. + "ABAP SQL statements using database tables as data sources + "Data source that cannot be accessed in ABAP Cloud + SELECT carrid, connid FROM spfli WHERE carrid = 'LH' INTO TABLE @DATA(it1). + + "Data source that can be accessed in ABAP Cloud if you have imported + "the ABAP cheat sheet repository objects + SELECT carrid, connid FROM zdemo_abap_fli WHERE carrid = 'LH' INTO TABLE @DATA(it2). + + "Dynamic ABAP SQL statements + "In ABAP Cloud, no syntax error will be displayed. However, a runtime error + "will occur when running the class. + "Note: Check out the CL_ABAP_DYN_PRG class, which supports dynamic programming " by checking the validity of dynamic specifications. + SELECT SINGLE carrid, connid FROM ('SPFLI') WHERE carrid = 'LH' INTO NEW @DATA(ref_a). + "No runtime error if you have imported the ABAP cheat sheet repository objects + SELECT SINGLE carrid, connid FROM ('ZDEMO_ABAP_FLI') WHERE carrid = 'LH' INTO NEW @DATA(ref_b). + + "Examples for deprecated and invalid syntax in ABAP for Cloud Development + + DATA(num1) = 1. + DATA(num2) = 1. + DATA(num3) = 2. + + "Invalid statement + MOVE num3 TO num1. + "Alternative that can be used + num2 = num3. + + "Note: This table type is released. + DATA(it3) = VALUE string_table( ( `a` ) ( `b` ) ( `c` ) ). + "Invalid statement + DESCRIBE TABLE it3 LINES DATA(num_lines1). + "Alternative that can be used + DATA(num_lines2) = lines( it3 ). + + DATA: ref1 TYPE REF TO i, + ref2 TYPE REF TO i. + "Deprecated statement + GET REFERENCE OF num1 INTO ref2. + "Alternative that can be used + ref1 = REF #( num1 ). + + DATA str_itab TYPE string_table. + "Invalid statements + READ REPORT 'ZCL_DEMO_ABAP_UNIT_TEST=======CCAU' INTO str_itab. + WRITE 'hi'. + BREAK-POINT. + ENDMETHOD. + ENDCLASS. + ``` + +2) If available to you, you have accessed an on-premise ABAP system using ADT. + + You have the unrestricted ABAP language version at your disposal. For example, you can use the code from above and ... + - insert it into an [executable program (F1 for Standard ABAP)](https://help.sap.com/doc/abapdocu_latest_index_htm/latest/en-US/index.htm?file=abenexecutable_program_glosry.htm) (a *report*), create a local class and run the program. Reports are not available in ABAP Cloud. + - create a global class in the ABAP Class Builder (transaction `SE24`). SAP GUI is not available in ABAP Cloud. + + Assuming, as mentioned, you have accessed ADT, you can then check out the following: + a) Choose `CTRL + SHIFT + A` to open the search in ADT. Search the class `CL_ABAP_RANDOM_INT`. Once you have opened the class, check the *Properties* tab and find the API status information. + + b) Example class + - Create a global class and insert the code from above. Depending on the name of the class you created, replace the class name in the snippet. + - If you have not imported the ABAP cheat sheet GitHub repository, remove the lines of code using artifacts from that repository, i.e. change the `SELECT` and `READ REPORT` statemnets. You should not see any syntax errors. Activate the class. + - Run the class with *F9*. The code should have been processed up to the `BREAK-POINT` statement and the debugger should have started. You may want to check the content of the variables in the debugger. Choose *Terminate* to exit the debugger. + - So, unlike in the case of ABAP Cloud above, the code should work without restrictions. + - For the example class created, check the information in the *Properties* tab. Choose *General*. The *ABAP Language Version* is maintained as *Standard ABAP*: + ![Standard ABAP](./files/standard.png) + + c) Verify that your code in an on-premises ABAP system is cloud-ready + - You have walked through b), created a class, inserted the code from above, and activated the class. The *ABAP Language Version* is maintained as *Standard ABAP* in the *Properties* tab. + - Verifying if your code is cloud-ready + - You can use ATC check variant `ABAP_CLOUD_READINESS` for this purpose. + - For example, in your class, right-click and choose *Run As* → *4 ABAP Test Cockpit With...*. Enter `ABAP_CLOUD_READINESS` in the pop-up window and choose *Ok*. The ATC check run is started. + - As a result of the ATC check run (note that it may take a while to complete), the *ATC Problems* tab in ADT should display results. In this case, these are the errors and warnings mentioned above, indicating that the code is not cloud-ready in various places. Double-click on the findings for more detailed information. + + d) Cloud-ready development in an ABAP on-premise system + - You have walked through b), created a class, inserted the code from above, and activated the class. The *ABAP Language Version* is maintained as *Standard ABAP* in the *Properties* tab under *General*. + - Suppose you want to develop in a cloud-ready way and use ABAP for Cloud Development, i.e. the restricted ABAP language version, in an on-premise ABAP system that allows the unrestricted ABAP language version. + - Open the *Properties* tab and choose *General* for this purpose. + - Choose the *Edit...* button to the right of the *ABAP Language Version* property. + - Select *ABAP for Cloud Development* in the pop-up window and choose *Ok*. + - You will then be able to work with a repository object with the restrictions mentioned above. As a result, the example class with the code snippets will have syntax errors and cannot be activated. In more meaningful, productive development contexts, appropriate refactoring is required. + +

(⬆️ back to top)

+ +# More Information + +- Devtoberfest sessions + - [Overview of ABAP Cloud](https://www.youtube.com/watch?v=ApZSn_t_WSo) + - [ABAP Cloud for Classic ABAP Developers](https://youtu.be/jyLoSnHa0Vo) +- Blogs + - [Steampunk is going all-in](https://blogs.sap.com/2021/09/30/steampunk-is-going-all-in/) + - [Embedded Steampunk – Some more details for ABAP developers](https://blogs.sap.com/2022/09/05/embedded-steampunk-some-more-details-for-abap-developers/) +- Documentation + - [ABAP Cloud - Technical Use Cases and Recommended Technologies](https://www.sap.com/documents/2023/05/74fc05e6-747e-0010-bca6-c68f7e60039b.html) + - [SAP Business Technology Platform](https://help.sap.com/docs/btp/sap-business-technology-platform/sap-business-technology-platform?version=Cloud) on the SAP Help Portal + - Section [Released Components and Objects](https://help.sap.com/docs/btp/sap-business-technology-platform/released-components-and-objects?version=Cloud) including the topic [XCO Library](https://help.sap.com/docs/btp/sap-business-technology-platform/xco-library?version=Cloud) + - ABAP Keyword Documentation + - [Rules for ABAP Cloud](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenabap_strict_rules.htm) + - [Language Elements in ABAP Versions](https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenrestricted_abap_elements.htm): A table showing which ABAP language elements are allowed in which ABAP language version + +

(⬆️ back to top)

+ + +# Executable Example +[zcl_demo_abap_cloud_excursion](./src/zcl_demo_abap_cloud_excursion.clas.abap) + +> **💡 Note**
+> - Unlike other ABAP cheat sheet examples, this one does not focus on ABAP syntax as such (see the other non-Standard-ABAP ABAP cheat sheet examples for that using ABAP syntax available in ABAP for Cloud Development), but rather emphasizes released APIs and libraries that provide predefined functionality and can be used in ABAP for Cloud Development - in particular, the Extension Components Library (XCO). +> - The example covers an arbitrary selection for you to explore. For more detailed information and code snippets, see the SAP Help Portal documentation [here](https://help.sap.com/docs/btp/sap-business-technology-platform/sap-business-technology-platform?version=Cloud) and [here about XCO](https://help.sap.com/docs/btp/sap-business-technology-platform/xco-library?version=Cloud). In most cases, the example covers a selection of classes and methods for retrieving information about repository objects. It is more of a "playground" for exploring the APIs with a few snippets of code, and should be seen as an invitation to more in-depth exploration. \ No newline at end of file diff --git a/README.md b/README.md index e82ad92..ef7c31f 100644 --- a/README.md +++ b/README.md @@ -58,6 +58,7 @@ ABAP cheat sheets[^1] ... | Cheat Sheet | Topics Covered | Demo Example | | ------------- | ------------- | ----- | +|[ABAP for Cloud Development](19_ABAP_for_Cloud_Development.md)| Briefly touches on the terms ABAP Cloud and classic ABAP to set the context for ABAP for Cloud Development | [zcl_demo_abap_cloud_excursion](./src/zcl_demo_abap_cloud_excursion.clas.abap) (see the notes in the cheat sheet) | |[Data Types and Data Objects](16_Data_Types_and_Objects.md)| Contains basic information about data types and data objects in ABAP | [zcl_demo_abap_dtype_dobj](./src/zcl_demo_abap_dtype_dobj.clas.abap) | |[Internal Tables](01_Internal_Tables.md)| Creating, filling, reading from, sorting, modifying internal tables | [zcl_demo_abap_internal_tables](./src/zcl_demo_abap_internal_tables.clas.abap) | |[Structures](02_Structures.md)| Some basics when working with structures | [zcl_demo_abap_structures](./src/zcl_demo_abap_structures.clas.abap) | diff --git a/files/release_contract.png b/files/release_contract.png new file mode 100644 index 0000000000000000000000000000000000000000..c7731e4d332c0b82524948f65bf0d0dc52e17357 GIT binary patch literal 56975 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

>w-6@BXa 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

JEooEzI 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 literal 0 HcmV?d00001 diff --git a/files/released_APIs.png b/files/released_APIs.png new file mode 100644 index 0000000000000000000000000000000000000000..cffa08343d00ab7729bb1c9e7d56306be1321b35 GIT binary patch literal 18652 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 literal 0 HcmV?d00001 diff --git a/files/standard.png b/files/standard.png new file mode 100644 index 0000000000000000000000000000000000000000..5f57c393ab0a72cf93512d2070717dcbadb7c3ae GIT binary patch literal 2991 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 cheat sheet: Excursions into ABAP for Cloud Development

+"! Example to demonstrate released APIs and libraries with the restricted ABAP language version.
Choose F9 in ADT to run the class. +CLASS zcl_demo_abap_cloud_excursion DEFINITION + PUBLIC + FINAL + CREATE PUBLIC . + + PUBLIC SECTION. + INTERFACES if_oo_adt_classrun. + PROTECTED SECTION. + PRIVATE SECTION. + TYPES: BEGIN OF details_struc, + name TYPE string, + details TYPE string, + END OF details_struc. + + CLASS-DATA details_tab TYPE TABLE OF details_struc WITH EMPTY KEY. + CLASS-DATA str TYPE string. + CLASS-DATA infos TYPE string_table. + CLASS-METHODS heading IMPORTING text TYPE string + RETURNING VALUE(output) TYPE string. + + "NOTE: + "The names specified for the following constants are used by several + "code snippets in the example class. Make sure that you insert suitable + "values before running the example class. + + "Package name: Use the package name in which you cloned the ABAP cheat sheets, + "for example, ZABAP_CHEAT_SHEETS. + CONSTANTS package TYPE sxco_package VALUE 'ZABAP_CHEAT_SHEETS'. + + "The following constants are relevant for the ABAP repository object generation. + "See the comments in the section further down. + "Name of the package in which you want to generate the repository objects + CONSTANTS package4gen TYPE sxco_package VALUE 'ZABAP_CHEAT_SHEETS'. + "ID of a modifiable transport request + CONSTANTS tr_req_id TYPE sxco_transport VALUE 'ID0A123456'. + "Name of the data element to be created + CONSTANTS gen_dtel TYPE sxco_ad_object_name VALUE 'ZDEMO_ABAP_DTEL'. + "Name of the domain to be created + CONSTANTS gen_doma TYPE sxco_ad_object_name VALUE 'ZDEMO_ABAP_STATUS'. + "Name of the database table to be created + CONSTANTS gen_tabl TYPE sxco_dbt_object_name VALUE 'ZDEMO_ABAP_BOOK'. + "To enable the generation, specify "abap_true" for the contant value. + CONSTANTS generation_ok TYPE abap_bool VALUE abap_false. + +ENDCLASS. + +CLASS zcl_demo_abap_cloud_excursion IMPLEMENTATION. + + METHOD if_oo_adt_classrun~main. + out->write( |ABAP Cheat Sheet Example: Excursions into ABAP for Cloud Development\n| ). + out->write( `1) Restrictions in ABAP for Cloud Development` ). + out->write( |\nYou can check the code of this section by commenting it in and out. Note the comments in the code.| ). + "The following statements demonstrate a selection of restrictions in ABAP for Cloud Development. + "Comment in the code lines (CTRL + 7) up to BREAK-POINT and check the syntax errors/warnings + "displayed. + "Notes about the errors/warnings: + "- Using ABAP SQL statements, data is retrieved from database tables. The first table + " is a demo table provided by SAP. This table cannot be accessed directly (unlike in on-premise + " systems) and therefore cannot be used as a data source from which to select. The second + " is a database table from the ABAP Cheat Sheet GitHub repository. If you have imported + " the repository into the system, you can use it as a data source. + "- The example includes dynamic ABAP SQL statements. This is just to emphasize that such + " statements can lead to unwanted results, since in this case you cannot select from the + " first database table whose name is specified dynamically. Therefore, there is no syntax + " error or warning at compile time, but an error at runtime. You can try the following: + " Comment out all code except the lines with the dynamic statements, activate the code + " and execute the class with F9. Note: Check out the CL_ABAP_DYN_PRG class, which supports + " dynamic programming by checking the validity of dynamic specifications. + "- Further examples of obsolete and invalid syntax in ABAP for Cloud Development include + " the invalid MOVE ... TO ... statement and others. To set breakpoints in ADT, double-click + " the area to the left of the code line number. + + +* SELECT carrid, connid FROM spfli WHERE carrid = 'LH' INTO TABLE @DATA(it1). +* SELECT carrid, connid FROM zdemo_abap_fli WHERE carrid = 'LH' INTO TABLE @DATA(it2). +* SELECT SINGLE carrid, connid FROM ('SPFLI') WHERE carrid = 'LH' INTO NEW @DATA(wa1). +* SELECT SINGLE carrid, connid FROM ('ZDEMO_ABAP_FLI') WHERE carrid = 'LH' INTO NEW @DATA(wa2). +* +* DATA(num1) = 1. +* DATA(num2) = 1. +* DATA(num3) = 2. +* +* MOVE num3 TO num1. +* num2 = num3. +* +* DATA(it3) = VALUE string_table( ( `a` ) ( `b` ) ( `c` ) ). +* DESCRIBE TABLE it3 LINES DATA(num_lines1). +* DATA(num_lines2) = lines( it3 ). +* +* DATA: ref1 TYPE REF TO i, +* ref2 TYPE REF TO i. +* ref1 = REF #( num1 ). +* GET REFERENCE OF num1 INTO ref2. +* +* DATA str_itab TYPE string_table. +* READ REPORT 'ZCL_DEMO_ABAP_UNIT_TEST=======CCAU' INTO str_itab. +* WRITE 'hi'. +* BREAK-POINT. + +********************************************************************** + + out->write( heading( `2) Using released APIs` ) ). + "The following code uses several released APIs. + "You can check out Released Objects in the Project Explorer in ADT in + "ABAP Cloud. + + "In the example, a released API is used to return the current date in UTC. + "You can use forward navigation by placing the cursor on the class, + "choosing CTRL and clicking. In the opened class, go to the Properties + "tab and choose API state to find the release contract for this class. + DATA(date) = cl_abap_context_info=>get_system_date( ). + DATA(current_year) = date(4). + DATA(up_to_year) = 2050. + + "The statement retrieves the leap years between the current year and + "the specfied years. A released CDS view is used as data source. + SELECT calendaryear + FROM i_calendaryear + WHERE calendaryear BETWEEN @current_year AND @up_to_year + AND IsLeapYear IS NOT INITIAL + INTO TABLE @DATA(future_leap_years). + + "To display output, the example class uses a released API. You can implement + "the interface if_oo_adt_classrun and the main method. The write method displays + "content in the console when running the class using F9 in ADT. + out->write( data = future_leap_years name = `future_leap_years` ). + + "Using a released data element + DATA number TYPE int4. + number = lines( future_leap_years ). + + out->write( |\nBetween { current_year } and 2050, there are { number } leap years.| ). + + "Using a released API as data source of a SELECT statement + "Among others, the month names of specified languages are retrieved in the example. + "The WHERE clause is specified in a way to only retrieve a selected set of months. + "For this purpose, more released APIs (classes cl_abap_random_int, cl_abap_random) + "are used. A minimum of 5 months and a maximum of all months is to be returned. + DATA(number_of_months) = cl_abap_random_int=>create( + seed = cl_abap_random=>seed( ) min = 5 + max = 12 )->get_next( ). + + SELECT CalendarMonth, CalendarMonthName, Language + FROM i_calendarmonthtext + WHERE Language IN ( 'E', 'I', 'D' ) + AND CalendarMonth <= @number_of_months + ORDER BY Language, CalendarMonth + INTO TABLE @DATA(months). + + "Using a released table type + DATA string_tab TYPE string_table. + + "Inserting the retrieved data into a table of type string + LOOP AT months INTO DATA(month_wa). + APPEND |{ month_wa-CalendarMonth } { month_wa-CalendarMonthName } ({ month_wa-Language })| TO string_tab. + ENDLOOP. + + "Using a released API, the data is serialized + DATA(json_str) = /ui2/cl_json=>serialize( data = string_tab + pretty_name = /ui2/cl_json=>pretty_mode-low_case + compress = abap_false + hex_as_base64 = abap_false + format_output = abap_true + assoc_arrays = abap_true + assoc_arrays_opt = abap_true ). + + out->write( |\nNumber of months per language: { number_of_months }| ). + out->write( |\nMonths returned:| ). + out->write( data = string_tab ). + out->write( |\nMonths returned (serialized data object):| ). + out->write( data = json_str ). + + "Getting APIs for use in ABAP for Cloud Development + "The released CDS view contains the relevant information. In the example, + "the names of released classes are retrieved with a specific name pattern. + SELECT ReleasedObjectType, ReleasedObjectName, ReleaseState + FROM i_apisforclouddevelopment + WHERE releasestate = 'RELEASED' + AND ReleasedObjectType = 'CLAS' + AND ReleasedObjectName LIKE 'CL_ABAP_RANDOM_P%' + INTO TABLE @DATA(rel_cl_abap_random). + + out->write( |\nRead result::| ). + out->write( data = rel_cl_abap_random name = `rel_cl_abap_random` ). + + "Getting the number of all released classes in the system + SELECT COUNT(*) + FROM i_apisforclouddevelopment + WHERE releasestate = 'RELEASED' + AND ReleasedObjectType = 'CLAS' + INTO @DATA(num_rel_cl). + + "Getting the number of all released interfaces in the system + SELECT COUNT(*) + FROM i_apisforclouddevelopment + WHERE releasestate = 'RELEASED' + AND ReleasedObjectType = 'INTF' + INTO @DATA(num_rel_intf). + + out->write( |\nThere are { num_rel_cl } released classes and { num_rel_intf } released interfaces in the system.| ). + +********************************************************************** + + out->write( heading( `Excursions into the XCO Library` ) ). + "The following code snippets focuse on the XCO library that provides + "predefined functionality and can be used in ABAP for Cloud Development. + "The examples cover a selection of options for you to explore. For more + "detailed information and more code snippets, see the SAP Help Portal + "documentation. In most cases, the examples deal with classes and methods + "for getting information about repository objects. + "Note: + "- Due to the many methods and options, method chaining comes in handy. + "- To further explore the options with the classes and methods, you can + " put the cursor behind => or -> and choose CTRL + Space to get input + " suggestions. + + out->write( |3) Getting Repository Object-Related Information| ). + + "Getting all accessible repository objects in the system (indicated by the + "value provided for "in") + "To further process the returned values, you can loop over them. + DATA(all_obj) = xco_cp_abap_repository=>objects->all->in( xco_cp_abap=>repository )->get( ). + + out->write( |\nThere are { lines( all_obj ) } accessible repository objects in the system. Note that this number also includes custom artifacts.| ). + +********************************************************************** + + "Getting all accessible database tables + "You can specify concrete artifacts (check CTRL + Space after objects->) + DATA(all_tables) = xco_cp_abap_repository=>objects->tabl->all->in( xco_cp_abap=>repository )->get( ). + + out->write( |\nThere are { lines( all_tables ) } accessible database tables in the system. Note that this number includes custom database tables.| ). + +********************************************************************** + + "Checking the existence of a certain package + "Note: The value provided for 'for' is specified in the private section + " of the class. Use the package name in which you cloned the ABAP + " cheat sheets, for example, ZABAP_CHEAT_SHEETS. + + "Creating a handler for the specified package + "You can create a break point here and check out the content of the variable + "in the debugger to find out what information is included. + DATA(package_handle) = xco_cp_abap_repository=>package->for( package ). + DATA(package_exists) = package_handle->exists( ). + "Using method chaining, you can retreive the information in one go. + DATA(package_exists_ch) = xco_cp_abap_repository=>package->for( package )->exists( ). + + IF package_exists IS NOT INITIAL + AND package_exists_ch IS NOT INITIAL. + out->write( |\nThe package { package } exists in the system.| ). + ELSE. + out->write( |\nThe package { package } does not exist in the system.| ). + ENDIF. + +********************************************************************** + + "Getting more information + IF package_exists IS NOT INITIAL. + DATA(package_name) = package_handle->name. + DATA(software_comp) = package_handle->read( )-property-software_component->name. + + out->write( |\nThe package name is { package_name } (retrieved using the "name" attribute).| ). + out->write( |\nIts software component is { software_comp }.| ). + + "Getting all repository objects contained in the package + DATA(all_objs) = xco_cp_abap_repository=>objects->all->in( package_handle )->get( ). + + "Looping over the result for further processing + "In this example, the name of the repository objects and their types are + "extracted and inserted in a table for displaying purposes. + LOOP AT all_objs ASSIGNING FIELD-SYMBOL(). + APPEND VALUE #( name = ->name->value + details = ->type->value ) TO details_tab. + ENDLOOP. + + SORT details_tab BY name. + + out->write( |\nThe package { package } includes the following { lines( details_tab ) } repository objects:| ). + out->write( details_tab ). + ENDIF. + +********************************************************************** + + "Refining the search using a filter and search pattern + "The search patterns uses a name from the ABAP cheat sheets repository objects. + DATA(filter1) = xco_cp_abap_repository=>object_name->get_filter( + xco_cp_abap_sql=>constraint->contains_pattern( 'ZDEMO_ABAP_RAP_R%' ) ). + + "Getting all accessible BDEFs that start with ZDEMO_ABAP_RAP_R in a particular package + "As shown above, loop over the handler to get more detailed information. You can also set + "a break point to check out the content of the variable in the debugger. + IF package_exists = abap_true. + DATA(bdefs_in_package) = xco_cp_abap_repository=>objects->bdef->where( VALUE #( ( filter1 ) + ) )->in( xco_cp_abap=>repository )->get( ). + + out->write( |\nThere are { lines( bdefs_in_package ) } accessible BDEFs with the specified name pattern in the specified package.| ). + ENDIF. + + "Getting all accessible interfaces with a particular name pattern in the entire system + DATA(filter2) = xco_cp_abap_repository=>object_name->get_filter( + xco_cp_abap_sql=>constraint->contains_pattern( 'IF_ABAP_BEHV%' ) ). + + DATA(all_intfs) = xco_cp_abap_repository=>objects->intf->where( VALUE #( ( filter2 ) + ) )->in( xco_cp_abap=>repository )->get( ). + + out->write( |\nThere are { lines( all_intfs ) } accessible interfaces with the specified name pattern in the entire system.| ). + + "Getting repository objects based on a particular software component + "In the example, all classes are retrieved that have a particular name pattern + "and have a particular software component. + DATA(filter3) = xco_cp_system=>software_component->get_filter( xco_cp_abap_sql=>constraint->equal( 'SAP_BASIS' ) ). + DATA(filter4) = xco_cp_abap_repository=>object_name->get_filter( xco_cp_abap_sql=>constraint->contains_pattern( '%CL_ABAP_RAND%' ) ). + DATA(filtered_classes) = xco_cp_abap_repository=>objects->clas->where( VALUE #( ( filter3 ) ( filter4 ) + ) )->in( xco_cp_abap=>repository )->get( ). + + out->write( |\nThere are { lines( filtered_classes ) } accessible classes with the specified name pattern and software component.| ). + +********************************************************************** + + out->write( heading( `4) Getting Database Table-Related Information` ) ). + + "Creating a filter with a search pattern + DATA(pattern) = 'ZDEMO_ABAP_FL%'. + DATA(filter5) = xco_cp_abap_repository=>object_name->get_filter( + xco_cp_abap_sql=>constraint->contains_pattern( pattern ) ). + + "Getting all database tables whose names begin with the specified name pattern + "and that are contained in the package specified above. + DATA(dbtabs) = xco_cp_abap_repository=>objects->tabl->database_tables->where( VALUE #( ( filter5 ) + ) )->in( package_handle )->get( ). + + IF dbtabs IS NOT INITIAL. + + infos = VALUE #( ( |Information about database tables retrieved using search pattern { pattern }| ) ). + LOOP AT dbtabs INTO DATA(db). + "Getting the name of the database table + DATA(a1_name) = db->name. + "Getting information about technical properties (selection) + DATA(a2_content) = db->content( )->get( ). + DATA(a3_descr) = a2_content-short_description. + DATA(a4_del_cl) = a2_content-delivery_class->value. + DATA(a5_data_maint) = a2_content-data_maintenance->if_xco_printable~get_text( )->get_lines( )->join( )->value. + "Getting all fields of the database table + "The handler is further processed. In the example, only the field names are retreived. + DATA(a6_fields) = db->fields->all->get( ). + + CLEAR str. + LOOP AT a6_fields INTO DATA(fields). + str = str && COND #( WHEN sy-tabix <> 1 THEN `, ` ELSE `` ) && fields->name. + ENDLOOP. + + infos = VALUE #( BASE infos + ( `*********************************` ) + ( |Db table name: { a1_name }| ) + ( |Description: { a3_descr }| ) + ( |Delivery class: { a4_del_cl }| ) + ( |Data maintenance: { a5_data_maint }| ) + ( |Field names: { str }| ) ). + + ENDLOOP. + out->write( infos ). + CLEAR infos. + ELSE. + out->write( |\nNo database tables found.| ). + ENDIF. + +********************************************************************** + + "Getting information about a particular database table + out->write( |\nInformation about a particular demo database table| ). + DATA(db_table) = CONV sxco_dbt_object_name( 'ZDEMO_ABAP_CARR' ). + DATA(b1_handler) = xco_cp_abap_dictionary=>database_table( db_table ). + DATA(b2_exists) = b1_handler->exists( ). + IF b2_exists IS NOT INITIAL. + DATA(b3_name) = b1_handler->name. + DATA(b4_descr) = b1_handler->content( )->get_short_description( ). + DATA(b5_del_cl) = b1_handler->content( )->get_delivery_class( )->value. + DATA(b6_data_maint) = a2_content-data_maintenance->if_xco_printable~get_text( )->get_lines( )->join( )->value. + DATA(b7_fields) = b1_handler->fields->all->get_names( ). + DATA(b8_keys) = b1_handler->fields->key->get_names( ). + DATA(b9_vis) = b1_handler->get_api_state( )->get_visibilities( ). + DATA(b10_rel_state) = b1_handler->get_api_state( )->get_release_state( )->value. + + CLEAR str. + "Getting information about the Visibilities of the repository object + LOOP AT b9_vis INTO DATA(vis_b). + CASE abap_true. + WHEN vis_b->use_in_key_user_apps( ). + str = |Key user: { vis_b->use_in_key_user_apps( ) }|. + WHEN vis_b->use_in_sap_cloud_platform( ). + str = str && | Cloud: { vis_b->use_in_sap_cloud_platform( ) }|. + ENDCASE. + ENDLOOP. + + infos = VALUE #( + ( |Information about database table { db_table }| ) + ( `*********************************` ) + ( |Db table name: { b3_name }| ) + ( |Description: { b4_descr }| ) + ( |Delivery class: { b5_del_cl }| ) + ( |Data maintenance: { b6_data_maint }| ) + ( |Visibilities: { COND #( WHEN str IS INITIAL THEN `None` ELSE str ) }| ) + ( |Release state: { b10_rel_state }| ) + ( |Field names: { concat_lines_of( table = b7_fields sep = `, ` ) }| ) + ( |Key fields: { concat_lines_of( table = b8_keys sep = `, ` ) }| ) + ). + + out->write( infos ). + CLEAR infos. + ELSE. + out->write( |\nThe database table { db_table } does not exist.| ). + ENDIF. + +********************************************************************** + + out->write( |\nInformation about a particular database table field| ). + + IF b2_exists IS NOT INITIAL. + db_table = 'ZDEMO_ABAP_CARR'. + DATA(db_field) = CONV sxco_ad_field_name( 'CARRID' ). + DATA(c1_handler) = xco_cp_abap_dictionary=>database_table( db_table )->field( db_field )->content( ). + + "Getting attributes of the field + DATA(c2_field_attributes) = c1_handler->get( ). + DATA(c3_is_key) = c2_field_attributes-key_indicator. + DATA(c4_is_not_null) = c2_field_attributes-not_null. + "You can get the information also using a different way, as shown below. + DATA(c5_built_in_t) = c2_field_attributes-type->get_built_in_type( )->abap_type->get_type_descriptor( )->type_kind. + "Getting information using the handler created initially and for getting attributes individually. + DATA(c6_field_name) = c1_handler->field->name. + DATA(c7_db_name) = c1_handler->field->database_table->name. + DATA(c8_is_key) = c1_handler->get_key_indicator( ). + "You may want to check the details for the following variable in the debugger. + DATA(c9_type_handler) = c1_handler->get_type( ). + DATA(c10_built_in_t) = c9_type_handler->get_built_in_type( )->abap_type->get_type_descriptor( )->type_kind. + DATA(c11_type_outp_len) = c9_type_handler->get_built_in_type( )->abap_type->get_type_descriptor( )->output_length. + DATA(c12_type_abs_name) = c9_type_handler->get_built_in_type( )->abap_type->get_type_descriptor( )->absolute_name. + + infos = VALUE #( + ( |Information about field { db_field } in database table { db_table }| ) + ( `*********************************` ) + ( |Field name: { c6_field_name }| ) + ( |Db table name: { c7_db_name }| ) + ( |Is key field: { c3_is_key } (Alternative retrieval: { c8_is_key })| ) + ( |Is not null: { c4_is_not_null }| ) + ( |Built-in type of field: { c5_built_in_t } (Alternative retrieval: { c10_built_in_t })| ) + ( |Output length: { c11_type_outp_len }| ) + ( |Absolute name of type: { c12_type_abs_name }| ) ). + + out->write( infos ). + CLEAR infos. + ELSE. + out->write( |\nThe database table { db_table } does not exist.| ). + ENDIF. + +********************************************************************** + + out->write( heading( `5) Getting Data Element-Related Information` ) ). + + "Getting information about a released data element + DATA(dtel) = CONV sxco_ad_object_name( 'MANDT' ). + DATA(d1_handler) = xco_cp_abap_dictionary=>data_element( dtel ). + DATA(d2_exists) = d1_handler->exists( ). + IF d2_exists IS NOT INITIAL. + DATA(d3_name) = d1_handler->name. + DATA(d4_vis) = d1_handler->get_api_state( )->get_visibilities( ). + DATA(d5_rel_state) = d1_handler->get_api_state( )->get_release_state( )->value. + DATA(d6_descr) = d1_handler->content( )->get_short_description( ). + DATA(d7_built_in_t) = d1_handler->content( )->get_underlying_built_in_type( )->abap_type->get_type_descriptor( )->type_kind. + DATA(d8_type_outp_len) = d1_handler->content( )->get_underlying_built_in_type( )->abap_type->get_type_descriptor( )->output_length. + + CLEAR str. + "Processing Visibilities information + LOOP AT d4_vis INTO DATA(vis_d). + CASE abap_true. + WHEN vis_d->use_in_key_user_apps( ). + str = |Key user: { vis_d->use_in_key_user_apps( ) }|. + WHEN vis_d->use_in_sap_cloud_platform( ). + str = str && | Cloud: { vis_d->use_in_sap_cloud_platform( ) }|. + ENDCASE. + ENDLOOP. + + infos = VALUE #( + ( |Information about data element { dtel }| ) + ( `*********************************` ) + ( |Data element name: { d3_name }| ) + ( |Short description: { d6_descr }| ) + ( |Visibilities: { COND #( WHEN str IS INITIAL THEN `None` ELSE str ) }| ) + ( |Release state: { d5_rel_state }| ) + ( |Built-in type: { d7_built_in_t }| ) + ( |Output length: { d8_type_outp_len }| ) ). + + out->write( infos ). + CLEAR infos. + ELSE. + out->write( |\nThe data element { dtel } does not exist.| ). + ENDIF. + +********************************************************************** + + out->write( heading( `6) Getting Table Type-Related Information` ) ). + + DATA(tab_type) = CONV sxco_ad_object_name( 'STRING_TABLE' ). + DATA(e1_handler) = xco_cp_abap_dictionary=>table_type( tab_type ). + DATA(e2_exists) = e1_handler->exists( ). + IF e2_exists IS NOT INITIAL. + DATA(e3_name) = e1_handler->name. + DATA(e4_vis) = e1_handler->get_api_state( )->get_visibilities( ). + DATA(e5_rel_state) = e1_handler->get_api_state( )->get_release_state( )->value. + DATA(e6_descr) = e1_handler->content( )->get_short_description( ). + DATA(e7_tab_key) = e1_handler->content( )->get_primary_key( )->key_definition->value. + DATA(e8_tab_key) = e1_handler->content( )->get_primary_key( )->key_definition->if_xco_printable~get_text( )->get_lines( )->join( )->value. + DATA(e9_type_abs_name) = e1_handler->content( )->get_row_type( )->get_built_in_type( )->abap_type->get_type_descriptor( )->absolute_name. + + CLEAR str. + "Processing Visibilities information + LOOP AT e4_vis INTO DATA(vis_e). + CASE abap_true. + WHEN vis_e->use_in_key_user_apps( ). + str = |Key user: { vis_e->use_in_key_user_apps( ) }|. + WHEN vis_e->use_in_sap_cloud_platform( ). + str = str && | Cloud: { vis_e->use_in_sap_cloud_platform( ) }|. + ENDCASE. + ENDLOOP. + + infos = VALUE #( + ( |Information about table type { tab_type }| ) + ( `*********************************` ) + ( |Table type name: { e3_name }| ) + ( |Short description: { e6_descr }| ) + ( |Visibilities: { COND #( WHEN str IS INITIAL THEN `None` ELSE str ) }| ) + ( |Release state: { e5_rel_state }| ) + ( |Table key: { e7_tab_key } (i.e. { e8_tab_key })| ) + ( |Absolute type name of underlying built-in type: { e9_type_abs_name }| ) ). + + out->write( infos ). + CLEAR infos. + ELSE. + out->write( |\nThe table type { tab_type } does not exist.| ). + ENDIF. + +********************************************************************** + + out->write( heading( `7) Getting CDS View Entity-Related Information` ) ). + + DATA(cds) = CONV sxco_cds_object_name( 'ZDEMO_ABAP_CDS_VE_ASSOC' ). + DATA(f1_handler) = xco_cp_cds=>view_entity( cds ). + DATA(f2_exists) = f1_handler->exists( ). + IF f2_exists IS NOT INITIAL. + DATA(f3_name) = f1_handler->name. + "You may want to check the details for the following variable in the debugger. + DATA(f4_content) = f1_handler->content( )->get( ). + "Fields of the CDS view entity + DATA(f5_field_handler) = f1_handler->fields->all->get( ). + DATA(f6_get_field_names) = f1_handler->fields->all->get_names( ). + DATA(f7_field_names) = concat_lines_of( table = f6_get_field_names sep = `, ` ). + + CLEAR infos. + "Getting field information using the field handler + LOOP AT f5_field_handler INTO DATA(cds_field). + DATA(f8_field_name) = cds_field->name. + APPEND f8_field_name TO infos. + "The demo CDS view entity does not have much included for displaying purposes. + "Therefore, you may create a break point here and check the variable content in + "the debugger for various pieces of information that are accessible. + DATA(f9_field_content) = cds_field->content( )->get( ). + ENDLOOP. + + DATA(f10_field_names) = concat_lines_of( table = infos sep = `, ` ). + + "Getting the associations of the view entity + DATA(f11_assoc) = f1_handler->associations->all->get( ). + + CLEAR infos. + LOOP AT f11_assoc INTO DATA(assoc). + DATA(f12_assoc_name) = assoc->name. + APPEND f12_assoc_name TO infos. + "You may want to check the details for the following variable in the debugger. + DATA(f13_assoc_details) = assoc->content( )->get( ). + ENDLOOP. + + DATA(f14_assocs) = concat_lines_of( table = infos sep = `, ` ). + + infos = VALUE #( + ( |Information about CDS view entity { cds }| ) + ( `*********************************` ) + ( |CDS view entity name: { f3_name }| ) + ( |Field names: { f7_field_names }| ) + ( |Alternative field name retrieval: { f10_field_names }| ) + ( |Association names: { f14_assocs }| ) ). + + out->write( infos ). + CLEAR infos. + ELSE. + out->write( |\nThe CDS view entity { cds } does not exist.| ). + ENDIF. + +********************************************************************** + + out->write( |\nCDS View Entity Example with Parameters| ). + + cds = 'ZDEMO_ABAP_CDS_VE_SEL'. + DATA(g1_handler) = xco_cp_cds=>view_entity( cds ). + DATA(g2_exists) = g1_handler->exists( ). + IF g2_exists IS NOT INITIAL. + DATA(g3_name) = g1_handler->name. + + "Getting parameters + DATA(g4_params) = g1_handler->parameters->all->get( ). + LOOP AT g4_params INTO DATA(param). + DATA(g5_param_name) = param->content( )->get_original_name( ). + DATA(g6_param_built_in_type) = param->content( )->get_data_type( )->is_built_in_type( ). + IF g6_param_built_in_type IS NOT INITIAL. + DATA(g7_type_abs_name) = param->content( )->get_data_type( )->get_built_in_type( )->abap_type->get_type_descriptor( )->absolute_name. + ENDIF. + APPEND |{ g5_param_name } { COND #( WHEN g6_param_built_in_type IS NOT INITIAL THEN `(Absolute type name: ` && g7_type_abs_name && `)` ELSE `` ) } | TO infos. + ENDLOOP. + + DATA(g8_all_params) = concat_lines_of( table = infos sep = `, ` ). + + infos = VALUE #( + ( |Information about CDS view entity { cds }| ) + ( `*********************************` ) + ( |CDS view entity name: { g3_name }| ) + ( |Parameter: { g8_all_params }| ) ). + + out->write( infos ). + CLEAR infos. + ELSE. + out->write( |\nThe CDS view entity { cds } does not exist.| ). + ENDIF. + +********************************************************************** + + out->write( |\nCDS View Entity Example with Compositions| ). + + cds = 'ZDEMO_ABAP_RAP_RO_M'. + DATA(h1_handler) = xco_cp_cds=>view_entity( cds ). + DATA(h2_exists) = h1_handler->exists( ). + IF h2_exists IS NOT INITIAL. + DATA(h3_name) = h1_handler->name. + + DATA(h4_comps) = h1_handler->compositions->all->get( ). + LOOP AT h4_comps INTO DATA(comp). + + DATA(h5_entity_name) = comp->entity->name. + DATA(h6_fields) = comp->entity->fields->all->get_names( ). + DATA(h7_target_name) = comp->target. + DATA(h8_cardinality_max) = comp->content( )->get( )-cardinality-max. + DATA(h9_cardinality_min) = comp->content( )->get( )-cardinality-min. + DATA(h10_alias) = comp->content( )->get( )-alias. + + APPEND |Entity: { h5_entity_name } Fields: { concat_lines_of( table = h6_fields sep = `, ` ) } | && + |Target: { h7_target_name } Cardinality: Min { h9_cardinality_min } Max { h8_cardinality_max } | && + |Alias: { h10_alias } | TO infos. + ENDLOOP. + + DATA(h11_comps) = concat_lines_of( table = infos sep = `, ` ). + + infos = VALUE #( + ( |Information about CDS view entity { cds }| ) + ( `*********************************` ) + ( |CDS view entity name: { h3_name }| ) + ( |Compositions: { h11_comps }| ) ). + + out->write( infos ). + CLEAR infos. + ELSE. + out->write( |\nThe CDS view entity { cds } does not exist.| ). + ENDIF. + +********************************************************************** + + out->write( heading( `8) Getting Interface-Related Information` ) ). + + "Getting a list of all implementations of a given interface + DATA(intf) = CONV sxco_ao_object_name( 'ZDEMO_ABAP_OBJECTS_INTERFACE' ). + DATA(i1_handler) = xco_cp_abap=>interface( intf ). + DATA(i2_exist) = i1_handler->exists( ). + IF i2_exist IS NOT INITIAL. + DATA(i3_name) = i1_handler->name. + + "Getting static data object declarations + DATA(i4_stat_dobj) = i1_handler->components->class_data->all->get( ). + + CLEAR str. + LOOP AT i4_stat_dobj INTO DATA(do). + str = str && COND #( WHEN sy-tabix <> 1 THEN `, ` ELSE `` ) && do->name. + ENDLOOP. + + DATA(i5_stat_dobjs) = str. + CLEAR str. + + "Getting instance methods + DATA(i5_in_meth) = i1_handler->components->method->all->get( ). + LOOP AT i5_in_meth INTO DATA(imeth). + DATA(i6_in_meth_name) = imeth->name. + + str = str && COND #( WHEN sy-tabix <> 1 THEN ` / ` ELSE `` ) && imeth->name. + + "Getting formal parameter names using get_names + DATA(params) = imeth->parameters->all->get_names( ). + + "Getting formal parameters + DATA(i7_formal_params) = imeth->parameters->all->get( ). + DATA i8_p TYPE string. + LOOP AT i7_formal_params INTO DATA(p). + DATA(i9_pname) = p->name. + DATA(i10_ptype) = p->content( )->get_kind( )->if_xco_printable~get_text( )->get_lines( )->join( )->value. + APPEND |{ i9_pname } ({ i10_ptype })| TO infos. + ENDLOOP. + + str = |{ str } (Parameters: { concat_lines_of( table = infos sep = ` ` ) })|. + CLEAR infos. + ENDLOOP. + + "Getting information about where the interface is implemented + "You may want to check the details for the following variable in the debugger. + DATA(i11_intf_impl_get) = i1_handler->implementations->all->get( ). + DATA(i11_intf_impl_names) = i1_handler->implementations->all->get_names( ). + + infos = VALUE #( + ( |Information about interface { intf }| ) + ( `*********************************` ) + ( |Interface name: { i3_name }| ) + ( |Static data objects (CLASS-DATA) in interface: { i5_stat_dobjs }| ) + ( |Instance methods (METHODS) in interface: { str }| ) + ( |Implementations of the interface exist here: { concat_lines_of( table = i11_intf_impl_names sep = `, ` ) }| ) ). + + out->write( infos ). + CLEAR: infos, str. + ELSE. + out->write( |\nThe interface { intf } does not exist.| ). + ENDIF. + +********************************************************************** + + out->write( heading( `9) Getting Class-Related Information` ) ). + + DATA(cl) = CONV sxco_ao_object_name( 'ZCL_DEMO_ABAP_UNIT_TEST' ). + DATA(j1_handler) = xco_cp_abap=>class( cl ). + DATA(j2_exists) = j1_handler->exists( ). + IF j2_exists IS NOT INITIAL. + DATA(j3_name) = j1_handler->name. + "Accessing definition part + "You may want to check the details for the following variable in the debugger. + DATA(j4_name) = j1_handler->definition->content( )->get( ). + "Getting instance methods in the private visibility section + DATA(j5_in_meth_priv) = j1_handler->definition->section-private->components->method->all->get( ). + + CLEAR details_tab. + LOOP AT j5_in_meth_priv INTO DATA(in_meth_priv). + DATA(j6_in_meth_priv_name) = in_meth_priv->name. + APPEND VALUE #( name = j6_in_meth_priv_name ) TO details_tab. + "Getting formal paramter information + DATA(j7_params) = in_meth_priv->parameters->all->get( ). + DATA j8_form_param TYPE string. + CLEAR j8_form_param. + LOOP AT j7_params INTO DATA(par). + DATA(j9_par_name) = par->name. + DATA(j10_par_kind) = par->content( )->get_kind( )->if_xco_printable~get_text( )->get_lines( )->join( )->value. + DATA(j11_par_type) = par->content( )->get_typing_definition( )->get_value( ). + j8_form_param = j8_form_param && |{ j9_par_name } (Kind: { j10_par_kind }, Type: { j11_par_type }) / |. + ENDLOOP. + REPLACE PCRE `/\s$` IN j8_form_param WITH ``. + details_tab[ name = j6_in_meth_priv_name ]-details = j8_form_param. + ENDLOOP. + + "Accessing impementation part of a particular method and getting source code + DATA(method_name) = CONV sxco_clas_method_name( 'CLASS_CONSTRUCTOR' ). + DATA(j12_method_content) = j1_handler->implementation->method( method_name )->content( )->get( ). + + DATA(j13_method_source_code) = xco_cp=>strings( j12_method_content-source + )->join( |{ cl_abap_char_utilities=>cr_lf }| + )->value. + + "Getting the source code using the get_source method + "You may want to check the details for the following variable in the debugger. + DATA(j14_get_source) = j1_handler->implementation->method( 'IF_OO_ADT_CLASSRUN~MAIN' )->content( )->get_source( ). + DATA(j15_method_source_code_b) = xco_cp=>strings( j14_get_source + )->join( |{ cl_abap_char_utilities=>cr_lf }| + )->value. + + out->write( |Information about class { cl }| ). + out->write( |\nInstance methods and their formal parameters| ). + out->write( details_tab ). + CLEAR details_tab. + out->write( |\nSource code of implementation part of method { method_name }| ). + out->write( j13_method_source_code ). + ELSE. + out->write( |\nThe class { cl } does not exist.| ). + ENDIF. + +********************************************************************** + + out->write( |\nGetting Subclasses| ). + + cl = 'CL_ABAP_TYPEDESCR'. + DATA(k1_handler) = xco_cp_abap=>class( cl ). + DATA(k2_exists) = k1_handler->exists( ). + IF k2_exists = abap_true. + "You may want to check the details for the following variable in the debugger. + DATA(k3_get_subclasses) = k1_handler->subclasses->all->get( ). + "Getting the names of the subclasses + DATA(k4_subclass_names) = k1_handler->subclasses->all->get_names( ). + + out->write( data = k4_subclass_names name = `k4_subclass_names` ). + ELSE. + out->write( |\nThe class { cl } does not exist.| ). + ENDIF. + +********************************************************************** + + out->write( heading( `10) Getting AMDP-Related Information` ) ). + + cl = 'ZCL_DEMO_ABAP_AMDP'. + method_name = 'SELECT_GET_CARR_FLI'. + DATA(l1_handler) = xco_cp_abap=>class( cl ). + DATA(l2_exists) = l1_handler->exists( ). + IF l2_exists IS NOT INITIAL. + DATA(l3_name) = l1_handler->name. + "Getting content of the method + DATA(l4_content) = l1_handler->implementation->method( method_name )->content( )->get( ). + DATA(l5_db_type) = l4_content-amdp-database_type->if_xco_abap_token~get_source( ). + DATA(l6_db_lang) = l4_content-amdp-database_language->if_xco_abap_token~get_source( ). + IF l4_content-amdp-database_options IS NOT INITIAL. + DATA(l4_db_opt) = l4_content-amdp-database_options[ 1 ]->if_xco_abap_token~get_source( ). + ENDIF. + + CLEAR str. + LOOP AT l4_content-amdp-database_entities INTO DATA(amdp_ent). + str = str && ` ` && amdp_ent->if_xco_printable~get_text( )->get_lines( )->join( )->value. + ENDLOOP. + + DATA(l5_method_source_code) = l4_content-source. + DATA(l6_meth_source_code) = xco_cp=>strings( l5_method_source_code )->join( |{ cl_abap_char_utilities=>cr_lf }| )->value. + + infos = VALUE #( + ( |Information about AMDP class { cl }| ) + ( `*********************************` ) + ( |Class name: { l3_name }| ) + ( |Db type: { l5_db_type }| ) + ( |Db language: { l6_db_lang }| ) + ( |Db options: { l4_db_opt }| ) + ( |Db entities: { str }| ) ). + + out->write( infos ). + CLEAR: infos, str. + out->write( |\nSource code of implementation part of method { method_name }| ). + out->write( l6_meth_source_code ). + ELSE. + out->write( |\nThe interface { intf } does not exist.| ). + ENDIF. + +********************************************************************** + + out->write( heading( `11) Getting sy-Related Information Using XCO` ) ). + "Among others, the examples cover time and date-related information. + + "Creating a time stamp + DATA(m_moment) = xco_cp_time=>moment( + iv_year = '2024' + iv_month = '01' + iv_day = '01' + iv_hour = '12' + iv_minute = '34' + iv_second = '55' ). + + "Getting user time zone + DATA(m1_user_time_zone) = xco_cp_time=>time_zone->user->value. + "Result is of type string + DATA(m2_moment_string) = m_moment->as( xco_cp_time=>format->abap )->value. + "Result of type string using other formatting + DATA(m3_moment_format_a) = m_moment->as( xco_cp_time=>format->iso_8601_basic )->value. + DATA(m4_moment_format_b) = m_moment->as( xco_cp_time=>format->iso_8601_extended )->value. + "Current moment in the time zone of the current user + DATA(m5_cur_moment4user) = xco_cp=>sy->moment( xco_cp_time=>time_zone->user )->as( xco_cp_time=>format->iso_8601_extended )->value. + "Current moment in UTC + DATA(m6_cur_moment_utc) = xco_cp=>sy->moment( xco_cp_time=>time_zone->utc )->as( xco_cp_time=>format->iso_8601_extended )->value. + "Current UNIX timestamp + DATA(m7_unix_tstmp) = xco_cp=>sy->unix_timestamp( )->value. + "For the time, you can also use the TIME method + DATA(m8_time) = xco_cp=>sy->time( xco_cp_time=>time_zone->user )->as( xco_cp_time=>format->iso_8601_extended )->value. + "Getting second, minute, hour information + DATA(m9_seconds) = xco_cp=>sy->time( xco_cp_time=>time_zone->user )->second. + DATA(m10_minutes) = xco_cp=>sy->time( xco_cp_time=>time_zone->user )->minute. + DATA(m11_hours) = xco_cp=>sy->time( xco_cp_time=>time_zone->user )->hour. + "Calculations + DATA(m12_add_time) = xco_cp=>sy->time( xco_cp_time=>time_zone->user )->add( iv_hour = 1 iv_minute = 1 iv_second = 1 )->as( xco_cp_time=>format->iso_8601_extended )->value. + DATA(m13_subtract_time) = xco_cp=>sy->time( xco_cp_time=>time_zone->user )->subtract( iv_hour = 1 iv_minute = 1 iv_second = 1 )->as( xco_cp_time=>format->iso_8601_extended )->value. + "Dates + DATA(m14_date) = xco_cp=>sy->date( )->as( xco_cp_time=>format->iso_8601_extended )->value. + DATA(m15_day) = xco_cp=>sy->date( )->day. + DATA(m16_month) = xco_cp=>sy->date( )->month. + DATA(m17_year) = xco_cp=>sy->date( )->year. + "Calculations + DATA(m18_add_date) = xco_cp=>sy->date( )->add( iv_day = 1 iv_month = 1 iv_year = 1 )->as( xco_cp_time=>format->iso_8601_extended )->value. + DATA(m19_subtract_date) = xco_cp=>sy->date( )->subtract( iv_day = 1 iv_month = 1 iv_year = 1 )->as( xco_cp_time=>format->iso_8601_extended )->value. + "Getting technical name of user, see also the API cl_abap_context_info + DATA(m20_user_name) = xco_cp=>sy->user( )->name. + + out->write( data = m1_user_time_zone name = `m1_user_time_zone` ). + out->write( data = m2_moment_string name = `m2_moment_string` ). + out->write( data = m3_moment_format_a name = `m3_moment_format_a` ). + out->write( data = m4_moment_format_b name = `m4_moment_format_b` ). + out->write( data = m5_cur_moment4user name = `m5_cur_moment4user` ). + out->write( data = m6_cur_moment_utc name = `m6_cur_moment_utc` ). + out->write( data = m7_unix_tstmp name = `m7_unix_tstmp` ). + out->write( data = m8_time name = `m8_time` ). + out->write( data = m9_seconds name = `m9_seconds` ). + out->write( data = m10_minutes name = `m10_minutes` ). + out->write( data = m11_hours name = `m11_hours` ). + out->write( data = m12_add_time name = `m12_add_time` ). + out->write( data = m13_subtract_time name = `m13_subtract_time` ). + out->write( data = m14_date name = `m14_date` ). + out->write( data = m15_day name = `m15_day` ). + out->write( data = m16_month name = `m16_month` ). + out->write( data = m17_year name = `m17_year` ). + out->write( data = m18_add_date name = `m18_add_date` ). + out->write( data = m19_subtract_date name = `m19_subtract_date` ). + out->write( data = m20_user_name name = `m20_user_name` ). + +********************************************************************** + + out->write( heading( `12) Generating Repository Objects Using XCO` ) ). + "The example covers the generation of a domain, data element and a + "database table using XCO. + "NOTE: + "To carry out the object generation, make sure that you meet the following + "prerequisites: + "1) You have a modifiable transport request (suitable for demo content). In + " ADT, got to the Transport Organizer tab, check that you have a transport + " request available under "Modifiable". Otherwise, create a new transport + " request. + " Copy the ID of the transport request and insert it in the constant "tr_req_id" + " that is available in the private Visibilities section of the class. + " + "2) You have specified a package for demo content, for example, the + " package of the ABAP cheat sheets, which is "ZABAP_CHEAT_SHEETS" in the example. + " Make sure that you have assigned the constant "package4gen" a value + " with a valid package iin which you want to create the demo repository + " objects. + " + "3) You have provided suitable names for the demo objects. Check and, if need be, + " change the constant values for gen_dtel, gen_doma, gen_tabl. + " + "4) To "enable" the generation, assign the constant "generation_ok" the value + " "abap_true". + " + "The generation of the objects is only carried out if all of the mentioned + "prerequisites are met. Find more code snippets about repository object + "generation in the SAP Help Portal documentation. + + "Checking validity of the specified transport request ID + TRY. + DATA(n1_handler) = xco_cp_cts=>transport->for( tr_req_id ). + DATA(n2_exists) = n1_handler->exists( ). + DATA(n3_status) = n1_handler->get_status( ). + CATCH CX_root INTO DATA(e). + ENDTRY. + + "Checking if repository objects with the names specified already exist in the system + DATA(n6_exists_tabl) = xco_cp_abap_dictionary=>database_table( gen_tabl )->exists( ). + DATA(n7_exists_dtel) = xco_cp_abap_dictionary=>data_element( gen_dtel )->exists( ). + DATA(n8_exists_doma) = xco_cp_abap_dictionary=>domain( gen_doma )->exists( ). + + CASE abap_true. + WHEN n6_exists_tabl. + DATA(flag) = abap_true. + WHEN n7_exists_dtel. + flag = abap_true. + WHEN n8_exists_doma. + flag = abap_true. + WHEN OTHERS. + ENDCASE. + + "Checking if pacakge exists + DATA(n9_exists_devc) = xco_cp_abap_repository=>package->for( package4gen )->exists( ). + + IF n2_exists IS NOT INITIAL + AND n3_status = xco_cp_transport=>status->modifiable + AND flag IS INITIAL + AND n9_exists_devc = abap_true + AND generation_ok = abap_true. + + DATA(n10_handler) = xco_cp_generation=>environment->dev_system( tr_req_id ). + DATA(n11_put) = n10_handler->create_put_operation( ). + +********************************************************************** + "Domain + DATA(n12_doma_spec) = n11_put->for-doma->add_object( gen_doma + )->set_package( package4gen + )->create_form_specification( ). + n12_doma_spec->set_short_description( 'Demo domain' ). + n12_doma_spec->set_format( xco_cp_abap_dictionary=>built_in_type->char( 10 ) ). + n12_doma_spec->fixed_values->add_fixed_value( 'BOOKED' + )->set_description( 'Booked' ). + n12_doma_spec->fixed_values->add_fixed_value( 'CANCELED' + )->set_description( 'Canceled' ). +********************************************************************** + "Data element + DATA(n13_dtel_spec) = n11_put->for-dtel->add_object( gen_dtel + )->set_package( package4gen + )->create_form_specification( ). + n13_dtel_spec->set_short_description( 'Booking status' ). + + n13_dtel_spec->set_data_type( xco_cp_abap_dictionary=>domain( gen_doma ) ). +*********************************************************************** + "Database table + DATA(n14_tabl_spec) = n11_put->for-tabl-for-database_table->add_object( gen_tabl + )->set_package( package4gen + )->create_form_specification( ). + n14_tabl_spec->set_short_description( 'Booking request' + )->set_delivery_class( xco_cp_database_table=>delivery_class->a + )->set_data_maintenance( xco_cp_database_table=>data_maintenance->allowed ). + n14_tabl_spec->add_field( 'CLIENT' )->set_type( xco_cp_abap_dictionary=>built_in_type->clnt + )->set_key_indicator( + )->set_not_null( ). + n14_tabl_spec->add_field( 'ID' )->set_type( xco_cp_abap_dictionary=>built_in_type->char( 30 ) + )->set_key_indicator( + )->set_not_null( ). + "Using built-in ABAP types + n14_tabl_spec->add_field( 'FROM_DATE' )->set_type( xco_cp_abap_dictionary=>built_in_type->dats ). + n14_tabl_spec->add_field( 'TO_DATE' )->set_type( xco_cp_abap_dictionary=>built_in_type->dats ). + "Using the created data element + n14_tabl_spec->add_field( 'STATUS' )->set_type( xco_cp_abap_dictionary=>data_element( gen_dtel ) ). + "Using a released data element + n14_tabl_spec->add_field( 'USER_NAME' )->set_type( xco_cp_abap_dictionary=>data_element( 'SYUNAME' ) ). +********************************************************************** + "Executing the generation + TRY. + n11_put->execute( ). + out->write( `Generation successful. Check out the newly created repository objects in the Project Explorer. Refresh the target package.` ). + CATCH cx_xco_gen_put_exception INTO DATA(err). + out->write( err->get_text( ) ). + ENDTRY. + + ELSE. + CLEAR details_tab. + out->write( `The following information is displayed if the generation has not been carried out. Before generating the ` && + `repository objects, all of the following prerequisites must be met.` ). + details_tab = VALUE #( + ( name = `Transport request` details = `n2_exists: "` && n2_exists && `" / The value for "n2_exists" should be "X". ` && + `Otherwise, it indicates that the transport request does not exist. In that case, provide a suitable transport ` && + `request ID for the constant in the private section.` ) + ( name = `Modifiable transport request` details = COND #( WHEN e IS INITIAL THEN `n3_status: "` && n3_status->value && + `" / The value for "n3_status" should be "` && xco_cp_transport=>status->modifiable->value && + `". Otherwise, it indicates that the transport request is not modifiable. In that case, provide a suitable transport ` && + `request ID for the constant in the private section.` ELSE `There is an issue with the transport request ID provided: ` && + e->get_text( ) ) ) + ( name = `Package` details = `n9_exists_devc: "` && n9_exists_devc && `" / The value for "n9_exists_devc" should be "X". ` && + `Otherwise, it indicates that the package name as specified does not exist in the system. In that case, provide an ` && + `existing package name for the constant in the private section.` ) + ( name = `Repository object names` details = `flag: "` && flag && `" / The value for "flag" should be "" (initial). Otherwise, ` && + `it indicates that one or more artifacts with the same names as provided already exist in the system. In that case, ` && + `provide other names.` ) + ( name = `generation_ok flag` details = `generation_ok: "` && generation_ok && `" / The value for generation_ok should ` && + `be "X". Otherwise, it indicates that the execution of the generation is disabled. In that case, change the value of the constant ` && + `in the private section to "abap_true" to carry out the generation.` ) ). + out->write( details_tab ). + ENDIF. + ENDMETHOD. + METHOD heading. + output = |\n_________________________________________________________________________________\n\n{ text }\n\n|. + ENDMETHOD. +ENDCLASS. diff --git a/src/zcl_demo_abap_cloud_excursion.clas.xml b/src/zcl_demo_abap_cloud_excursion.clas.xml new file mode 100644 index 0000000..5f790f7 --- /dev/null +++ b/src/zcl_demo_abap_cloud_excursion.clas.xml @@ -0,0 +1,16 @@ + + + + + + ZCL_DEMO_ABAP_CLOUD_EXCURSION + E + ABAP cheat sheet: Excursions into ABAP for Cloud Development + 1 + X + X + X + + + +