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-Parameter	Beschreibung
URL	URL des Browseraufrufs
WINDOW_NAME	unter ITS: Name des Browser-Zielfensters
NEW_WINDOW	unter 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:

Ausnahme	Beschreibung
FRONTEND_NOT_SUPPORTED	Frontend wird nicht unterstützt
FRONTEND_ERROR	Fehler in SAPGUI aufgetreten
PROG_NOT_FOUND	Programm nicht gefunden oder nicht ausführbar
NO_BATCH	Frontend-Funktion im Batch nicht ausführbar
UNSPECIFIED_ERROR	nicht 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“.

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-Parameter	Beschreibung
DOCUMENT	Pfad + Dokumentname
APPLICATION	Pfad + Anwendungsname
PARAMETER	Parameter für Anwendung
DEFAULT_DIRECTORY	Vorschlagsverzeichnis
MAXIMIZED	Fenster maximiert anzeigen
MINIMIZED	Fenster minimiert anzeigen
SYNCHRONOUS	Wenn ‚X‘: die Anwendung läuft synchron
OPERATION	Reserviert: Verb für ShellExecute

Folgende Ausnahmen können von der Methode erzeugt werden:

Ausnahme	Beschreibung
CNTL_ERROR	Controlfehler
ERROR_NO_GUI	Kein GUI verfügbar
BAD_PARAMETER	Falsche Parameterkombination
FILE_NOT_FOUND	Datei nicht gefunden
PATH_NOT_FOUND	Pfad nicht gefunden
FILE_EXTENSION_UNKNOWN	Anwendung für angegebene Erweiterung wurde nicht gefunden
ERROR_EXECUTE_FAILED	Durchführung der Anwendung oder des Dokuments fehlgeschlagen
SYNCHRONOUS_FAILED	Synchroner Aufruf der Applikation nicht möglich
NOT_SUPPORTED_BY_GUI	Nicht 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.

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.