Dynamische Calculation Views anlegen

Implementierung von Eingabeparametern

Objective

After completing this lesson, you will be able to definieren Sie Eingabeparameter, um dynamische Werte an eine Calculation View zu übergeben.

Eingabeparameter

Ein Eingabeparameter ähnelt einer Variablen insofern, als er die Übergabe dynamischer Werte an eine Calculation View zur Laufzeit unterstützt. Während eine Variable jedoch nur einen Zweck hat, d.h. einen dynamischen Filter basierend auf Attributen bereitzustellen, kann ein Eingabeparameter zusätzliche Anforderungen erfüllen.

Eingabeparameter können an verschiedenen Stellen verwendet werden, um dynamische Werte bereitzustellen, insbesondere berechnete Spalten, eingeschränkte Spalten und Filterausdrücke. Im Folgenden finden Sie einige Beispiele:

  • Berechnete Spalte

    Sie möchten eine Ad-hoc-Berechnung des prognostizierten Umsatzes für das nächste Jahr ausführen, basierend auf dem aktuellen Jahr und einer gesamten erwarteten Umsatzsteigerung, z.B. 11 %, die vom Benutzer zur Laufzeit eingegeben wurde.

  • Eingeschränkte Spalte

    Sie möchten, dass eine Calculation View den Umsatz für ein vom Benutzer zur Laufzeit ausgewähltes Jahr zurückgibt, z.B. 2019 und das Vorjahr, indem zwei eingeschränkte Spalten verwendet werden.

  • Filter

    Sie möchten das Datenset für Kundenaufträge filtern, deren Gesamtbetrag 10.000 USD übersteigt. Der Schwellenwert wird zur Laufzeit eingegeben.

    Sie möchten Verkaufsdaten nach Produkten filtern, deren Name den String 'GTR' enthält. Der String wird zur Laufzeit vom Benutzer ausgewählt.

    Sie möchten gezielt steuern, wo ein Filterausdruck, der auf einer Benutzereingabe basiert, im Berechnungsszenario angewendet wird. Mit Variablen können Sie in der Calculation View nicht genau auswählen, auf welchen Knoten der Filter angewendet wird. Variablen wenden Filter immer oben an.

Eingabeparameter können auch verwendet werden, wenn Sie skalare oder Tabellenfunktionen in Ihrer Calculation View haben. Die Parameter dieser Funktionen können mit Werten versorgt werden, die Sie zur Laufzeit beim Abfragen Ihrer Calculation View eingeben. Dazu müssen Sie die Parameter zuordnen, die später in dieser Lektion behandelt werden.

Notiz

Das Filtern von Daten nach Attributen kann mithilfe von Variablen oder Eingabeparametern erreicht werden. In diesem Fall ist es einfacher, Variablen zu verwenden, da Sie den Filterausdruck nicht schreiben müssen. Darüber hinaus unterstützen einige Frontend-Clients möglicherweise keine Eingabeparameter, aber die meisten unterstützen Variablen.

Eingabeparametertypen

Folgende Arten von Eingabeparametern werden unterstützt:

TypAnwendungsfälle
Direkt: WährungFür die Währungsumrechnung, wenn der Endbenutzer eine Quell- oder Zielwährung angeben soll.
Direkt: DatumZum Abrufen von Daten basierend auf einem Datum, das vom Endbenutzer eingegeben (oder in einem Eingabefeld für den Kalendertyp ausgewählt) wurde.
Direkt: MengeneinheitZum Abrufen von Daten basierend auf einer vom Endbenutzer ausgewählten Mengeneinheit
Statische ListeUm dem Endbenutzer eine vordefinierte Werteliste zur Verfügung zu stellen, in der er ein oder mehrere Elemente auswählt.
SpalteDem Endbenutzer eine Werteliste aus einer Spalte der Calculation View bereitstellen
Abgeleitet aus TabelleWenn Sie möchten, dass der Endbenutzer eine festgelegte Werteliste aus einer Tabelle hat (nicht unbedingt in der Sicht enthalten)
Abgeleitet von VerfahrenWenn der Parameterwert basierend auf der skalaren Ausgabe einer gespeicherten Prozedur an die Calculation View übergeben werden soll
Direkt (ohne semantischen Typ)Wenn keiner der oben genannten Punkte zutrifft und/oder wenn Sie möchten, dass der Benutzer einen Parameter eingibt, ohne ihn aus einer vordefinierten Liste auszuwählen.

Der Parametertyp Direkt kann mit einem semantischen Typ wie Datum, Währung oder Mengeneinheit kombiniert werden. Das bedeutet, dass die Wertehilfe auf diesen Werttypen basiert. Wenn Sie beispielsweise Datum angeben, wird ein Popup-Kalender für die Benutzeraufforderung angezeigt. Wenn Sie Währung angeben, wird in der Wertehilfe eine Liste der gültigen Währungen angezeigt. Dadurch können wir eine flexible Eingabe für den Benutzer bereitstellen, aber auch die Art der zulässigen Werte steuern.

Semantiktypen für Währung und Mengeneinheit

Für die semantischen Typen Währung und Mengeneinheit wird die Liste der vorgeschlagenen Werte basierend auf den entsprechenden Referenztabellen in SAP HANA angelegt. Diese Einrichtung setzt voraus, dass das Standardschema, das der View zugeordnet ist, die Referenztabellen enthält.

Eingabeparameter unterstützen mehrere Werte. Das bedeutet, dass der Endbenutzer zur Laufzeit die Möglichkeit hat, mehrere Werte für den Parameter bereitzustellen. Im Folgenden finden Sie einige Beispiele für Anwendungsfälle:

  • Anwenden von Filtern der Typen Werteliste und Nicht in Liste

  • Ausdruck von berechneten Spalten und Ausdruck von Filtern in Projektionsknoten, sofern der Ausdruck eine mehrwertige Eingabe erfordert

Wenn Sie einen Eingabeparameter vom Typ Abgeleitet von Prozedur/Skalarfunktion definieren, ist es möglich, Parameter der Eingabe der Skalarfunktion oder Prozedur zuzuordnen.

Notiz

Eingabeparameter der Typen Aus Tabelle abgeleitet und Aus Prozedur/Skalarfunktion abgeleitet generieren keine Eingabeaufforderung für den Endbenutzer (sie übergeben die Parameterwerte direkt), es sei denn, Sie wählen die Option Eingabe aktiviert aus. In diesem Fall können die von der Tabelle, Prozedur oder Skalarfunktion zurückgegebenen Werte vom Endbenutzer geändert werden.

Bei der Ausführung der Calculation View werden Eingabeparameter innerhalb der SQL-Abfrage mit einer PLACEHOLDER-Klausel übergeben, z.B.:

SELECT <columns> FROM <calculation_view_name> (Platzhalter."$$IP_YEAR$$"=>'2019') GROUP BY <group_by-Spalten>;

Nicht alle Anwendungen können Werte an PLACEHOLDER übergeben. Aus diesem Grund müssen Sie manchmal Variablen verwenden, um dasselbe Ergebnis zu erzielen.

Notiz

Wenn Sie einen Eingabeparameter definiert haben, müssen Sie ihn dann in einem Ausdruck verwenden. Andernfalls wird sie ignoriert.

Eingabeparameter anlegen

Wie bereits erwähnt, kann im Gegensatz zu einer Variablen ein Eingabeparameter in einem bedingten Ausdruck verwendet werden. Beispielsweise können wir einen Eingabeparameter verwenden, um festzulegen, welche Kennzahl in einer bestimmten Spalte angezeigt werden soll.

Um dies zu veranschaulichen, legen wir eine berechnete Spalte namens AMOUNT an, die entweder mit dem Bruttobetrag oder dem Nettobetrag gefüllt werden kann, abhängig vom Wert, den der Benutzer beim Abfragen der View wählt.

In unserem Beispiel haben wir uns entschieden, einen Eingabeparameter vom Typ Statische Liste zu verwenden. Das bedeutet, dass wir den zulässigen Wert vordefinieren, der vom Benutzer in einer Liste ausgewählt werden kann. Dies ist für kurze Listen in Ordnung, aber wenn die Liste groß wird, wird es umständlich, sie zu verwalten, da Sie die Calculation View bearbeiten und jedes Mal neu aufbauen müssten. Natürlich können Sie den Typ Direkt wählen, was bedeutet, dass der Benutzer alles eingeben kann. Dies würde jedoch bedeuten, dass der Benutzer, abgesehen von der fehlenden Hilfestellung, auch den Wert falsch eingeben oder den Wert im falschen Format eingeben kann (möglicherweise, wenn führende Nullen hinzugefügt werden, wenn sie nicht erforderlich waren).

Eine gute Lösung wäre, den Eingabeparameter mit dem Typ Spalte zu definieren und dann in der Wertehilfe für View/Tabelle den Namen einer Tabelle oder View einzugeben, in der die zulässigen Einträge angezeigt werden. Dies bedeutet auch, dass diese Liste von mehreren Eingabeparametern verwendet werden kann und fördert die zentrale Pflege der konsistenten Liste zulässiger Werte.

Eingabeparameter

Ein Beispiel für einen Eingabeparameter mit einer statischen Liste.

Wenn der Endbenutzer entscheiden soll, ob der Brutto- oder Nettobetrag in einer Sicht angezeigt werden soll, besteht der erste Schritt darin, einen Eingabeparameter anzulegen, der in einer Berechnung verwendet wird.

Der Eingabeparameter kann einen beliebigen geeigneten Typ haben, z.B. Statische Liste.

In diesem Beispiel kann der Benutzer entweder "Bruttobetrag" oder "Nettobetrag" wählen.

Der Standardwert GROSS wird dem Eingabeparameter zugeordnet, wenn der Benutzer nichts angibt.

Ein in einer Formel verwendeter Eingabeparameter muss nicht unbedingt vom Typ Statische Liste sein. Es kann sich beispielsweise auch um einen direkten numerischen Wert handeln, der in der Multiplikation verwendet wird, oder eine beliebige andere Berechnungsart.

Eingabeparameter in einer Berechnung aufrufen

Berechnete Spalte mit einem Eingabeparameter in seinem Ausdruck.

Der nächste Schritt besteht darin, den Eingabeparameter in einer berechneten Spalte zu verwenden.

Dies geschieht durch den Aufruf in einfachen Anführungszeichen und doppelten Dollarzeichen.

In diesem Beispiel wird der Eingabeparameter in der Bedingung eines IF-Ausdrucks verwendet: if('$$GROSS_OR_NET$$'='Gross',"GROSS_AMOUNT","NET_AMOUNT")

Wenn der Benutzer GROSS auswählt, zeigt die berechnete Spalte (vom Typ Measure) die Kennzahl GROSS_AMOUNT in der Spalte AMOUNT an. Jede andere Auswahl führt zur Anzeige von NET_AMOUNT.

Eingabeparameter mit Datumsangaben

Bildschirmaufnahme eines Eingabeparameters, dessen Datentyp auf DATE gesetzt ist.

Ein Eingabeparametertyp vom Typ "Direkt" mit dem semantischen Typ "Datum" kann nützlich sein, wenn Sie Berechnungen basierend auf einem vom Reporting-Benutzer angegebenen Datum anlegen möchten.

Sie können einen Datumsbereich anlegen, indem Sie ein Paar von Eingabeparametern anlegen (z.B. "Datum von" und "Datum bis").

Beachten Sie, dass der Datentyp auf "DATE" gesetzt sein muss.

Verwenden eines Kalenderdialogs für Datumseingabeparameter

Bildschirmaufnahme des Öffnens der Wertehilfe für einen Eingabeparameter. Wenn es vom Typ Datum ist, kann der Endbenutzer das entsprechende Datum aus einem Kalender auswählen, nachdem er die Wertehilfe im Vorschaudialog gestartet hat.

Wenn Sie den Typ "Datum" verwenden, erleichtern Sie es dem Endbenutzer, ein Datum auszuwählen, indem Sie einen Kalenderdialog zur Auswahl des entsprechenden Datums verwenden.

In der Abbildung wird der Benutzer nach einem Einzelwert gefragt. Termine können auch als Bereiche ausgewählt werden.

Notiz

SAP empfiehlt, nach Möglichkeit Eingabeparameter anstelle von Variablen zu verwenden, da Eingabeparameter mehr Flexibilität und Funktionen bieten als Variablen. Einige Frontend-Werkzeuge können jedoch keine Eingabeparameter verarbeiten. Daher müssen Variablen verwendet werden.

Eingabeparameter zur Übergabe dynamischer Werte definieren