URL im Browser öffnen – ABAP

Mit ABAP ist es möglich, aus SAP ERP bzw. SAP S/4HANA eine URL im Browser öffnen zu lassen. Dabei gibt es mehre Möglichkeiten, diese Anforderung umzusetzen. Wie man am einfachsten mit ABAP eine URL im Browser öffnen lassen kann, erfährst Du in diesem Artikel.

Funktionsbaustein CALL_BROWSER

Eine der einfachsten Möglichkeiten, eine URL aus dem SAP ERP- bzw. SAP S/4HANA-System zu öffnen, ist der Aufruf des Funktionsbausteins CALL_BROWSER. Dieser Funktionsbaustein hat den Import-Parameter “URL”, mit dessen Hilfe man direkt die gewünschte URL angeben kann, die man aufrufen möchte. So einfach kann man eine URL im Browser öffnen. Dabei wird der Standardbrowser verwendet.

*----------------------------------------------------------------------
* Aufruf von ERP-UP - URL im Browser öffnen
*----------------------------------------------------------------------
CALL FUNCTION 'CALL_BROWSER'
 EXPORTING
   URL                          = 'https://erp-up.de'
 EXCEPTIONS
   FRONTEND_NOT_SUPPORTED       = 1
   FRONTEND_ERROR               = 2
   PROG_NOT_FOUND               = 3
   NO_BATCH                     = 4
   UNSPECIFIED_ERROR            = 5
   OTHERS                       = 6
          .
IF sy-subrc <> 0.
* Implement suitable error handling here
ENDIF.

Insgesamt hat der Funktionsbaustein CALL_BROWSER folgende Parameter:

Import-ParameterBeschreibung
URLURL des Browseraufrufs
WINDOW_NAMEunter ITS: Name des Browser-Zielfensters
NEW_WINDOWunter Win32: Öffnen eines neuen Fensters

Die beiden Import-Parameter BROWSER_TYPE und CONTEXTSTRING sind obsolet und sollen nicht mehr verwendet werden.

Folgende Ausnahmen existieren beim Funktionsbaustein:

AusnahmeBeschreibung
FRONTEND_NOT_SUPPORTEDFrontend wird nicht unterstützt
FRONTEND_ERRORFehler in SAPGUI aufgetreten
PROG_NOT_FOUNDProgramm nicht gefunden oder nicht ausführbar
NO_BATCHFrontend-Funktion im Batch nicht ausführbar
UNSPECIFIED_ERRORnicht spezifizierte Ausnahme

Beim Aufruf des Funktionsbausteins CALL_BROWSER kann es vorkommen, dass ein Fenster zur SAP-GUI-Sicherheit erscheint. Dieses muss man bestätigen (Button “Zulassen”), damit aus der SAP GUI heraus die URL im Browser geöffnet werden kann. Falls man einen URL-Aufruf öfters starten möchte, kann man mit der Checkbox die “Entscheidung merken”.

Wenn man eine URL im Browser öffnen lassen möchte, kann ein Fenster zur SAP-GUI-Sicherheit erscheinen.

Methode EXECUTE der Klasse CL_GUI_FRONTEND_SERVICES

Die Methode execute der Klasse cl_gui_frontend_services wird beim Aufruf des Funktionsbausteins CALL_BROWSER verwendet. Als Alternative zu CALL_BROWSER kann man also direkt die Methode execute der Klasse cl_gui_frontend_services verwenden.

Es handelt sich dabei um eine statische Methode. Das heißt, dass man keine Instanz der Klasse erzeugen muss, um die Methode aufzurufen.

Für den URL-Aufruf verwendet man den Import-Parameter document. Mit diesem Parameter gibt man die URL an.

**----------------------------------------------------------------------
** Aufruf von ERP-UP - URL im Browser öffnen
**----------------------------------------------------------------------
CALL METHOD cl_gui_frontend_services=>execute
  EXPORTING
    document               = 'https://erp-up.de'
  EXCEPTIONS
    cntl_error             = 1
    error_no_gui           = 2
    bad_parameter          = 3
    file_not_found         = 4
    path_not_found         = 5
    file_extension_unknown = 6
    error_execute_failed   = 7
    synchronous_failed     = 8
    not_supported_by_gui   = 9
    others                 = 10
        .
IF sy-subrc <> 0.
* Implement suitable error handling here
ENDIF.

Diese Methode besitzt insgesamt folgende Import-Parameter und ist vielseitig einsetzbar:

Import-ParameterBeschreibung
DOCUMENTPfad + Dokumentname
APPLICATIONPfad + Anwendungsname
PARAMETERParameter für Anwendung
DEFAULT_DIRECTORYVorschlagsverzeichnis
MAXIMIZEDFenster maximiert anzeigen
MINIMIZEDFenster minimiert anzeigen
SYNCHRONOUSWenn ‘X’: die Anwendung läuft synchron
OPERATIONReserviert: Verb für ShellExecute

Folgende Ausnahmen können von der Methode erzeugt werden:

AusnahmeBeschreibung
CNTL_ERRORControlfehler
ERROR_NO_GUIKein GUI verfügbar
BAD_PARAMETERFalsche Parameterkombination
FILE_NOT_FOUNDDatei nicht gefunden
PATH_NOT_FOUNDPfad nicht gefunden
FILE_EXTENSION_UNKNOWNAnwendung für angegebene Erweiterung wurde nicht gefunden
ERROR_EXECUTE_FAILEDDurchführung der Anwendung oder des Dokuments fehlgeschlagen
SYNCHRONOUS_FAILEDSynchroner Aufruf der Applikation nicht möglich
NOT_SUPPORTED_BY_GUINicht unterstützt von GUI

URL im Browser öffnen als eigenes PopUp-Fenster

Der Funktionsbaustein CALL_BROWSER oder die Methode execute der Klasse cl_gui_frontend_services rufen den Standardbrowser mit der URL auf. Unter Umständen kann es gewünscht sein, dass man den Link in einem in SAP ERP bzw. SAP S/4HANA integrierten PopUp-Fenster öffnen möchte.

Für diese Anforderung kann man die statische Methode show_url der Klasse cl_abap_browser verwenden. Neben der Angabe der URL und dem Fenstertitel kann man noch die Position des PopUp-Fensters genauer spezifizieren.

**----------------------------------------------------------------------
** Aufruf von ERP-UP - URL im Browser öffnen
**----------------------------------------------------------------------
CALL METHOD cl_abap_browser=>show_url
  EXPORTING
    url          = 'https://erp-up.de'
    title        = 'ERP UP'
    size         = cl_abap_browser=>large
    modal        = abap_true
    printing     = abap_false
    buttons      = abap_true
    format       = cl_abap_browser=>landscape
    position     = cl_abap_browser=>topleft
    context_menu = abap_false
    dialog       = abap_true.

URL in einen PopUp in SAP ERP bzw. SAP S/4HANA öffnen.

Mit der statischen Methode show_html kann man ebenfalls direkt in SAP ERP bzw. SAP S/4HANA HTML-Code anzeigen lassen. Hierbei muss man vorab den HTML-Code generieren und beim Aufruf der Methode übergeben.

Über den Autor

Andreas Geiger

Schön, dass Du Dich für SAP ERP bzw. SAP S/4HANA interessierst.

Mein Name ist Andreas Geiger und ich bin der Gründer von ERP-UP.de. Mein Ziel ist es, so viel nützliches Wissen wie möglich über das SAP ERP-System zu vermitteln. Ich möchte Dir damit einen Mehrwert bieten. Es freut mich, wenn ich Dir damit helfen kann.

Mehr zu ERP UP

ERP UP unterstützen

Wenn Du mit ERP UP zufrieden bist, kannst Du mich gerne unterstützen. Dabei gibt es unzählige Möglichkeiten, wie Du mich einfach und schnell unterstützen kannst. Wie Du genau ERP UP unterstützen kannst, erfährst Du hier. Vielen Dank.

Schreibe einen Kommentar