UI5/Fiori und der Cache!

Veröffentlicht am 4. Mai 202215. November 2024 von Johann Fößleitner

Viele kennen die Situation. Man hat im Entwicklungssystem eine super coole UI5/Fiori App für ein S/4HANA System gebastelt, aber nach dem Import in das Produktivsystem (oder Q-System) geht erstmal gar nix. Target was not found, Type Error, Unknown Setting, Cannot read properties, …

Sehr oft liegen die Gründe der Probleme am Cache! Nicht nur am Browser Cache, auch im SAP Backend gibt es mehrere zu berücksichtigende Caches. Nachfolgend eine Auflistung der Cache Themen, die mir im Zuge meiner Arbeit untergekommen sind.

Eigentlich unglaublich, wie viele Caches man ggf. löschen / invalidieren muss.

Wichtiger Hinweis: Das sind meine persönlichen Erfahrungen, bitte verwendet die Reports oder Transaktionen nur nach vorheriger Prüfung. Es kann durchaus sein, dass der eine oder andere Report obsolet wird oder in gewissen System nicht verwendet werden darf! Ich übernehme keine Garantie, dass die Reports oder Transaktionen in euren Systemen einwandfrei und korrekt funktionieren.

Name	Typ	Erläuterung	Bereich
/UI5/APP_INDEX_CALCULATE	Report	Ab UI Add-On 2.0+ Sollte periodisch eingeplant sein	UI / App
/UI2/DELETE_CACHE	Report	Löscht UI2 Services & Target Mapping Caches	UI / App / Lpd
/IWFND/CACHE_CLEANUP	Transaktion	Clean Frontend OData Cache	GW
/IWBEP/CACHE_CLEANUP	Transaktion	Clean Backend OData Cache	GW
ICM Server Cache		Global Invalidieren	UI / App / GW
/UI2/INVALIDATE_CLIENT_CACHES	Report	Client Cache Invalidation Fiori Launchpad / Cache Buster	UI / App
/UI2/INVALIDATE_GLOBAL_CACHES	Report	Invalidiert alle UI2 Caches (Alle Services mit /UI2/*, SHMM, … )	UI / App
/UI5/UPD_ODATA_METADATA_CACHE	Report	OData Cache – Cache Buster Tokens	UI / App
/UI5/UPDATE_CACHEBUSTER	Report	Nur für UI Add-On 1.0	UI / APP
CL_SADL_LOAD_AREA	Shared Memory	Shared Memory invalidieren	UI / APP
/UI2/FLP_DEL_PERSONALIZATION	Report	SAP Fiori Launchpad Personalisierungen	UI / APP
/UI2/PAGE_CACHE_SYNCHRONIZE /UI2/SYNC_PBC	Report Transaction	Synchronization of the User-Independent Cache	UI / APP
/UI2/EAM_BUILD_CACHE	Report	App Finder Performance Cache	UI / APP
Browser Cache		IE, Chrome, … Cache	UI / APP

/UI5/APP_INDEX_CALCULATE

Das ist mein Lieblingsreport in dem Zusammenhang, da er mir in den meisten Fällen immer die Probleme löst. Es gibt einen Applikationsindex und Caching für Apps, Komponenten und Libraries. Dieser Report löscht bzw. invalidiert diese Caches / Indextabellen und ist im Normalfall automatisch eingeplant.

Ich habe jedoch die Erfahrung gemacht, dass nach einem Transport von Änderungen einer UI5 Anwendung, ein explizites Ausführen des Reports für die jeweilige Anwendung notwendig ist.

Weiter Informationen zu dem Report können hier entnommen werden:

SAP Note – 2449635
help.sap.com

/UI2/DELETE_CACHE

Hier geht es um das Löschen des UI2 Cache. Dieser kann für einen User oder generell gelöscht werden.

/IWFND/CACHE_CLEANUP und /IWBEP/CACHE_CLEANUP

Invalidiert / Löscht das oData Model (SEGW oder RAP) am Frontend- und Backend-Server.

/UI2/INVALIDATE_CLIENT_CACHES

Dieser Report sollte überhaupt nur in Ausnahmefällen notwendig sein – wenn der UI5 Cache Buster im Einsatz ist. Eine Erklärung zum Report gibt es unter help.sap.com.

/UI2/INVALIDATE_GLOBAL_CACHES

Invalidiert alle globalen UI2 Caches. Bitte die Dokumentation des Reports im System beachten.

/UI5/UPD_ODATA_METADATA_CACHE

Der Report löscht die OData Caches Tokens. Bitte auch hier die Dokumentation des Reports beachten.

/UI5/UPDATE_CACHEBUSTER

Der sorgt dafür, dass der Cache Buster mit dem aktuellsten UI5 Metadaten arbeitet. Der Report ist jedoch nur bei Systemen mit UI Add-On 1.0 einzusetzen. Bei Systemen mit einem höheren UI Add-On Release ist hingegen /UI5/APP_INDEX_CALCULATE zu verwenden.

SAP Note 2474334

/UI2/FLP_DEL_PERSONALIZATION

Fiori Launchpad Homepages können normalerweise durch den Anwender personalisiert werden. Es können neue Gruppen angelegt werden, Apps entfernt oder hinzugefügt werden. Manchmal ist es notwendig, solche Personalisierungen zurückzusetzen. Beispielsweise nach Änderungen im Fiori Katalog oder einer Fiori Gruppe. Ein Erklärung zu der Funktion ist hier beschrieben.

/UI2/PAGE_CACHE_SYNCHRONIZE

Der Report bereinigt Cache Probleme im Bereich der Launchpad Catalogs/Groups. Laut SAP sollte der Report regelmäßig eingeplant werden. Der Report ist auch über die Transaktion /UI2/SYNC_PBC erreichbar.

help.sap.com

/UI2/EAM_BUILD_CACHE

Hier geht es um die Performance im Bereich App Finder. Weiter Informationen zu dem Report können hier entnommen werden:

SAP Note – 2545066
help.sap.com

Sonstiges

Änderungen an Service-Definitionen müssen manchmal manuell in Transportaufträgen aufgenommen und transportiert werden.

Fazit

Es vergeht fast kein Transport wo nicht irgendein Cache ein Problem bereitet. Aber mit dem /UI5/APP_INDEX_CALCULATE bekommt man das meist in den Griff.

Ich werden diesen Blogpost nach und nach um weitere Erkenntnisse in dem Zusammenhang ergänzen.

Fuzzy Search für Rapid Report Generator Reports

Veröffentlicht am 3. Mai 20224. Mai 2023 von Domi Bigl

Die SAP HANA Datenbank bietet mit der FUZZY Funktion eine fehlertolerante Textsuche. Während diese Suche für Fiori Applikationen relativ einfach über CDS-Annotations aktiviert werden kann, muss man für ABAP SQL oder ABAP ein paar Objekte anlegen und ein wenig programmieren.

@Search.searchable : true
define …
{
  @Search.defaultSearchElement : true
  @Search.fuzzinessThreshold : 0.7
  @Search.ranking : #HIGH
  ...
}

@Search.searchable : true

define …

{

@Search.defaultSearchElement : true

@Search.fuzzinessThreshold : 0.7

@Search.ranking : #HIGH

...

}

Der Rapid Report Generator – RRG – kann neben ALV Reports auch CDS Views und ABAP Klassen als Datenquelle verwenden. Damit ergeben sich zwei Möglichkeiten eine Fuzzy Suche in RRG Reports anzubieten. In diesem Post schauen wir uns die AMDP Variante an.

AMDPs – ABAP Managed Database Procedures

AMDP bieten die Möglichkeit, SAP HANA Features zu verwenden, die nicht über openSQL/ABAP SQL bereitgestellt werden (z.B. Fuzzy-Suche). Sie sind also eine Erweiterung des bekannten EXEC_SQL. Da AMDP als Methoden in globalen Klassen implementiert sind, können sie auch aus jedem ABAP Coding aufgerufen werden.

Was man für AMDP braucht und wie man die Fuzzy-Suche nutzt steht hier in einem unseren älteren Beiträgen: AMDP – Fuzzy Search im ABAP® mit SAP HANA®

Im RRG kann man ABAP Coding über den Report Typ ABAPCLASS einbinden.

Bei diesem Report Typ erfolgt die Datenbeschaffung über das Interface /CADAXO/IF_UI38_TYPE_ABAPCLASS. Wir erstellen also eine Klasse mit diesem Interface und legen den Report an.

Methode EXECUTE_QUERY

Wir verwenden dafür die vorhandene Klasse aus dem Post, ergänzen sie um das Interface und implementieren die Methode /cadaxo/if_ui38_type_abapclass~execute_query.

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION
  PUBLIC
  FINAL
  CREATE PUBLIC .

  PUBLIC SECTION.

    INTERFACES /cadaxo/if_ui38_type_abapclass.
    INTERFACES if_amdp_marker_hdb.

    TYPES: ty_orders TYPE STANDARD TABLE OF /CADAXO/UI38D_Demo_Orders WITH DEFAULT KEY.

    METHODS search_orders IMPORTING VALUE(i_search_term) TYPE string
                          EXPORTING VALUE(e_orders)      TYPE ty_orders.

  PROTECTED SECTION.
  PRIVATE SECTION.
ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

...
...

  METHOD /cadaxo/if_ui38_type_abapclass~execute_query.

    FIELD-SYMBOLS: <result> TYPE ANY TABLE.

    TRY.
        DATA(search_term) = i_filter_select_options[ property = 'NAME' ]-select_options[ 1 ]-low.

        me->search_orders( EXPORTING i_search_term = search_term
                           IMPORTING e_orders      = DATA(orders) ).

        e_count = lines( orders ).
        ASSIGN e_result->* TO <result>.
        <result> = CORRESPONDING #( orders ).

      CATCH cx_sy_itab_line_not_found.
        e_count = 0.
    ENDTRY.

  ENDMETHOD.

ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION

PUBLIC

FINAL

CREATE PUBLIC .

PUBLIC SECTION.

INTERFACES /cadaxo/if_ui38_type_abapclass.

INTERFACES if_amdp_marker_hdb.

TYPES: ty_orders TYPE STANDARD TABLE OF /CADAXO/UI38D_Demo_Orders WITH DEFAULT KEY.

METHODS search_orders IMPORTING VALUE(i_search_term) TYPE string

EXPORTING VALUE(e_orders) TYPE ty_orders.

PROTECTED SECTION.

PRIVATE SECTION.

ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

...

METHOD /cadaxo/if_ui38_type_abapclass~execute_query.

FIELD-SYMBOLS: <result> TYPE ANY TABLE.

TRY.

DATA(search_term) = i_filter_select_options[ property = 'NAME' ]-select_options[ 1 ]-low.

me->search_orders( EXPORTING i_search_term = search_term

IMPORTING e_orders = DATA(orders) ).

e_count = lines( orders ).

ASSIGN e_result->* TO <result>.

<result> = CORRESPONDING #( orders ).

CATCH cx_sy_itab_line_not_found.

e_count = 0.

ENDTRY.

ENDMETHOD.

ENDCLASS.

Wir holen uns den eingegebenen Suchbegriff aus dem Filterfeld für Name, rufen die AMDP Methode search_orders( ) auf und liefern das Ergebnis an das RRG Framework.

RRG Report

Mit der Transaktion /CADAXO/UI§(_ADMIN legen wir den RRG Report SEARCH_ORDERS_FUZZY mit dem Typ ABAPCLASS an. Als Result Structure verwenden wir /CADAXO/UI38D_Demo_Orders und als ABAP Klasse natürlich /CADAXO/CL_UI38_DMO_ORDER_AMDP.

Die wichtigsten Einstellungen erfolgen bei den Feldern. Hier muss im Bereich Filter Fields der Feld Name als filterbar gekennzeichnet werden. Weiters macht es Sinn den Filter als Pflichtfeld zu definieren und nur einen Einzelwert zuzulassen.

Ergebnisliste

Wir haben jetzt einen Fiori List Report mit fehlertoleranter Suche nach Kundennamen – implementiert in einer ABAP Managed Database Procedure.

ABAP CDS Table Functions – AMDPs für CDS

Mit CDS Table Functions können AMDPs als Datenquelle von CDS Views dienen. Diese können dann in openSQL/ABAP SQL Queries verwendet werden. Ein Post hierzu folgt demnächst! Stay tuned 😉

Links

Hier eine kleine Sammlung an relevanten und nützlichen Links zu diesem Thema:

SAP HANA Fuzzy Search https://help.sap.com/docs/SAP_HANA_PLATFORM/691cb949c1034198800afde3e5be6570/cc602780bb5710148aa2bf6cab3c015b.html?&locale=en-US

Fuzzy Search für Fiori Anwendung https://help.sap.com/docs/ABAP_PLATFORM_BW4HANA/cc0c305d2fab47bd808adcad3ca7ee9d/6f9212bbaf5e4d598c774b96d93f7b79.html?locale=en-US

AMDP https://help.sap.com/doc/abapdocu_753_index_htm/7.53/de-DE/abenamdp.htm

ABAP® CDS Table Functions – AMDP – Fuzzy Search für ABAP® SQL mit SAP HANA®

Veröffentlicht am 2. Mai 20224. Mai 2023 von Domi Bigl

Im vorangegangenen Post AMDP – Fuzzy Search im ABAP® mit SAP HANA® verwenden wir eine AMDP, um mit ABAP Coding eine Fuzzy Suche durchzuführen. Um diese Suche auch in SQL Statements verwenden zu können – z.B. bei INSERT brauchen wir ABAP CDS Table Functions. Dieser Beitrag bietet hierfür einen Leitfaden und erläutert die Thematik Schritt-für-Schritt.

ABAP CDS Table Function

Hier ist der Ausgangspunkt eine Data Definition – mittels DDL wird die Table Funktion als Datasource definiert und über die Felder die Struktur festgelegt. Table Functions können auch Parameter besitzen.

@ClientDependent: false
@EndUserText.label: 'ui38 - demo - Orders'
define table function /CADAXO/UI38D_DEMO_ORDER_SH
  with parameters
    name_search :abap.char( 50 )
returns
{
  key OrderId     : /cadaxo/ui38_dmo_order_id;
      CustomerId  : /cadaxo/ui38_dmo_customer_id;
      ProductId   : /cadaxo/ui38_dmo_product_id;
      OrderDate   : /cadaxo/ui38_dmo_order_date;
      Quantity    : /cadaxo/ui38_dmo_quantity;
      Unit        : /cadaxo/ui38_dmo_unit;
      TotalPrice  : /cadaxo/ui38_dmo_price;
      Currency    : /cadaxo/ui38_dmo_currency;
      Description : /cadaxo/ui38_dmo_description;
      Name        : /cadaxo/ui38_dmo_name;
      Score       : /cadaxo/ui38_dmo_score;
}
implemented by method /cadaxo/cl_ui38_dmo_order_amdp=>search_orders_CDS;

@ClientDependent: false

@EndUserText.label: 'ui38 - demo - Orders'

define table function /CADAXO/UI38D_DEMO_ORDER_SH

with parameters

name_search :abap.char( 50 )

returns

{

key OrderId : /cadaxo/ui38_dmo_order_id;

CustomerId : /cadaxo/ui38_dmo_customer_id;

ProductId : /cadaxo/ui38_dmo_product_id;

OrderDate : /cadaxo/ui38_dmo_order_date;

Quantity : /cadaxo/ui38_dmo_quantity;

Unit : /cadaxo/ui38_dmo_unit;

TotalPrice : /cadaxo/ui38_dmo_price;

Currency : /cadaxo/ui38_dmo_currency;

Description : /cadaxo/ui38_dmo_description;

Name : /cadaxo/ui38_dmo_name;

Score : /cadaxo/ui38_dmo_score;

}

implemented by method /cadaxo/cl_ui38_dmo_order_amdp=>search_orders_CDS;

Auffallend ist das returns vor der Feldlist. Damit wird die Struktur der Datensource festgelegt. Wichtiger ist aber der implemented by method Teil, hier /cadaxo/cl_ui38_dmo_order_amdp=>search_orders_CDS

Wenn die Klasse schon existiert, kann die Methode einfach per Quick-Fix angelegt werden!

AMDP Klasse und Methode anlegen

Auch Table Function AMDP werden als spezielle Methode in einer ABAP Klasse implementiert – die Definition erfolgt wie bei jeder anderen Klasse.

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION
  PUBLIC
  FINAL
  CREATE PUBLIC .

  PUBLIC SECTION.
    INTERFACES if_amdp_marker_hdb.

    CLASS-METHODS search_orders_CDS FOR TABLE FUNCTION /cadaxo/ui38d_demo_order_sh.

  PROTECTED SECTION.
  PRIVATE SECTION.
ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION

PUBLIC

FINAL

CREATE PUBLIC .

PUBLIC SECTION.

INTERFACES if_amdp_marker_hdb.

CLASS-METHODS search_orders_CDS FOR TABLE FUNCTION /cadaxo/ui38d_demo_order_sh.

PROTECTED SECTION.

PRIVATE SECTION.

ENDCLASS.

Durch das Interface IF_AMDP_MARKER_HDB wird die Klasse besonders, was bei der Schnittstellendefinition der statischen Methode search_orders_CDS erkennbar ist: „Verwende alle Parameter der Table Function als Importing Parameter und die Feldliste als Struktur der Return Tabelle“. Aber auch im Implementierungs-Teil erkennt man den Sonderstatus.

CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

  METHOD search_orders_CDS BY DATABASE FUNCTION
                           FOR HDB LANGUAGE SQLSCRIPT
                           OPTIONS READ-ONLY
                           USING /cadaxo/ui38d_demo_orders.
    RETURN SELECT OrderId,
                  CustomerId,
                  ProductId,
                  OrderDate,
                  Quantity,
                  Unit,
                  TotalPrice,
                  Currency,
                  Description,
                  Name,
                  score( ) as Score
                  from "/CADAXO/UI38D_DEMO_ORDERS"
                  WHERE contains( Name, :name_search, fuzzy( 0.0 ) );

  ENDMETHOD.

ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

METHOD search_orders_CDS BY DATABASE FUNCTION

FOR HDB LANGUAGE SQLSCRIPT

OPTIONS READ-ONLY

USING /cadaxo/ui38d_demo_orders.

RETURN SELECT OrderId,

CustomerId,

ProductId,

OrderDate,

Quantity,

Unit,

TotalPrice,

Currency,

Description,

Name,

score( ) as Score

from "/CADAXO/UI38D_DEMO_ORDERS"

WHERE contains( Name, :name_search, fuzzy( 0.0 ) );

ENDMETHOD.

ENDCLASS.

Die Methodenimplementierung hat einige zusätzliche Statements – Details gibt es auf https://help.sap.com/doc/abapdocu_750_index_htm/7.50/de-de/abapmethod_by_db_proc.htm

BY DATABASE FUNCTION	„Ich bin eine AMDP.“
FOR HDB	Derzeit nur „HDB“ – Kommen auch andere Datenbanken?!?!
LANGUAGE SQLSCRIPT	Wir nehmen SQLSCRIPT.
OPTIONS READ-ONLY	Wir lesen nur, geändert wird nicht!
USING /cadaxo/ui38d_demo_orders	Wir wollen die Bestellungen aus /cadaxo/ui38d_demo_orders

Details zur Fuzzy Search findet man hier: https://help.sap.com/docs/SAP_HANA_PLATFORM/691cb949c1034198800afde3e5be6570/ce619608bb5710148a42ebb92208b5cd.html?locale=en-US

Daten selektieren

Auf Table Functions wird ganz normal mittels ABAP SQL zugegriffen

    SELECT FROM /cadaxo/ui38d_demo_order_sh( name_search = 'Hat Nägel' ) 
           fields OrderId,
                  CustomerId, 
                  ProductId,  
                  OrderDate,  
                  Quantity,   
                  Unit,       
                  TotalPrice, 
                  Currency,   
                  Description,
                  Name,       
                  Score      
           INTO TABLE @DATA(orders).

SELECT FROM /cadaxo/ui38d_demo_order_sh( name_search = 'Hat Nägel' )

fields OrderId,

CustomerId,

ProductId,

OrderDate,

Quantity,

Unit,

TotalPrice,

Currency,

Description,

Name,

Score

INTO TABLE @DATA(orders).

Der SELECT im SQL Cockpit for SAP® Systems

AMDP – Fuzzy Search im ABAP® mit SAP HANA®

Veröffentlicht am 27. April 20224. Mai 2023 von Domi Bigl

Die SAP HANA Datenbank bietet viele nützliche und coole Funktionen, die über openSQL/ABAP SQL hinaus gehen. Um auf diese Features zuzugreifen und die ganze Power der HANA Datenbank nutzen zu können, gibt es ABAP Managed Database Procedures – AMDP. Damit kann man, ähnlich wie mit EXEC SQL bzw. ADBC (ABAP Database Connectivity), native Datenbank Statements absetzen. In diesem Blogbeitrag beschäftigen wir uns mit den nötigen Anlage- und Implementierungsschritten.

AMDP Klasse und Methode anlegen

AMDP werden als spezielle Methode in einer ABAP Klasse implementiert – die Definition erfolgt wie bei jeder anderen Klasse:

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION
  PUBLIC
  FINAL
  CREATE PUBLIC .

  PUBLIC SECTION.

    INTERFACES if_amdp_marker_hdb.

    TYPES: ty_orders TYPE STANDARD TABLE OF /CADAXO/UI38D_Demo_Orders WITH DEFAULT KEY.

    METHODS search_orders IMPORTING VALUE(i_search_term) TYPE string
                          EXPORTING VALUE(e_orders)      TYPE ty_orders.

  PROTECTED SECTION.
  PRIVATE SECTION.
ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION

PUBLIC

FINAL

CREATE PUBLIC .

PUBLIC SECTION.

INTERFACES if_amdp_marker_hdb.

TYPES: ty_orders TYPE STANDARD TABLE OF /CADAXO/UI38D_Demo_Orders WITH DEFAULT KEY.

METHODS search_orders IMPORTING VALUE(i_search_term) TYPE string

EXPORTING VALUE(e_orders) TYPE ty_orders.

PROTECTED SECTION.

PRIVATE SECTION.

ENDCLASS.

Durch das Interface IF_AMDP_MARKER_HDB wird die Klasse besonders, was man im Implementierungs-Teil sehen kann:

CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

  METHOD search_orders BY DATABASE PROCEDURE
                       FOR HDB LANGUAGE SQLSCRIPT
                       OPTIONS READ-ONLY
                       USING /cadaxo/ui38d_demo_orders.

    e_orders = select OrderId,
                      CustomerId,
                      ProductId,
                      OrderDate,
                      Quantity,
                      Unit,
                      TotalPrice,
                      Currency,
                      Description,
                      Name,
                      from "/CADAXO/UI38D_DEMO_ORDERS";
  ENDMETHOD.

ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

METHOD search_orders BY DATABASE PROCEDURE

FOR HDB LANGUAGE SQLSCRIPT

OPTIONS READ-ONLY

USING /cadaxo/ui38d_demo_orders.

e_orders = select OrderId,

CustomerId,

ProductId,

OrderDate,

Quantity,

Unit,

TotalPrice,

Currency,

Description,

Name,

from "/CADAXO/UI38D_DEMO_ORDERS";

ENDMETHOD.

ENDCLASS.

Die Methodenimplementierung hat einige zusätzliche Statements – Details dazu gibt es auf https://help.sap.com/doc/abapdocu_750_index_htm/7.50/de-de/abapmethod_by_db_proc.htm

BY DATABASE PROCEDURE	„Ich bin eine AMDP.“
FOR HDB	Derzeit nur „HDB“ – Kommen auch andere Datenbanken?!?!
LANGUAGE SQLSCRIPT	Wir nehmen SQLSCRIPT.
OPTIONS READ-ONLY	Wir lesen nur, geändert wird nicht!
USING /cadaxo/ui38d_demo_orders	Wir wollen die Bestellungen aus /cadaxo/ui38d_demo_orders.

AMDP Method aufrufen

Aufgerufen wir die AMDP Methode wie jede andere auch:

    new /cadaxo/cl_ui38_dmo_order_amdp( )->search_orders( EXPORTING i_search_term = 'Hat Nägel'
                                                          IMPORTING e_orders      = data(orders) ).

1 2	new /cadaxo/cl_ui38_dmo_order_amdp( )->search_orders( EXPORTING i_search_term = 'Hat Nägel' IMPORTING e_orders = data(orders) ).

Fuzzy Search

Ok, der SELECT ist nicht gerade spektakulär – das geht auch mit ABAP SQL. Aber eine fehlertolerante Fuzzy Search?!?

Wir wollen Bestellungen zu Kundennamen finden, auch wenn wir den nicht so ganz genau kennen. Dabei hilft uns CONTAINS und FUZZY – https://help.sap.com/docs/SAP_HANA_PLATFORM/691cb949c1034198800afde3e5be6570/9a4da8f6f23b4ebf95c98f1104a56db4.html?&locale=en-US

Wir erweitern den SELECT um eine WHERE Klausel und suchen wie folgt nach dem Namen:

    e_orders = select OrderId,
                      CustomerId,
                      ProductId,
                      OrderDate,
                      Quantity,
                      Unit,
                      TotalPrice,
                      Currency,
                      Description,
                      Name
                      from "/CADAXO/UI38D_DEMO_ORDERS"
                      where contains( Name, :i_search_term, fuzzy( 0.5 ) );

e_orders = select OrderId,

CustomerId,

ProductId,

OrderDate,

Quantity,

Unit,

TotalPrice,

Currency,

Description,

Name

from "/CADAXO/UI38D_DEMO_ORDERS"

where contains( Name, :i_search_term, fuzzy( 0.5 ) );

Die FUZZY Funktion liefert alle Namen zurück, deren Vergleich mit dem I_Search_Term mindestens einen Score von 0.5 ergibt. Das klingt erstmal einfach, kann aber ziemlich knifflig werden, vor allem, wenn man die Treffermenge, Genauigkeit und Relevanz für Benutzer optimieren möchte. Der passende Schwellenwert ist dann oft nur empirisch ermittelbar.

SCORE

Um den errechneten Wert der Übereinstimmung anzuzeigen und danach zu sortieren, gibt es die Funktion SCORE. Mit FUZZY( 0.0) werden alle Namen mit einem ermittelten Score größer 0 ausgegeben.

    e_orders = select OrderId,
                      CustomerId,
                      ProductId,
                      OrderDate,
                      Quantity,
                      Unit,
                      TotalPrice,
                      Currency,
                      Description,
                      Name,
                      score( ) as Score
                      from "/CADAXO/UI38D_DEMO_ORDERS"
                      where contains( Name, :i_search_term, fuzzy( 0.0 ) );

e_orders = select OrderId,

CustomerId,

ProductId,

OrderDate,

Quantity,

Unit,

TotalPrice,

Currency,

Description,

Name,

score( ) as Score

from "/CADAXO/UI38D_DEMO_ORDERS"

where contains( Name, :i_search_term, fuzzy( 0.0 ) );

Eine Suche nach „Hat Nägel“ ergibt dann z.B. folgende Trefferliste:

Komplettes Coding

Das ganze Coding sieht folgendermaßen aus:

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION
  PUBLIC
  FINAL
  CREATE PUBLIC .

  PUBLIC SECTION.

    INTERFACES if_oo_adt_classrun.

    INTERFACES if_amdp_marker_hdb.

    TYPES: ty_score TYPE p LENGTH 3 DECIMALS 2.
    TYPES: BEGIN OF ty_order.
             INCLUDE TYPE /CADAXO/UI38D_Demo_Orders.
    TYPES:   Score TYPE ty_score,
           END OF ty_order.


    TYPES: ty_orders TYPE STANDARD TABLE OF ty_order WITH DEFAULT KEY.

    METHODS search_orders IMPORTING VALUE(i_search_term) TYPE string
                          EXPORTING VALUE(e_orders)      TYPE ty_orders.

  PROTECTED SECTION.
  PRIVATE SECTION.
ENDCLASS.



CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

  METHOD search_orders BY DATABASE PROCEDURE
                       FOR HDB LANGUAGE SQLSCRIPT
                       OPTIONS READ-ONLY
                       USING /cadaxo/ui38d_demo_orders.

    e_orders = select OrderId,
                      CustomerId,
                      ProductId,
                      OrderDate,
                      Quantity,
                      Unit,
                      TotalPrice,
                      Currency,
                      Description,
                      Name,
                      score( ) as Score
                      from "/CADAXO/UI38D_DEMO_ORDERS"
                      where contains( Name, :i_search_term, fuzzy( 0.0 ) );
  ENDMETHOD.

  METHOD if_oo_adt_classrun~main.

    new /cadaxo/cl_ui38_dmo_order_amdp( )->search_orders( EXPORTING i_search_term = 'Hat Nägel'
                                                          IMPORTING e_orders      = data(orders) ).

    out->write( name = 'Bestellungen zur Suche:' && '`Hat Nägel`' data = orders ).

  ENDMETHOD.

ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp DEFINITION

PUBLIC

FINAL

CREATE PUBLIC .

PUBLIC SECTION.

INTERFACES if_oo_adt_classrun.

INTERFACES if_amdp_marker_hdb.

TYPES: ty_score TYPE p LENGTH 3 DECIMALS 2.

TYPES: BEGIN OF ty_order.

INCLUDE TYPE /CADAXO/UI38D_Demo_Orders.

TYPES: Score TYPE ty_score,

END OF ty_order.

TYPES: ty_orders TYPE STANDARD TABLE OF ty_order WITH DEFAULT KEY.

METHODS search_orders IMPORTING VALUE(i_search_term) TYPE string

EXPORTING VALUE(e_orders) TYPE ty_orders.

PROTECTED SECTION.

PRIVATE SECTION.

ENDCLASS.

CLASS /cadaxo/cl_ui38_dmo_order_amdp IMPLEMENTATION.

METHOD search_orders BY DATABASE PROCEDURE

FOR HDB LANGUAGE SQLSCRIPT

OPTIONS READ-ONLY

USING /cadaxo/ui38d_demo_orders.

e_orders = select OrderId,

CustomerId,

ProductId,

OrderDate,

Quantity,

Unit,

TotalPrice,

Currency,

Description,

Name,

score( ) as Score

from "/CADAXO/UI38D_DEMO_ORDERS"

where contains( Name, :i_search_term, fuzzy( 0.0 ) );

ENDMETHOD.

METHOD if_oo_adt_classrun~main.

new /cadaxo/cl_ui38_dmo_order_amdp( )->search_orders( EXPORTING i_search_term = 'Hat Nägel'

IMPORTING e_orders = data(orders) ).

out->write( name = 'Bestellungen zur Suche:' && '`Hat Nägel`' data = orders ).

ENDMETHOD.

ENDCLASS.

Hinzufügen von Suchhilfen zu einem Report

Veröffentlicht am 13. April 20224. Mai 2023 von Domi Bigl

Der Rapid Report Generator for SAP Fiori® – RRG – bietet mehrere Möglichkeiten Suchhilfen für Filterfelder bereitzustellen. Dazu muss zunächst die RRG-Suchhilfe im RRG definiert und entsprechend ihres Typs konfiguriert werden. Dann kann die RRG-Suchhilfe jedem passenden Feld in jedem RRG-Report zugewiesen werden. Felder können auch mehrere RRG-Suchhilfen besitzen.

1. Suchhilfe definieren

RRG-Suchhilfen werden in der Admintransaktion definiert und bearbeitet.

Bei der Anlage muss ein eindeutiger Name und einer dieser Typen von RRG-Suchhilfen gewählt werden:

Domain Values
Elementare Suchhilfe (SE11)
View

Die Konfiguration der RSuchhilfe ist natürlich typabhängig.

Domain Values

Für Domain Values muss die Domäne definiert werden.

Elementare Suchhilfe

Neben der SAP-Suchhilfe muss auch genau ein Feld aus den Suchhilfeparametern ausgewählt werden. Der Wert dieses Feldes wird dann von der RRG-Suchhilfe zurück geliefert.

Alle Felder aus dem Suchhilfeergebnis

Hinweis: Es kann JEDES Felder der SAP-Suchhilfeergebnislist verwendet werden, nicht nur welche, die als EXPORT-Parameter definiert sind!

View

Als Datasource können die folgenden Objekte verwendet werden:

Tabelle
DB-View (SE11)
CDS View/Entity

2. Suchhilfe den Feldern zuordnen

Eine RRG-Suchhilfe kann jedem filterbaren Feld in jedem Report zugeordnet werden. Ein Feld kann auch mehrere RRG-Suchhilfen haben.

In der App kann dann zwischen den RSuchhilfen gewechselt werden.

Webinar – Modernize your ABAP®

Veröffentlicht am 24. März 20224. Mai 2023 von Johann Fößleitner

Vielen Dank für Ihre Teilnahme an unserem Webinar!

Wir sind ja mit Selbstlob sehr zurückhaltend – aber die Erklärung von Domi zu Table Expressions & Table Functions zählt mit zu den besten Erklärungen die ich bisher zu dem Thema gesehen habe!

Natürlich sind auch Sörens Erklärungen zu Field Symbols bzw. Reference hervorzuheben und mein Part zu CORRESPONDING ist bis auf ein paar Versprecher auch ganz gut.

Unterlagen/Links zum Webinar „Modernize your ABAP“

Präsentationsunterlagen in PDF – Diesmal gab es keine Slides
YouTube Videoaufzeichnung: https://youtu.be/KnmxHhLedpk
ABAP Code https://github.com/cadaxo/Webinars/tree/modernize-your-abap-20220225

Video Sprungmarken

- Table Expressions & Table Functions – https://youtu.be/KnmxHhLedpk?t=221
- New & Cast – https://youtu.be/KnmxHhLedpk?t=1020
- CORRESPONDING/CL_ABAP_CORRESPONDING – https://youtu.be/KnmxHhLedpk?t=1682
- String Expressions/Templates – https://youtu.be/KnmxHhLedpk?t=2457
- Field Symbols/Reference, Value – https://youtu.be/KnmxHhLedpk?t=2908

Twitter

Sören Schlegel, https://twitter.com/SoSchlegel87
Dominik Bigl, https://twitter.com/DomiBiglSAP
Johann Fößleitner, https://twitter.com/foessleitnerj

Unser nächstes Webinar

Das Thema steht noch nicht fest, aber der Termin steht schon einmal: 29. April 2022 – Und registrieren kann man sich auch schon: https://www.eventbrite.at/e/webinar-cooler-inhalt-folgt-tickets-305097915077

Webinar – ABAP® RESTful Application Programming Model (RAP) – Teil 3

Veröffentlicht am 28. September 20214. Mai 2023 von Johann Fößleitner

Vielen Dank für Ihre Teilnahme an unserem Webinar!

Das spannende Thema RAP wird uns alle noch viele Jahre beschäftigen. In unseren nächsten Webinaren werden wir uns erst einmal wieder anderen ABAP Themen beschäftigen. Wir sind noch nicht sicher, ob unser nächstes Webinare im November stattfinden wird. Unsere ganze Aufmerksamkeit gilt nämlich nun der ABAPConf welche am 9. Dezember 2021 über die Bühne gehen wird. Ein Tag an dem sich alles um ABAP dreht! Einfach hier auf Eventbrite registrieren, damit ihr in der Sache am Laufenden bleibt! Für das Event selber ist keine Registrierung notwendig.

Unterlagen/Links zum Webinar „ABAP RESTful Application Programming Model (RAP) – 3. Teil“

Präsentationsunterlagen in PDF: Webinar – ABAP RAP – Teil 3
YouTube Videoaufzeichnung: https://youtu.be/bgEZH4g6hqQ

Teilnehmer

Deutschland 44%
Österreich 41%
Schweiz 3.5 %
Rest 11.5 % (Tschechien, Ungarn, Türkei, Weißrussland, UK)

Twitter

Sören Schlegel, https://twitter.com/SoSchlegel87
Dominik Bigl, https://twitter.com/DomiBiglSAP
Johann Fößleitner, https://twitter.com/foessleitnerj

Unsere nächtes Webinar

Findet vielleicht im noch im November oder erst im nächsten Jahr statt. Aber dafür gibt es mit der ABAPconf einen perfekten Ersatz! Wir würden uns freuen, wenn wir Euch bei der ABAPConf wieder sehen würden.

Webinar – ABAP® RESTful Application Programming Model (RAP) – Teil 2

Veröffentlicht am 1. Juli 20214. Mai 2023 von Johann Fößleitner

Vielen Dank für Ihre Teilnahme an unserem Webinar!

Auch das nächste Webinar im September wird zum Thema RAP sein. Es gibt genug Themen. – Anmeldelink befindet sich ganz unten in diesem Blog.

Unterlagen/Links zum Webinar „ABAP RESTful Application Programming Model (RAP) – 2. Teil“

Präsentationsunterlagen in PDF: Webinar – ABAP RAP
Youtube Videoaufzeichnung: https://youtu.be/_njhLP7DsTQ

Webinar – ABAP RESTful Application Programming Model (RAP)
Webinar – ABAP RESTful Application Programming Model (RAP) – Teil 2
Webinar – ABAP RESTful Application Programming Model (RAP) – Teil 3

Teilnehmer

Deutschland 52%
Österreich 38%
Schweiz 5 %
Rest 5 % (Belgien, Frankreich, Polen, USA)

Twitter

Sören Schlegel, https://twitter.com/SoSchlegel87
Dominik Bigl, https://twitter.com/DomiBiglSAP
Johann Fößleitner, https://twitter.com/foessleitnerj

Unsere nächtes Webinar

Freitag 24. September 2021, 10:00 Uhr – ABAP RESTful Application Programming Model (RAP) – 3. Teil

Webinar – ABAP® RESTful Application Programming Model (RAP)

Veröffentlicht am 30. April 202116. Oktober 2024 von Johann Fößleitner

Vielen Dank für Ihre Teilnahme an unserem Webinar!

Wie angekündigt, werden wir uns auch im nächsten Webinar mit RAP beschäftigen. Dann etwas mehr im Detail. – Anmeldelink befindet sich ganz unten in diesem Blog.

Unterlagen/Links zum Webinar „ABAP RESTful Application Programming Model (RAP)“

Präsentationsunterlagen in PDF: Webinar ABAP RAP
Youtube Videoaufzeichnung: https://youtu.be/XzDN1llm0Fo

Blogs/Links

Webinar – ABAP RESTful Application Programming Model (RAP)
Webinar – ABAP RESTful Application Programming Model (RAP) – Teil 2
Webinar – ABAP RESTful Application Programming Model (RAP) – Teil 3

FAQ

Es gab einige Fragen im Verlauf des Webinars:

Frage: Ist das ABAP RESTful Programming Model, zu dem es ja auch Literatur von SAP Press gibt, das selbe wie RAP?
- Antwort: Ja genau RAP = RESTful Applicatino Programming Model
Frage: Wie kann ich verhindern, dass bei Projections auf einen Root-View, die Compositionen verlorenen gehen?
- Antwort: Bei der Projection muss man die Composition umbiegen auf die Projection des „Kindes“
Frage: OData V4 geht auf onPrem mit 2020 SPS01.
- Antwort: Jop!
Frage: Die neuen, nicht mehr DDIC basierten, View-Entities kann man leider nicht mit den SE16* Transaktionen auswerten. Wisst ihr da einen Workaround? Ist gerade für Troubleshooting auf Nicht-Entwicklungssystemen und Mandanten immer ganz praktisch, da man dort oft keinen ADT Zugriff hat. Zudem ist es für Nicht-Entwickler auch nützlich im die Views, bzw. die Daten zu validieren.
- Antwort: Da gäbe es unser Cadaxo SQL Cockpit.
Frage: Welche Eclipse Version habt Ihr im Einsatz?
- Antwort: Eclipse 2020-12 mit ABAP 3.16 -> immer the Latest and greatest! – Ergänzung Föß: Ich aktualisiere Eclipse immer alle 3 Monate, sobald eine neue Version rauskommt. ADT Update checke und update ich ggf. täglich.
Frage: Was ist der unterschied von define root view und definde root view entity?
- Antwort: ROOT VIEW ist noch DDIC basiert (DDIC View)
Frage: Gibt es hier ein Thema Locking auf den DB-Tabellen?
- Antwort: Locking geht natürlich auch: Sperrobjekte, Optimistisches Locking im eTag (das kommt beim nächsten Mal ganz sicher), Draft
Frage: Domi hat das managed Szenario oder?
- Antwort: Domi verwendet das Managed Szenario, aber dem EML ist es egal was drunter läuft – ob managed oder un-managed
Frage: Starkes Webinar. Vielen Dank für den Vortrag. Macht das ganze viel sympatischer wenn es live (coding) durchgeführt wird!
- Antwort: Danke dir!
Frage: Danke. Wollte nur wissen, ob man die neueste Version nutzen kann, nicht das es Probleme gibt.
- Antwort: Immer die neueste von ADT und Eclipse – man sollte aber 1 bis 2 Wochen warten mit dem Eclipse update, bis auch die SAP 100%ig nachgezogen hat 🙂
Frage: Eine Verständnisfrage, in den Beispielen der SAP sieht man immer die Implementierung auf Basis „selbst“ erstellter Tabellen. Aber wie funktioniert das ganze Model, wenn ich auf APIs (OneOrder, BP usw) zugreifen muss. Ich will ja nicht unbedingt Daten lesen und schreiben mit direktem Tabellen Zugriff.
- Antwort: Dieses Thema versuchen wir beim nächsten oder übernächsten Webinar aufzugreifen.

CDS View Entities / CDS Root View Entities

Wir haben im Webinar immer mit CDS ROOT VIEW ENTITIES gearbeitet. CDS View Entites sind ab aber erst ABAP 7.55 verfügbar und es handelt sich dabei um eine verbesserte / erweiterte Möglichkeit der CDS DDIC-based Views. CDS View Entities sind sozusagen der Nachfolger der CDS DDIC-based Views.

Unterschiede:

Keine zusätzlicher DB View notwendig (@AbapCatalog.sqlViewName … ) – daher aber auch kein SE16 …
Schnellere Aktivierung
Vereinfachte Syntax
Verbesserter / strikterer Syntaxcheck um potentielle Fehler bereits bei der Aktivierung zu erkennen

Teilnehmer

Deutschland 50%
Österreich 41%
Rest 9 % (Schweiz, Russland, Rumänien, Indien, Frankreich)

Twitter

Sören Schlegel, https://twitter.com/SoSchlegel87
Dominik Bigl, https://twitter.com/DomiBiglSAP
Johann Fößleitner, https://twitter.com/foessleitnerj

Unsere nächtes Webinar

Freitag 25. Juni 2021, 10:00 Uhr – ABAP RESTful Application Programming Model (RAP) – 2. Teil

Cadaxo SQL Cockpit Report Generation

Veröffentlicht am 9. März 20214. Mai 2023 von patilp

One important (and cool) feature of SQL Cockpit is an ability to auto-generate ABAP reports directly from the SQL query entered in the cockpit.

We illustrate below, one example of how this may be utilised

As you can see from the code snippet and screenshot below, suppose we want to generate a report output that executes a relatively complex select query :

SELECT
  but000~partner,
  but000~type,
  but000~bpkind,
  but000~bu_group,
  but000~bpext,
  but000~bu_sort1,
  but000~bu_sort2,
  but000~source,
  but000~xdele,
  but000~xblck,  

  but020~xdfadr,
  but020~adext,
  but020~guid,
  but020~move_addr,
  but020~date_from,
  but020~address_guid,
  but020~addr_valid_from,
  but020~addr_valid_to,
  but020~addr_move_date,

  adrc~addrnumber,
  adrc~nation,
  adrc~title,
  adrc~name1,
  adrc~name2,
  adrc~name3,
  adrc~name4,
  adrc~name_text,
  adrc~name_co,
  adrc~city1,
  adrc~city2,
  adrc~city_code,
  adrc~cityp_code

  FROM but000 INNER JOIN but020 ON but000~partner = but020~partner
  LEFT OUTER JOIN adrc ON but020~addrnumber = adrc~addrnumber
  
  WHERE 
      but000~partner IN &PARTNER&
  AND but000~type = '1'
  AND but000~bpkind = ''
  
  and but020~addr_valid_to = '99991231235959'
  AND but020~nation = ''

  AND adrc~title = ''
  AND adrc~name1 = ''
  AND adrc~city1 = 'Wien'
  .

SELECT

but000~partner,

but000~type,

but000~bpkind,

but000~bu_group,

but000~bpext,

but000~bu_sort1,

but000~bu_sort2,

but000~source,

but000~xdele,

but000~xblck,

but020~xdfadr,

but020~adext,

but020~guid,

but020~move_addr,

but020~date_from,

but020~address_guid,

but020~addr_valid_from,

but020~addr_valid_to,

but020~addr_move_date,

adrc~addrnumber,

adrc~nation,

adrc~title,

adrc~name1,

adrc~name2,

adrc~name3,

adrc~name4,

adrc~name_text,

adrc~name_co,

adrc~city1,

adrc~city2,

adrc~city_code,

adrc~cityp_code

FROM but000 INNER JOIN but020 ON but000~partner = but020~partner

LEFT OUTER JOIN adrc ON but020~addrnumber = adrc~addrnumber

WHERE

but000~partner IN &PARTNER&

AND but000~type = '1'

AND but000~bpkind = ''

and but020~addr_valid_to = '99991231235959'

AND but020~nation = ''

AND adrc~title = ''

AND adrc~name1 = ''

AND adrc~city1 = 'Wien'

If you want to generate SAP report that executes this query, it would be a tedious and repetitive work to create a report manually in ABAP. Report generation feature of SQL Cockpit makes this work much simpler and quicker as illustrated below (We have implemented customer requirements with many more fields and complex select query that pulls data from upto 10 database tables!).

After executing the SQL query, just click on the highlighted „Template“ icon and „Select Template“ textbox appears

Choose an ‚advanced‘ option in the screenshot above.

We are taken to the Report Template Wizard

Click on the Continue button

Enter the report name, description, and other optional information. Note that „Tabular Selection Blocks“ checkbox to generate multiple tabs on the selection screen is selected. Continue to the next window

As shown below, we get a list of selection screen field options, (also auto-generated from the WHERE condition of the SQL query 🙂 )

As shown above, we have three options…

create a selection screen field with an auto-populated value from the SQL where condition
create a selection screen field without an auto-populated value from the SQL where condition
Select query of a generated report will contain hard-coded value from the SQL where condition

Click on Continue button again after making your selections from one of these options

Finally, a generate report option is presented along with a list of specified report parameters in the previous step as seen below

Click on the Generate Report button

Select package as applicable and we are done.

Presto!

A generated report can be viewed / executed in SE38 like any other custom report.

Note the selection screen as seen below (with different selection screen tabs for fields from different tables)

Here is a screenshot from the select query (that was also auto-generated, of course 🙂 )

As highlighted in the screenshot, one of the where condition was created with a hard-coded values from the select query („Wien“) as per the selection in the report generation template!

Conclusion: we can auto-generate complex SAP reports using SQL Cockpit in less than 15 minutes! We can even customize special features based on individual client requirements.

This saves a lot of a lot of repetitive work for programmers and power users 😉