Anwendungsbeispiel

Objective

After completing this lesson, you will be able to eine Erweiterung für SAP S/4HANA mit der SAP-BTP-ABAP-Umgebung entwickeln

Erweiterungsszenario

Um die Vorgehensweise für eine Side-by-Side-Erweiterung besser zu verstehen, wird in dieser Lektion ein entsprechendes Beispiel implementiert. Es geht nicht darum, die verwendeten Konzepte und Programmiermodelle im Detail zu verstehen. Vielmehr soll das Gesamtbild einer Side-by-Side-Erweiterung vermittelt werden.

Die Abbildung erläutert, woher die Daten stammen, die in einer Anwendung angezeigt werden.

Zunächst wird eine Basisanwendung in der ABAP-Umgebung von SAP Business Technology Platform (BTP) angelegt, die zur Verwaltung von Kundenrechnungsreklamationen verwendet werden soll. Als Grundlage dafür wird eine entsprechende Tabelle auf der SAP-HANA-Datenbank der SAP-BTP-ABAP-Umgebung mit geeigneten Feldern angelegt. Die Felder Rechnungs-ID, Kunden-ID und Kundenname werden dabei verwendet, um die Rechnungsdaten zu speichern, für die eine Reklamation angelegt wird.

Die vorhandenen Kundenrechnungen werden jedoch im SAP-S/4HANA-On-Premise-System verwaltet. Zu diesem Zweck wurde in einer vorherigen Übung ein entsprechendes benutzerdefiniertes Business-Objekt angelegt. Um die Rechnungsdaten für eine Reklamation auswählen zu können, sollte daher auf dem SAP-Fiori-UI der Cloud-Anwendung eine Wertehilfe angeboten werden, über die die vorhandenen Rechnungsdaten aus dem SAP-S/4HANA-On-Premise-System angezeigt werden.

Die Abbildung veranschaulicht die unten aufgeführten Erläuterungen.

Auf die Rechnungsdaten im On-Premise-System wird über den OData-Service zugegriffen, der für das benutzerdefinierte Business-Objekt generiert wurde. Das bedeutet, dass der OData-Service im On-Premise-System aus der ABAP-basierten Cloud-Anwendung mithilfe des Service SAP BTP Connectivity und des Cloud Connector aufgerufen wird.

ABAP-Entwicklungswerkzeuge mit der SAP-BTP-ABAP-Umgebung verbinden und ein ABAP-Paket anlegen

Die Schritte und Daten dieser Demonstration finden Sie in der Übung „ABAP-Entwicklungswerkzeuge mit der SAP-BTP-ABAP-Umgebung verbinden und ein ABAP-Paket anlegen".

ABAP-Entwicklungswerkzeuge mit der SAP-BTP-ABAP-Umgebung verbinden und ein ABAP-Paket anlegen

In dieser Übung legen Sie ein ABAP-Cloud-Projekt in den ABAP Development Tools (ADT) an, um die Entwicklungsumgebung mit der ABAP-Serviceinstanz in der SAP-BTP-ABAP-Umgebung zu verbinden. Um eine Verbindung zur ABAP-Serviceinstanz herzustellen, die in diesem Kurs verwendet wird, verwenden Sie einen Serviceschlüssel, der bereits für die ABAP-Serviceinstanz konfiguriert wurde. Anschließend legen Sie ein ABAP-Paket auf der ABAP-Serviceinstanz an. Alle Repository-Objekte, die in den folgenden Übungen angelegt werden sollen, werden diesem Paket zugeordnet.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Schritte

  1. Verbinden Sie ADT mit der ABAP-Serviceinstanz über den Serviceschlüssel, der von Ihrem Referenten bereitgestellt wird.

    1. Wenn Eclipse noch nicht gestartet wurde, öffnen Sie es über Eclipse→Eclipse IDE im Windows-Startmenü.

    2. Stellen Sie sicher, dass die ABAP-Perspektive angezeigt wird. Um die ABAP-Perspektive zu öffnen, wählen Sie das Symbol Open Perspective in der Eclipse-Symbolleiste. Wählen Sie im daraufhin angezeigten Dialogfenster die ABAP-Perspektive aus, und wählen Sie Open.

    3. Wählen Sie im Menü File→New→ABAP Cloud Project.

      Ergebnis

      Die erste Seite des Assistenten zum Anlegen eines neuen ABAP-Cloud-Projekts wird geöffnet.
    4. Markieren Sie den Auswahlknopf Use a Service Key, und wählen Sie Next.

      Ergebnis

      Die Assistentenseite Systemverbindung über einen Serviceschlüssel wird geöffnet.
    5. Kopieren Sie den von Ihrem Referenten bereitgestellten Serviceschlüssel, und fügen Sie ihn in das Textfeld Serviceschlüssel im JSON-Format ein.

    6. Wählen Sie Next.

      Ergebnis

      Die Assistentenseite Am SAP-Cloud-System anmelden wird geöffnet.
    7. Wählen Sie die Drucktaste Anmeldeseite im Browser öffnen, um sich am ABAP-System anzumelden. Daraufhin wird der Standardbrowser geöffnet und zeigt eine Meldung an, dass Sie erfolgreich angemeldet wurden.

      Notiz

      Die Authentifizierung erfolgt im Browser.

      Notiz

      Wenn Sie nicht automatisch angemeldet wurden, klicken Sie auf den Link <xxxxxxxxx>.accounts.ondemand.com, der auf der angezeigten Browserseite angezeigt wird. Wenn Sie dazu aufgefordert werden, geben Sie Ihre E-Mail-Adresse gefolgt vom Kennwort in die entsprechenden Eingabefelder im Browser ein. Sie erhalten die erforderliche E-Mail-Adresse und das Kennwort von Ihrem Referenten. Wählen Sie abschließend die Drucktaste Anmelden, um sich am ABAP-System anzumelden.
    8. Schließen Sie den Browser. Die Assistentenseite Service Instance Connection wird geöffnet. Um die Anmeldesprache anzupassen, geben Sie die entsprechende Abkürzung ein.

    9. Wählen Sie Next.

      Ergebnis

      Die Assistentenseite Projektname und Favoritenpakete wird geöffnet.
    10. Um das ABAP-Cloud-Projekt anzulegen, wählen Sie Finish.

    Ergebnis

    Das ABAP-Cloud-Projekt wird im Projekt-Explorer angelegt und hinzugefügt.
  2. Legen Sie ein neues ABAP-Paket vom Typ Entwicklung mit dem Namen ZS4D425_##_CLD unter dem generierten Paket ZLOCAL an.

    1. Klappen Sie in ADT den Ordner Favorite Packages unter Ihrem Ordner ABAP Cloud Project im Project Explorer auf.

    2. Klicken Sie mit der rechten Maustaste auf ZLOCAL, und wählen Sie New→ABAP Package.

    3. Geben Sie im angezeigten Dialogfenster Neues ABAP-PaketZS4D425_##_CLD als Name und Side-by-Side-Erweiterung als Beschreibung ein. Stellen Sie sicher, dass ZLOCAL als Oberpaket und Entwicklung als Pakettyp ausgewählt ist. Markieren Sie Zu Favoritenpaketen hinzufügen, und wählen Sie Weiter.

    4. Wählen Sie auf dem Bild Auswahl des Transportauftrags die Option Neuen Auftrag anlegen, und geben Sie Teilnehmer ## als Auftragsbeschreibung ein.

    5. Klicken Sie auf Beenden.

    Ergebnis

    Ihr neues ABAP-Paket ZS4D425_##_CLD wird im Project Explorer unter Favorite Packages angezeigt.

Importieren Sie das Paket ZS4D425_SOL_CLD aus Github in die SAP-BTP-ABAP-Umgebung.

Als Vorbereitung für die nächsten Übungen importieren Sie das Paket ZS4D425_SOL_CLD aus Github in die SAP-BTP-ABAP-Umgebung.

Das Paket ZS4D425_SOL_CLD enthält sowohl Musterlösungen als auch Kopiervorlagen.

Notiz

Da ABAP Git nicht alle Objekttypen unterstützt, enthält das Paket ZS4D425_SOL_CLD keine ausführbare Implementierung des Übungsszenarios. Die folgenden Repository-Objekte, die von den Studenten in ihren Paketen entsprechend angelegt werden, sind nicht im Paket ZS4D425_SOL_CLD enthalten:
  • ZSC_D425_INVOICES_98 (Service-Consumption-Modell)
  • Z_COMPLAINT_98 (BSP-Applikation)
  • Z_COMPLAINT_98_UI5R (SAP-Fiori-Launchpad-App-Deskriptor-Element)
  • ZD425_COMPLAINT_IAM_98_EXT (IAM-App)
  • ZD425_COMPLAINT_BC_98 (IAM-Anwendungskatalog)

Schritte

  1. Legen Sie ein neues ABAP-Paket vom Typ Entwicklung in der Softwarekomponente ZLOCAL mit dem Namen ZS4D425_SOL_CLD an.

    1. Klicken Sie in ADT mit der rechten Maustaste auf Ihr ABAP-Cloud-Projekt, und wählen Sie im Kontextmenü New→ABAP Package.

    2. Geben Sie im Dialogfenster ABAP-PaketZS4D425_SOL_CLD als Namen und Side-by-Side-Erweiterung als Beschreibung ein. Markieren Sie das Ankreuzfeld Zu Favoritenpaketen hinzufügen, und stellen Sie sicher, dass Entwicklung als Pakettyp ausgewählt ist. Wählen Sie anschließend Weiter.

    3. Geben Sie ZLOCAL als Softwarekomponente ein, und wählen Sie Next.

    4. Wählen Sie im Dialogfenster Selection of Transport Request den Transportauftrag aus, den Sie in der vorherigen Demo angelegt haben, und wählen Sie Finish.

  2. Verknüpfen Sie das abapGit-Repository mit der URL https://github.com/s4d425/ZS4D425_SOL_CLD.git mit dem Paket ZS4D425_SOL_CLD, und ziehen Sie den Inhalt dieses Repositorys.

    Notiz

    Wenn die importierten Objekte nicht unter dem Paket ZS4D425_SOL_CLD im Project Explorer angezeigt werden, öffnen Sie das Kontextmenü für das Paket im Project Explorer, und wählen Sie das Element Refresh aus.
    1. Öffnen Sie die Sicht abapGit Repositories. Wählen Sie Window→Show Overview→Other…→abapGit Repositories. Die Sicht wird im unteren Bildbereich geöffnet.

    2. Wählen Sie in der Sicht abapGit Repositories das Symbol + in der Symbolleiste (Link New abapGit Repository...).

    3. Geben Sie im Dialogfenster Link abapGit Repository die URLhttps://github.com/s4d425/ZS4D425_SOL_CLD.git ein, und wählen Sie Next.

    4. Geben Sie im Schritt Branch und PaketauswahlZS4D425_SOL_CLD als Paket ein. Stellen Sie sicher, dass die Verzweigung refs/heads/main ausgewählt ist, und markieren Sie das Ankreuzfeld Pull after link. Wählen Sie anschließend Weiter.

    5. Wählen Sie im Schritt Auswahl des Transportauftrags die Option Fertigstellen.

    6. Warten Sie, bis der Wert Erfolgreich gepullt in der Spalte Status in der Sicht abapGit Repositories für die ausgelöste Pull-Aktion angezeigt wird. Aktualisieren Sie dazu die Anzeige über das Symbol Aktualisieren in der Symbolleiste der Sicht abapGit Repositories.

  3. Aktivieren Sie alle gepullten Objekte.

    1. Wählen Sie in der Eclipse-Symbolleiste das Symbol Inaktive ABAP-Entwicklungsobjekte aktivieren, oder wählen Sie Strg+Umschalt+F3.

    2. Stellen Sie im daraufhin angezeigten Dialogfenster sicher, dass alle abgerufenen Objekte ausgewählt sind, und wählen Sie Aktivieren.

Anlegen einer Datenbanktabelle in der SAP-BTP-ABAP-Umgebung

Die Schritte und Daten dieser Demonstration finden Sie in der Übung Eine Datenbanktabelle in der SAP-BTP-ABAP-Umgebung anlegen.

Datenbanktabelle in der SAP-BTP-ABAP-Umgebung anlegen

Im Übungsszenario zur Side-by-Side-Erweiterbarkeit legen wir eine Anwendung in der SAP-BTP-ABAP-Umgebung an. Diese Anwendung wird verwendet, um Kundenrechnungsreklamationen zu verwalten. Die Reklamationen werden in einer Datenbanktabelle in der SAP-BTP-ABAP-Umgebung gespeichert.

Nachdem die Basisanwendung angelegt wurde, wird sie erweitert, um einen OData-Service aus dem SAP-S/4HANA-On-Premise-System zu integrieren, der in der Schulung verwendet wird. Dazu rufen wir den OData-Service für Kundenrechnungen im On-Premise-System aus der Basisanwendung auf, die in der SAP-BTP-ABAP-Umgebung ausgeführt wird. Dieser OData-Service wurde in einer vorherigen Übung über ein benutzerdefiniertes Business-Objekt angelegt. Die Daten, die dieser OData-Service aus dem Backend bereitstellt, werden als Wertehilfe in unsere Basisanwendung integriert.

Im ersten Schritt legen wir nun die Datenbanktabelle in der SAP-BTP-ABAP-Umgebung an, die zum Speichern der Reklamationen in der Cloud verwendet wird.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Musterlösung:Z425_COMPLAINT98 (Datenbanktabelle)

Schritte

  1. Legen Sie eine Datenbanktabelle mit dem Namen Z425_COMPLAINT## in Ihrem Paket ZS4D425_##_CLD mit der Beschreibung Kundenreklamationen zu Rechnungen an.

    1. Klicken Sie in ADT mit der rechten Maustaste auf Ihr Paket ZS4D425_##_CLD, und wählen Sie New→Other ABAP Repository Object.

    2. Suchen Sie im daraufhin angezeigten Dialogfenster nach Datenbanktabelle, wählen Sie sie aus, und klicken Sie auf Weiter.

    3. Geben Sie auf dem Bild Neue DatenbanktabelleZ425_COMPLAINT## als Name und Kundenreklamationen zu Rechnungen als Beschreibung ein. Wählen Sie danach Next.

    4. Stellen Sie im Schritt Auswahl des Transportauftrags sicher, dass die Option Aus Aufträgen wählen, an denen ich beteiligt bin ausgewählt ist. Wählen Sie den Transportauftrag aus, den Sie in der letzten Übung angelegt haben, und wählen Sie Fertigstellen.

    Ergebnis

    Ein Editor mit der Definition der neuen Datenbanktabelle wird geöffnet. Sie enthält den folgenden Code:
    Code Snippet
    123456789
    @EndUserText.label : 'Customer complaints about invoices' @AbapCatalog.enhancement.category : #NOT_EXTENSIBLE @AbapCatalog.tableCategory : #TRANSPARENT @AbapCatalog.deliveryClass : #A @AbapCatalog.dataMaintenance : #RESTRICTED define table z425_complaint## { key client : abap.clnt; }
  2. Legen Sie die folgenden Felder für die Tabelle an:

    NameTypLängeKeyNicht Null
    Mandantabap.clnt XX
    UUIDsysuuid_x16 XX
    Complaint_idabap.numc10 X
    Rechnung_IDabap.numc10  
    customer_idabap.numc8  
    Kundennameabap.char25  
    Grundabap.char256  
    actionabap.char256  
    geschlossenabap_boolean   
    local_created_byabp_creation_user   
    local_created_atabp_creation_tstmpl   
    local_last_changed_byabp_locinst_lastchange_user   
    local_last_changed_atabp_locinst_lastchange_tstmpl   
    last_changed_atabp_lastchange_tstmpl   

    Notiz

    Für die folgenden Übungen ist es wichtig, dass die Tabellenfelder genau wie oben angegeben definiert sind.
    1. Definieren Sie die Felder der Datenbanktabelle wie folgt:

      Code Snippet
      123456789101112131415161718192021
      @EndUserText.label : 'Customer complaints about invoices' @AbapCatalog.enhancement.category : #NOT_EXTENSIBLE @AbapCatalog.tableCategory : #TRANSPARENT @AbapCatalog.deliveryClass : #A @AbapCatalog.dataMaintenance : #RESTRICTED define table z425_complaint## { key client : abap.clnt not null; key uuid : sysuuid_x16 not null; complaint_id : abap.numc(10) not null; invoice_id : abap.numc(10); customer_id : abap.numc(8); customer_name : abap.char(25); reason : abap.char(256); action : abap.char(256); closed : abap_boolean; local_created_by : abp_creation_user; local_created_at : abp_creation_tstmpl; local_last_changed_by : abp_locinst_lastchange_user; local_last_changed_at : abp_locinst_lastchange_tstmpl; last_changed_at : abp_lastchange_tstmpl; }
  3. Sichern und aktivieren Sie Ihre Eingaben.

    1. Um Ihre Eingaben zu sichern, können Sie die Tastenkombination Strg+S verwenden.

    2. Die Aktivierung kann über die Tastenkombination Strg+F3 erfolgen.

Basisanwendung

Die Basisanwendung verwendet einen OData-Service, um auf die in der letzten Übung angelegte Datenbanktabelle zuzugreifen. Im nächsten Schritt wird dieser OData-Service mithilfe des ABAP-RESTful-Anwendungsprogrammiermodells implementiert.

Da das ABAP-RESTful-Anwendungsprogrammiermodell nicht Gegenstand dieser Schulung ist, wird ein Generator verwendet, um den erforderlichen ABAP-RESTful-Anwendungsprogrammiermodell-basierten OData-Service anzulegen.

Die folgenden Abbildungen geben einen kurzen Überblick über RAP. Details zum ABAP-RESTful-Anwendungsprogrammiermodell finden Sie in der Dokumentation sowie in separaten Schulungen.

Das ABAP-RESTful-Anwendungsprogrammiermodell definiert die Architektur für die durchgängige Entwicklung von SAP-HANA-optimierten OData-Services. Sie unterstützt die Entwicklung aller Arten von Fiori-Anwendungen sowie das Veröffentlichen von Web-APIs. Sie basiert auf Technologien und Frameworks wie Core Data Services (CDS) zur Definition semantisch umfangreicher Datenmodelle und einer Servicemodellinfrastruktur zum Anlegen von OData-Services mit Bindungen an ein OData-Protokoll und ABAP-basierten Anwendungsservices für benutzerdefinierte Logik und SAPUI5-basierte Benutzungsoberflächen.

Das ABAP-RESTful-Anwendungsprogrammiermodell ist in folgenden Produkten verfügbar:

  • SAP-BTP-ABAP-Umgebung
  • SAP S/4HANA Cloud
  • Application Server ABAP 7.55 SP03
Siehe Beschreibung unten.

Das obige Diagramm strukturiert die Entwicklung eines OData-Service aus Designzeitsicht. Das heißt, es zeigt die wichtigsten Entwicklungsartefakte an, mit denen Sie sich beim Anlegen eines OData-Service mit dem ABAP-RESTful-Programmiermodell befassen müssen. Das Diagramm verfolgt einen Bottom-Up-Ansatz, der dem Entwicklungsablauf ähnelt. Die Hauptentwicklungsaufgaben können in drei Schichten kategorisiert werden: Datenmodellierung und -verhalten, Bereitstellung von Business-Services und Servicenutzung.

Siehe Beschreibung unten.

Das obige Diagramm bietet eine Laufzeitperspektive auf das ABAP-RESTful-Programmiermodell. Laufzeitobjekte sind erforderliche Komponenten zum Ausführen einer Anwendung. Dieser Laufzeit-Stack wird in einem Top-Down-Ansatz dargestellt. Ein OData-Client sendet eine Anforderung, die dann an die generischen Laufzeit-Frameworks übergeben wird. Diese Frameworks bereiten eine konsumierbare Anforderung für ABAP-Code vor und verteilen sie an die relevante Geschäftslogikkomponente. Die Anfrage wird vom Business-Objekt (BO) ausgeführt, wenn Daten geändert werden, oder durch die Abfrage, wenn Daten nur aus der Datenquelle gelesen werden.

Generieren des OData-Service für die Basisanwendung

Die Schritte und Daten dieser Demonstration finden Sie in der Übung OData-Service für die Basisanwendung generieren.

OData-Service für die Basisanwendung generieren

Im Übungsszenario für die Side-by-Side-Erweiterung implementieren wir eine Anwendung in der SAP-BTP-ABAP-Umgebung. Zu diesem Zweck wurde in der vorherigen Übung eine Datenbanktabelle in der SAP-BTP-ABAP-Umgebung angelegt, mit der Reklamationen zu Kundenrechnungen persistiert werden können.

In dieser Übung wird ein OData-Service generiert, der Lese- und Schreibzugriff auf die Datenbanktabelle ermöglicht. Um den OData-Service anzulegen, verwenden wir ein verwaltetes Business-Objekt, das auf dem ABAP-RESTful-Anwendungsprogrammiermodell (RAP) basiert.

Wir verwenden den sogenannten ABAP Repository Objects Generator, um die erforderlichen ABAP-RAP-Repository-Objekte für uns zu generieren.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Schritte

  1. Um den OData-UI-Service und alle zugrunde liegenden Objekte anzulegen, rufen Sie den ABAP Objects Repository Generator mit Bezug auf Ihre Datenbanktabelle Z425_COMPLAINT## auf. Verwenden Sie den Generator-OData-UI-Service. Um den Generator zu konfigurieren, verwenden Sie die folgenden Werte:

    Werte für Generator-OData-UI-Service

    CategoryEigenschaftWert
    GeneralReferenziertes ObjektZ425_COMPLAINT##
    BeschreibungReklamation ##
    Business-Objekt; DatenmodellCDS-EntitätsnameZR_425_COMPLAINT##
    AliasnameReklamation
    Business-Objekt; VerhaltenVerhaltensimplementierungsklasseZBP_R_425_COMPLAINT##
    EntwurfstabellennameZ425_COMPL##D
    Serviceprojektion; ServiceprojektionsentitätCDS-EntitätsnameZC_425_COMPLAINT##
    Serviceprojektion; ServiceprojektionsverhaltenVerhaltensimplementierungsklasseZBP_C_425_COMPLAINT##
    Business-Service; Service-DefinitionName der Service-DefinitionZUI_425_COMPLAINT##_O4
    Business-Service, Service-BindungService-Binding-NameZUI_425_COMPLAINT##_O4
    BindungstypOData V4 - UI
    1. Positionieren Sie den Cursor auf Ihrer Datenbanktabelle Z425_COMPLAINT##.

    2. Drücken Sie die sekundäre Maustaste, und rufen Sie die Funktion ABAP-Repository-Objekte generieren auf.

    3. Wählen Sie auf dem Bild Select Generator die Option ABAP RESTful Aplication Programming Model→OData UI Service. Wählen Sie Weiter.

    4. Geben Sie auf dem nächsten Bild im Feld Paket Ihr Paket ZS4D425_##_CLD ein, und wählen Sie Weiter.

    5. Geben Sie auf dem Bild Configure Generator die Werte für jede Kategorie und Eigenschaft wie in der obigen Tabelle angegeben ein. Ändern Sie ggf. die vorgeschlagenen Werte. Wählen Sie Weiter.

    6. Prüfen Sie auf dem nächsten Bild die Vorschau. Wählen Sie Weiter.

    7. Wählen Sie auf dem nächsten Bild Ihren Transportauftrag aus, und wählen Sie Fertigstellen. Anschließend werden die Artefakte generiert.

  2. Aktualisieren Sie die Anzeige Ihres Pakets ZS4D425_##_CLD im Project Explorer, um die generierten Objekte unter Ihrem Paket anzuzeigen.

    1. Klicken Sie im Project Explorer mit der rechten Maustaste auf Ihr Paket ZS4D425_##_CLD, und wählen Sie im Kontextmenü Refresh. Alternativ können Sie F5 drücken.

  3. Untersuchen Sie die generierte Interface-View ZR_425_COMPLAINT_##.

    Woher liest diese Sicht ihre Daten?

    _____________________________________________________________________________

    Die View definiert Aliasnamen in Binnenmajuskel für die Tabellenfeldnamen. Wie lauten die Aliasnamen der folgenden Tabellenfelder?

    TabellenfeldnameAliasname
    COMPLAINT_ID 
    INVOICE_ID 
    CUSTOMER_ID 
    CUSTOMER_NAME 
    1. Um die Interface-View ZR_425_COMPLAINT## im Editor zu öffnen, expandieren Sie die folgenden Knoten unter Ihrem Paket im Project Explorer: ZS4D425_##_CLD→Core Data Services→Data Definitions. Doppelklicken Sie anschließend auf ZR_425_COMPLAINT##.

    2. Die View liest ihre Daten aus der Datenbanktabelle Z425_COMPLAINT##.

    3. Sie definiert die folgenden Aliasnamen:

      TabellenfeldnameAliasname
      COMPLAINT_IDReklamations-ID
      INVOICE_IDInvoiceID
      CUSTOMER_IDCustomerID
      CUSTOMER_NAMECustomerName
  4. Untersuchen Sie die generierte Projektions-View ZC_425_COMPLAINT##.

    Woher liest diese Sicht ihre Daten?

    _____________________________________________________________________________

    1. Um die Projektions-View ZC_425_COMPLAINT## im Editor zu öffnen, expandieren Sie die folgenden Knoten unter Ihrem Paket im Project Explorer: ZS4D425_##_CLD→Core Data Services→Data Definitions. Doppelklicken Sie anschließend auf ZC_425_COMPLAINT##.

    2. Die View liest ihre Daten aus der Interface-View ZR_425_COMPLAINT_##.

  5. Untersuchen Sie die generierte Verhaltensdefinition ZR_425_COMPLAINT## für die Interface-View ZR_425_COMPLAINT##, die das Verhalten des RAP-Business-Objekts definiert.

    Wie lautet der Name der globalen Klasse, die zur Implementierung des Verhaltens verwendet wird?

    _____________________________________________________________________________

    Welche transaktionalen Operationen sind in der Verhaltensdefinition für das RAP-Business-Objekt definiert?

    _____________________________________________________________________________

    1. Um die Verhaltensdefinition ZR_425_COMPLAINT## im Editor zu öffnen, expandieren Sie die folgenden Knoten unter Ihrem Paket im Project Explorer: ZS4D425_##_CLD→Core Data Services→Behavior Definitions. Doppelklicken Sie anschließend auf ZR_425_COMPLAINT##.

    2. Der Name der globalen Klasse, die zur Implementierung des Verhaltens verwendet wird, lautet ZBP_R_D425_Complaint##.

    3. Die transaktionalen Operationen create, update und delete werden für das RAP-Business-Objekt definiert.

  6. Untersuchen Sie die generierte Projektionsverhaltensdefinition ZC_425_COMPLAINT_## für die Projektions-View ZC_425_COMPLAINT_##, die eine Teilmenge der Elemente der zugrunde liegenden Basisverhaltensdefinition ZR_425_COMPLAINT_## exponiert.

    Welche transaktionalen Operationen für das RAP-Business-Objekt, das in der zugrunde liegenden Basisverhaltensdefinition ZR_425_COMPLAINT_## definiert ist, werden in der Projektionsverhaltensdefinition wiederverwendet?

    _____________________________________________________________________________

    1. Um die Projektionsverhaltensdefinition ZC_425_COMPLAINT## im Editor zu öffnen, expandieren Sie die folgenden Knoten unter Ihrem Paket im Project Explorer: ZS4D425_##_CLD→Core Data Services→Behavior Definitions. Doppelklicken Sie anschließend auf ZC_425_COMPLAINT##.

    2. Die Projektionsverhaltensdefinition verwendet die Operationen create, update und delete aus der Basisverhaltensdefinition wieder.

  7. Untersuchen Sie die generierte Service-Definition ZUI_425_COMPLAINT##_O4.

    Welche CDS-Entität wird über diese Service-Definition für den Business-Service exponiert?

    _____________________________________________________________________________

    Welcher Aliasname ist für diese CDS-Entität definiert?

    _____________________________________________________________________________

    1. Um die Service-Definition ZUI_425_COMPLAINT##_O4 im Editor zu öffnen, expandieren Sie die folgenden Knoten unter Ihrem Paket im Project Explorer: ZS4D425_##_CLD→Business Services→Service Definitions. Doppelklicken Sie anschließend auf ZUI_425_COMPLAINT##_O4.

    2. Die Service-Definition exponiert die CDS-Entität ZC_425_COMPLAINT##.

    3. Für diese CDS-Entität ist der Aliasname Complaint definiert.

  8. Untersuchen Sie das generierte Service-Binding ZUI_425_COMPLAINT##_O4.

    Auf welcher Service-Definition basiert diese Service-Bindung?

    _____________________________________________________________________________

    Welcher Bindungstyp wird mit diesem Service-Binding implementiert?

    _____________________________________________________________________________

    1. Um die Service-Bindung ZUI_425_COMPLAINT##_O4 im Editor zu öffnen, expandieren Sie die folgenden Knoten unter Ihrem Paket im Project Explorer: ZS4D425_##_CLD→Business Services→Service Bindings. Doppelklicken Sie anschließend auf ZUI_425_COMPLAINT##_O4.

    2. Das Service-Binding basiert auf der Service-Definition ZUI_425_COMPLAINT##_O4.

    3. Der Bindungstyp OData V4 - UI wird mit dem Service-Binding implementiert.

  9. Publizieren Sie die Service-Bindung ZUI_425_COMPLAINT##_O4.

    1. Öffnen Sie die Service-Bindung ZUI_425_COMPLAINT##_O4 im Editor, sofern sie noch nicht geöffnet ist.

    2. Wählen Sie im Service-Binding-Editor die Drucktaste Publizieren, um das Service-Binding zu veröffentlichen.

      Notiz

      Seien Sie geduldig, die Veröffentlichung der Service-Bindung dauert ein wenig Zeit.
  10. Öffnen Sie die Vorschau der SAP-Fiori-Elements-App für die Entitätsmenge Reklamation.

    1. Öffnen Sie die Service-Bindung ZUI_425_COMPLAINT##_O4 im Editor, sofern sie noch nicht geöffnet ist.

    2. Wählen Sie die Entitätsmenge Reklamation im Abschnitt Entitätsmenge und Assoziation des Service-Binding-Editors aus.

    3. Klicken Sie auf die Schaltfläche Vorschau....

      Notiz

      Wenn Sie nicht automatisch angemeldet sind, klicken Sie auf den Link <xxxxxxxxx>.accounts.ondemand.com, der auf der angezeigten Browserseite angezeigt wird. Wenn Sie dazu aufgefordert werden, geben Sie Ihre E-Mail-Adresse gefolgt vom Kennwort in die entsprechenden Eingabefelder im Browser ein. Sie erhalten die erforderliche E-Mail-Adresse und das Kennwort von Ihrem Referenten. Wählen Sie abschließend die Drucktaste Anmelden, um sich am ABAP-System anzumelden.
  11. Legen Sie eine neue Reklamation über die Vorschau der SAP-Fiori-Elements-App an. Aktualisieren Sie anschließend die gesicherte Reklamation, und löschen Sie sie abschließend erneut.

    Notiz

    Über die generierte Vorschau der SAP-Fiori-Elements-App können Reklamationen nicht nur angezeigt, sondern auch angelegt, aktualisiert und gelöscht werden. Dies liegt daran, dass Create-, Update- und Delete-Operationen für das RAP-Business-Objekt definiert wurden (siehe oben).

    1. Verwenden Sie die entsprechenden UI-Elemente der Vorschau der SAP-Fiori-Elements-App, um die Anlege-, Aktualisierungs- und Löschvorgänge auszuführen.

Ergebnis

Die Vorschau der SAP-Fiori-Elements-App bietet eine nahezu vollständige Benutzungsoberfläche mit Funktionen zum Suchen und Filtern sowie zum Anlegen, Aktualisieren und Löschen von Reklamationen.

In der Anwendung wird jedoch keine Wertehilfe bereitgestellt. Später stellen wir eine Wertehilfe für die Rechnungs-ID bereit, die auch die Felder für die Kunden-ID und den Kundennamen mit Werten füllt. Zu diesem Zweck verwenden wir den OData-Service für Kundenrechnungen aus dem SAP-S/4HANA-On-Premise-System, den wir in einer vorherigen Übung mithilfe eines benutzerdefinierten Business-Objekts angelegt haben. Dieser OData-Service wird als Wertehilfe über eine Side-by-Side-Erweiterung in die Anwendung in der ABAP-Umgebung integriert.

Für das Tabellenfeld Geschlossen wird der Bezeichner Wahrheitswert in der Vorschau der SAP-Fiori-Elements-App verwendet. Diese und einige andere Bezeichnungen werden in der nächsten Übung angepasst.

Bezeichner der SAP-Fiori-Elements-Anwendung anpassen

Die Schritte und Daten dieser Demonstration finden Sie in der Übung „Bezeichner der SAP-Fiori-Elements-Anwendung anpassen".

Bezeichner der SAP-Fiori-Elements-Anwendung anpassen (optional)

In der letzten Übung haben Sie den OData-Service für die Basisanwendung über die Vorschau der SAP-Fiori-Elements-App getestet. Die in der SAP-Fiori-Elements-Anwendung angezeigten Bezeichner werden über eine sogenannte Metadatenerweiterung angegeben, die vom RAP-Generator generiert wird.

In dieser Übung passen Sie einen der Bezeichner in der SAP-Fiori-Elements-Anwendung über diese generierte Metadatenerweiterung an.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Musterlösung:ZC_425_Complaint98 (Metadatenerweiterung)

Schritte

  1. Öffnen Sie die generierte Metadatenerweiterung ZC_425_Complaint##.

    1. Um die Metadatenerweiterung ZC_425_Complaint## im Editor zu öffnen, expandieren Sie die folgenden Knoten unter Ihrem Paket im Project Explorer: ZS4D425_##_CLD→Core Data Services→Metadata Extensions. Doppelklicken Sie anschließend auf ZC_425_Complaint##.

  2. Passen Sie in der Metadatenerweiterung ZC_425_Complaint## die Bezeichner für die Tabelle auf dem List Report und der Object Page wie folgt an:

    ElementGenerierter Bezeichner für List Report und Object PageAngepasster Bezeichner für Listen-Report und Objektseite
    AbgeschlossenWahrheitswertAbgeschlossen
    Reklamations-IDReklamations-IDReklamations-ID
    InvoiceIDInvoiceIDRechnungs-ID
    CustomerIDCustomerIDCustomer ID
    CustomerNameCustomerNameKundenname

    Aktivieren Sie anschließend Ihre Metadatenerweiterung ZC_425_Complaint##.

    1. Suchen Sie in der Metadatenerweiterung nach folgenden Annotationen für das Element Closed:

      Code Snippet
      123456789101112
      @UI.identification: [ { position: 80 , label: 'Truth value' } ] @UI.lineItem: [ { position: 80 , label: 'Truth value' } ] @UI.selectionField: [ { position: 80 } ] Closed;

      Passen Sie sie wie folgt an:

      Code Snippet
      12345678910
      @EndUserText.label: 'Closed' @UI.identification: [ { position: 80 } ] @UI.lineItem: [ { position: 80 @UI.selectionField: [ { position: 80 } ] Closed;
    2. Wiederholen Sie dies für die anderen Elemente.

    3. Um die Metadatenerweiterung zu aktivieren, können Sie die Tastenkombination Strg+F3 verwenden.

  3. Testen Sie Ihre Anpassungen über die Vorschau der SAP-Fiori-Elements-App für die Entitätsmenge Reklamation.

    1. Öffnen Sie die Service-Bindung ZUI_425_COMPLAINT##_O4 im Editor, sofern sie noch nicht geöffnet ist.

    2. Wählen Sie die Entitätsmenge Reklamation im Abschnitt Entitätsmenge und Assoziation des Service-Binding-Editors aus.

    3. Wählen Sie Preview....

      Notiz

      Wenn Sie nicht automatisch angemeldet sind, klicken Sie auf den Link <xxxxxxxxx>.accounts.ondemand.com, der auf der angezeigten Browserseite angezeigt wird. Wenn Sie dazu aufgefordert werden, geben Sie Ihre E-Mail-Adresse gefolgt vom Kennwort in die entsprechenden Eingabefelder im Browser ein. Sie erhalten die erforderliche E-Mail-Adresse und das Kennwort von Ihrem Referenten. Wählen Sie abschließend die Drucktaste Anmelden, um sich am ABAP-System anzumelden.
    4. Prüfen Sie, ob die angepassten Bezeichner in der Tabelle List Report und auf der Objektseite der App angezeigt werden.

Berechnen des semantischen Schlüssels

Die Schritte und Daten dieser Demonstration finden Sie in der Übung Den semantischen Schlüssel berechnen.

Semantischen Schlüssel berechnen (optional)

Um das semantische Schlüsselfeld ComplaintID automatisch mit einem Wert zu versehen, implementieren wir in dieser Übung eine sogenannte Ermittlung.

Notiz

Physisch ist das Feld UUID Schlüsselfeld der Verhaltensdefinition ZR_425_COMPLAINT##. Das semantische (d.h. visuell lesbare) Feld ComplaintID ist jedoch wie ein Schlüsselfeld.

Eine Ermittlung ist ein optionaler Teil des Business-Objekt-Verhaltens, der Instanzen von Business-Objekten basierend auf Auslösebedingungen modifiziert. Hier wird eine Ermittlung implementiert, um die ID einer Reklamation zu berechnen, die vom Benutzer der Anwendung gelesen werden kann. Sobald der Benutzer eine neue Reklamation anlegt, wird die Ermittlung ausgeführt und berechnet den entsprechenden Wert für das semantische Schlüsselfeld.

Die Implementierung der Ermittlung erfolgt in der lokalen Klasse LHC_COMPLAINT, die Teil der globalen Verhaltensimplementierungsklasse ZBP_R_425_COMPLAINT## ist. Sowohl diese globale als auch die lokale Klasse wurden bereits vom Generator angelegt. Daher muss nur die Methode CALCULATECOMPLAINTID auf der lokalen Klasse LHC_COMPLAINT implementiert werden. Der Einfachheit halber kopieren Sie in dieser Übung die lokale Klasse LHC_COMPLAINT aus der Musterlösung und passen sie an Ihr Business-Objekt an.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Musterlösungen:

Globale Klasse ZBP_R_425_COMPLAINT98

Verhaltensdefinition ZR_425_COMPLAINT98

Metadatenerweiterung ZC_425_COMPLAINT98

Schritte

  1. Setzen Sie das Feld ComplaintID in der Verhaltensdefinition ZR_425_COMPLAINT## auf readonly.

    1. Öffnen Sie die Verhaltensdefinition ZR_425_COMPLAINT##.

    2. Suchen Sie nach dem Feld ( readonly ).

    3. Fügen Sie ComplaintID zur Liste der schreibgeschützten Felder hinzu.

    Das Feld ( readonly )-Klausel sollte wie folgt lauten:

    Code Snippet
    123456
    field ( readonly ) UUID, LastChanged, LocalLastChanged;

  2. Fügen Sie der Verhaltensdefinition ZR_425_COMPLAINT## eine Determinierung hinzu.

    1. Öffnen Sie die Verhaltensdefinition ZR_425_COMPLAINT##.

    2. Suchen Sie nach der Zeile vor der letzten Zeile:

    Suchen nach

    Code Snippet
    12345678
    mapping for z425_complaint## { UUID = uuid; ... LastChanged = last_changed; } }

    Fügen Sie diesen Quelltext hinzu (vor der letzten geschweiften Klammer):

    Code Snippet
    1
    determination CalculateComplaintID on save { create; }

    Insgesamt muss gelesen werden:

    Code Snippet
    123456789
    mapping for z425_complaint## { UUID = uuid; ... LastChanged = last_changed; } }

    Notiz

    Sie können die angezeigten Meldungen ignorieren. Sie verschwinden nach dem nächsten Schritt.
  3. Aktivieren Sie die Verhaltensdefinition.

    1. Wählen Sie die Funktion Aktivieren.

  4. Kopieren Sie aus der Methodenimplementierung CalculateComplaintID aus der lokalen Klasse LHC_ZR_425_COMPLAINT98 aus der globalen Klasse ZBP_R_425_COMPLAINT98.

    1. Wählen Sie das Symbol Open ABAP Development Object in der Eclipse-Symbolleiste aus, oder drücken Sie Strg+Umschalt+A.

    2. Geben Sie im Dialogfenster Open ABAP Development Objectals Suchstring ZBP_R_425_COMPLAINT98 ein. Wählen Sie ZBP_R_425_COMPLAINT98 im Bereich Matching-Positionen aus, und wählen Sie OK.

    3. Wählen Sie unten im daraufhin geöffneten Editor die Registerkarte Lokale Typen.

    4. Markieren Sie den vollständigen Quelltext der Implementierung der Methode CalculateComplaintID der Klasse LHC_ZR_425_COMPLAINT98, die nun angezeigt wird (z.B. über Strg+A), und kopieren Sie sie anschließend (z.B. über Strg+C).

  5. Ersetzen Sie die Implementierung der Methode CalculateComplaintID der lokalen Klasse LHC_ZR_425_COMPLAINT## in Ihrer globalen Klasse ZBP_R_425_COMPLAINT## durch das kopierte Coding.

    1. Um die globale Klasse ZBP_R_425_COMPLAINT## im Editor zu öffnen, expandieren Sie die folgenden Knoten unter Ihrem Paket im Project Explorer: ZS4D425_##_CLD→Source Code Library→Classes→ZBP_R_425_COMPLAINT##. Doppelklicken Sie anschließend auf LHC_ZR_425_COMPLAINT##.

    2. Ersetzen Sie im daraufhin angezeigten Editor das Coding der Implementierung der Methode CalculateComplaintID der Klasse LHC_ZR_425_COMPLAINT## durch den kopierten Code.

  6. Passen Sie den kopierten Code an den folgenden drei Stellen an Ihre Gruppennummer an:

    Kopierter CodeAngepasster Quelltext
    READ ENTITIES OF zr_425_complaint_98IN LOCAL MODEREAD ENTITIES OF zr_425_complaint_##IN LOCAL MODE
    SELECT SINGLE FROM z425_complaint98FIELDS MAX( complaint_id ) INTO @DATA(max_complaint).SELECT SINGLE FROM z425_complaint##FIELDS MAX( complaint_id ) INTO @DATA(max_complaint).
    MODIFY ENTITIES OF zr_425_complaint_98IN LOCAL MODEMODIFY ENTITIES OF zr_425_complaint_##IN LOCAL MODE

    Aktivieren Sie anschließend Ihre Klasse ZBP_R_425_COMPLAINT##.

    Notiz

    Der Einfachheit halber wählt die Ermittlungsimplementierung aus der Datenbank die höchste Reklamations-ID aus, die bisher zugeordnet wurde. Der ausgewählte Wert wird dann erhöht, um weitere semantische Schlüssel zu generieren, die vom Benutzer gelesen werden können. In einer produktiven Anwendung würde man lieber einen Nummernkreis verwenden.
    1. Passen Sie den kopierten Quelltext wie folgt an:

      Code Snippet
      1234567891011121314151617181920212223242526272829303132333435363738
      CLASS lhc_zr_425_complaint## DEFINITION INHERITING FROM cl_abap_behavior_handler. PRIVATE SECTION. METHODS: calculatecomplaintid FOR DETERMINE ON SAVE IMPORTING keys FOR Complaint~CalculateComplaintID . ENDCLASS. CLASS lhc_zr_425_complaint## IMPLEMENTATION. METHOD calculatecomplaintid. "Ensure idempotence READ ENTITIES OF zr_425_complaint_ IN LOCAL MODE ENTITY Complaint FIELDS ( ComplaintID ) WITH CORRESPONDING #( keys ) RESULT DATA(complaints). DELETE complaints WHERE ComplaintID IS NOT INITIAL. CHECK complaints IS NOT INITIAL. "Get max complaintID SELECT SINGLE FROM z425_complaint FIELDS MAX( complaint_id ) INTO @DATA(max_complaint). "update involved instances MODIFY ENTITIES OF zr_425_complaint_ IN LOCAL MODE ENTITY Complaint UPDATE FIELDS ( ComplaintID ) WITH VALUE #( FOR complaint IN complaints INDEX INTO i ( %tky = complaint-%tky ComplaintID = max_complaint + i ) ) REPORTED DATA(lt_reported). "fill reported reported = CORRESPONDING #( DEEP lt_reported ). ENDMETHOD. ENDCLASS.
    2. Um die Klasse zu aktivieren, können Sie die Tastenkombination Strg+F3 verwenden.

  7. Ändern Sie die Titelinformationen in Metadatenerweiterung ZC_425_COMPLAINT##. Ändern Sie die Annotationen für Titel und Beschreibung. Sie können den geänderten Teil auch aus der Lösungsmetadatenerweiterung ZC_425_COMPLAINT98 kopieren.

    AnnotationAlter WertNeuer Wert
    @UI.headerInfo.title.value:Uuid'ComplaintId'
    @UI.headerInfo.description.value:Uuid'CustomerName'

    Aktivieren Sie die Metadatenerweiterung.

    1. Öffnen Sie die Metadatenerweiterung ZC_425_COMPLAINT##.

    2. Suchen Sie in der Metadatenerweiterung nach folgenden Annotationen für das Element Closed:

      Code Snippet
      12345678
      @Metadata.layer: #CORE @UI.headerInfo.title.type: #STANDARD @UI.headerInfo.title.value: 'Uuid' @UI.headerInfo.description.type: #STANDARD @UI.headerInfo.description.value: 'Uuid'

      Passen Sie sie wie folgt an:

      Code Snippet
      12345678
      @Metadata.layer: #CORE @UI.headerInfo.title.type: #STANDARD @UI.headerInfo.title.value: 'ComplaintId' @UI.headerInfo.description.type: #STANDARD @UI.headerInfo.description.value: 'CustomerName'
    3. Aktivieren Sie die Metadatenerweiterung.

  8. Testen Sie die Ermittlungsimplementierung über die Vorschau der SAP-Fiori-Elements-App für die Entitätsmenge Reklamation. Testen Sie das neue Erscheinungsbild von Titel und Beschreibung.

    1. Öffnen Sie die Service-Bindung ZUI_425_COMPLAINT##_O4 im Editor, sofern sie noch nicht geöffnet ist.

    2. Wählen Sie die Entitätsmenge Reklamation im Abschnitt Entitätsmenge und Assoziation des Service-Binding-Editors aus.

    3. Wählen Sie Preview....

      Notiz

      Wenn Sie nicht automatisch angemeldet sind, klicken Sie auf den Link <xxxxxxxxx>.accounts.ondemand.com, der auf der angezeigten Browserseite angezeigt wird. Wenn Sie dazu aufgefordert werden, geben Sie Ihre E-Mail-Adresse gefolgt vom Kennwort in die entsprechenden Eingabefelder im Browser ein. Sie erhalten die erforderliche E-Mail-Adresse und das Kennwort von Ihrem Referenten. Wählen Sie abschließend Anmelden, um sich am ABAP-System anzumelden.
    4. Wählen Sie in der angezeigten SAP-Fiori-Elements-App die Drucktaste Anlegen.

    5. Füllen Sie das Formular aus, und wählen Sie Anlegen.

      Ergebnis

      Prüfen Sie die Nummerierung für den semantischen Schlüssel: Das Feld Reklamations-ID sollte nun eine 1 anzeigen.

      Prüfen Sie den Titel und die Beschreibung. Für den Titel sollte nun die Reklamations-ID angezeigt werden. Geben Sie eine Beschreibung für den Kundennamen ein.

Backend-Integration

Die Abbildung zeigt das Service-Consumption-Modell, das unten beschrieben wird.

Um den OData-Service des SAP-S/4HANA-On-Premise-Systems in der SAP-BTP-ABAP-Umgebung zu verwenden, benötigen Sie eine lokale Darstellung des Remote-Service. Mithilfe eines Service-Consumption-Modells können Sie die OData-Metadaten des Remote-Service in die SAP-BTP-ABAP-Umgebung importieren und Proxy-Artefakte für den Remote-Service anlegen. Der Assistent, der die Proxy-Artefakte anlegt, benötigt ein CSDL-XML-Dokument des externen Service als Grundlage für das Service-Consumption-Modell. Die generierten abstrakten Entitäten spiegeln das Datenmodell des Remote-Service wider.

Die Abbildung visualisiert das Verbrauchsszenario, das unten beschrieben wird.

Das Datenmodell für die Wertehilfe wird in einer CDS-Custom-Entität definiert. Das heißt, die Custom-Entität definiert die Elemente, die in der Wertehilfe verwendet werden sollen, und typisiert sie.

Im Gegensatz zu CDS-Views haben Custom-Entitäten keine SELECT-Anweisung, um die Daten aus einer Datenquelle abzurufen. Die Laufzeit einer Custom-Entität muss in einer zugehörigen ABAP-Klasse implementiert werden, die über die Annotation @ObjectModel.query.impledBy referenziert werden muss.

Diese sogenannte Query-Implementierungsklasse muss die Methode select des Interface IF_RAP_QUERY_PROVIDER implementieren, um Abfrageanforderungen durch den Client zu verarbeiten. In der Implementierung dieser Methode werden die Rechnungsdaten über den Remote-Service über den generierten Client-Proxy ausgewählt.

Service-Consumption-Modell für den On-Premise-OData-Service anlegen

Die Schritte und Daten dieser Demonstration finden Sie in der Übung Ein Service-Consumption-Modell für den On-Premise-OData-Service anlegen.

Service-Consumption-Modell für den On-Premise-OData-Service anlegen

In den vorherigen Übungen wurde der OData-Service der Basisanwendung implementiert. In der Vorschau der zugehörigen SAP-Fiori-Elements-App ist zu sehen, dass diese Anwendung keine Wertehilfe auf der Benutzungsoberfläche für die Verwaltung von Reklamationen bereitstellt.

Mit einer Side-by-Side-Erweiterung möchten wir nun eine solche Wertehilfe für die Rechnungs-ID hinzufügen. Zu diesem Zweck verwenden wir den OData-Service für Kundenrechnungen aus dem On-Premise-System, der in einer früheren Übung über ein benutzerdefiniertes Business-Objekt angelegt wurde. Dieser OData-Service stellt die Daten für die Wertehilfe für die Rechnungsnummer bereit, die auch die Felder für den Kundennamen und die Kunden-ID mit Werten füllt.

In dieser Übung legen wir zunächst ein Service-Consumption-Modell für den OData-Service für Kundenrechnungen an, den wir später verwenden, um diesen Service im On-Premise-System aus der Anwendung in der SAP-BTP-ABAP-Umgebung aufzurufen.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Schritte

  1. Sichern Sie das Servicemetadatendokument des OData-Service für Kundenrechnungen aus dem On-Premise-System in einer lokalen Datei namens $metadata.xml im Verzeichnis N:\Documents.

    Notiz

    Sie können im Browser über die URL https://s4dhost.wdf.sap.corp:44310/sap/opu/odata/sap/ZZ1_CUSTOMERINVOICE##_CDS/$metadata auf das Servicemetadatendokument zugreifen.

    Notiz

    Das Service-Consumption-Modell verwendet die Beschreibung einer externen Schnittstelle (derzeit werden OData, SOAP und RFC unterstützt) als Eingabe. Im Fall von OData stellt das sogenannte OData-Service-Metadatendokument die entsprechende Schnittstellenbeschreibung bereit. Basierend auf den Informationen im Servicemetadatendokument werden OData-Consumption-Proxy-Objekte für das Service-Consumption-Modell generiert. Mit diesen Objekten können Sie ABAP-Code schreiben, mit dem Sie Remote-OData-Services aufrufen können.
    1. Wenn der Chrome-Browser noch nicht gestartet ist, öffnen Sie ihn über das Windows-Startmenü.

    2. Geben Sie die folgende URL ein, und drücken Sie dann die Eingabetaste: https://s4dhost.wdf.sap.corp:44310/sap/opu/odata/sap/ZZ1_CUSTOMERINVOICE##_CDS/$metadata

    3. Wenn Sie dazu aufgefordert werden, melden Sie sich mit Ihrem Benutzer TRAIN-## und dem zugehörigen Kennwort am S4D-System an.

      Ergebnis

      Das Servicemetadatendokument wird im Browser angezeigt.
    4. Führen Sie einen Rechtsklick im Browserfenster aus, und wählen Sie im angezeigten Kontextmenü Sichern als....

    5. Wählen Sie im daraufhin angezeigten Dialogfenster den Ordner N:\Documents aus, und geben Sie $metadata.xml als Dateiname ein. Wählen Sie dann Sichern.

  2. Legen Sie basierend auf dem gesicherten Servicemetadatendokument ein Service-Consumption-Modell für die Entitätsmenge ZZ1_CUSTOMERINVOICE## des OData-Service für Kundenrechnungen in Ihrem Paket ZS4D425_##_CLD an. Verwenden Sie ZSC_D425_INVOICES_## als Namen und Invoices from S4D als Beschreibung für das Service-Consumption-Modell.

    1. Klicken Sie in ADT mit der rechten Maustaste auf Ihr Paket ZS4D425_##_CLD, und wählen Sie New→Other ABAP Repository Object.

    2. Suchen Sie im daraufhin angezeigten Dialogfenster nach Service-Consumption-Modell, wählen Sie es aus, und klicken Sie auf Weiter.

    3. Geben Sie auf dem Bild Service-Consumption-ModellZSC_D425_INVOICES_## als Name und Rechnungen aus S4D als Beschreibung ein. Stellen Sie sicher, dass OData als Remote-Consumption-Modus ausgewählt ist. Wählen Sie danach Next.

    4. Wählen Sie im angezeigten Dialogfenster Durchsuchen..., um die Datei N:\Documents\$metadata.xml auszuwählen, die Sie im vorherigen Schritt angelegt haben. Wählen Sie Next.

    5. Im Schritt Komponenten des OData-Service sehen Sie alle Komponenten aus der Service-Metadatendatei. Wählen Sie Next.

    6. Im Schritt ETag-Unterstützung müssen Sie nichts ändern. Wählen Sie Next.

    7. Stellen Sie im Schritt Auswahl des Transportauftrags sicher, dass die Option Aus Aufträgen wählen, an denen ich beteiligt bin ausgewählt ist. Wählen Sie den Transportauftrag aus, den Sie in einer vorherigen Übung angelegt haben, und wählen Sie Fertigstellen.

      Ergebnis

      Das Service-Consumption-Modell wird generiert und im Editor angezeigt.
  3. Untersuchen Sie das generierte Service-Consumption-Modell.

    Auf welche Service-Entitätsmengen kann über das Service-Consumption-Modell zugegriffen werden?

    _____________________________________________________________________________

    Für welche Operationen stellt das Service-Consumption-Modell Beispielcode für den Zugriff auf Entitätsmengen bereit?

    _____________________________________________________________________________

    1. Wenn das Service-Consumption-Modell noch nicht geöffnet ist, öffnen Sie es wie folgt: Expandieren Sie die folgenden Knoten unter Ihrem Paket im Project Explorer: ZS4D425_##_CLD→Business Services→Service Consumption Models. Doppelklicken Sie anschließend auf ZSC_D425_INVOICES_##. Die Service-Entitätsmengen, auf die über das Service-Consumption-Modell zugegriffen werden kann, werden im Abschnitt Service-Entitätsmengen des Editors angezeigt: darunter finden Sie ZZ1_CUSTOMERINVOICE##. Markieren Sie diesen Eintrag mit der Maus.

    2. Im Abschnitt Details der Service-Entitätsmenge des Editors finden Sie die Code-Beispiele für den Zugriff auf die Entitätsmenge. Für die folgenden Operationen wird Beispielquelltext bereitgestellt: Anlegen, Lesen, Liste lesen, Aktualisieren, Löschen.

Anlegen einer Konsolenanwendung zum Testen des Service-Consumption-Modells

Die Schritte und Daten dieser Demonstration finden Sie in der Übung Eine Konsolenanwendung zum Testen des Service-Consumption-Modells anlegen.

Konsolenanwendung zum Testen des Service-Consumption-Modells anlegen

In dieser Übung legen Sie eine kleine Konsolenanwendung an, um das Service-Consumption-Modell zu testen. Auf diese Weise prüfen Sie, ob der Aufruf des OData-Service im On-Premise-System aus der SAP-BTP-ABAP-Umgebung funktioniert. Das Auffinden von Fehlern, die auftreten können, ist über eine Konsolenanwendung viel einfacher als später, wenn das Service-Consumption-Modell bereits in die Basisanwendung integriert wurde.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Musterlösung:ZCL_CE_D425_INVOICES_98 (globale Klasse)

Schritte

  1. Legen Sie eine globale Klasse mit dem NamenZCL_CE_D425_INVOICES_## in Ihrem Paket ZS4D425_##_CLD an. Verwenden Sie die benutzerdefinierte Entität der Query-Implementierung als Beschreibung für die Klasse. Stellen Sie sicher, dass die Klasse das Interface IF_OO_ADT_CLASSRUN implementiert.

    Notiz

    Der Aufruf des OData-Service im On-Premise-System wird später über eine sogenannte Custom-Entität in die Basisanwendung integriert. Zu diesem Zweck wird die jetzt angelegte Klasse als Query-Implementierung der Custom-Entität wiederverwendet. Daher wählen wir hier bereits den Klassennamen und die Beschreibung entsprechend aus. Die CE im Klassennamen gibt an, dass diese Klasse als Query-Implementierung für eine Custom-Entität dient.
    1. Klicken Sie in ADT mit der rechten Maustaste auf Ihr Paket ZS4D425_##_CLD, und wählen Sie New→Other ABAP Repository Object.

    2. Suchen Sie im daraufhin angezeigten Dialogfenster nach ABAP-Klasse, wählen Sie sie aus, und klicken Sie auf Weiter.

    3. Geben Sie auf dem Bild ABAP-KlasseZCL_CE_D425_INVOICES_## als Name und die benutzerdefinierte Query-Implementierungsentität als Beschreibung ein.

    4. Wählen Sie auf dem Bild ABAP-Klasse die Drucktaste Hinzufügen.... Suchen Sie im angezeigten Dialogfenster Add ABAP Interface nach IF_OO_ADT_CLASSRUN, wählen Sie es aus, und klicken Sie auf OK. Wählen Sie anschließend Next auf dem Bild ABAP Class.

    5. Stellen Sie im Schritt Auswahl des Transportauftrags sicher, dass die Option Aus Aufträgen wählen, an denen ich beteiligt bin ausgewählt ist. Wählen Sie den Transportauftrag aus, den Sie in einer vorherigen Übung angelegt haben, und wählen Sie Fertigstellen.

      Ergebnis

      Die Klasse wird im ABAP-Klasseneditor generiert und angezeigt. Stellen Sie sicher, dass Ihr Quelltext wie folgt aussieht:
      Code Snippet
      1234567891011121314151617
      CLASS zcl_ce_d425_invoices_## DEFINITION PUBLIC FINAL CREATE PUBLIC . PUBLIC SECTION. INTERFACES if_oo_adt_classrun. PROTECTED SECTION. PRIVATE SECTION. ENDCLASS. CLASS zcl_ce_d425_invoices_## IMPLEMENTATION. METHOD if_oo_adt_classrun~main. ENDMETHOD. ENDCLASS.
  2. Fügen Sie die folgende Typdeklaration zum Public Section Ihrer Klasse ZCL_CE_D425_INVOICES_## hinzu:

    Code-Snippet

    Notiz

    Die vom OData-Service im On-Premise-System zurückgegebenen Daten werden über das Service-Consumption-Modell als interne Tabelle zur Verfügung gestellt. Der hier angelegte Datentyp wird später zum Anlegen entsprechender interner Tabellen verwendet.
    1. Stellen Sie sicher, dass Ihr Quelltext wie folgt aussieht:

      Code Snippet
      123456789101112131415161718
      CLASS zcl_ce_d425_invoices_## DEFINITION PUBLIC FINAL CREATE PUBLIC . PUBLIC SECTION. INTERFACES if_oo_adt_classrun. PROTECTED SECTION. PRIVATE SECTION. ENDCLASS. CLASS zcl_ce_d425_invoices_## IMPLEMENTATION. METHOD if_oo_adt_classrun~main. ENDMETHOD. ENDCLASS.
  3. Fügen Sie die folgende Methodendefinition zum Public Section Ihrer Klasse ZCL_CE_D425_INVOICES_## hinzu:

    Code-Snippet

    Notiz

    Die Methode get_Invoices wird verwendet, um den Zugriff auf den Remote-OData-Service zu implementieren. Die Methode akzeptiert Filterbedingungen (OData-Abfrageoption $filter) und Werte für das Paging der Daten (OData-Abfrageoptionen $top und $skip) als optionale Importparameter. Diese Parameter werden später in der Implementierung der Methode über das Service-Consumption-Modell an den aufgerufenen OData-Service übergeben. Die Export-Schnittstelle der Methode get_Invoices gibt die übereinstimmenden Daten zurück, die vom OData-Service bereitgestellt werden.

    1. Stellen Sie sicher, dass Ihr Quelltext wie folgt aussieht:

      Notiz

      Sie können den angezeigten Fehler ignorieren, der besagt, dass die Implementierung für die Methode get_Invoices fehlt. Die Implementierung wird im nächsten Schritt hinzugefügt.
      Code Snippet
      1234567891011121314151617181920
      CLASS zcl_ce_d425_invoices_## DEFINITION PUBLIC FINAL CREATE PUBLIC . PUBLIC SECTION. INTERFACES if_oo_adt_classrun. TYPES tt_business_data TYPE zsc_d425_invoices_##=>tyt_zz_1_customerinvoice_##_ty. PROTECTED SECTION. PRIVATE SECTION. ENDCLASS. CLASS zcl_ce_d425_invoices_## IMPLEMENTATION. METHOD if_oo_adt_classrun~main. ENDMETHOD. ENDCLASS.
  4. Implementieren Sie die beiden Methoden if_oo_adt_classrun~main und get_Invoices in Ihrer Klasse ZCL_CE_D425_INVOICES_##. Kopieren Sie dazu die entsprechenden Methodenimplementierungen aus der Musterlösung ZCL_CE_D425_INVOICES_98.

    Gleichen Sie in der Implementierung der Methode get_invoices den kopierten Code wie folgt mit Ihrer Gruppennummer ab.

    In der Implementierung der Methode if_oo_adt_classrun~main gibt es nichts zu ändern. (Vergessen Sie jedoch nicht, sie zu kopieren.)

    Kopiertes Coding der Methode get_invoices:

    Code Snippet
    12345678910111213141516171819
    METHOD get_invoices. [...] DATA(lo_odata_client_proxy) = /iwbep/cl_cp_factory_remote=>create_v2_remote_proxy( EXPORTING is_proxy_model_key = VALUE #( repository_id = 'DEFAULT' proxy_model_id = 'ZSC_D425_INVOICES_98' proxy_model_version = '0001' ) io_http_client = lo_http_client iv_relative_service_root = '/sap/opu/odata/sap/ZZ1_CUSTOMERINVOICE98_CDS' ). " Navigate to the resource and create a request for the read operation DATA(lo_request) = lo_odata_client_proxy->create_resource_for_entity_set( 'ZZ_1_CUSTOMERINVOICE_98' )->create_request_for_read( ). [...] ENDMETHOD.

    Angepasster Quelltext der Methode get_invoices:

    Code Snippet
    123456789101112131415161718
    METHOD get_invoices. [...] DATA(lo_odata_client_proxy) = /iwbep/cl_cp_factory_remote=>create_v2_remote_proxy( EXPORTING is_proxy_model_key = VALUE #( repository_id = 'DEFAULT' proxy_model_id = 'ZSC_D425_INVOICES_##' proxy_model_version = '0001' ) io_http_client = lo_http_client iv_relative_service_root = '/sap/opu/odata/sap/ZZ1_CUSTOMERINVOICE##_CDS' ). " Navigate to the resource and create a request for the read operation DATA(lo_request) = lo_odata_client_proxy->create_resource_for_entity_set( 'ZZ_1_CUSTOMERINVOICE_##' )->create_request_for_read( ). [...] ENDMETHOD.

    Aktivieren Sie anschließend Ihre Klasse ZCL_CE_D425_INVOICES_##.

    1. Wählen Sie das Symbol Open ABAP Development Object in der Eclipse-Symbolleiste aus, oder drücken Sie Strg+Umschalt+A.

    2. Geben Sie im Dialogfenster Open ABAP Development ObjectZCL_CE_D425_INVOICES_## als Suchbegriff ein. Wählen Sie ZCL_CE_D425_INVOICES_98 im Bereich Matching-Positionen aus, und wählen Sie OK.

    3. Markieren Sie im daraufhin geöffneten ABAP-Klasseneditor den unten hervorgehobenen Code, und kopieren Sie ihn (z.B. über Strg+C).

      Der vollständige Quelltext:

      Code Snippet
      123456789101112131415161718192021222324252627282930
      CLASS zcl_ce_d425_invoices_## DEFINITION PUBLIC FINAL CREATE PUBLIC . PUBLIC SECTION. INTERFACES: if_oo_adt_classrun. TYPES tt_business_data TYPE zsc_d425_invoices_##=>tyt_zz_1_customerinvoice_##_ty. METHODS get_invoices IMPORTING it_filter_cond TYPE if_rap_query_filter=>tt_name_range_pairs OPTIONAL iv_top TYPE i OPTIONAL iv_skip TYPE i OPTIONAL EXPORTING et_business_data TYPE tt_business_data RAISING /iwbep/cx_cp_remote /iwbep/cx_gateway cx_web_http_client_error cx_http_dest_provider_error. PROTECTED SECTION. PRIVATE SECTION. ENDCLASS. CLASS zcl_ce_d425_invoices_## IMPLEMENTATION. ENDCLASS.
    4. Kehren Sie zu Ihrer Klasse ZCL_CE_D425_INVOICES_## zurück. Löschen Sie den folgenden Quelltext aus dem Implementierungsteil der Klasse:

      Code-Snippet
    5. Fügen Sie anschließend den kopierten Quelltext in den Implementierungsteil der Klasse ein. Ändern Sie ihn wie oben beschrieben.

    6. Um die Klasse zu aktivieren, können Sie die Tastenkombination Strg+F3 verwenden.

  5. Führen Sie Ihre ABAP-Klasse ZCL_CE_D425_INVOICES_## als Konsolenanwendung aus.

    Notiz

    Der kopierte Code geht davon aus, dass eine Destination mit dem Namen S4D_100 angelegt wurde, die zum Herstellen der Verbindung zum SAP-S/4HANA-On-Premise-System verwendet wird. Passen Sie bei Bedarf den im Code verwendeten Destinationsnamen an.
    Code Snippet
    12345
    " Create http client DATA(lo_http_destination) = cl_http_destination_provider=>create_by_cloud_destination( i_name = '' i_authn_mode = if_a4c_cp_service=>service_specific ).

    Notiz

    In der Methode if_oo_adt_classrun~main wird ein Filter gesetzt, der nur Rechnungen mit einer ID größer oder gleich 1 selektiert. Außerdem ist das Ergebnis auf 3 Datensätze beschränkt. Passen Sie diese Einschränkungen bei Bedarf an Ihre Daten an.
    Code Snippet
    123456789101112131415161718
    lt_ranges_table = . lt_filter_conditions = VALUE #( ( name = 'ID' range = lt_ranges_table ) ). TRY. me->get_invoices( EXPORTING it_filter_cond = lt_filter_conditions iv_top = iv_skip = IMPORTING et_business_data = lt_business_data ) . out->write( lt_business_data ). CATCH cx_root INTO DATA(lx_exception). out->write( cl_message_helper=>get_latest_t100_exception( lx_exception )->if_message~get_longtext( ) ). ENDTRY.
    1. Um Ihre Klasse ZCL_CE_D425_INVOICES_## als Konsolenanwendung auszuführen, klicken Sie mit der rechten Maustaste in den ABAP-Editor, in dem Ihre Klasse angezeigt wird, und wählen Sie Run As→1 ABAP Application (Console). Alternativ können Sie F9 drücken.

    Ergebnis

    Die Sicht Konsole zeigt nun die vom Remote-OData-Service zurückgegebenen Datensätze an. Die Ausgabe sollte wie folgt aussehen:

    Code Snippet
    1234
    Table SAP_UUID APPLYCUSTOMERDISCOUNT_AC APPLYCUSTOMERDISCOUNT_AC_VC ID ID_VC CUSTOMERID ... 005056044E851EDBBCA9087C5A80EF49 X 0000000815 99999999 005056044E851EDBBCEF851328D60939 X 0000004712 99999999 005056044E851EDBBCEFD06F059A6A5C X 0000004713 99999999

Benutzerdefinierte Entität anlegen

Die Schritte und Daten dieser Demonstration finden Sie in der Übung Eine benutzerdefinierte Entität anlegen.

Benutzerdefinierte Entität anlegen

Um den OData-Service aus dem SAP-S/4HANA-On-Premise-System über eine Wertehilfe in die Basisanwendung integrieren zu können, legen Sie nun eine benutzerdefinierte Entität an. Diese Custom-Entität definiert das Datenmodell, über das die Daten aus dem Remote-OData-Service für die Wertehilfe zur Verfügung gestellt werden.

Im Gegensatz zu „normalen" CDS-Views, die Daten aus Datenbanktabellen oder anderen CDS-Views lesen, wird die Datenbeschaffung für Custom-Entitäten manuell implementiert. Das heißt, die Daten für das über die Custom-Entität definierte Datenmodell werden codebasiert über eine ABAP-Klasse ausgewählt, die das Interface IF_RAP_QUERY_PROVIDER implementiert. Die entsprechende Query-Implementierung für die benutzerdefinierte Entität wird in der nächsten Übung durchgeführt. Dazu wird die in der letzten Übung angelegte Klasse wiederverwendet.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Musterlösung:ZCE_D425_INVOICES_98 (Datendefinition)

Schritte

  1. Legen Sie eine benutzerdefinierte Entität mit dem NamenZCE_D425_INVOICES_## und der BeschreibungBenutzerdefinierte Entität für Rechnungen aus S4D in Ihrem Paket ZS4D425_##_CLD an. Verwenden Sie zu diesem Zweck die DatendefinitionsvorlageBenutzerdefinierte Entität mit Parametern definieren.

    Notiz

    Für die Custom-Entität in dieser Übung sind keine Parameter erforderlich. Es gibt jedoch keine Vorlage zum Anlegen einer Custom-Entität ohne Parameter. Daher löschen Sie im nächsten Schritt den für die Parameter generierten Code.
    1. Klicken Sie mit der rechten Maustaste auf Ihr Paket ZS4D425_##_CLD, und wählen Sie New→Other ABAP Repository Object.

    2. Suchen Sie im daraufhin angezeigten Dialogfenster nach Datendefinition, wählen Sie sie aus, und wählen Sie Weiter.

    3. Geben Sie auf dem Bild DatendefinitionZCE_D425_INVOICES_## als Name und Benutzerdefinierte Entität für Rechnungen aus S4D als Beschreibung ein. Wählen Sie danach Next.

    4. Stellen Sie im Schritt Auswahl des Transportauftrags sicher, dass die Option Aus Aufträgen wählen, an denen ich beteiligt bin ausgewählt ist. Wählen Sie den Transportauftrag aus, den Sie in einer vorherigen Übung angelegt haben, und wählen Sie Weiter.

      Achtung

      Wählen Sie in diesem Schritt nicht Fertigstellen. Andernfalls gelangen Sie nicht zum Dialogfenster, in dem Sie die Vorlage auswählen können.
    5. Wählen Sie auf dem Bild Vorlagen die Vorlage Benutzerdefinierte Entität mit Parametern definieren aus, und wählen Sie Fertigstellen.

      Ergebnis

      Die Custom-Entität wird generiert und im Editor angezeigt. Stellen Sie sicher, dass Ihr Quelltext wie folgt aussieht:
      Code Snippet
      1234567
      @EndUserText.label: 'Custom entity for invoices from S4D' define custom entity ZCE_D425_INVOICES_## with parameters parameter_name : parameter_type { key key_element_name : key_element_type; element_name : element_type; }
  2. Löschen Sie die Anweisung with parameters parameter_name : parameter_type aus dem Quelltext Ihrer benutzerdefinierten Entität ZCE_D425_INVOICES_##. Entfernen Sie außerdem die folgenden beiden Zeilen aus der Definition der Custom-Entität:

    Code Snippet
    12
    key key_element_name : key_element_type; element_name : element_type;

    Notiz

    Sie können den angezeigten Fehler ignorieren. Sie verschwindet, wenn der benutzerdefinierten Entität im nächsten Schritt Elemente hinzugefügt werden.
    1. Löschen Sie die oben genannten Anweisungen aus dem Quelltext. Stellen Sie sicher, dass Ihre Implementierung nun wie folgt aussieht:

      Code Snippet
      12345
      @EndUserText.label: 'Custom entity for invoices from S4D' define custom entity ZCE_D425_INVOICES_## { }
  3. Fügen Sie der Definition Ihrer benutzerdefinierten Entität ZCE_D425_INVOICES_## die folgenden Elemente hinzu:

    Code Snippet
    12345678
    key SAP_UUID : sysuuid_x16; ID : abap.numc( 10 ); Customer_ID : abap.numc( 8 ); Customer_Name : abap.char( 25 ); @Semantics.amount.currencyCode: 'Amount_C' Amount_V : abap.curr( 16, 3 ); @Semantics.currencyCode: true Amount_C : abap.cuky;

    Notiz

    Um das Datenmodell einfach zu halten, müssen nicht alle Felder aus dem Remote-OData-Service über die benutzerdefinierte Entität für die Wertehilfe exponiert werden. Der Einfachheit halber beschränken wir uns hier auf einige wenige Felder.
    1. Um die Kopiervorlage ZD425_##_ZZ1_CUSTOMERINVOICE## im Editor zu öffnen, expandieren Sie die folgenden Knoten unter Ihrem Paket im Project Explorer: ZS4D425_##_CLD→Core Data Services→Data Definitions. Doppelklicken Sie anschließend auf ZD425_##_ZZ1_CUSTOMERINVOICE##.

    2. Kopieren Sie nacheinander die oben genannten Elemente aus der Kopiervorlage, und fügen Sie sie dann zwischen den geschweiften Klammern in Ihre benutzerdefinierte Entität ein. Stellen Sie sicher, dass die Definition Ihrer benutzerdefinierten Entität schließlich wie folgt aussieht:

      Code Snippet
      123456789101112
      @EndUserText.label: 'Custom entity for invoices from S4D' define custom entity ZCE_D425_INVOICES_## { key SAP_UUID : sysuuid_x16; ID : abap.numc( 10 ); Customer_ID : abap.numc( 8 ); Customer_Name : abap.char( 25 ); @Semantics.amount.currencyCode: 'Amount_C' Amount_V : abap.curr( 16, 3 ); @Semantics.currencyCode: true Amount_C : abap.cuky; }
  4. Passen Sie die Anzahl der Nachkommastellen für das Feld Amount_V von 3 auf 2 wie folgt an:

    Code Snippet
    1
    Amount_V : abap.curr( 16, );

    Achtung

    Es werden nur Betragsfelder mit 2 Nachkommastellen unterstützt.
    1. Nehmen Sie in der Definition Ihrer benutzerdefinierten Entität ZCE_D425_INVOICES_## die oben beschriebene Änderung vor. Stellen Sie sicher, dass die Definition nun wie folgt aussieht:

      Code Snippet
      123456789101112
      @EndUserText.label: 'Custom entity for invoices from S4D' define custom entity ZCE_D425_INVOICES_## { key SAP_UUID : sysuuid_x16; ID : abap.numc( 10 ); Customer_ID : abap.numc( 8 ); Customer_Name : abap.char( 25 ); @Semantics.amount.currencyCode: 'Amount_C' Amount_V : abap.curr( 16, ); @Semantics.currencyCode: true Amount_C : abap.cuky; }
  5. Definieren Sie nun die Klasse ZCL_CE_D425_INVOICES_##, die Sie in der letzten Übung angelegt haben, als Query-Implementierungsklasse für Ihre benutzerdefinierte Entität. Fügen Sie dazu die folgende Annotation vor der Anweisung define custom entity ZCE_D425_INVOICES_## in Ihrer Custom-Entität hinzu:

    Code Snippet
    1
    @ObjectModel.query.implementedBy: 'ABAP:ZCL_CE_D425_INVOICES_##'

    Notiz

    In der nächsten Übung ändern Sie die Klasse ZCL_CE_D425_INVOICES_## entsprechend.

    Aktivieren Sie anschließend Ihre benutzerdefinierte Entität ZCE_D425_INVOICES_##.

    1. Aktualisieren Sie den Quelltext Ihrer benutzerdefinierten Entität wie oben beschrieben. Stellen Sie sicher, dass die Definition Ihrer benutzerdefinierten Entität nun wie folgt aussieht:

      Code Snippet
      12345678910111213
      @EndUserText.label: 'Custom entity for invoices from S4D' define custom entity ZCE_D425_INVOICES_## { key SAP_UUID : sysuuid_x16; ID : abap.numc( 10 ); Customer_ID : abap.numc( 8 ); Customer_Name : abap.char( 25 ); @Semantics.amount.currencyCode: 'Amount_C' Amount_V : abap.curr( 16, 2 ); @Semantics.currencyCode: true Amount_C : abap.cuky; }
    2. Um die benutzerdefinierte Entität zu aktivieren, können Sie die Tastenkombination Strg+F3 verwenden.

Implementieren der Query-Implementierungsklasse der benutzerdefinierten Entität

Die Schritte und Daten dieser Demonstration finden Sie in der Übung Implementieren der Query-Implementierungsklasse der Custom-Entität.

Query-Implementierungsklasse der benutzerdefinierten Entität implementieren

In der letzten Übung haben Sie die benutzerdefinierte Entität ZCE_D425_INVOICES_## angelegt und die zuvor angelegte Klasse ZCL_CE_D425_INVOICES_## als Query-Implementierungsklasse für diese benutzerdefinierte Entität angegeben.

In dieser Übung ändern Sie nun die Klasse ZCL_CE_D425_INVOICES_## entsprechend. Dazu müssen Sie das Interface IF_RAP_QUERY_PROVIDER in der Klasse ZCL_CE_D425_INVOICES_## implementieren. Dieses Interface verfügt über eine Methode namens select, mit der die Datenbeschaffung für die Custom-Entität implementiert wird. In der Implementierung dieser Methode delegieren Sie die Datenbeschaffung an die Methode get_Invoices, die bereits in der Klasse vorhanden ist.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Musterlösung:ZCL_CE_D425_INVOICES_98 (globale Klasse)

Schritte

  1. Implementieren Sie das Interface IF_RAP_QUERY_PROVIDER für Ihre Klasse ZCL_CE_D425_INVOICES_##, indem Sie dem Public Section der Klasse die folgende Anweisung hinzufügen:

    Code Snippet
    1
    INTERFACES if_rap_query_provider.

    Notiz

    Sie können die angezeigte Warnung ignorieren, dass die Implementierung für die Methode if_rap_query_provider~select fehlt. Die Implementierung wird im nächsten Schritt hinzugefügt.
    1. Passen Sie Ihre Klasse wie oben beschrieben an. Stellen Sie sicher, dass der Definitionsteil Ihrer Klasse wie folgt aussieht:

      Code Snippet
      12345678910111213
      CLASS zcl_ce_d425_invoices_## DEFINITION PUBLIC FINAL CREATE PUBLIC . PUBLIC SECTION. INTERFACES if_oo_adt_classrun. ... PROTECTED SECTION. PRIVATE SECTION. ENDCLASS.
  2. Implementieren Sie die Methode if_rap_query_provider~select für Ihre Klasse ZCL_CE_D425_INVOICES_##. Kopieren Sie dazu die entsprechende Methodenimplementierung aus der Musterlösung ZCL_CE_D425_INVOICES_98.

    Notiz

    In der Implementierung der Methode select wird der Importparameter io_request dieser Methode verwendet, um OData-Abfrageoptionen des eingehenden OData-Aufrufs abzurufen.

    Paging-bezogene Einstellungen werden von io_request->get_paging( )->get_page_size( ) (Abfrageoption $top) und io_request->get_paging( )->get_offset( ) (Abfrageoption $skip) abgefragt. Alle gesetzten Filter (Abfrageoption $filter) werden über io_request->get_filter( )->get_as_ranges( ) abgerufen.

    Die Paging- und Filtereinstellungen werden an die vorhandene Methode get_Invoices übergeben, die dann die entsprechenden Daten aus dem SAP-S/4HANA-On-Premise-System zurückgibt.

    Es werden jedoch nicht alle OData-Abfrageoptionen an den OData-Service im SAP-S/4HANA-On-Premise-System übergeben. Beispielsweise wird jede angeforderte Sortierung der Daten (Systemabfrageoption $orderby) nicht berücksichtigt. Das bedeutet, dass es nicht möglich ist, die Rechnungsdaten in der Wertehilfe zu sortieren.

    1. Sofern noch nicht geschehen, können Sie die Musterlösung ZCL_CE_D425_INVOICES_98 im ABAP-Klasseneditor wie folgt öffnen:

      Wählen Sie das Symbol Open ABAP Development Object in der Eclipse-Symbolleiste aus, oder drücken Sie Strg+Umschalt+A. Geben Sie im daraufhin angezeigten Dialogfenster ABAP-Entwicklungsobjekt öffnenZCL_CE_D425_INVOICES_98 als Suchstring ein. Wählen Sie dann ZCL_CE_D425_INVOICES_98 im Bereich Matching-Positionen aus, und wählen Sie OK.

    2. Markieren Sie in der Musterlösung ZCL_CE_D425_INVOICES_98 den Code der Methodenimplementierung if_rap_query_provider~select, und kopieren Sie ihn anschließend (z.B. über Strg+C).

      Code Snippet
      12345678910111213141516171819202122232425262728293031323334353637
      CLASS zcl_ce_d425_invoices_98 DEFINITION PUBLIC FINAL CREATE PUBLIC . PUBLIC SECTION. INTERFACES if_oo_adt_classrun. ... METHODS get_invoices IMPORTING it_filter_cond TYPE if_rap_query_filter=>tt_name_range_pairs OPTIONAL iv_top TYPE i OPTIONAL iv_skip TYPE i OPTIONAL EXPORTING et_business_data TYPE tt_business_data RAISING /iwbep/cx_cp_remote /iwbep/cx_gateway cx_web_http_client_error cx_http_dest_provider_error. PROTECTED SECTION. PRIVATE SECTION. ENDCLASS. CLASS zcl_ce_d425_invoices_98 IMPLEMENTATION. METHOD if_oo_adt_classrun~main. ... ENDMETHOD. METHOD get_invoices. ... ENDMETHOD. ENDCLASS.
    3. Fügen Sie den kopierten Quelltext in den Implementierungsteil Ihrer Klasse ZCL_CE_D425_INVOICES_## ein. Stellen Sie sicher, dass Ihre Klasse nun wie folgt aussieht:

      Code Snippet
      12345678910111213141516171819202122232425
      CLASS zcl_ce_d425_invoices_## DEFINITION PUBLIC FINAL CREATE PUBLIC . PUBLIC SECTION. INTERFACES if_oo_adt_classrun. INTERFACES if_rap_query_provider. ... . PROTECTED SECTION. PRIVATE SECTION. ENDCLASS. CLASS zcl_ce_d425_invoices_## IMPLEMENTATION. METHOD if_oo_adt_classrun~main. ... ENDMETHOD. METHOD get_invoices. ... ENDMETHOD. ENDCLASS.
  3. Aktivieren Sie Ihre Klasse ZCL_CE_D425_INVOICES_##.

    1. Um die Klasse zu aktivieren, können Sie die Tastenkombination Strg+F3 verwenden.

Benutzerdefinierte Entität über die Service-Definition exponieren und als Wertehilfe in die Basisanwendung integrieren

Die Schritte und Daten dieser Demonstration finden Sie in der Übung Benutzerdefinierte Entität über die Service-Definition exponieren und als Wertehilfe in die Basisanwendung integrieren.

Benutzerdefinierte Entität über die Service-Definition exponieren und als Wertehilfe in die Basisanwendung integrieren

In dieser Übung exponieren Sie die zuvor angelegte und implementierte benutzerdefinierte Entität über den OData-Service der Basisanwendung. Dazu fügen Sie die Custom-Entität zur entsprechenden Service-Definition hinzu. Anschließend verwenden Sie die benutzerdefinierte Entität in der Basisanwendung, um eine Wertehilfe für Kundenrechnungen bereitzustellen. Abschließend testen Sie die Anwendung mithilfe der Vorschau der SAP-Fiori-Elements-App.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Musterlösung:

  • ZUI_425_COMPLAINT98_O4 (Service-Definition)
  • ZC_425_COMPLAINT98 (CDS-Projektions-View)

Schritte

  1. Exponieren Sie Ihre benutzerdefinierte Entität ZCE_D425_INVOICES_## über die Service-Definition ZUI_425_COMPLAINT##_O4, indem Sie der Service-Definition die folgende Anweisung hinzufügen:

    Code Snippet
    1
    expose ZCE_D425_INVOICES_## as Invoice;
    1. Sofern noch nicht geschehen, können Sie die Service-Definition ZUI_425_COMPLAINT##_O4 im Editor wie folgt öffnen:

      Wählen Sie das Symbol Open ABAP Development Object in der Eclipse-Symbolleiste aus, oder drücken Sie Strg+Umschalt+A. Geben Sie im daraufhin angezeigten Dialogfenster Open ABAP Development ObjectZUI_425_COMPLAINT##_O4 als Suchstring ein. Wählen Sie dann ZUI_425_COMPLAINT##_O4 im Bereich Matching-Positionen aus, und wählen Sie OK.

    2. Fügen Sie der Service-Definition die oben genannte Anweisung hinzu. Stellen Sie sicher, dass die Service-Definition wie folgt aussieht:

      Code Snippet
      1234
      define service ZUI_425_COMPLAINT##_O4 { expose ZC_425_COMPLAINT## as Complaint; }
  2. Aktivieren Sie Ihre Änderungen.

    1. Um die Service-Definition zu aktivieren, können Sie die Tastenkombination Strg+F3 verwenden.

  3. Definieren Sie nun Ihre benutzerdefinierte Entität ZCE_D425_INVOICES_## als Wertehilfe für das Feld InvoiceID in der Basisanwendung, indem Sie diesem Feld in der Projektions-View ZC_425_COMPLAINT## die folgende Annotation hinzufügen:

    Code Snippet
    1234567
    @Consumption.valueHelpDefinition: [{ entity : { name: 'ZCE_D425_INVOICES_##', element: 'ID' }, additionalBinding : [{ localElement: 'CustomerID', element: 'Customer_ID' }, { localElement: 'CustomerName', element: 'Customer_Name' }] }] InvoiceID, ...

    Notiz

    Die Annotation additionalBinding stellt sicher, dass die Werte der Felder CustomerID und CustomerName in der Basisanwendung in den Wertehilfedialog kopiert werden, wenn die Wertehilfe aufgerufen wird. Wenn eine Kundenrechnung in der Wertehilfe ausgewählt wird, werden diese Felder entsprechend mit den Werten der gleichnamigen Felder aus der Wertehilfe gefüllt.
    1. Sofern noch nicht geschehen, können Sie die Projektions-View ZC_425_COMPLAINT## im Editor wie folgt öffnen:

      Wählen Sie das Symbol Open ABAP Development Object in der Eclipse-Symbolleiste aus, oder drücken Sie Strg+Umschalt+A. Geben Sie im daraufhin angezeigten Dialogfenster Open ABAP Development ObjectZC_425_COMPLAINT## als Suchbegriff ein. Wählen Sie dann ZC_425_COMPLAINT## im Bereich Matching-Positionen aus, und wählen Sie OK.

    2. Fügen Sie die obige Annotation zum Feld InvoiceID in der Projektions-View hinzu. Stellen Sie sicher, dass die Projektions-View wie folgt aussieht:

      Code Snippet
      123456789101112131415161718192021222324
      @AccessControl.authorizationCheck: #CHECK @Metadata.allowExtensions: true @EndUserText.label: 'Projection View for Complaint' @ObjectModel.semanticKey: [ 'ComplaintID' ] @Search.searchable: true define root view entity ZC_425_COMPLAINT## as projection on ZR_D425_COMPLAINT_## { key UUID, @Search.defaultSearchElement: true @Search.fuzzinessThreshold: 0.90 ComplaintID, InvoiceID, CustomerID, CustomerName, Reason, Action, Closed, CreatedBy, CreatedAt, LastChangedBy, LastChangedAt }
  4. Aktivieren Sie Ihre Änderungen.

    1. Um die Projektions-View zu aktivieren, können Sie die Tastenkombination Strg+F3 verwenden.

  5. Testen Sie abschließend die Wertehilfe. Öffnen Sie dazu die Vorschau der SAP-Fiori-Elements-App für die Entitätsmenge Reklamation. Legen Sie in der App eine neue Reklamation an, und rufen Sie die nun verfügbare Wertehilfe für das Feld Rechnungs-ID auf der Objektseite auf.

    1. Öffnen Sie die Service-Bindung ZUI_425_COMPLAINT##_O4 im Editor, sofern sie noch nicht geöffnet ist.

    2. Wählen Sie die Entitätsmenge Reklamation im Abschnitt Entitätsmenge und Assoziation des Service-Binding-Editors aus.

      Notiz

      Zusätzlich zur Entitätsmenge Complaint wird in diesem Abschnitt nun auch die Entitätsmenge Invoice angezeigt.
    3. Wählen Sie Preview....

      Notiz

      Wenn Sie nicht automatisch angemeldet sind, klicken Sie auf den Link <xxxxxxxxx>.accounts.ondemand.com, der auf der angezeigten Browserseite angezeigt wird. Wenn Sie dazu aufgefordert werden, geben Sie Ihre E-Mail-Adresse gefolgt vom Kennwort in die entsprechenden Eingabefelder im Browser ein. Sie erhalten die erforderliche E-Mail-Adresse und das Kennwort von Ihrem Referenten. Wählen Sie abschließend die Drucktaste Anmelden, um sich am ABAP-System anzumelden.
    4. Wählen Sie in der angezeigten App Anlegen.

    5. Klicken Sie auf der Objektseite auf das Wertehilfesymbol, das für das Feld Rechnungsnummer angezeigt wird, um die Wertehilfe zu öffnen.

      Ergebnis

      Der Wertehilfedialog wird geöffnet und zeigt die aus dem SAP-S/4HANA-On-Premise-System ausgewählten Kundenrechnungen in der Tabelle Positionen an.
    6. Wählen Sie in der Tabelle Positionen eine Rechnung aus.

      Ergebnis

      Der ausgewählte Datensatz wird an die Objektseite übertragen, d.h. die Felder Rechnungs-ID, Kunden-ID und Kundenname werden mit den entsprechenden Werten gefüllt.

SAP Fiori Launchpad – Personalisierung

Um die Anwendung in der SAP-BTP-ABAP-Umgebung über das SAP Fiori Launchpad verfügbar zu machen, müssen die folgenden Schritte implementiert werden: Zunächst wird eine List-Report-Objektseite -Anwendung mit SAP Business Application Studio angelegt. Diese Anwendung wird in der ABAP-Serviceinstanz deployt, die unter anderem ein SAP-Fiori-Launchpad-App-Deskriptor-Element in der ABAP-Umgebung anlegt.

Die Abbildung veranschaulicht die unten aufgeführten Erläuterungen.

Anschließend wird über ADT eine IAM-App angelegt, der das SAP-Fiori-Launchpad-App-Deskriptor-Element zugeordnet ist. Als Nächstes wird ein IAM-Anwendungskatalog in ADT angelegt, dem wiederum die IAM-App zugeordnet ist.

Schließlich wird über das SAP Fiori Launchpad eine Benutzerrolle angelegt, der der zuvor angelegte IAM-Anwendungskatalog hinzugefügt wird. Außerdem werden die Anwendungsbenutzer, die Zugriff auf die Anwendung haben sollen, ebenfalls zur Benutzerrolle hinzugefügt.

Nachdem dies entsprechend konfiguriert wurde, können die berechtigten Benutzer die Anwendung über den App Finder im SAP Fiori Launchpad öffnen.

Eine SAP-Fiori-Elements-Anwendung basierend auf dem entwickelten OData-Service in SAP Business Application Studio anlegen

Die Schritte und Daten dieser Demo finden Sie in der Übung Eine SAP-Fiori-Elements-Anwendung basierend auf dem entwickelten OData-Service in SAP Business Application Studio anlegen.

SAP-Fiori-Elements-Anwendung basierend auf dem entwickelten OData-Service in SAP Business Application Studio anlegen (optional)

In den vorherigen Übungen haben Sie eine Anwendung für die Verwaltung von Kundenreklamationen in der SAP-BTP-ABAP-Umgebung angelegt. In dieser Anwendung haben Sie eine Wertehilfe über eine Side-by-Side-Erweiterung integriert, die ihre Daten über einen OData-Service abruft, der im SAP-S/4HANA-On-Premise-System aufgerufen wird, das in dieser Klasse verwendet wird.

Die Benutzungsoberfläche der Anwendung wurde bisher über eine SAP-Fiori-Elements-App-Vorschau zur Verfügung gestellt, die aus den ABAP Development Tools aufgerufen werden kann. Die folgenden Übungen konzentrieren sich nun auf das Anlegen der Benutzungsoberfläche für die Anwendung mit SAP Business Application Studio und das anschließende Deployment in der SAP-BTP-ABAP-Umgebung.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Notiz

Die folgenden Daten werden in der Übung benötigt, um SAP Business Application Studio mit Cloud Foundry zu verbinden. Er wird Ihnen von Ihrem Referenten zur Verfügung gestellt:
  • E-Mail-Adresse
  • Password
  • Organisation

Schritte

  1. Öffnen Sie Ihren Entwicklungsbereich S4D425_## in SAP Business Application Studio. Führen Sie den Befehl CF: Login to Cloud Foundry aus, um SAP Business Application Studio mit Cloud Foundry zu verbinden.

    1. Öffnen Sie SAP Business Application Studio über die URL, die Sie von Ihrem Referenten erhalten haben.

    2. Wenn Sie nicht automatisch angemeldet wurden, wählen Sie den Link <xxxxxxxxx>.accounts.ondemand.com, der auf der angezeigten Browserseite angezeigt wird. Wenn Sie dazu aufgefordert werden, geben Sie Ihre E-Mail-Adresse gefolgt vom Kennwort in die entsprechenden Eingabefelder im Browser ein. Sie erhalten die erforderliche E-Mail-Adresse und das Kennwort von Ihrem Referenten. Wählen Sie abschließend die Drucktaste Anmelden, um sich am SAP Business Application Studio anzumelden.

      Ergebnis

      Der Dev Space Manager wird im Browser angezeigt.
    3. Stellen Sie sicher, dass sich Ihr Dev Space im Status RUNNING befindet. Ist dies nicht der Fall, starten Sie ihn.

    4. Klicken Sie auf den Namen S4D425_## Ihres Dev Space, sobald er sich im Status RUNNING befindet.

      Ergebnis

      SAP Business Application Studio wird in Ihrem SAP-Fiori-EntwicklungsbereichS4D425_## geöffnet.
    5. Wählen Sie im Menü von SAP Business Application Studio den Pfad →View Command Palette.

    6. Suchen Sie in der angezeigten Palette nach dem Befehl CF: Login to Cloud Foundry, und wählen Sie ihn aus.

      Ergebnis

      Der Assistent für die Cloud-Foundry-Anmeldung wird gestartet.
    7. Bestätigen Sie im Schritt Enter Cloud Foundry endpoint die angezeigte URL mit ENTER.

    8. Geben Sie im Schritt E-Mail-Adresse eingeben die von Ihrem Referenten angegebene E-Mail-Adresse ein, und bestätigen Sie Ihre Eingabe mit ENTER.

    9. Geben Sie im Schritt Kennwort eingeben das von Ihrem Referenten bereitgestellte Kennwort ein, und bestätigen Sie Ihre Eingabe mit der Eingabetaste.

    10. Wählen Sie im nächsten Schritt die vom Referenten bereitgestellte Organisation aus.

    11. Wählen Sie im Schritt Space auswählen den angezeigten Space mit dem Namen dev aus.

      Ergebnis

      Sie sind nun bei Cloud Foundry angemeldet. Organisation und Space wurden festgelegt.
  2. Legen Sie nun eine SAP-Fiori-App mit dem Floorplan List Report Page in SAP Business Application Studio an. Die Anwendung soll auf Ihrem OData-Service basieren, der in ADT entwickelt wurde. Verwenden Sie dazu die folgenden Werte in den entsprechenden Wizard-Schritten:

    Datenquellen- und Serviceauswahl

      
    DatenquelleMit einem System verbinden
    SystemABAP-Umgebung auf SAP Business Technology Platform
    ABAP-Umgebungdefault_abap
    Service

    ZUI_425_COMPLAINT##_O4(0001) - OData V4

    Entitätsauswahl

      
    HauptentitätReklamation
    Tabellenspalten automatisch hinzufügen?Ja

    Projektattribute

      
    Modulnames4d425_Complaint_##
    AnwendungstitelReklamationen
    Anwendungsnamensraum
    DescriptionReklamationen verwalten
    Pfad des Projektordners/home/user/projects
    Deployment-Konfiguration hinzufügenJa
    FLP-Konfiguration hinzufügenJa
    Erweiterte Optionen konfigurierenNein

    Deployment-Konfiguration

      
    Wählen Sie das Ziel ausABAP
    Zielabap-cloud-default_abap-...
    SAPUI5-ABAP-Repository (maximale Länge: 15 Zeichen)Z_COMPLAINT_##
    PaketZS4D425_##_CLD
    Transportauftrag<Ihr Transportauftrag>
    Deployment-BeschreibungStudent ##

    Notiz

    Sie können Ihre Transportauftragsnummer wie folgt nachschlagen:

    1. Wählen Sie unter Wie möchten Sie einen Transportauftrag eingeben? die Option Aus vorhandenem auswählen.
    2. Wählen Sie dann im Feld Transportauftrag über das Dropdown-Menü Ihren ADT-Auftrag aus (z.B. H01K900008).

    Notiz

    Die Deployment-Konfiguration kann nach dem Anlegen des Projekts über die Datei ui5-deploy.yaml im Projektverzeichnis bearbeitet werden.

    Fiori-Launchpad-Konfiguration

      
    Semantisches ObjektReklamation
    Aktionmanage##
    TitelReklamationen verwalten
    Untertitel (optional)Student ##

    Notiz

    Die Fiori-Launchpad-Konfiguration kann nach dem Anlegen des Projekts über die Datei webapp/manifest.json im Projektverzeichnis bearbeitet werden.
    1. Wählen Sie im Menü von SAP Business Application Studio File→New Project from Template.

    2. Wählen Sie im angezeigten Assistenten Project From Template die SAP-Fiori-Anwendungskachel aus, und wählen Sie Start.

    3. Wählen Sie im Schritt Floorplan Selection die Option SAP Fiori Application als Application Type, wählen Sie die Kachel List Report Page, und wählen Sie Next.

    4. Geben Sie im Schritt Data Source and Service Selection die Werte aus der entsprechenden Tabelle oben ein, und wählen Sie Next.

    5. Geben Sie im Schritt Entitätsauswahl den Wert aus der entsprechenden Tabelle oben ein, und wählen Sie Weiter.

    6. Geben Sie im Schritt Projektattribute die Werte aus der entsprechenden Tabelle oben ein, und wählen Sie Weiter.

    7. Geben Sie im Schritt Deployment-Konfiguration die Werte aus der entsprechenden Tabelle oben ein, und wählen Sie Weiter.

    8. Geben Sie im Schritt Fiori-Launchpad-Konfiguration die Werte aus der entsprechenden Tabelle oben ein, und wählen Sie Fertigstellen.

      Ergebnis

      Ihr SAP-Fiori-Elements-Projekt wird generiert und für die zukünftige Verwendung gesichert.
  3. Öffnen Sie das Projekt s4d425_Complaint_##, das Sie gerade in einem Arbeitsbereich angelegt haben.

    1. Wählen Sie Datei→Arbeitsbereich öffnen...aus dem Menü von SAP Business Application Studio.

    2. Wählen Sie im daraufhin angezeigten Dialogfenster Arbeitsbereich öffnen den Ordner s4d425_Complaint_## aus, und wählen Sie Öffnen.

      Ergebnis

      Das Projekt s4d425_Complaint_## wird in SAP Business Application Studio geöffnet.
  4. In der nächsten Übung deployen Sie die SAP-Fiori-Elements-Anwendung, die Sie gerade angelegt haben, in der SAP-BTP-ABAP-Umgebung. Testen Sie zuvor die Anwendung in diesem letzten Schritt in SAP Business Application Studio.

    1. Klicken Sie mit der rechten Maustaste auf den Ordner webapp in Ihrem Projekt s4d425_Complaint_##, und wählen Sie im angezeigten Kontextmenü Preview Application.

    2. Wählen Sie in der Palette Vorschauoptionen im angezeigten Dialogfenster Start (Fiori-Lauf …).

      Ergebnis

      Die Anwendung wird nun auf einer neuen Registerkarte angezeigt. Die Benutzungsoberfläche sollte der Benutzungsoberfläche ähneln, die über die Vorschau der SAP-Fiori-Elements-App in ADT angezeigt wird.
    3. Wählen Sie auf der angezeigtenSeite Listenreport die Option Start, um die vorhandenen Datensätze anzuzeigen.

    4. Wählen Sie einen Datensatz aus der Tabelle aus, um die zugehörige Object Page anzuzeigen.

Deployment der SAP-Fiori-Elements-Anwendung in der SAP-BTP-ABAP-Umgebung durchführen

Die Schritte und Daten dieser Demonstration finden Sie in der Übung SAP-Fiori-Elements-Anwendung in der SAP-BTP-ABAP-Umgebung deployen.

SAP-Fiori-Elements-Anwendung in der SAP-BTP-ABAP-Umgebung deployen (optional)

In dieser Übung deployen Sie die in SAP Business Application Studio angelegte SAP-Fiori-Elements-Anwendung in der SAP-BTP-ABAP-Umgebung. Anschließend prüfen Sie in ADT die Entwicklungsobjekte, die durch das Deployment in die SAP-BTP-ABAP-Umgebung angelegt wurden.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Schritte

  1. Deployen Sie Ihr Projekt s4d425_Complaint_## aus SAP Business Application Studio in die SAP-BTP-ABAP-Umgebung. Verwenden Sie dazu den Befehl npm run deploy im Terminal.

    1. Wählen Sie im Menü von SAP Business Application Studio Terminal→New Terminal.

    2. Geben Sie an der Eingabeaufforderung im Terminal den Befehl npm run deploy ein, und drücken Sie die Eingabetaste:

      Code Snippet
      1
      user: s4d425_complaint_## $

      Notiz

      Stellen Sie sicher, dass das Terminal im Projektverzeichnis geöffnet ist. Dem Zeichen $ muss der Benutzer s4d425_Complaint_## vorangehen.
    3. Wenn Sie dazu aufgefordert werden, bestätigen Sie die angezeigte Deployment-Konfiguration, und drücken Sie dann y.

      Ergebnis

      Das Deployment in die SAP-BTP-ABAP-Umgebung wird nun ausgeführt. Am Ende des Deployment-Prozesses sollte die Meldung Deployment erfolgreich im Terminal angezeigt werden.
  2. Über das Deployment wurden mehrere Entwicklungsobjekte in der SAP-BTP-ABAP-Umgebung angelegt. Für die nächste Übung sind die beiden folgenden Objekte besonders wichtig: Die eigentliche SAPUI5-Applikation wurde als BSP-Applikation mit dem Namen Z_COMPLAINT_## abgelegt. Die Konfiguration für die Integration der Anwendung in das SAP Fiori Launchpad wurde hingegen in einem sogenannten Fiori-Launchpad-App-Deskriptor-Element mit dem Namen Z_COMPLAINT_##_UI5R gesichert.

    Prüfen Sie, ob diese beiden Entwicklungsobjekte in ADT unter Ihrem Paket angezeigt werden. Aktualisieren Sie dazu zunächst die Anzeige Ihres Pakets in ADT.

    Notiz

    Weder die BSP-Applikation noch das SAP-Fiori-Launchpad-App-Deskriptor-Element können in ADT geöffnet werden.
    1. Klicken Sie mit der rechten Maustaste in ADT auf Ihr Paket ZS4D425_##_CLD, und wählen Sie im angezeigten Kontextmenü Refresh. Alternativ können Sie auch die Funktionstaste F5 verwenden.

    2. Die BSP-Applikation Z_COMPLAINT_## sollte nun unter dem folgenden Knoten in Ihrem Paket angezeigt werden: ZS4D425_##_CLD→BSP-Bibliothek→BSP-Anwendungen.

    3. Das SAP-Fiori-Launchpad-App-Deskriptor-Element Z_COMPLAINT_##_UI5R sollte unter dem folgenden Knoten in Ihrem Paket angezeigt werden: ZS4D425_##_CLD→Fiori Launchpad App Descr Items.

Integration der SAP-Fiori-Elements-Anwendung in das SAP Fiori Launchpad der SAP-BTP-ABAP-Umgebung

Die Schritte und Daten dieser Demo finden Sie in der Übung SAP-Fiori-Elements-Anwendung in das SAP Fiori Launchpad der SAP-BTP-ABAP-Umgebung integrieren.

SAP-Fiori-Elements-Anwendung in das SAP Fiori Launchpad der SAP-BTP-ABAP-Umgebung integrieren (optional)

In dieser Übung integrieren Sie die SAP-Fiori-Elements-Anwendung, die Sie in der letzten Übung in der SAP-BTP-ABAP-Umgebung deployt haben, in das SAP Fiori Launchpad. Dazu legen Sie zunächst eine IAM-App in ADT an. Um die IAM-App zu konfigurieren, geben Sie das SAP-Fiori-Launchpad-App-Deskriptor-Element für Ihre Anwendung in den Eigenschaften der IAM-App ein. Anschließend legen Sie einen IAM-Anwendungskatalog in ADT an, dem Sie die IAM-App über eine sogenannte IAM-App zur Katalogzuordnung hinzufügen. Nachdem Sie die IAM-App und den IAM-Anwendungskatalog lokal veröffentlicht haben, legen Sie schließlich über das SAP Fiori Launchpad (des ABAP-Cloud-Service) eine Anwendungsrolle an und ordnen ihr sowohl den IAM-Anwendungskatalog als auch Ihren Benutzer zu.

Notiz

In dieser Übung ersetzen Sie ## in den Werten durch Ihre Gruppennummer.

Schritte

  1. Legen Sie in ADT eine IAM-App mit dem Namen ZD425_COMPLAINT_IAM_## und der Beschreibung Reklamation IAM-App an.

    Notiz

    Die Entwicklungsumgebung hängt automatisch das Suffix _EXT an den Namen der IAM-App an.

    Ordnen Sie Ihr vorhandenes SAP-Fiori-Launchpad-App-Deskriptor-Element Z_COMPLAINT_##_UI5R der IAM-App zu.

    Vergessen Sie nicht, Ihre Änderungen zu sichern.

    1. Klicken Sie in ADT mit der rechten Maustaste auf Ihr Paket ZS4D425_##_CLD, und wählen Sie New→Other ABAP Repository Object.

    2. Suchen Sie im daraufhin angezeigten Dialogfenster nach IAM-App, wählen Sie sie aus, und klicken Sie auf Weiter.

    3. Geben Sie ZD425_COMPLAINT_IAM_## als Name und Complaint IAM App als Beschreibung ein. Stellen Sie sicher, dass EXT - Externe App als Anwendungstyp ausgewählt ist, und wählen Sie Weiter.

    4. Stellen Sie im Schritt Auswahl des Transportauftrags sicher, dass die Option Aus Aufträgen wählen, an denen ich beteiligt bin ausgewählt ist. Wählen Sie den Transportauftrag aus, den Sie in einer vorherigen Übung angelegt haben, und wählen Sie Fertigstellen.

      Ergebnis

      Die IAM-App wird generiert und im Editor angezeigt.
    5. Geben Sie im Feld Fiori Launchpad App Descr Item ID den Wert Z_COMPLAINT_##_UI5R ein.

      Notiz

      Hierfür steht Ihnen im Feld eine Wertehilfe zur Verfügung, die über Strg+Leertaste aufgerufen werden kann.
    6. Sichern Sie abschließend die IAM-App.

  2. Veröffentlichen Sie Ihre IAM-App ZD425_COMPLAINT_IAM_##_EXT lokal.

    1. Stellen Sie sicher, dass Ihre IAM-App ZD425_COMPLAINT_IAM_##_EXT im Editor angezeigt wird.

    2. Wählen Sie in der oberen rechten Ecke des Editors Lokal veröffentlichen.

  3. Legen Sie nun einen IAM-Anwendungskatalog mit dem Namen ZD425_COMPLAINT_BC_## und der Beschreibung Reklamation IAM-Anwendungskatalog ## an. Fügen Sie Ihrem Katalog Ihre IAM-App ZD425_COMPLAINT_IAM_##_EXT hinzu.

    Notiz

    Verwenden Sie für diesen Schritt den Link Neuen Anwendungskatalog anlegen, und ordnen Sie ihm die App zu, die im Editor für Ihre IAM-App ZD425_COMPLAINT_IAM_##_EXT angezeigt wird.
    1. Stellen Sie sicher, dass Ihre IAM-App ZD425_COMPLAINT_IAM_##_EXT im Editor angezeigt wird.

    2. Klicken Sie auf den Link Neuen Anwendungskatalog anlegen, und ordnen Sie ihm die App zu.

    3. Geben Sie im daraufhin geöffneten Dialogfenster Anwendungskatalog den NamenZD425_COMPLAINT_BC_## und die BeschreibungReklamation IAM-Anwendungskatalog ## ein, und wählen Sie Weiter.

    4. Stellen Sie im Schritt Auswahl des Transportauftrags sicher, dass die Option Aus Aufträgen wählen, an denen ich beteiligt bin ausgewählt ist. Wählen Sie den Transportauftrag aus, den Sie in einer vorherigen Übung angelegt haben, und wählen Sie Fertigstellen.

      Ergebnis

      Das Dialogfenster Anwendungskatalog-App-Zuordnung wird geöffnet.
    5. Stellen Sie sicher, dass im Dialogfenster ZD425_COMPLAINT_BC_##_0001 als Name und die Zuordnung des Anwendungskatalogs zur IAM-App als Beschreibung angezeigt werden. Wählen Sie anschließend Weiter.

    6. Stellen Sie im Schritt Auswahl des Transportauftrags sicher, dass die Option Aus Aufträgen wählen, an denen ich beteiligt bin ausgewählt ist. Wählen Sie den Transportauftrag aus, den Sie in einer vorherigen Übung angelegt haben, und wählen Sie Fertigstellen.

  4. Veröffentlichen Sie Ihren IAM-Anwendungskatalog ZD425_COMPLAINT_BC_## lokal.

    1. Stellen Sie sicher, dass Ihr IAM-Anwendungskatalog ZD425_COMPLAINT_BC_## im Editor angezeigt wird.

    2. Wählen Sie in der oberen rechten Ecke des Editors Lokal veröffentlichen.

  5. Öffnen Sie nun die Anwendung Anwendungsrollen pflegen über das SAP Fiori Launchpad der SAP-BTP-ABAP-Umgebung. Legen Sie eine neue Benutzerrolle mit der Benutzerrollen-ID ZD425_BR_## und der Benutzerrollenbeschreibung S4D425 Teilnehmer ## an.

    Fügen Sie Ihren IAM-Anwendungskatalog ZD425_COMPLAINT_BC_## und Ihren Anwendungsbenutzer zur neu angelegten Benutzerrolle hinzu.

    Notiz

    Weitere Informationen zu dem Ihnen zugeordneten Anwendungsbenutzer erhalten Sie von Ihrem Referenten.
    1. Klicken Sie im Project Explorer mit der rechten Maustaste auf Ihr ABAP-Cloud-Projekt, und wählen Sie Properties im Kontextmenü, das angezeigt wird.

    2. Wählen Sie im Dialogfenster, das sich öffnet, auf der linken Seite ABAP-Entwicklung aus, und klicken Sie dann auf die System-URL, die auf der rechten Seite angezeigt wird.

    3. Wenn Sie nicht automatisch angemeldet sind, klicken Sie auf der im Browser angezeigten Seite auf den Link <xxxxxxxxx>.accounts.ondemand.com, um die Anmeldung durchzuführen. Wenn Sie dazu aufgefordert werden, geben Sie Ihre E-Mail-Adresse gefolgt vom Kennwort in die entsprechenden Eingabefelder im Browser ein. Sie erhalten die erforderliche E-Mail-Adresse und das Kennwort von Ihrem Referenten. Wählen Sie abschließend Anmelden, um sich am ABAP-System anzumelden.

    4. Wählen Sie nun die Kachel Anwendungsrollen pflegen auf der Seite Identitäts- und Zugriffsverwaltung (im Bereich Administration).

    5. Wählen Sie in der daraufhin angezeigten Anwendung Anwendungsrollen pflegen in der Fußzeile die Option Neu.

    6. Geben Sie im Dialogfenster Neue BenutzerrolleZD425_BR_## als Anwendungsrollen-ID und S4D425 Teilnehmer ## alsBenutzerrollenbeschreibung ein. Wählen Sie anschließend Create.

    7. Wählen Sie auf der daraufhin angezeigten Seite die Registerkarte Zugeordnete Anwendungskataloge.

    8. Wählen Sie Hinzufügen auf der Registerkarte Zugeordnete Anwendungskataloge.

    9. Suchen Sie im Dialogfenster Anwendungskataloge hinzufügen nach Ihrem Anwendungskatalog ZD425_COMPLAINT_BC_## (Reklamation IAM-Anwendungskatalog ##), wählen Sie ihn aus, und wählen Sie OK.

    10. Wechseln Sie nun zur Registerkarte Zugeordnete Anwendungsbenutzer.

    11. Wählen Sie Hinzufügen auf der Registerkarte Zugeordnete Anwendungsbenutzer.

    12. Suchen Sie im Dialogfenster Anwendungsbenutzer hinzufügen nach Ihrem Anwendungsbenutzer, wählen Sie ihn aus, und wählen Sie OK.

    13. Legen Sie auf der Registerkarte Allgemeine Rollendetails für die Felder für die Zugriffskategorien→Schreiben, Lesen, Wertehilfe den Wert Uneingeschränkt fest. Setzen Sie für das Feld Lesen, Wertehilfe auch den Wert Uneingeschränkt.

    14. Sichern Sie abschließend Ihre Benutzerrolle über die Drucktaste Sichern. Bestätigen Sie das eventuell angezeigte Dialogfenster, indem Sie OK wählen.

  6. Fügen Sie abschließend die Anwendung SAP Fiori Elements zur Seite Kommunikationsverwaltung des Bereichs Verwaltung des SAP Fiori Launchpads hinzu, und testen Sie die Anwendung über das Launchpad.

    Notiz

    Um sicherzustellen, dass die Benutzerrollenkonfiguration, die Sie gerade vorgenommen haben, im System aktiv ist, muss das SAP Fiori Launchpad möglicherweise zuerst im Browser aktualisiert werden.
    1. Öffnen Sie das Benutzeraktionsmenü über die Drucktaste in der oberen rechten Ecke des SAP Fiori Launchpad, und wählen Sie den Eintrag Aktuelle Seite bearbeiten aus.

    2. Wählen Sie für die Gruppe Kommunikationsverwaltung die Funktion Abschnitt hinzufügen.

    3. Spielen Sie in den neuen Abschnitt S4D425 Functions als Titel ein. Verschieben Sie den Abschnitt ganz nach oben.

    4. Wählen Sie in Ihrem neuen Abschnitt Kachel hinzufügen.

    5. Wählen Sie auf der linken Seite im App Finder Ihren Anwendungskatalog Reklamation IAM Anwendungskatalog ## aus.

      Ergebnis

      Auf der rechten Seite des Bildes sehen Sie nun die Kachel Reklamationen verwalten - Teilnehmer ##.
    6. Klicken Sie auf die Stecknadel in der unteren rechten Ecke der Kachel.

    7. Wählen Sie nun Startseite (das SAP-Symbol) aus dem Navigationsmenü, um zur Seite Aktuelle Seite bearbeiten zurückzukehren.

    8. Wählen Sie Zurück, um zur Startseite zurückzukehren.

    9. Wählen Sie die Kachel Reklamationen verwalten - Teilnehmer ##, um die Anwendung zu starten.

    10. Wählen Sie auf der daraufhin angezeigten Seite List Reportdie Option Start, um die verfügbaren Datensätze anzuzeigen.

    11. Wählen Sie einen Datensatz aus der Tabelle aus, um die entsprechende Object Page aufzurufen.