Hilfsmethoden

Erstellte Klassen für Hilfsmethoden

Die erstellte Klasse erweitert die Oberklasse /mobbuild/cl_request_base und erbt deren Methoden. Dabei werden die Methoden on_pbo und on_pai in der neuen Klasse redefiniert, um benutzerdefinierte Logik zu implementieren.

Redefinierte Methoden

on_pai

Process After Input ermöglicht die Integration benutzerdefinierter Logik nach der Benutzereingabe.

on_pbo

Process Before Output wird verwendet, um die benutzerdefinierte Logik vor der Anzeige der UI5-Applikation auszuführen.

Geerbte Methoden

Die von der Oberklasse /mobbuild/cl_request_base geerbten Methoden stehen als Hilfsmethoden zur Verfügung. Sie können genutzt werden, um auf die UI5-Applikation Einfluss zu nehmen und Standardoperationen zu vereinfachen.

Hilfsmethoden

CONSTRUCTOR

Erzeugt das Control. Grundsätzlich verwenden alle Komponentenklassen diese Signatur des Constructors, es sei denn, dieser ist erneut bei einer Klasse aufgeführt.

ÜbergabeparameterTypStandardwertBeschreibung
IS_DATATY_CONTROLZu setzende Daten für das Control

Control Factory

CREATE_MESSAGE_BOX

Diese Methode erzeugt eine neue MessageBox.

ÜbergabeparameterTypStandardwertBeschreibung
IV_TEXTStringAnzuzeigender Text für die MessageBox
IV_MSG_BOX_TYPEStringZu setzender Type für die MessageBox
RückgabeparameterTypBeschreibung
RO_MESSAGE_BOXMessageBoxSelbstreferenz

Beispiel:

MessageBox
    data(lv_text) = |This is my MessageBox|.
    data(lv_msg_box_type) = |alert|.

    data(lo_message_box) = me->create_message_box( iv_text = lv_text
                                                   iv_msg_box_type = lv_msg_box_type ).

    lo_message_box->add_action( iv_action = /mobbuild/cl_msg_box_action=>co_yes
                                iv_submit = abap_true ).

    lo_message_box->add_action( iv_action = /mobbuild/cl_msg_box_action=>co_no
                                iv_submit = abap_true ).

    lo_message_box->set_emphasized_action( iv_action = /mobbuild/cl_msg_box_action=>co_yes ).

    me->set_message_box( lo_message_box ).

CREATE_MESSAGE_TOAST

Diese Methode erzeugt ein MessageToast.

ÜbergabeparameterTypStandardwertBeschreibung
IV_TEXTStringAnzuzeigender Text im MessageToast
IV_DURATION?Integer1000Dauer, für die das MessageToast angezeigt werden soll. In Millisekunden
RückgabeparameterTypBeschreibung
RO_MESSAGE_TOASTMessageToastSelbstreferenz

Beispiel:

MessageToast
    data(lv_text) = |This is my MessageToast|.
    data(lo_message_toast) = me->create_message_toast( lv_text ).
    me->set_message_toast( lo_message_toast ).

GET_CLASS_NAME

Diese Methode gibt den Klassennamen eines übergebenen Control-Types zurück.

ÜbergabeparameterTypStandardwertBeschreibung
IV_CONTROL_TYPEStringControl-Type, zu dem der Klassenname bestimmt werden soll
RückgabeparameterTypBeschreibung
RV_CLASS_TYPEStringZu bestimmender Klassenname

GET_CONTROL

Diese Methode liest eine Control in einer Applikation anhand der übergebenen ID aus und gibt diese anschließend zurück.

ÜbergabeparameterTypStandardwertBeschreibung
IV_CONTROL_IDStringID des auszulesenden Controls
RückgabeparameterTypBeschreibung
RO_CONTROLControlAuszulesendes Control

GET_CONTROLS

Diese Methode gibt alle Controls aus einer Applikation zurück.

RückgabeparameterTypBeschreibung
RT_CONTROLSMT_CONTROLSAuszulesende Controls

GET_CONTROLS_BY_TYPE

Diese Methode liest alle Controls eines Types in einer Applikation aus und gibt diese zurück.

ÜbergabeparameterTypStandardwertBeschreibung
IV_CONTROL_TYPEStringType der auszulesenden Controls
RückgabeparameterTypBeschreibung
RT_CONTROLSMT_CONTROLSListe mit allen auszulesenden Controls

GET_CONTROL_BY_CONTROL_ID

Diese Methode liest eine Control in einer Applikation anhand der übergebenen ID aus und gibt diese anschließend zurück.

ÜbergabeparameterTypStandardwertBeschreibung
IV_CONTROL_IDStringID des auszulesenden Controls
RückgabeparameterTypBeschreibung
RO_CONTROLControlAuszulesendes Control

INIT_CONTROLS

Diese Methode initialisiert alle Controls, die zur App hinzugefügt wurden. Sie besitzt weder Über- noch Rückgabeparameter. Diese Methode sollte bei Klassen aufgerufen werden, die Kinder haben und bei einer PBO initialisiert werden müssen.

Request_Base

ADD_GLOBAL_DATA

Fügt globale Daten hinzu, die von jeder Klasse ausgelesen werden können.

ÜbergabeparameterTypStandardwertBeschreibung
IV_KEYStringKey, mit dem ein neuer Eintrag angelegt werden soll
IO_DATAANYDaten, die zu dem Eintrag hinzugefügt werden sollen

CLEAR_MESSAGE_BOX

Diese Methode löscht die MessageBox vollständig. Es gibt weder Über- noch Rückgabeparameter.

CLEAR_MESSAGE_TOAST

Diese Methode löscht das MessageToast vollständig. Es gibt weder Über- noch Rückgabeparameter.

GET_APPLICATION_ID

Diese Methode gibt die ID der gesetzten Applikation zurück.

RückgabeparameterTypBeschreibung
RV_APPLICATION_IDStringGesetzte ID

GET_CLIENT_ID

Diese Methode gibt die ID des Clients zurück.

RückgabeparameterTypBeschreibung
RV_CLIENT_IDStringGesetzte ID

GET_DEVICE

Gibt das Gerät zurück, das der Benutzer zum Anzeigen ausgewählt hat.

RückgabeparameterTypBeschreibung
RS_DEVICETY_DEVICEVom Benutzer ausgewähltes Gerät

GET_DEVICE_ORIENTATION

Gibt die Ausrichtung des Geräts zurück, die der Benutzer zum Anzeigen ausgewählt hat. Sie kann vertikal oder horizontal sein.

RückgabeparameterTypBeschreibung
RV_ORIENTATIONStringVom Benutzer ausgewählte Ausrichtung des Geräts

GET_DEVICE_TYPE

Gibt den Typ des Geräts zurück, das der Benutzer zum Anzeigen ausgewählt hat. Dieser gibt beispielsweise an, ob es sich um einen Desktop oder ein mobiles Gerät handelt.

RückgabeparameterTypBeschreibung
RV_TYPEStringDer Typ des vom Benutzer ausgewählten Geräts

GET_EVENT

Gibt ein ausgelöstes Event zurück. Erzeugt standardmäßig ein Request-Data-Event, falls keines vorhanden ist.

RückgabeparameterTypBeschreibung
RO_EVENTEventAusgelöstes Event

GET_GLOBAL_DATA

Liest ein Datenpaar der globalen Daten aus anhand eines Keys.

ÜbergabeparameterTypStandardwertBeschreibung
IV_KEYStringKey, dessen Datenpaar gelöscht werden soll
CO_DATAANY CHANGINGDatenobjekt, in dem die globalen Daten abgelegt werden

GET_I18N

Diese Methode gibt das passende i18n-Model zur App und zum gewünschten Sprachcode zurück. Eine Liste aller Sprachcodes kann hier gefunden werden: https://www.npmjs.com/package/i18n-iso-countries

ÜbergabeparameterTypStandardwertBeschreibung
IV_ISO639D_ISO639Sprachcode, nach dem übersetzt werden soll
RückgabeparameterTypBeschreibung
RT_I18NTT_I18NGibt das i18n-Model zurück

GET_I18N_TEXT

Diese Methode gibt einen übersetzten Text nach einem Übersetzungsschlüssel (Translate Key) zurück.

ÜbergabeparameterTypStandardwertBeschreibung
IV_ISO639D_ISO639Sprachcode, nach dem übersetzt werden soll
IV_KEYTranslate KeyKey des Strings, der übersetzt werden soll
RückgabeparameterTypBeschreibung
RV_TEXTTextÜbersetzter Text

GET_PAGE_ZOOM

Gibt den Zoom der aktuellen View zurück.

RückgabeparameterTypBeschreibung
RV_PAGE_ZOOMstringZoom der View in %

GET_RESPONSE_DATA

Auslesen der Response-Daten zu Request-Daten.

RückgabeparameterTypBeschreibung
RV_JSONStringAuszulesende Daten als Antwort auf eine Request

GET_SCREEN_HEIGHT

Gibt die Höhe des Bildschirms zurück. Abhängig vom Gerät, das der Benutzer ausgewählt hat.

RückgabeparameterTypBeschreibung
RV_HEIGHTIHöhe des Bildschirms

GET_SCREEN_WIDTH

Gibt die Breite des Bildschirms zurück. Abhängig vom Gerät, das der Benutzer ausgewählt hat.

RückgabeparameterTypBeschreibung
RV_WIDTHIBreite des Bildschirms

GET_TEXT

Diese Methode gibt einen übersetzten Text nach einem Schlüssel zurück.

ÜbergabeparameterTypStandardwertBeschreibung
IV_KEYStringSchlüssel, nach dem übersetzt werden soll
RückgabeparameterTypBeschreibung
RV_TEXTTextÜbersetzter Text

GET_TYPE

Gibt ein ausgelöstes Event zurück. Erzeugt standardmäßig ein Request-Data-Event, falls keines vorhanden ist.

RückgabeparameterTypBeschreibung
RO_EVENTEventAusgelöstes Event

GET_VIEW

Gibt die aktuelle View zurück. Erzeugt eine neue View, falls keine vorhanden ist.

RückgabeparameterTypBeschreibung
RO_VIEWViewAuszulesende View

ON_REQUEST

Diese Methode prüft ob das PAI- oder PBO-Skript ausgeführt werden soll und ruft das entsprechende auf. Keine Über- oder Rückgabeparameter.

REMOVE_GLOBAL_DATA

Entfernt ein Datenpaar der globalen Daten anhand eines Keys.

ÜbergabeparameterTypStandardwertBeschreibung
IV_KEYStringKey, dessen Datenpaar gelöscht werden soll

SET_FOCUS

Diese Methode setzt den Fokus auf eine Control anhand der Control-ID.

ÜbergabeparameterTypStandardwertBeschreibung
IV_CONTROL_IDStringID des Controls, auf das der Fokus gesetzt werden soll

SET_MESSAGE_BOX

Diese Methode zeigt eine bereits erstellte MessageBox auf dem Bildschirm des Benutzers an.

ÜbergabeparameterTypStandardwertBeschreibung
IO_MESSAGE_BOXMessage BoxMessageBox, die auf dem Bildschirm des Users angezeigt werden soll

SET_MESSAGE_TOAST

Diese Methode zeigt ein bereits erstelltes MessageToast auf dem Bildschirm des Benutzers an.

ÜbergabeparameterTypStandardwertBeschreibung
IO_MESSAGE_TOASTMessageToastMessageToast, das auf dem Bildschirm des Users angezeigt werden soll

SET_NAV_TO

Diese Methode navigiert zu einer anderen View, die über die jeweilige ID festgelegt werden muss.

ÜbergabeparameterTypStandardwertBeschreibung
IV_VIEW_IDStringID der View, zu der navigiert werden soll

SET_PAGE_ZOOM

Diese Methode setzt den Zoom der aktuellen View.

ÜbergabeparameterTypStandardwertBeschreibung
IV_PAGE_ZOOMstringSetzen der Zooms der aktuellen view
RückgabeparameterTypBeschreibung
RV_PAGE_ZOOMstringZoom der View in %

SET_REQUEST_DATA

ÜbergabeparameterTypStandardwertBeschreibung
IS_REQUEST_DATATY_TRANSFER

SET_REQUEST_DATA_RAW

Setzen der Daten, die angefragt werden.

ÜbergabeparameterTypStandardwertBeschreibung
IV_JSONStringAngefragte Daten in Form eines JSON