Chapter 10 – Subscreens, tabs and HTML viewer ABAP Course Chapter 10 – Subscreens, tabs and HTML viewer Lecturer: André Bögelsack, UCC Technische Universität München Author: Valentin Nicolescu, André Bögelsack

Copyright 2008 UCC TU München All rights reserved Weitergabe und Vervielfältigung dieser Publikation oder von Teilen daraus sind, zu welchem Zweck und in welcher Form auch immer, ohne die ausdrückliche schriftliche Genehmigung durch HCC TU München nicht gestattet. In dieser Publikation enthaltene Informationen können ohne vorherige Ankündigung geändert werden. Microsoft®, WINDOWS®, NT®, EXCEL®, Word®, PowerPoint® und SQL Server® sind eingetragene Marken der Microsoft Corporation. IBM®, DB2®, OS/2®, DB2/6000®, Parallel Sysplex®, MVS/ESA®, RS/6000®, AIX®, S/390®, AS/400®, OS/390® und OS/400® sind eingetragene Marken der IBM Corporation. ORACLE® ist eine eingetragene Marke der ORACLE Corporation. INFORMIX®-OnLine for SAP und Informix® Dynamic ServerTM sind eingetragene Marken der Informix Software Incorporated.  UNIX®, X/Open®, OSF/1® und Motif® sind eingetragene Marken der Open Group. Citrix®, das Citrix-Logo, ICA®, Program Neighborhood®, MetaFrame®, WinFrame®, VideoFrame®, MultiWin® und andere hier erwähnte Namen von Citrix-Produkten sind Marken von Citrix Systems, Inc. HTML, DHTML, XML, XHTML sind Marken oder eingetragene Marken des W3C®, World Wide Web Consortium, Massachusetts Institute of Technology.   JAVA® ist eine eingetragene Marke der Sun Microsystems, Inc. JAVASCRIPT® ist eine eingetragene Marke der Sun Microsystems, Inc., verwendet unter der Lizenz der von Netscape entwickelten und implementierten Technologie.   SAP, SAP Logo, R/2, RIVA, R/3, SAP ArchiveLink, SAP Business Workflow, WebFlow, SAP EarlyWatch, BAPI, SAPPHIRE, Management Cockpit, mySAP, mySAP.com und weitere im Text erwähnte SAP-Produkte und -Dienstleistungen sowie die entsprechenden Logos sind Marken oder eingetragene Marken der SAP AG in Deutschland und anderen Ländern weltweit. MarketSet und Enterprise Buyer sind gemeinsame Marken von SAP Markets und Commerce One. Alle anderen Namen von Produkten und Dienstleistungen sind Marken der jeweiligen Firmen. Die Verwendung der Screenshots wurde mit dem jeweiligen Eigner abgesprochen.

Agenda Subscreens TabStrips HTML viewer control

Usage of subscreens Main screen Invocation Process before output (PBO) 200 Main screen Process after input (PAI) 200 Invocation Source: Following SAP 2008

Specialties of subscreens Subscreens do not have own ok_codes Ok_code is parsed by the main screen No changes to Gui status during subscreen flow logic Following instructions are not allowed in subscreens: SET TITLEBAR, SET PF-STATUS, SET SCREEN, LEAVE SCREEN, LEAVE TO SCREEN

TabStrips Tabs may be used to structure content Tabs are very common in SAP system Every tab may contain other data/document

TabStrips TabStrip contains several tabs Each tab has its own subscreen to show data Each tab is assigned to own subscreen TabStrip text TabStrip Subscreen Screen

TabStrips Two variants of implementation Buffering in SAPGui Buffering in application server PBO modules are executed for all tabs and results are sent to SAPGui Switching between tabs can be done in SAPGui PAI modules of all tabs are executed in case of a raised event PBO module is only executed for one tab Switching between tabs is slow because each switch has to be done on application server Only PAI module of active tab is executed Performance Validation and execution of all tabs at the same time  costs performance on the application server Validation and execution of one tab only

TabStrips Creation of a TabStrip using TabStrip Wizard Start from the Graphical Screen Painter

TabStrips Creation of a TabStrip using TabStrip Wizard Name of the TabStrip Implementation mode

TabStrips Creation of a TabStrip using TabStrip Wizard Tab titles are defined here

TabStrips Creation of a TabStrip using TabStrip Wizard Number of subscreen has to be assigned Function code must be defined Function code is used to determine which tab was clicked by the user

TabStrips Creation of a TabStrip using TabStrip Wizard Name of the include of the main program

TabStrips Creation of a TabStrip using TabStrip Wizard

TabStrips Flow logic of program when using subscreen’s Main screen Process after input (PAI) Main screen Process before output (PBO) Subscreen 1-x Process before output (PBO) Main screen Main screen Process after input (PAI) Subscreen 1-x Sub screen Sub screen

HTML view control Enables SAP Gui to display HTML data HTML data cannot be displayed in SAP Gui by default  instead the standard web browser is used Documents from SAP web repository, business server pages as well as any kind of URL may be displayed

HTML view control Creation of HTML viewer control Start from Graphical Screen Painter using customer control

HTML view control Creation of HTML viewer control Change the size of the custom control Assign a name to the custom control, e.g. ‘HTML_VIEWER‘

CL_GUI_CUSTOM_CONTAINER HTML view control CUSTOM CONTROL HTML_VIEWER Container CL_GUI_CUSTOM_CONTAINER bsp_container Parent CL_GUI_HTML_VIEWER html_bsp

HTML view control Declare references in TOP INCLUDE: Data: html_bsp TYPE REF TO cl_gui_html_viewer, bsp_container TYPE REF TO cl_gui_custom_container. Instantiation in PBO: IF bsp_container IS INITIAL. CREATE OBJECT bsp_container EXPORTING container_name = ‘HTML_VIEWER’. CREATE OBJECT hmtl_bsp parent = bsp_container. ENDIF.

HTML view control Access to HTML view control via methods: show_url: Loads website from URL into HTML view control load_html_document: Loads document from repository go_home: Shows the homepage of standard web browser do_refresh: Refreshes loaded web site

BSP & HTML view control When using BSP’s in HTML viewer control you need the URL of the BSP including a session id SAP provides you with a method: CALL METHOD cl_http_ext_webapp=>create_url_for_bsp_application EXPORTING bsp_application = “ZY_99_BSP” bsp_start_page = “auswahl.htm” bsp_start_parameters = pars IMPORTING abs_url = urlbsp.