ABAP-CDS-Annotationen im Backend konfigurieren

Listenreport anlegen

Objective

After completing this lesson, you will be able to legen Sie eine Metadatenerweiterung an, und fügen Sie UI-Annotationen für den List Report hinzu.

ABAP-CDS-Metadatenerweiterung für eine Projektions-View anlegen

In dieser Übung fügen Sie eine ABAP-CDS-Metadatenerweiterung für die Projektions-View der Entität „Travel" hinzu. Sie können alle UI-relevanten Annotationen darin einfügen.

Voraussetzungen

Sie haben die Übung OData-V4-Service veröffentlichen im Kapitel Einen Überblick über das ABAP-RESTful-Anwendungsprogrammiermodell erhalten (Lektion: OData-V4-Service anlegen) abgeschlossen.

Simulation ansehen und Schritte ausführen

Diese Übung enthält eine Simulation, die Sie durch detaillierte Schritte führt. Sie finden alle Schritte nach der Simulation. Sie können der Simulation folgen und die Schritte mit Ihrem eigenen Testkonto durchführen.

Schritte

  1. Sie haben das OData-Servicepaket, das Sie zuvor generiert haben, in ADT geöffnet.

  2. Klappen Sie Core Data Services in ZFE_TRAVEL_###### auf, wobei ZFE_TRAVEL_###### die eindeutige ID Ihres Pakets ist.

  3. Wählen Sie Datendefinitionen aus, und expandieren Sie sie. Sie sehen die drei Projektions-Views, für die Sie UI-Annotationen anlegen können.

  4. Doppelklicken Sie unter Datendefinitionen auf ZC_FE_TRAVEL_######. Die Projektions-View für die Entität Travel wird geöffnet.

  5. Legen Sie eine Metadatenerweiterung für die Entität Concur Travel an.

    1. Wählen Sie ZC_FE_TRAVEL_######, und klicken Sie mit der rechten Maustaste darauf.

    2. Wählen Sie Neue Metadatenerweiterung. Das Dialogfenster Neue Metadatenerweiterung wird geöffnet.

    3. Stellen Sie sicher, dass der Name der Metadatenerweiterung als ZC_FE_TRAVEL_###### eingegeben ist.

    4. Geben Sie die Beschreibung als UI-Annotationen für die Entität Travel ein.

    5. Wählen Sie Next. Das Bild Transportauftrag auswählen wird geöffnet.

    6. Wählen Sie erneut Weiter. Die Vorlagen werden angezeigt.

    7. Wählen Sie Fertigstellen. Sie sehen, dass eine Metadatenerweiterung generiert wurde. Die Annotation ZC_FE_TRAVEL_###### ist Ihre Projektions-View. Sie können dieser Datei alle UI-relevanten Annotationen für die Entität Travel hinzufügen.

  6. Drücken Sie STRG + LEERTASTE. Wählen Sie aus der nachfolgenden Dropdown-Liste #CORE(annotation)aus. Sie haben #CORE als Wert für die @Metadata.layerausgewählt.

  7. Expandieren Sie Metadata Extensions. Sie können die neu angelegte Metadatenerweiterung ZC_FE_TRAVEL_###### im Ordner Metadatenerweiterung sehen.

Ergebnis

Sie haben erfolgreich eine ABAP-CDS-Metadatenerweiterung für ZC_FE_TRAVEL_###### ABAP-CDS-Projektions-View angelegt. In den nächsten Übungen fügen Sie dieser Datei alle UI-relevanten Annotationen für die Entität Travel hinzu.

Spalten zur List-Report-Tabelle hinzufügen

In dieser Übung erfahren Sie, wie Sie spalten zur Tabelle hinzufügen, die Reisen anzeigt. Dazu müssen Sie die entsprechenden Felder mit der Annotation ABAP CDS @UI.lineItem versehen.

Voraussetzungen

Sie haben die Übung eine ABAP-CDS-Metadatenerweiterung für eine Projektions-View anlegen in dieser Lektion abgeschlossen.

Simulation ansehen und Schritte ausführen

Diese Übung enthält eine Simulation, die Sie durch detaillierte Schritte führt. Sie finden alle Schritte nach der Simulation. Sie können der Simulation folgen und die Schritte mit Ihrem eigenen Testkonto durchführen.

Schritte

  1. Öffnen Sie die App-Vorschau in Ihrem Browser. Die Tabelle zeigt keine Spalten an.

  2. Öffnen Sie die Projektions-View der Entität Travel in ADT.

    1. Sie haben das OData-Servicepaket, das Sie in einer vorherigen Übung generiert haben, in ADT geöffnet.

    2. Markieren und doppelklicken Sie auf ZC_FE_TRAVEL_######, das in den Datendefinitionen verfügbar ist. Die Projektions-View für die Entität Travel wird geöffnet.

    3. Kopieren Sie die folgenden Felder, die Sie zum Hinzufügen von Annotationen verwenden möchten:

      • TravelID
      • AgencyID
      • CustomerID
      • BeginDate
      • EndDate
      • BookingFee
      • TotalPrice
      • OverallStatus
      • LastChangedAt
  3. Fügen Sie alle ausgewählten Felder aus der Projektions-View in die Metadatenerweiterung ein.

    1. Doppelklicken Sie in den Metadatenerweiterungen auf ZC_FE_TRAVEL_######.

    2. Wie im folgenden Beispielquelltext gezeigt, fügen Sie alle Felder aus der Projektions-View der Entität Travel ein, für die Sie die Annotation @UI.lineItem hinzufügen möchten.

      Code Snippet
      1234567891011
      { TravelID; AgencyID; CustomerID; BeginDate; EndDate; BookingFee; TotalPrice; OverallStatus; LastChangedAt; }
  4. Fügen Sie die ABAP CDS @UI.lineItem eine Zeile über dem Feld hinzu.

    1. Beginnen Sie mit der Eingabe @UI.lineItem eine Zeile über dem Feld.

    2. Drücken Sie STRG + LEERTASTE auf Ihrer Tastatur, um Annotationsvorschläge anzuzeigen.

    3. Wählen Sie @lineItem: [{}] (annotation)und doppelklicken Sie darauf.

  5. Fügen Sie die Eigenschaft position der Annotation @UI.lineItem hinzu.

    1. Drücken Sie STRG + LEERTASTE auf Ihrer Tastatur.

    2. Wählen Sie @position: (annotation)und doppelklicken Sie darauf.

    3. Geben Sie als Bestandswert 10 ein. Das Feld TravelID wird als erste Spalte der Tabelle angezeigt.

    4. Führen Sie die folgenden Schritte für jedes Feld aus. Stellen Sie sicher, dass Sie den Positionswert für die restlichen Felder in fortlaufender Reihenfolge eingeben. In diesem Fall ist der Positionswert für das zweite Feld 20, für das dritte Feld 30 usw.

  6. Klicken Sie in der Menüleiste auf Aktivieren, um Ihre Änderungen zu sichern und zu aktivieren.

  7. Öffnen Sie die App-Vorschau in Ihrem Browser, um alle felder mit Anmerkungen anzuzeigen.

    1. Expandieren Sie im Project Explorer den Ordner Business Services.

    2. Klappen Sie die Option Service-Bindings aus den Business-Services heraus auf.

    3. Doppelklicken Sie auf ZUI_FE_TRAVEL_######_O4.

    4. Wählen Sie Travel aus Entitätsmenge und Assoziation der Registerkarte Service Version Details im geöffneten Service-Binding aus.

    5. Wählen Sie Vorschau. Die App-Vorschau zeigt alle Felder an, die mit @UI.lineItem als Tabellenspalten annotiert wurden.

  8. Wählen Sie Start. Die Tabellendaten werden angezeigt.

  9. Markieren Und klicken Sie auf den ersten Eintrag in der Tabelle. Die Objektseite des ausgewählten Tabelleneintrags wird angezeigt. Diese Objektseite ist leer, da die entsprechenden Annotationen noch nicht gepflegt wurden.

Ergebnis

Sie haben der Tabelle erfolgreich Spalten hinzugefügt, in denen alle felder mit Anmerkungen angezeigt werden. Außerdem haben Sie die Daten in der Tabelle erfolgreich angezeigt und zu einer Objektseite navigiert.

Filterfelder zum List Report hinzufügen

In dieser Übung fügen Sie die FelderTravelID, AgencyIDund CustomerID zur Filterleiste des Listen-Reports hinzu.

Voraussetzungen

Sie haben die Übung „Spalten zur List-Report-Tabelle hinzufügen" in dieser Lektion abgeschlossen.

Simulation ansehen und Schritte ausführen

Diese Übung enthält eine Simulation, die Sie durch detaillierte Schritte führt. Sie finden alle Schritte nach der Simulation. Sie können der Simulation folgen und die Schritte mit Ihrem eigenen Testkonto durchführen.

Schritte

  1. Sie haben die Metadatenerweiterung für die Projektions-View Travel in ADT geöffnet.

  2. Annotieren Sie TravelID mit @UI.selectionField.

    1. Beginnen Sie mit der Eingabe von @UI.selection vor dem Feld TravelID .

    2. Wählen Sie @selectionField: [{}] (annotation) aus der nachfolgenden Liste aus, und doppelklicken Sie darauf.

  3. Legen Sie TravelID das erste Filterfeld auf der Benutzungsoberfläche fest.

    1. Positionieren Sie den Cursor innerhalb der geschweiften Klammern für @UI. selectionField: [{}].

    2. Wählen Sie @position: (annotation) aus den Optionen aus, und doppelklicken Sie darauf.

    3. Geben Sie 10 als Positionseigenschaft der @UI.selectionField Annotation ein. Auf diese Weise wird TravelID zum ersten Filterfeld auf der Benutzungsoberfläche.

  4. Annotieren Sie die AgencyID und CustomerID mit @UI.selectionField auf die gleiche Weise wie für TravelIDbeschrieben. Stellen Sie sicher, dass Sie den Positionswert für die restlichen Felder in fortlaufender Reihenfolge eingeben. In diesem Fall ist der Positionswert für das zweite Feld 20, für das dritte Feld 30 usw.

  5. Klicken Sie in der Menüleiste auf Aktivieren, um Ihre Änderungen zu sichern und zu aktivieren.

  6. Öffnen Sie die App-Vorschau in Ihrem Browser, um alle mit Anmerkungen versehenen Filterfelder anzuzeigen.

    1. Doppelklicken Sie auf ZUI_FE_TRAVEL_######_O4.

    2. Wählen Sie Travel auf der Registerkarte Entitätsmenge und Assoziation der Serviceversionsdetails im geöffneten Service-Binding aus.

    3. Wählen Sie Vorschau. Die App-Vorschau zeigt nun die felder Reise-ID, Reisebüro-ID und Kunden-ID als Filterleistenfelder an. Das Feld Suchen und der Bearbeitungsstatus werden standardmäßig der Filterleiste hinzugefügt.

  7. Wählen Sie Start. Die Tabellendaten werden angezeigt.

  8. Filtern Sie die Tabellendaten aus dem Feld Agentur-ID.

    1. Wählen Sie die Wertehilfeoption für Agentur-ID.

    2. Wählen Sie die erste Position aus der generierten Liste auf der Registerkarte Suchen und auswählen aus.

    3. Wählen Sie OK aus.

    4. Wählen Sie start aus der Liste aus. Sie sehen, dass die Tabellendaten gemäß den Filterkriterien gefiltert werden, die Sie zuvor ausgewählt haben.

Ergebnis

Sie haben der Filterleiste des Listenberichts erfolgreich die Reise-ID, die Reisebüro-ID und die Kunden-ID hinzugefügt. Sie haben Daten basierend auf den von Ihnen ausgewählten Filterkriterien gefiltert.

Kritikalität zur Spalte Reisestatus hinzufügen

In dieser Übung fügen Sie die Kritikalitätsfarbe zu den Gesamtstatuswerten hinzu. In der Spalte Gesamtstatus wird der Gesamtstatus der Reise angezeigt, wobei O offen, A akzeptiert und X storniert ist. Basierend auf den Kritikalitätsfarben wird der Status "Akzeptiert" grün, der Status "Offen" - orange und der Status "Abgebrochen" - rot angezeigt. Sie fügen diesen Werten auch entsprechende Symbole hinzu.

Voraussetzungen

Sie haben die Übung „Ihrem List Report Filterfelder hinzufügen" in dieser Lektion abgeschlossen.

Simulation ansehen und Schritte ausführen

Diese Übung enthält eine Simulation, die Sie durch detaillierte Schritte führt. Sie finden alle Schritte nach der Simulation. Sie können der Simulation folgen und die Schritte mit Ihrem eigenen Testkonto durchführen.

Schritte

  1. Das Dokument Hervorheben von Einzelposten anhand der Kritikalität von SAP Fiori Elements wird geöffnet. Sie können die möglichen Werte für die Kritikalität sehen.

  2. Sie haben die Metadatenerweiterung für die Projektions-View Travel in ADT geöffnet.

  3. Doppelklicken Sie in den Datendefinitionen auf ZI_FE_TRAVEL_######. Die ABAP-CDS-View für die Entität Travel wird geöffnet. Im generierten View steht das Feld OVERALL_STATUS zur Verfügung.

  4. Wie im folgenden Beispielcode gezeigt, fügen Sie ein virtuelles Element namens OverallStatusCriticality hinzu, das die zugeordneten Werte von OVERALL_STATUS enthält.

    Code Snippet
    123456
    case OVERALL_STATUS when 'O' then 2 when 'A' then 3 when 'X' then 1 else 0 end as OverallStatusCriticality,
  5. Klicken Sie in der Menüleiste auf Aktivieren, um Ihre Änderungen zu sichern und zu aktivieren.

  6. Fügen Sie das neu angelegte Feld zur Entwurfstabelle für die Entität Concur Travel hinzu.

    1. Expandieren Sie Behavior Definitions aus dem Project Explorer.

    2. Doppelklicken Sie auf ZI_FE_TRAVEL_######. Klicken Sie in der Menüleiste auf Aktivieren.

    3. Sie sehen ein Fehlersymbol für die Entwurfstabelle.

    4. Wählen Sie das Fehlersymbol. Die Fehlermeldung wird aufgeklappt.

    5. Doppelklicken Sie auf die Nachricht. Das Feld overallstatuscriticality wird der Entwurfstabelle der Entität Travel hinzugefügt.

  7. Wählen Sie in der Menüleiste erneut Aktivieren, um Ihre Änderungen zu sichern und zu aktivieren.

  8. Fügen Sie das neu angelegte Feld zur Projektions-View hinzu.

    1. Doppelklicken Sie im Project Explorer auf ZC_FE_TRAVEL_######.

    2. Blättern Sie nach unten zu OverallStatus , und fügen Sie das Feld OverallStatusCriticality zur Projektions-View hinzu.

    3. Klicken Sie in der Menüleiste auf Aktivieren, um Ihre Änderungen zu sichern und zu aktivieren.

  9. Fügen Sie die Kritikalitätseigenschaft als OverallStatusCriticality zur @UI.lineItem Annotation für das Feld OverallStatus hinzu.

    1. Doppelklicken Sie im OrdnerMetadata Extensions des Project Explorer auf ZC_FE_TRAVEL_######. Die Metadatenerweiterung wird für die Entität Concur Travel geöffnet.

    2. Fügen Sie die Eigenschaft criticality: 'OverallStatusCriticality' der Annotation @UI.lineItem zu OverallStatushinzu. Diese Eigenschaft soll direkt nach der Eigenschaft position hinzugefügt werden. Sie können sie wie im folgenden Beispielcode gezeigt annotieren:

      Code Snippet
      12
      @UI.lineItem: [{position: ##, criticality: 'OverallStatusCriticality'}] OverallStatus;
    3. Klicken Sie in der Menüleiste auf Aktivieren, um Ihre Änderungen zu sichern und zu aktivieren.

  10. Die Änderungen in ADT sind nun vollständig. Wechseln Sie in Ihrem Browser zur App-Vorschau.

  11. Wählen Sie Start. In der Spalte Gesamtstatus werden die Kritikalitätsfarbe und die Gesamtstatuswerte angezeigt.

Ergebnis

Sie haben die Kritikalitätsfarbe sowie die Kritikalitätssymbole für die Spalte Gesamtstatus der Entität Reise erfolgreich hinzugefügt. Sie haben die Änderungen in Ihrer App-Vorschau angezeigt.

Beschreibungstext anstelle von Codes für den Gesamtstatus hinzufügen

In dieser Übung ersetzen Sie die Codes in der Spalte „Gesamtstatus" des Listen-Reports durch aussagekräftige Texte.

Voraussetzungen

Sie haben die Übung „Kritikalität zur Spalte reise-Status hinzufügen" in dieser Lektion abgeschlossen.

Simulation ansehen und Schritte ausführen

Diese Übung enthält eine Simulation, die Sie durch detaillierte Schritte führt. Sie finden alle Schritte nach der Simulation. Sie können der Simulation folgen und die Schritte mit Ihrem eigenen Testkonto durchführen.

Schritte

  1. In ADT sind Datendefinitionen im Projekt-Explorer geöffnet.

  2. Prüfen Sie die Textanbietersicht.

    1. Doppelklicken Sie in den Datendefinitionen auf ZI_FE_TRAVEL_######.

    2. Sie sehen, dass die Assoziation zur Textanbieter-View für TravelStatus bereits definiert ist.

    3. Blättern Sie nach unten. Sie können sehen, dass die Assoziation _TravelStatus in der Reise-CDS-View exponiert wird.

  3. Fügen Sie das Textfeld aus der Textanbieter-View zur Projektions-View der Entität Travel hinzu.

    1. Stellen Sie sicher, dass die Textanbietersicht für den Reisestatus geöffnet ist, indem Sie auf ZI_FE_STAT_######. doppelklicken.

    2. Drücken Sie die Funktionstaste F8, um den Textwert der Sicht anzuzeigen.

    3. Doppelklicken Sie auf ZC_FE_TRAVEL_######. Die Projektions-View der Entität Travel wird geöffnet.

    4. Fügen Sie der Projektions-View ein neues Feld _TravelStatus.TravelStatusText as TravelStatusText hinzu, das einen Reisestatustext enthält.

  4. Kommentieren Sie OverallStatus in der Projektsicht mit @ObjectModel.text.element .

    1. Sie haben die Projektions-View der Entität Travel geöffnet.

    2. Fügen Sie die Annotation @ObjectModel.text.element: ['TravelStatusText'] zum Feld OverallStatus hinzu. Beachten Sie, dass die Annotation @ObjectModel von der CDS-Laufzeit benötigt wird und daher direkt in der Projektions-View und nicht in der Metadatenerweiterung hinzugefügt wird.

  5. Klicken Sie in der Menüleiste auf Aktivieren, um Ihre Änderungen zu sichern und zu aktivieren.

  6. Wechseln Sie in Ihrem Browser zur App-Vorschau. Sie können die Texte zusätzlich zu den Codes für die Spalte Gesamtstatus sehen. Sie müssen nun die Codes ausblenden, damit nur der erforderliche Text sichtbar ist.

  7. Fügen Sie die Annotation @UI.textArrangement hinzu, um nur einen Text ohne Den Quelltext anzuzeigen.

    1. Expandieren Sie metadata extensions from the Project Explorer in ADT.

    2. Doppelklicken Sie auf ZC_FE_TRAVEL_######. Die Metadatenerweiterung wird für die Projektions-View Travel geöffnet.

    3. Konzentrieren Sie sich auf den OverallStatus Einzelposten.

    4. Fügen Sie die Annotation @UI.textArrangement: #TEXT_ONLY dem OverallStatushinzu. Dieser Wert stellt sicher, dass nur Text auf der Benutzungsoberfläche sichtbar ist und der in Klammern angezeigte Code ausgeblendet bleibt.

  8. Wählen Sie in der Menüleiste erneut Aktivieren, um Ihre Änderungen zu sichern und zu aktivieren.

  9. Wechseln Sie in Ihrem Browser zur App-Vorschau. Sie sehen nun, dass die Codes ausgeblendet sind.

Ergebnis

Sie haben den Text erfolgreich zur Spalte „Gesamtstatus" für die Entität „Reise" hinzugefügt. Sie haben auch die Codes des Status ausgeblendet, die in Klammern angezeigt werden.