Web Frontend for Web Services and Business Objects

Transcription

1 WebTransactions V7.0 Web Frontend for Web Services and Business Objects Edition: June 2005 Copyright Fujitsu Siemens Computers GmbH, All rights reserved. Delivery subject to availability; right of technical modifications reserved. All hardware and software names used are trademarks of their respective manufacturers. This manual was produced by cognitas. Gesellschaft für Technik-Dokumentation mbh

2

3 Contents 1 Preface Product characteristics Architecture of the web frontend for web services and business objects WebTransactions documentation Structure and target group of this manual Notational conventions Concept of the web frontend Creating a base directory Creating a base directory with WebLab Structure of a base directory java subdirectory wsdl subdirectory Generating templates BizTransactions with Java integration BizTransactions with SOAP integration General web services with SOAP integration Testing the web frontend Testing the web frontend for business objects Prerequisites for Java business objects Prerequisites for business objects as web services General start template for business objects Web frontends for business objects Testing the web frontend for general web services General start template for web services Web frontend for a web service Editing templates Accessing objects Integration via Java (BizTransactions business objects) Integration via SOAP (BizTransactions business objects and web services) Example of a simple data type Example of a complex data type Web Frontend for Web Services and Business Objects

4 Contents 6.2 Master templates Generated templates Business object integration via Java Business object integration via SOAP Using general web services via SOAP integration Communication sharing of Java business objects and WebTransactions Defining Java business object properties Calling Java business objects Defining the communication mode Example for a host application with communication sharing Glossary Abbreviations Related publications Index Web Frontend for Web Services and Business Objects

5 1 Preface Over the past few years, more and more IT users have found themselves working in heterogeneous system and application environments, with mainframes standing next to UNIX and Windows systems and PCs operating alongside terminals. Different hardware, operating systems, networks, databases and applications are operated in parallel. Highly complex, powerful applications are found on mainframe systems, as well as on UNIX and Windows servers. Most of these have been developed with considerable investment and generally represent central business processes which cannot be replaced by new software without a certain amount of thought. The ability to integrate existing heterogeneous applications in a uniform, transparent IT concept is a key requirement for modern information technology. Flexibility, investment protection, and openness to new technologies are thus of crucial importance. 1.1 Product characteristics With WebTransactions, Fujitsu Siemens Computers offers a best-of-breed web integration server which will make a wide range of business applications ready for use with browsers and portals in the shortest possible time. WebTransactions enables rapid, cost-effective access via standard PCs and mobile devices such as tablet PCs, PDAs (Personal Digital Assistant) and mobile phones. WebTransactions covers all the factors typically involved in web integration projects. These factors range from the automatic preparation of legacy interfaces, the graphic preparation and matching of workflows and right through to the comprehensive frontend integration of multiple applications. WebTransactions provides a highly scaleable runtime environment and an easy-to-use graphic development environment. Web Frontend for Web Services and Business Objects 5

6 Product characteristics Preface On the first integration level, you can use WebTransactions to integrate and link the following applications and content directly to the Web so that they can be easily accessed by users in the internet and intranet: Dialog applications in BS2000/OSD UNIX applications AS400 applications MVS or z/os applications System-wide transaction applications based on openutm Dynamic web content Users access the host application in the internet or intranet using a web browser of their choice. Thanks to the use of state-of-the-art technology, WebTransactions provides a second integration level which allows you to replace or extend the typically alphanumeric user interfaces of the existing host application with an attractive graphical user interface and also permits functional extensions to the host application without the need for any intervention on the host (dialog reengineering). On a third integration level, you can use the uniform browser interface to link different host applications together. For instance, you can link any number of previously heterogeneous host applications (e.g. MVS or OSD applications) with each other or combine them with dynamic Web contents. The source that originally provided the data is now invisible to the user. In addition, you can extend the performance range and functionality of the WebTransactions application through dedicated clients. For this purpose, WebTransactions offers an open protocol and special interfaces (APIs). Furthermore, the object-oriented access to OSD, MVS and. openutm host applications via business objects previously provided in the BizTransactions supply unit is now also integrated in WebTransactions. For more detailed information on business objects (BOs) and the BizTransactions functionality, see the Application Integration with Business Objects manual. Host applications and dynamic Web content can be accessed not only via WebTransactions but also by ordinary terminals or clients. This allows for the step-by-step connection of a host application to the Web, while taking account of the wishes and requirements of different user groups. 6 Web Frontend for Web Services and Business Objects

7 Preface Architecture of the web frontend 1.2 Architecture of the web frontend for web services and business objects The figure below shows the architecture of the web frontend for web services and business objects: WebTransactions Browser with frontend web server Kernel Generated template WT_SOAP WT_JAVA Java SOAP SOAP Java BO BO as web service Web service WSDL file Java archive Figure 1: Architecture of the web frontend for web services and business objects WebTransactions uses this web frontend for web services and business objects to access general web services and business objects. Web Frontend for Web Services and Business Objects 7

8 WebTransactions documentation Preface 1.3 WebTransactions documentation The WebTransactions documentation consists of the following documents: An introductory manual which applies to all supply units: Concepts and Functions This manual describes the key concepts behind WebTransactions: The various possible uses of WebTransactions. The concept behind WebTransactions and the meanings of the objects in WebTransactions, their main characteristics and methods, their interaction and life cycle. The dynamic runtime of a WebTransactions application. The administration of WebTransactions. The WebLab development environment. A Reference Manual which also applies to all supply units and which describes the WebTransactions template language WTML. This manual describes the following: Template Language After an overview of WTML, information is provided about: The lexical components used in WTML. The class-independent global functions, e.g. escape() or eval(). The integrated classes and methods, e.g. array or Boolean classes. The WTML tags which contain functions specific to WebTransactions. The WTScript statements that you can use in the WTScript areas. The class templates which you can use to automatically evaluate objects of the same type. The master templates used by WebTransactions as templates to ensure a uniform layout. A description of Java integration, showing how you can instantiate your own Java classes in WebTransactions and a description of user exits, which you can use to integrate your own C/C++ functions. 8 Web Frontend for Web Services and Business Objects

9 Preface WebTransactions documentation The ready-to-use user exits shipped together with WebTransaction. The XML conversion for the portable representation of data used for communication with external applications via XML messages and the conversion of WTScript data structures into XML documents. A User Guide for each type of host adapter with special information about the type of data source: Connection to AS400 applications Connection to openutm applications via UPIC Connection to OSD applications Connection to MVS applications Connection to UNIX applications All the host adapter guides contain a comprehensive example session. The manuals describe: The installation of WebTransactions with each type of host adapter. The setup and starting of a WebTransactions application. The conversion templates for the dynamic conversion of formats on the web browser interface. The editing of templates. The control of communications between WebTransactions and the host applications via various system object attributes. The handling of asynchronous messages and the print functions of WebTransactions. A User Guide that applies to all the supply units and describes the possibilities of the HTTP host adapter: Access to Dynamic Web Contents This manual describes: How you can use WebTransactions to access a HTTP server and use its resources. The integration of SOAP (Simple Object Access Protocol) protocols in WebTransactions and the connection of web services via SOAP. Web Frontend for Web Services and Business Objects 9

10 WebTransactions documentation Preface A User Guide valid for all the supply units which describes the open protocol, and the interfaces for the client development for WebTransactions: Client APIs for WebTransactions This manual describes: The concept of the client-server interface in WebTransactions. The WT_RPC class and the WT_REMOTE interface. An object of the WT_RPC class represents a connection to a remote WebTransactions application which is run on the server side via the WT_REMOTE interface. The Java package com.siemens.webta for communication with WebTransactions supplied with the product. A User Guide which describes the BizTransactions components: Application Integration With Business Objects This manual describes the concept behind BizTransactions together with its mode of operation and its components. It explains all the steps involved in creating business objects and web services. The manual is intended for all users who want to create business objects for accessing host applications in order to: develop graphical user interfaces for host applications (e.g. via GUIs created using WebTransactions, Visual Basic, Visual C++, Microfocus NetExpress or Java). provide the host application as a web service, for example in the internet. integrate interactions with host applications in Microsoft Office products (e.g. the current data of an openutm mainframe application in Excel tables). 10 Web Frontend for Web Services and Business Objects

11 Structure and target group of this manual 1.4 Structure and target group of this manual This manual is intended for anyone who wishes to integrate business objects and general web services in WebTransactions, and describes the procedures involved in detail. It is designed to supplement the introductory WebTransactions manual Concepts and Functions and the reference guide Template Language to provide all the information you need in order to integrate business objects and general web services in WebTransactions. Scope of the manual The web frontend for web services and business objects runs on Solaris, Linux, Windows and BS2000/OSD. The information provided in this manual applies for all of these system platforms, unless indicated otherwise. 1.5 Notational conventions The following notational conventions are used in this documentation: typewriter font italic font Fixed components which are input or output in precisely this form, such as keywords, URLs, file names Variable components which you must replace with real specifications; also used for menu items bold font Items shown exactly as displayed on your screen or on the graphical user interface; also used for menu items [ ] Optional specifications; do not enter the square brackets themselves {alternative1 alternative2 } Alternative specifications. You must select one of the expressions inside the braces. The individual expressions are separated from one another by a vertical bar. Do not enter the braces (curly brackets) and vertical bars themselves.... Optional repetition or multiple repetition of the preceding components Important notes and further information Ê i Prompt telling you to do something. Web Frontend for Web Services and Business Objects 11

12 Eine Dokuschablone von Frank Flachenecke

13 2 Concept of the web frontend Working with WebTransactions you can incorporate in your WebTransactions application any Java object via the WT_JAVA interface and any web service via the WT_SOAP interface. The Java interface is described in the WebTransactions manual Template Language. Information on integrating the SOAP protocol in WebTransactions is provided in the WebTransactions manual Access to Dynamic Web Contents. In addition to the functions of the WT_SOAP and WT_JAVA interfaces WebTransactions offers a basic interface, or web frontend, for the following cases: Integration of Java business objects created with BizTransactions Integration of business objects created as web services with BizTransactions The SOAP protocol is stateless. Therefore operations must not be bound to a i certain object, but they have to be kept independent of the instance, just like class methods. To obtain this, select the Method value for the business object property Connection when creating the business object (see BizTransactions manual Application Integration with Business Objects ). Integration of web services which are freely available in the WWW The web frontend is implemented in a template, that you can generate with WebLab. It controls the display on the browser and the communication with the web service and the Java business object. WebLab requires for the generation of this template a description file in WSDL format ( Web Service Description Language), that describes the operations of the web service and the methods of the Java business object. For Java business objects you receive the WSDL file by selecting the Web Service and WSDL file option when generating the object. Via the web frontend you can provide users with the functionality of the web service and the business object. Alternatively you profit from it by obtaining an overview of their functionality, and adapting the generated template to suit your needs. Web Frontend for Web Services and Business Objects 13

14 Concept of the web frontend WebTransactions Browser with frontend web server Kernel Generated template WT_SOAP WT_JAVA Java SOAP SOAP Java BO BO as web service Web service WSDL file Java archive Figure 2: Flowchart for the web frontend At runtime, WebTransactions uses the template to generate an HTML page for the browser, as well as a WT_JAVA object for each of the Java components or an instance of the WT_SOAP class for web services. It then uses these objects to communicate with the relevant components. It is possible for you to influence the communication process and to subsequently edit the template to suit your needs. To connect a component to WebTransactions via a web frontend, proceed as follows: Ê Using WebLab, create a base directory. Ê Create or supply the WSDL file. Ê Generate the template for the web frontend. Ê Run the template. Ê Edit the template to suit your needs. These steps are described in the following chapters. 14 Web Frontend for Web Services and Business Objects

15 3 Creating a base directory Once you have installed WebTransactions on the WebTransactions server and WebLab on your Windows PC, you can use WebLab to create one or more base directories. A base directory includes all the files which configure WebTransactions for a specific application scenario. If you de-install WebTransactions or install a new product version, the individual configurations are therefore retained. 3.1 Creating a base directory with WebLab Before you can create a base directory for a WebTransactions application, the WebTransactions administrator must have created a user ID for you and then subsequently released one or more pools for this user ID in which you can create a base directory. Before you create a base directory, it is recommended that you first create a project to store most important data required by WebLab when working with the WebTransactions application. When creating a project, you are automatically offered the opportunity to create a base directory. To do this, proceed as follows: Ê Call WebLab, e.g. via Start/Programs/WebTransactions 7.0/WebLab Ê Ê Ê There are two possibilities for starting to create a base directory: Ê Select the Project/New... command and when asked whether you want to create a base directory, answer Yes. or Ê Choose the Generate/Basedir... command and specify that a new project is to be created when the relevant query appears. In both instances, the Connect dialog box is opened. In the Connect dialog box, enter the connection parameters and confirm with OK. In the next dialog box, enter your user ID and password and click OK. Web Frontend for Web Services and Business Objects 15

16 Structure of a base directory Creating a base directory Ê In the Create Basedir dialog box, make the following entries: Select the directory under which your base directory is to be created. Enter a name for the new base directory. In the openseas area, check the openseas support box. Click OK. Structure and contents of a base directory are described in the WebTransactions manual Concepts and Functions and in section Structure of a base directory on page 16. Converting a base directory to a new version Ê Ê Ê Select Generate/Update Base Directory. This opens the Update Base Directory dialog box. If you only want to change the links from the base directory to the new installation directory, select the Update all links option. Select this option when you have updated the files that are supplied or generated by WebTransactions. If all files which are copied or generated on creation of the base directory need to be recreated, select the Overwrite all files option. 3.2 Structure of a base directory This section only describes the specifics of the base directory of the web frontend for web services and business objects. i For general information on the structure of base directories see WebTransactions manual Concepts and Functions java subdirectory This subdirectory is created not with the base directory, but when you use Java business objects. The Jar archives of the Java business objects used, as well as the Jar archives required by these business objects at runtime are stored in java wsdl subdirectory This subdirectory is created not with the base directory, but when you use web services. The WSDL files of the web services used, which are required by WebTransactions at runtime are stored in wsdl. 16 Web Frontend for Web Services and Business Objects

17 4 Generating templates Once you have created a base directory for business objects or web services or you are connected to such a base directory, you can use WebLab to generate a template with the following commands: Generate/Templates/for Business Objects... Generate/Templates/for WebServices... With these commands you can generate templates for integrating business objects and general web services in WebTransactions. To generate the required templates, you also need the following: a description file (WSDL file) the corresponding master template WSDL file In the course of the generation process, you specify one or more description files, known as WSDL files (WebService Description Language). Each WSDL file will contain a description of precisely one component. If you specify several WSDL files, a template will be generated for each of the associated components. WSDL files can be stored locally on your own system or under the base directory. The WSDL file for a business object is generated using BizTransactions. Most web services are already described in WSDL, which means that a WSDL file for the respective service will be readily available on the web. Web Frontend for Web Services and Business Objects 17

18 Generating templates Master templates A template is generated for each WSDL file on the basis of a special master template: Java business objects business objects as web service web services JAVA_BO.wmt WSDL.wmt WSDL.wmt These master templates are stored in the subdirectory weblab under the WebLab installation directory, and can be customized to suit your needs. The master template tags are described in the WebTransactions manual Template Language. WSDL files Master template Generated templates for openseas or web services Figure 3: Generating templates for openseas or web services The templates generated on the basis of WSDL files and a master template have predefined names: wtopenseas_componentname.htm for templates generated for business objects (BOs) wtwebservice_componentname.htm for templates generated for general web services where componentname is dependent on the name of the WSDL file. They are stored in the base directory under config/forms, unless specified otherwise. If you wish to use another target directory, this must be located under basedir/config. The generated templates can then be used as is or as the basis for more sophisticated visual layouts. 18 Web Frontend for Web Services and Business Objects

19 Generating templates BizTransactions with Java integration 4.1 BizTransactions with Java integration Before generating a template, make sure that the following files are available: the WSDL file the master template JAVA_BO.wmt the Java business object (generated as a Java bean) The business object must be available in the form of a Java package in a JAR archive containing all user-defined classes (i.e. non-standard classes). Procedure To generate a template for Java business objects, proceed as follows: Ê In WebLab, choose Generate/Templates/for Business Objects to open the Create Templates for Business Objects dialog box. Web Frontend for Web Services and Business Objects 19

20 BizTransactions with Java integration Generating templates Ê Ê Ê Ê Ê Ê Ê Ê Ê At the bottom of the dialog box, click the JAVA radio button next to Integration via to display the Java options. Specify the directory containing the WSDL files to be used as the basis for generating the template, either by entering the directory path directly or by clicking Browse and making the appropriate selection. The WSDL documents for Generation list will then display all files in the specified directory. In WSDL documents for Generation, select the WSDL files to be used as the basis for generating the template. Check that the master template is set correctly (JAVA_BO.wmt). In WTML Directory, enter the subdirectory under the base directory in which the generated template is to be stored. Enter the absolute path name of the JAR archive directly, or click Browse and make the appropriate selection. Enter a package name for the business object. In Object name, specify a unique name for the business object. Click Generate to generate a template for integrating the Java business object in accordance with your specifications. In the process, the subdirectory java will be created under the base directory and the specified JAR archive will be copied to this subdirectory. 20 Web Frontend for Web Services and Business Objects

21 Generating templates BizTransactions with SOAP integration 4.2 BizTransactions with SOAP integration Before generating a template, make sure that the following files are available: the WSDL file the master template WSDL.wmt Procedure To generate a template for business objects for which you have generated a web service, proceed as follows: Ê In WebLab, choose Generate/Templates/for Business Objects to open the Create Templates for Business Objects dialog box. Ê Ê Ê Specify the directory containing the WSDL files to be used as the basis for generating the template, either by entering the directory path directly or by clicking Browse and making the appropriate selection. The WSDL documents for Generation list will then display all files in the specified directory. In WSDL documents for Generation, select the WSDL files to be used as the basis for generating the template. Check that the master template is set correctly (WSDL.wmt). Web Frontend for Web Services and Business Objects 21

22 BizTransactions with SOAP integration Generating templates Ê Ê Ê In WTML Directory, enter the subdirectory under the base directory in which the generated template is to be stored. Click the SOAP radio button next to Integration via. Click Generate to generate a template for integrating the business object in accordance with your specifications. In the process, the subdirectory wsdl will be created under the base directory and the specified WSDL file will be copied to this subdirectory. 22 Web Frontend for Web Services and Business Objects

23 Generating templates General web services with SOAP integration 4.3 General web services with SOAP integration Before generating a template, make sure that the following files are available: the WSDL file the master template WSDL.wmt Procedure To generate a template for web services, proceed as follows: Ê In WebLab, choose Generate/Templates/for WebServices to open the Create Templates for WebServices dialog box. Ê Ê Ê Ê Specify the directory containing the WSDL files to be used as the basis for generating the template, either by entering the directory path directly or by clicking Browse and making the appropriate selection. The WSDL documents for Generation list will then display all files in the specified directory. In WSDL documents for Generation, select the WSDL files to be used as the basis for generating the template. Check that the master template is set correctly (WSDL.wmt). In WTML Directory, enter the subdirectory under the base directory in which the generated template is to be stored. Web Frontend for Web Services and Business Objects 23

24 General web services with SOAP integration Generating templates Ê Click Generate to generate a template for integrating the web service in accordance with your specifications. In the process, the subdirectory wsdl will be created under the base directory and the specified WSDL file will be copied to this subdirectory. 24 Web Frontend for Web Services and Business Objects

25 5 Testing the web frontend Once you have generated the templates for integrating a business object or a web service, you are ready to test the web frontend. The generated templates can be used as is and form a modifiable web frontend. This chapter covers the following topics for both business objects and web services: the prerequisites for use the general start template the web frontend 5.1 Testing the web frontend for business objects When it comes to testing the various business objects, different prerequisites and flowcharts apply. These are described below. Web Frontend for Web Services and Business Objects 25

26 Testing the web frontend for business objects Testing the web frontend Prerequisites for Java business objects Once you have generated the template for integrating a Java business object, make sure the java subdirectory under the base directory contains the Jar archive for the business object. If the BizTransactions Object Builder is not installed on the computer on which WebLab is running, the archive bizta.jar must also be copied into the java subdirectory. You find these file on the WebTransactions server in the following directory: C:\Programme\Gemeinsame Dateien\FujitsuSiemensComputers\BizTransactions70\bin This Jar archive contains special classes for the business object, which will be accessed by WebTransactions at runtime. The flowchart for a Java business object frontend can thus be represented as follows: WebTransactions Browser with frontend web server Kernel WT_JAVA Java business object Generated template Java archives Figure 4: Flowchart for testing a Java business object 26 Web Frontend for Web Services and Business Objects

27 Testing the web frontend Testing the web frontend for business objects Prerequisites for business objects as web services i The SOAP protocol is stateless. Therefore operations must not be bound to a certain object, but they have to be kept independent of the instance, just like class methods. To obtain this, select the Method value for the business object property Connection when creating the business object (see BizTransactions manual Application Integration with Business Objects ). Once you have generated the template for integrating a business object, make sure the wsdl subdirectory contains the WSDL file for the business object. This file must also be checked to ensure that the web service s URL is entered correctly. Ê In WebLab, connect to the base directory by selecting File/Connect. Ê In the template tree, double-click on the WSDL file to open it for editing. Ê Check if you can access the web service s destination URL from the web. This URL is the value of the location attribute of the soap:address tag under the service port section of the WSDL file. Example: <service name="travelbo"> <port name="travelbowsifport" binding="tns:travelbowsifbinding"> <soap:address xmlns:wsdl=" location=" </port> </service> Ê If necessary replace localhost by the name of the host on which the web service is running. Ê Save and then close the WSDL file. The flowchart of a frontend for a business object used as web service can thus be represented as follows: Web Frontend for Web Services and Business Objects 27

28 Testing the web frontend for business objects Testing the web frontend WebTransactions Browser with frontend web server Kernel WT_SOAP Business object listener Generated template WSDL file Figure 5: Flowchart for testing a business object as web service 28 Web Frontend for Web Services and Business Objects

29 Testing the web frontend Testing the web frontend for business objects General start template for business objects Ê Ê Ê Ê In WebLab, open a session by selecting File/Start Session. In the Start Session dialog box, enter the required data on the WebTransactions host and the base directory. Set the start template to wtstart and confirm with OK. The start template will then be displayed in the predefined browser. Click openseas. This opens the start template for openseas components in the browser. The openseas component list will include all templates whose names begin with wtopenseas_ which are located in the directory defined by the system object s STYLE and LANGUAGE attributes Ê Choose an openseas component and confirm with access openseas. Web Frontend for Web Services and Business Objects 29

30 Testing the web frontend for business objects Testing the web frontend Web frontends for business objects Each business object is represented by a WebTransactions template. The interface itself is designed with the help of the WTBean wtctabs. It includes a tab sheet for the respective object, which is named after the object in question. Here you can define general settings, such as the proxy settings for integration via SOAP or the dynamic extension of the JAVA_CLASSPATH for integration via Java. Each method also has its own tab sheet containing the following information: the output or return value the last parameters entered the prescribed input parameters A method is called by clicking the execute button. Web frontend for BizTransactions via Java Figure 6: Tab sheet containing the methods of the Java business object 30 Web Frontend for Web Services and Business Objects

31 Testing the web frontend Testing the web frontend for business objects Web frontend for BizTransactions via SOAP Figure 7: Tab sheet containing the methods of the business object used as web service Web Frontend for Web Services and Business Objects 31

32 Testing the web frontend for general web services Testing the web frontend 5.2 Testing the web frontend for general web services Once you have generated the template for integrating a web service, make sure the wsdl subdirectory contains the WSDL file for the web service. If the web service is modified in some way since the generation of the template, it is recommended that you regenerate the template with the new WSDL file. The flowchart for a web service frontend can thus be represented as follows: WebTransactions Browser with frontend web server Kernel WT_SOAP web service Generated template WSDL file Figure 8: Flowchart for testing a web service 32 Web Frontend for Web Services and Business Objects

33 Testing the web frontend Testing the web frontend for general web services General start template for web services To start a web service frontend, proceed as follows: Ê In WebLab, open a session by selecting File/Start Session. Ê In the Start Session dialog box, enter the required data on the WebTransactions host and the base directory. Ê Set the start template to wtstart and confirm with OK. The start template will then be displayed in the predefined browser. Ê Click WebService. This opens the start template for the web service in the browser. The web service access list will include all templates whose names begin with wtwebservice_ which are located in the directory defined by the system object s STYLE and LANGUAGE attributes Ê Choose a web service and confirm with access Webservice. Web Frontend for Web Services and Business Objects 33

34 Testing the web frontend for general web services Testing the web frontend Web frontend for a web service A web service is represented by a WebTransactions template. The interface itself is designed with the help of the WTBean wtctabs. It includes a tab sheet for the web service, which is named after the web service in question. Here you can define general settings, such as the proxy settings for integration via SOAP. Each method also has its own tab sheet containing the following information: the output or return value the last parameters entered the prescribed input parameters A method is called by clicking the execute button. Figure 9: Tab sheet containing the web service BabelFish method 34 Web Frontend for Web Services and Business Objects

35 6 Editing templates As a template programmer, you can feel free to edit the generated templates in WebLab, e.g. in order to make the resulting interface more attractive to the eye. When working with WebLab, WebTransactions offers a considerable degree of support, particularly when it comes to things like using objects to transfer parameters, for example. For this purpose, WebTransactions generates an object for each structure used. Once the template is run, these objects are created and displayed in the WebLab object tree, from where they can be easily incorporated in the code using the normal WebLab utilities. This chapter contains information on the following: accessing objects enhancing the layout of the generated interfaces master templates At the end of the chapter, you will find a commented listing of the generated templates. Web Frontend for Web Services and Business Objects 35

36 Accessing objects Editing templates 6.1 Accessing objects BizTransactions integrations in WebTransactions are implemented using WebTransactions objects Integration via Java (BizTransactions business objects) In the case of integration via Java each BizTransactions business object is mapped to a WT_JAVA object. WT_JAVA class The WT_JAVA class is built into the WebTransactions kernel. With the WT_JAVA class objects of any JAVA class can be created in WTScript. Its methods and attributes can be accessed directly at the Java object. Representation of a BizTransactions business object by a WT_JAVA object For each business object a java object is created in WT_Script by means of the WT_JAVA class. This object gets the name Java_serial_number. The methods of the business object are called directly at these objects. For the web frontend, a method call including all the necessary parameters is generated at these objects for each method of the business object. Example: Calling the method GetAllGolfCourses_jb() Java_0.GetAllGolfCourses_jb(); 36 Web Frontend for Web Services and Business Objects

37 Editing templates Accessing objects Mapping Java data types to WTScript data types The table below shows how WTScript data types are mapped to Java data types in the parameters of the generated method calls. WTScript type Boolean objects String objects Number objects Java objects Java primitives Other WTScript objects Conversion to Java type Boolean Default: java.lang.string If the string consists of only one character, an attempt will also be made to convert this to type char. Default: double If the object cannot be converted to the default type, an attempt will be made to convert it to all other numeric types until a suitable conversion is found, provided the conversion does not result in a loss of accuracy. Default: Type used when creating the object If the object cannot be converted to the default type, an attempt will be made to convert it to all superclasses and implemented interfaces until a suitable conversion is found. Default: Corresponding primitive Java type If the object cannot be converted to the default type, an attempt will be made to convert it to all types for which the object value is valid until a suitable conversion is found. char values are not handled as numeric values. Not permitted as arguments Web Frontend for Web Services and Business Objects 37

38 Accessing objects Editing templates Objects for complex data types If a method uses complex data structures as parameters, these will be supported as follows when the web frontend is generated: An object of the WT_JAVA class is automatically created for each complex parameter used when the constructor calls are generated. In the process, WebTransactions assumes that all complex data types used correspond to objects available in the Java archives. The generation of constructor calls is initiated by the master template tag %%ObjectCreate%. Pregenerated Java objects can be used in the template as is or adapted to suit your needs. The name of a pregenerated Java object consists of: the name of the method used the structure name possibly a serial number, if the structure is used more than once within the method call For examples of how objects are used in the generated templates, see section Generated templates on page Web Frontend for Web Services and Business Objects

39 Editing templates Accessing objects Integration via SOAP (BizTransactions business objects and web services) In the case of integration via SOAP, each web service or business object (BO) is mapped to a WT_SOAP object when generating the web frontend. WT_SOAP class The WT_ SOAP class is implemented in the template wtsoap.htm and provides an access to web services via the SOAP protocol: An instance of this class represents a web service which must be described in a WSDL file. WT_SOAP analyzes the WSDL file and provides the operations of a web service as methods (proxy methods) of the WT_SOAP class. You will find a detailed description of the WT_SOAP class and corresponding methods in the WebTransactions manual Access to Dynamic Web Contents. Representation of a web service by a WT_SOAP object A web service is represented by an object of the WT_SOAP class. For each web service or each business object which you want to access as web service an instance of the WT_SOAP class is created. This instance is labeled WSDL_serial_number. Calling web service operations and business object methods It is possible to call proxy methods at a WT_SOAP object. In WebLab, a method call is inserted simply by dragging it from the object tree into the actual template. As the SOAP protocol is stateless, operations must be kept independent of objects, i just like class methods. This must be taken into consideration when designing business objects that are to be made available as web services. Web Frontend for Web Services and Business Objects 39

40 Accessing objects Editing templates Mapping SOAP data types to WTScript data types During generation, a method call including all the necessary parameters is generated for each web service operation. The table below shows how the parameter data types are mapped: SOAP data type string boolean float double int short long decimal struct (complextype) array WTScript data type string boolean number number number number number number Object Array 40 Web Frontend for Web Services and Business Objects

41 Editing templates Accessing objects Example of a simple data type An entry field and an associated value is generated on the web frontend for each method parameter. If the parameter has a simple data type, the user input will be forwarded directly to the method. Example of a web frontend for a web service The purpose of the following web service is to translate a piece of text. The first parameter specifies the direction of the translation process, while the second contains the actual text to be translated. Generating the entry fields Two entry fields are generated: <TABLE BGCOLOR="#99CCCC"> <TR> <TD>translationmode:</TD> <TD><INPUT TYPE="TEXT" CLASS="BOX" NAME="translationmode_Translate" SIZE=32></TD> </TR> <TR> <TD>sourcedata:</TD> <TD><INPUT TYPE="TEXT" CLASS="BOX" NAME="sourcedata_Translate" SIZE=32></TD> </TR> </TABLE> Calling the web service WSDL_0.service.Translate.port.TranslatePort.operation.Translate( WT_POSTED.translationmode_Translate, WT_POSTED.sourcedata_Translate); If you wish, you can change the graphical layout of the interface, e.g. by replacing one of the entry fields with a pick list: <TR> <TD>translationmode:</TD> <TD> <SELECT NAME="translationmode_Translate"> <OPTION VALUE="de_en" >German->English</OPTION> <OPTION VALUE="en_de" >English->German</OPTION> </SELECT> </TR> Since this pick list has the same name as the entry field, the operation call remains unchanged. Web Frontend for Web Services and Business Objects 41

42 Accessing objects Editing templates Example of a complex data type If you wish to incorporate more complex data structures in the interface, you must ensure that the user has some means of entering individual values for the various elements within the data structure at the interface. This is because only one entry field will initially be generated for each complex data type. Proceed as follows: Ê Ê At the appropriate location in the template, replace the INPUT tag generated for the entire structure with several INPUT tags for each attribute of the structure. After sending, copy this posted data to the object attributes in the Receive script before the method call. Example of a web frontend for a business object with integration via SOAP The following is generated: <wtoncreatescript> p0_businessobject_gettest = new Object(); //Objekt für die komplexe //Datenstruktur </wtoncreatescript> <input type="text" name="p0_businessobject_gettest" value=""/> <wtonreceivescript> /* Methodenaufruf; als Parameter wird das Objekt für die komplexe Datenstruktur übergeben */...gettest( proxyobjects.gettest_p0,...); </wtonreceivescript> 42 Web Frontend for Web Services and Business Objects

43 Editing templates Accessing objects Extend the script as follows: Ê Specify a separate INPUT tag for each attribute: Ê... <input type="text" name="p0_businessobject_gettest_minutes" value=""/>... For each attribute, add the following lines to the receive script before the method call (this example applies for the minutes attribute):... proxyobjects.gettest_p0.minutes = WT_POSTED.p0_BusinessObject_getTest_minutes;... <input type="text" name="p0_businessobject_gettest" value=""/> This procedure allows you to generate the attribute and assign it the value entered by the user at the interface. Other substitutions that must be carried out include: <input type="text" name="p0_businessobject_gettest.minutes" value=""> <input type="text" name="p0_businessobject_gettest.seconds" value=""> <input type="text" name="p0_businessobject_gettest.hours" value=""> <input type="text" name="p0_businessobject_gettest.date" value=""> <input type="text" name="p0_businessobject_gettest.month" value=""> <input type="text" name="p0_businessobject_gettest.year" value=""> Web Frontend for Web Services and Business Objects 43

44 Master templates Editing templates 6.2 Master templates The following master templates are supplied: WSDL.wmt JAVA_BO.wmt The supplied master templates are installed under installdir/weblab. The table below lists a number of new master template tags (MT tags), which have been introduced for the JAVA and WSDL protocol options only: MT tag %%SOURCE% %%ObjectName% %%PackageName% %%ArchiveName% %%ObjectCreate% %%MethodInterface% Explanation Replaced by the name of the copied WSDL file in the base directory (e.g. WSDL/BO1.wsdl) Replaced by the name of the Java business object Replaced by the name of the Java package containing the object Replaced by the name of the Java archive Initiates the generation of objects for complex structures Initiates the generation of the interface and further processing of individual methods The following MT tags may not be used for the generation of web frontends for business objects and web services in the master template: %%Lines...% %%ReceiveCopies% 44 Web Frontend for Web Services and Business Objects

45 Editing templates Generated templates 6.3 Generated templates This section describes the generated templates and the presentation of the associated interfaces for the following scenarios: Support for the business objects created with BizTransactions via Java integration Support for the business objects created with BizTransactions via SOAP integration Support for general web services via SOAP integration Web Frontend for Web Services and Business Objects 45

46 Generated templates Editing templates Business object integration via Java The text below shows the wtopenseas_stockinfo.htm template, generated in section BizTransactions with Java integration on page 19. Generation options <html> <wtrem>************************************************************************</wtrem> <wtrem>** WTML document: de.siemens.bizta.beans.stockinfo.stockinfo **</wtrem> <wtrem>************************************************************************</wtrem> <wtrem>** **</wtrem> <wtrem>** Document generation based on Master Template : **</wtrem> <wtrem>** C:\Programme\WebTransactionsV7\weblab\JAVA_BO.wmt **</wtrem> <wtrem>** **</wtrem> <wtrem>** Generated at Mon Jan 10 15:05: **</wtrem> <wtrem>** **</wtrem> <wtrem>** Options used by the generator : **</wtrem> <wtrem>** - %OPTIONS: **</wtrem> <wtrem>** CommObj = Java_0 **</wtrem> <wtrem>** Source = wsdl/stockinfo.wsdl - ObjectName = STOCKINFO **</wtrem> <wtrem>** BO_RTS = de.siemens.bizta.runtime - JavaUtil = java.util **</wtrem> <wtrem>************************************************************************</wtrem> <wtrem>** WebTransactions V7.0 Fujitsu Siemens Computers GmbH, 2005 **</wtrem> <wtrem>************************************************************************</wtrem> Extending the system object attribute JAVA-CLASSPATH to include all.jar files in the java subdirectory <wtoncreatescript> <!-- //create list of all available jar files in /java var systemexits = new WT_Userexit("WTSystemExits"); var dir = WT_SYSTEM.BASEDIR + "/java"; var jarfiles = ( systemexits.getdir(dir, "*.jar").split('\n')).sort(); if ( typeof WT_SYSTEM.JAVA_CLASSPATH == 'undefined' ) { WT_SYSTEM.JAVA_CLASSPATH = ""; } for( i in jarfiles ) { if ( ( jarfiles[i]!= "" ) && ( WT_SYSTEM.JAVA_CLASSPATH.indexOf(WT_SYSTEM.BASEDIR + "/java/" + jarfiles[i]) == -1 ) ) WT_SYSTEM.JAVA_CLASSPATH += WT_SYSTEM.BASEDIR + "/java/" + jarfiles[i] + (WT_SYSTEM.PLATFORM == "NT"? ";" : ":"); } if (WT_SYSTEM.PLATFORM == "NT") 46 Web Frontend for Web Services and Business Objects

47 Editing templates Generated templates JAVA_CLASSPATH_OUT = WT_SYSTEM.JAVA_CLASSPATH.replace(/;/g, '; '); else JAVA_CLASSPATH_OUT = WT_SYSTEM.JAVA_CLASSPATH.replace(/:/g, ': '); if ( typeof WT_SYSTEM.Java_0 == 'undefined' ) { WT_SYSTEM.Java_0 = new Object(); Creating complex data structures as Java objects //{{WebLab(object create) try { WT_SYSTEM.Java_0.BizTaEvent_STOCKINFO_fireEvent = new WT_JAVA.de.siemens.bizta.beans.STOCKINFO.BizTaEvent(); } catch (_exc){ WT_SYSTEM.Java_0.BizTaEvent_STOCKINFO_fireEvent = new WT_JAVA.de.siemens.bizta.runtime.BizTaEvent();} try { WT_SYSTEM.Java_0.BizTaEventListener_STOCKINFO_addBizTaEventListener = new WT_JAVA.de.siemens.bizta.beans.STOCKINFO.BizTaEventListener(); } catch (_exc) { WT_SYSTEM.Java_0.BizTaEventListener_STOCKINFO_addBizTaEventListener = new WT_JAVA.de.siemens.bizta.runtime.BizTaEventListener();} try { WT_SYSTEM.Java_0.BizTaEventListener_STOCKINFO_removeBizTaEventListener = new WT_JAVA.de.siemens.bizta.beans.STOCKINFO.BizTaEventListener(); } catch (_exc) { WT_SYSTEM.Java_0.BizTaEventListener_STOCKINFO_removeBizTaEventListener = new WT_JAVA.de.siemens.bizta.runtime.BizTaEventListener();} WT_SYSTEM.Java_0.StringHolder_STOCKINFO_readCompanyInfo = new WT_JAVA.de.siemens.bizta.runtime.StringHolder(); WT_SYSTEM.Java_0.StringHolder_STOCKINFO_readCompanyInfo_1 = new WT_JAVA.de.siemens.bizta.runtime.StringHolder(); WT_SYSTEM.Java_0.GregorianCalendar_STOCKINFO_format = new WT_JAVA.java.util.GregorianCalendar(); //}} } Creating a Java object with WT_JAVA if ( typeof WT_SYSTEM.Java_0.STOCKINFO == 'undefined' ) WT_SYSTEM.Java_0.STOCKINFO = new Object(); if ( typeof WT_SYSTEM.Java_0.STOCKINFO.instance == 'undefined' ) { try { Java_0 = WT_SYSTEM.Java_0.STOCKINFO.instance = new WT_JAVA.de.siemens.bizta.beans.STOCKINFO.STOCKINFO(); } catch ( exc ) { Web Frontend for Web Services and Business Objects 47

48 Generated templates Editing templates document.writeln(exc); WT_SYSTEM.Java_0.STOCKINFO.ret_value = exc; } } else Java_0 = WT_SYSTEM.Java_0.STOCKINFO.instance; Java_0_system = WT_SYSTEM; //--> </wtoncreatescript> <wtif (Java_0_system.PROLOG)> <wtinclude Name="##Java_0_system.PROLOG#"> </wtif> HTML header: defining the WebTransactions format <head> <title>webtransactions V7.0 - Java de.siemens.bizta.beans.stockinfo.stockinfo</title> ##WT_SYSTEM.CGI.HTTP_USER_AGENT.indexOf( 'MSIE' ) >= 0? '<meta http-equiv="pragma" content="no-cache"/>' : '<meta http-equiv="cache-control" content="no-cache"/>'# <wtif (WT_BROWSER.acceptClass)> <style type="text/css"> input { font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; } input.box { border: 0 solid; padding: 1px 0 1px 0; margin-left: -1px; margin-top: ##WT_BROWSER.marginTop#px; font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; color: #000000; background-color: #FFFFFF; } input.button { font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; border-width: 1pt; margin-left: -1pt; } select { font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; } pre { font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; margin: 0; } 48 Web Frontend for Web Services and Business Objects

49 Editing templates Generated templates </style> </wtif> </head> <body bgcolor="#336666" text="#000000"> <form webtransactions name="de.siemens.bizta.beans.stockinfo.stockinfo"> <table cellspacing="1" cellpadding="2"> <tr> <td colspan="3" align="right"> <img src="##wt_system.cgi.script_name#/logo" align="left"> <td><font size="+3" color="#ffffff">webta is the web frontend for openseas</font> </tr> <tr> <td> <wtif (Java_0_system.FORMTPL)> <wtinclude Name="##Java_0_system.FORMTPL#"> </wtif> </tr> Button for general control <TR BGCOLOR="#99CCCC"> <td colspan="3" align="center"> <h2>control</h2> <td align="center"><h3>return to component selection</h3> <td align="center"> <input type="submit" name="control" value="back"/> </tr> </table> General control <! > <!-- main template control section --> <! > <wtonreceivescript> if (WT_POSTED.Control) { WT_SYSTEM.FORMAT = 'wtconnectopenseas.htm'; exitreceiveprocessing(); } if (WT_POSTED.SetParameter) WT_SYSTEM.JAVA_CLASSPATH += WT_POSTED.WT_Java_ClassPath+ (WT_SYSTEM.PLATFORM == "NT"? ";" : ":"); </wtonreceivescript> Web Frontend for Web Services and Business Objects 49

50 Generated templates Editing templates Header for the Java business object <! > <!-- begin of service operations section --> <! > <wtc name="wtctabs" type="inline" version="7.0"> <wtctitle>tab Control <wtcpar name="objectname">componenttabs</wtcpar></wtctitle> <script language="javascript" src="##wt_system.wwwdocs_virtual#/javascript/wtctabs_browserfunctions.js" type="text/javascript"> </script> <script> <wtcpar name="objectname">componenttabs</wtcpar> = new wtctabs(<wtcpar name="width">950</wtcpar>,<wtcpar name="tabheight">20</wtcpar>,'<wtcpar name="ident">comptabs</wtcpar>',<wtcpar name="foregroundcolor">'#333333'</wtcpar>,<wtcpar name="backgroundcolor">'#dddddd'</wtcpar>,<wtcpar name="bordercolor">'#ffffff'</wtcpar>,<wtcpar name="foregroundcolordimmed">'#999999'</wtcpar>,<wtcpar name="backgroundcolorselecteddimmed">'#cccccc'</wtcpar>,<wtcpar name="bordercolordimmed">'#dddddd'</wtcpar>); </script> List of tab sheets, one for the business object and one for each method <! > <!-- begin of list of tabs --> <! > <wtclist name="tab-list" minlength="1"> <wtctitle>list of Tabs</wtcTitle> 50 Web Frontend for Web Services and Business Objects

51 Editing templates Generated templates Tab sheet for adding the Java classpath <! > <!-- begin of list item --> <! > <wtclistitem> <script language="javascript" type="text/javascript"> <wtcpar name="objectname">componenttabs</wtcpar>.addtab(<wtcpar name="titlename">'stockinfo'</wtcpar>, <wtcpar name="titlewidth">150</wtcpar>); </script> <wtcblock> <wtctitle><wtcpar name="titlename">'stockinfo'</wtcpar></wtctitle> <table cellspacing="3" cellpadding="2"> <tr bgcolor="#669999"> <td> current JAVA_CLASSPATH: <td> JAVA environment parameters: </tr> <tr bgcolor="#99cccc"> <td>##wt_system.java_classpath_out ' '# <td> <table> <tr> <td>java_classpath: <td><input type="text" name="wt_java_classpath" size="32"/> </tr> </table> <td> <input type="submit" name="setparameter" value="set parameters"/> </tr> </table> </wtcblock> </div> </wtclistitem> Web Frontend for Web Services and Business Objects 51

52 Generated templates Editing templates Blocks such as the one shown below for each method <! > <!-- begin of list item --> <! > <wtclistitem> <script language="javascript" type="text/javascript"> <wtcpar name="objectname">componenttabs</wtcpar>.addtab(<wtcpar name="titlename">'stockinfo_readcompanyinfo'</wtcpar>, <wtcpar name="titlewidth">120</wtcpar>); </script> <wtcblock> <wtctitle><wtcpar name="titlename">'stockinfo_readcompanyinfo'</wtcpar></wtctitle> User interface displaying return information displaying the last parameters specified generating entry fields for the method input parameters button for initiating the method <table cellspacing="3" cellpadding="2"> <tr bgcolor="#669999"> <td> return value: <td> previous parameters: <td> input parameters: <td>&nbsp </tr> Displaying return information <tr bgcolor="#99cccc"> <td> <table> <tr><td>##wt_system.java_0["stockinfo"].ret_stockinfo_readcompanyinfo#</td</tr> </table> 52 Web Frontend for Web Services and Business Objects

53 Editing templates Generated templates Displaying the last parameters specified <td> <table bgcolor="#99cccc"> <tr> <td> ##WT_POSTED.p0_STOCKINFO_readCompanyInfo ' '# </tr> <tr> <td> ##WT_POSTED.p1_STOCKINFO_readCompanyInfo ' '# </tr> <tr> <td> ##WT_POSTED.p2_STOCKINFO_readCompanyInfo ' '# </tr> </table> Generating entry fields for the method input parameters <td> <table bgcolor="#99cccc"> <tr> <td>p0: <td><input type="text" name="p0_stockinfo_readcompanyinfo" size="32"/> </tr> <tr> <td>p1: <td><input type="text" name="p1_stockinfo_readcompanyinfo" size="32"/> </tr> <tr> <td>p2: <td><input type="text" name="p2_stockinfo_readcompanyinfo" size="32"/> </tr> </table> Button for initiating the method <td> <input type="submit" name="stockinfo_readcompanyinfo" value="execute"/> </tr> </table> Web Frontend for Web Services and Business Objects 53

54 Generated templates Editing templates Calling the Java method with type-specific parameters (corresponding sections generated for each method) <wtonreceivescript> if ( WT_POSTED.STOCKINFO_readCompanyInfo) { try { WT_SYSTEM.Java_0["STOCKINFO"].ret_STOCKINFO_readCompanyInfo = Java_0.readCompanyInfo( WT_POSTED.p0_STOCKINFO_readCompanyInfo, WT_SYSTEM.Java_0.StringHolder_STOCKINFO_readCompanyInfo, WT_SYSTEM.Java_0.StringHolder_STOCKINFO_readCompanyInfo_1); } catch ( exc ) { WT_System.Java_0["STOCKINFO"].ret_STOCKINFO_readCompanyInfo = exc;} exitreceiveprocessing(); } </wtonreceivescript> </wtcblock> </div> </wtclistitem> <! > <!-- end of list item --> <! > </wtclist> End of the template: activating the tab sheets <! > <!-- end of list of tabs --> <! > </span> <script language="javascript" type="text/javascript"> <wtcpar name="objectname">componenttabs</wtcpar>.adjust(); <wtcpar name="objectname">componenttabs</wtcpar>.redefinefocus(); <wtcpar name="objectname">componenttabs</wtcpar>.activate(##wt_posted['wtctabs_<wtcpar name="ident">comptabs</wtcpar>_activetab'] 0#); </script> </wtc> <! > <!-- end of service operations section --> <! > </form> </body> <wtif (Java_0_system.EPILOG)> <wtinclude Name="##Java_0_system.EPILOG#"> </wtif> </html> 54 Web Frontend for Web Services and Business Objects

55 Editing templates Generated templates Business object integration via SOAP The text below shows the wtopenseas_k3_datentypen.htm template, generated in section BizTransactions with SOAP integration on page 21. Generation options <html> <wtrem>************************************************************************</wtrem> <wtrem>** WTML document: de.siemens.bizta.beans.k3_datentypen.k3_datentypen **</wtrem> <wtrem>************************************************************************</wtrem> <wtrem>** **</wtrem> <wtrem>** Document generation based on Master Template : **</wtrem> <wtrem>** C:\Programme\WebTransactionsV7\weblab\WSDL.wmt **</wtrem> <wtrem>** **</wtrem> <wtrem>** Generated at Mon Jan 10 15:52: **</wtrem> <wtrem>** **</wtrem> <wtrem>** Options used by the generator : **</wtrem> <wtrem>** - %OPTIONS: **</wtrem> <wtrem>** CommObj = WSDL_0 **</wtrem> <wtrem>** Source = wsdl/k3_datentypen.wsdl **</wtrem> <wtrem>************************************************************************</wtrem> <wtrem>** WebTransactions V7.0 Fujitsu Siemens Computers GmbH, 2005 **</wtrem> <wtrem>************************************************************************</wtrem> Creating a proxy object with WT_SOAP <wtoncreatescript> <!-- include ('wtsoap'); if ( typeof WT_SYSTEM.WSDL_0 == 'undefined' ) WT_SYSTEM.WSDL_0 = new Object(); if ( typeof WT_SYSTEM.WSDL_0["k3_Datentypen"] == 'undefined' ) WT_SYSTEM.WSDL_0["k3_Datentypen"] = new Object(); if ( typeof WT_SYSTEM.WSDL_0["k3_Datentypen"].instance == 'undefined' ) { try { WSDL_0 = WT_SYSTEM.WSDL_0["k3_Datentypen"].instance = new WT_SOAP('wsdl/k3_Datentypen.wsdl'); WSDL_0.proxyObjects = proxyobjects; } catch ( exc ) { document.writeln(exc); WT_SYSTEM.WSDL_0["k3_Datentypen"].ret_value = exc; } } else { WSDL_0 = WT_SYSTEM.WSDL_0["k3_Datentypen"].instance; proxyobjects = WSDL_0.proxyObjects; } Web Frontend for Web Services and Business Objects 55

56 Generated templates Editing templates WSDL_0_system = WT_SYSTEM; //--> </wtoncreatescript> <wtif (WSDL_0_system.PROLOG)> <wtinclude Name="##WSDL_0_system.PROLOG#"> </wtif> HTML header: defining the WebTransactions format <head> <title>webtransactions V7.0 - WebService de.siemens.bizta.beans.k3_datentypen.k3_datentypen</title> ##WT_SYSTEM.CGI.HTTP_USER_AGENT.indexOf( 'MSIE' ) >= 0? '<meta http-equiv="pragma" content="no-cache"/>' : '<meta http-equiv="cache-control" content="no-cache"/>'# <wtif (WT_BROWSER.acceptClass)> <style type="text/css"> input { font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; } input.box { border: 0 solid; padding: 1px 0 1px 0; margin-left: -1px; margin-top: ##WT_BROWSER.marginTop#px; font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; color: #000000; background-color: #FFFFFF; } input.button { font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; border-width: 1pt; margin-left: -1pt; } select { font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; } pre { font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; margin: 0; } </style> </wtif> </head> 56 Web Frontend for Web Services and Business Objects

57 Editing templates Generated templates <body bgcolor="#336666" text="#000000"> <form WebTransactions name="de.siemens.bizta.beans.k3_datentypen.k3_datentypen"> <table cellspacing="1" cellpadding="2"> <tr> <td colspan="3" align="right"> <img src="##wt_system.cgi.script_name#/logo" align="left"/> </tr> <tr> <td> <wtif (WSDL_0_system.FORMTPL)> <wtinclude Name="##WSDL_0_system.FORMTPL#"> </wtif> </tr> Button for general control <tr bgcolor="#99cccc"> <td colspan="3" align="center"> <h2>control</h2> <td align="center"><h3>return to component selection</h3> <td align="center"> <input type="submit" name="control" value="back"/> </tr> </table> General control for accessing the web service <! > <!-- main template control section --> <! > <wtonreceivescript> if (WT_POSTED.Control) { WT_SYSTEM.FORMAT = WT_SYSTEM.PREVIOUS_CONTROL_FORMAT; delete WT_SYSTEM.PREVIOUS_CONTROL_FORMAT; exitreceiveprocessing(); } if (WT_POSTED.SetParameter) { if (WT_POSTED.Proxy) { if (WT_POSTED.ProxyPort) WSDL_0.setProxy(WT_POSTED.Proxy, WT_POSTED.ProxyPort); else WSDL_0.setProxy(WT_POSTED.Proxy); } if (WT_POSTED.ProxyUser) Web Frontend for Web Services and Business Objects 57

58 Generated templates Editing templates { if (WT_POSTED.ProxyPwd) WSDL_0.setProxyAuthorization(WT_POSTED.ProxyUser, WT_POSTED.ProxyPwd); else WSDL_0.setProxyAuthorization(WT_POSTED.ProxyUser); } } </wtonreceivescript> Header for the WSDL service <! > <!-- begin of service operations section --> <! > <wtc name="wtctabs" type="inline" version="7.0"> <wtctitle>tab Control <wtcpar name="objectname">componenttabs</wtcpar></wtctitle> <script language="javascript" src="##wt_system.wwwdocs_virtual#/javascript/wtctabs_browserfunctions.js" type="text/javascript"> </script> <script> <wtcpar name="objectname">componenttabs</wtcpar> = new wtctabs(<wtcpar name="width">950</wtcpar>,<wtcpar name="tabheight">20</wtcpar>,'<wtcpar name="ident">comptabs</wtcpar>',<wtcpar name="foregroundcolor">'#333333'</wtcpar>,<wtcpar name="backgroundcolor">'#dddddd'</wtcpar>,<wtcpar name="bordercolor">'#ffffff'</wtcpar>,<wtcpar name="foregroundcolordimmed">'#999999'</wtcpar>,<wtcpar name="backgroundcolorselecteddimmed">'#cccccc'</wtcpar>,<wtcpar name="bordercolordimmed">'#dddddd'</wtcpar>); </script> <! > <!-- begin of list of tabs --> <! > <wtclist name="tab-list" minlength="1"> <wtctitle>list of Tabs</wtcTitle> Tab sheets for setting HTTP parameters for the service <! > <!-- begin of list item --> <! > <! > <wtclistitem> <script language="javascript" type="text/javascript"> <wtcpar name="objectname">componenttabs</wtcpar>.addtab(<wtcpar name="titlename">'javaservice'</wtcpar>, <wtcpar name="titlewidth">150</wtcpar>); </script> <wtcblock> <wtctitle><wtcpar name="titlename">'javaservice'</wtcpar></wtctitle> <table cellspacing="3" cellpadding="2"> <tr bgcolor="#669999"> 58 Web Frontend for Web Services and Business Objects

59 Editing templates Generated templates <td> further parameters: <td> HTTP parameters: </tr> <tr bgcolor="#99cccc"> <td> <table> <tr> <td>##wt_posted.proxy ' '# <td> </tr> <tr> <td>##wt_posted.proxyport ' '# <td> </tr> <tr> <td>##wt_posted.proxyuser ' '# <td> </tr> <tr> <td> <td> </tr> </TABLE> <td> <TABLE> <tr> <td>proxy: <td><input type="text" name="proxy" size="32"/> </tr> <tr> <td>proxy-port: <td><input type="text" name="proxyport" size="6"/> </tr> <tr> <td>proxy-user: <td><input type="text" name="proxyuser" size="32"/> </tr> <tr> <td>proxy-password: <td><input type="password" name="proxypwd" size="32"/> </tr> </table> <td> <input type="submit" name="setparameter" value="set parameters"/> </tr> Web Frontend for Web Services and Business Objects 59

60 Generated templates Editing templates </table> </wtcblock> </div> </wtclistitem> <! > <!-- end of list item --> <! > There are blocks such as the one shown below for all methods <! > <!-- begin of list item --> <! > <wtclistitem> <script language="javascript" type="text/javascript"> <wtcpar name="objectname">componenttabs</wtcpar>.addtab(<wtcpar name="titlename">'k3_datentypen_methstring'</wtcpar>, <wtcpar name="titlewidth">120</wtcpar>); </script> <wtcblock> <wtctitle><wtcpar name="titlename">'k3_datentypen_methstring'</wtcpar></wtctitle> User interface displaying return information displaying the last parameters specified generating entry fields for the method input parameters button for initiating the method <table cellspacing="3" cellpadding="2"> <tr bgcolor="#669999"> <td> return value: <td> previous parameters: <td> input parameters: <td>&nbsp </tr> Displaying return information <tr bgcolor="#99cccc"> <td> <table> <tr><td>##wt_system.wsdl_0["k3_datentypen"].ret_k3_datentypen_methstring#</td</tr> 60 Web Frontend for Web Services and Business Objects

61 Editing templates Generated templates </table> Displaying the last parameters specified <td> <table bgcolor="#99cccc"> <tr> <td> ##WT_POSTED.p0_k3_Datentypen_methString ' '# </tr> <tr> <td> ##WT_POSTED.p1_k3_Datentypen_methString ' '# </tr> <tr> <td> ##WT_POSTED.p2_k3_Datentypen_methString ' '# </tr> <tr> <td> ##WT_POSTED.p3_k3_Datentypen_methString ' '# </tr> </table> Generating entry fields for the method input parameters <td> <table bgcolor="#99cccc"> <tr> <td>p0: <td><input type="text" name="p0_k3_datentypen_methstring" size="32"/> </tr> <tr> <td>p1: <td><input type="text" name="p1_k3_datentypen_methstring" size="32"/> </tr> <tr> <td>p2: <td><input type="text" name="p2_k3_datentypen_methstring" size="32"/> </tr> <tr> <td>p3: Web Frontend for Web Services and Business Objects 61

62 Generated templates Editing templates <td><input type="text" name="p3_k3_datentypen_methstring" size="32"/> </tr> </table> Button for initiating the method <td> <input type="submit" name="k3_datentypen_methstring" value="execute"/> </tr> </table> Calling the proxy method with type-specific parameters (corresponding sections generated for all methods) <wtonreceivescript> if ( WT_POSTED.k3_Datentypen_methString) { try { WT_SYSTEM.WSDL_0["k3_Datentypen"].ret_k3_Datentypen_methString = WSDL_0.service.JavaService.port.k3_Datentypen.operation.methString( WT_POSTED.p0_k3_Datentypen_methString, proxyobjects.k3_datentypen_methstring_request_p1, proxyobjects.k3_datentypen_methstring_request_p2, proxyobjects.k3_datentypen_methstring_request_p3); } catch ( exc ) { WT_System.WSDL_0["k3_Datentypen"].ret_k3_Datentypen_methString = exc;} exitreceiveprocessing(); } </wtonreceivescript> </wtcblock> </div> </wtclistitem> <! > <!-- end of list item --> <! > 62 Web Frontend for Web Services and Business Objects

63 Editing templates Generated templates End of the template: activating the tab sheets </wtclist> <! > <!-- end of list of tabs --> <! > </span> <script language="javascript" type="text/javascript"> <wtcpar name="objectname">componenttabs</wtcpar>.adjust(); <wtcpar name="objectname">componenttabs</wtcpar>.redefinefocus(); <wtcpar name="objectname">componenttabs</wtcpar>.activate(##wt_posted['wtctabs_<wtcpar name="ident">comptabs</wtcpar>_activetab'] 0#); </script> </wtc> <! > <!-- end of service operations section --> <! > </form> </body> <wtif (WSDL_0_system.EPILOG)> <wtinclude Name="##WSDL_0_system.EPILOG#"> </wtif> </html> Web Frontend for Web Services and Business Objects 63

64 Generated templates Editing templates Using general web services via SOAP integration The text below shows the wtwebservice_babelfishservice.htm template, generated in section General web services with SOAP integration on page 23. Generation options <html> <wtrem>************************************************************************</wtrem> <wtrem>** WTML document: BabelFishService **</wtrem> <wtrem>************************************************************************</wtrem> <wtrem>** **</wtrem> <wtrem>** Document generation based on Master Template : **</wtrem> <wtrem>** C:\Programme\WebTransactionsV7\weblab\WSDL.wmt **</wtrem> <wtrem>** **</wtrem> <wtrem>** Generated at Mon Jan 10 11:06: **</wtrem> <wtrem>** **</wtrem> <wtrem>** Options used by the generator : **</wtrem> <wtrem>** - %OPTIONS: **</wtrem> <wtrem>** CommObj = WSDL_0 **</wtrem> <wtrem>** Source = wsdl/babelfishservice.wsdl **</wtrem> <wtrem>************************************************************************</wtrem> <wtrem>** WebTransactions V7.0 Fujitsu Siemens Computers GmbH, 2005 **</wtrem> <wtrem>************************************************************************</wtrem> Creating a proxy object with WT_SOAP <wtoncreatescript> <!-- include ('wtsoap'); if ( typeof WT_SYSTEM.WSDL_0 == 'undefined' ) WT_SYSTEM.WSDL_0 = new Object(); if ( typeof WT_SYSTEM.WSDL_0["BabelFishService"] == 'undefined' ) WT_SYSTEM.WSDL_0["BabelFishService"] = new Object(); if ( typeof WT_SYSTEM.WSDL_0["BabelFishService"].instance == 'undefined' ) { try { WSDL_0 = WT_SYSTEM.WSDL_0["BabelFishService"].instance = new WT_SOAP('wsdl/BabelFishService.wsdl'); WSDL_0.proxyObjects = proxyobjects; } catch ( exc ) { document.writeln(exc); WT_SYSTEM.WSDL_0["BabelFishService"].ret_value = exc; } } else { WSDL_0 = WT_SYSTEM.WSDL_0["BabelFishService"].instance; proxyobjects = WSDL_0.proxyObjects; 64 Web Frontend for Web Services and Business Objects

65 Editing templates Generated templates } WSDL_0_system = WT_SYSTEM; //--> </wtoncreatescript> <wtif (WSDL_0_system.PROLOG)> <wtinclude Name="##WSDL_0_system.PROLOG#"> </wtif> HTML header: defining the WebTransactions format <head> <title>webtransactions V7.0 - WebService BabelFishService</title> ##WT_SYSTEM.CGI.HTTP_USER_AGENT.indexOf( 'MSIE' ) >= 0? '<meta http-equiv="pragma" content="no-cache"/>' : '<meta http-equiv="cache-control" content="no-cache"/>'# <wtif (WT_BROWSER.acceptClass)> <style type="text/css"> input { font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; } input.box { border: 0 solid; padding: 1px 0 1px 0; margin-left: -1px; margin-top: ##WT_BROWSER.marginTop#px; font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; color: #000000; background-color: #FFFFFF; } input.button { font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; border-width: 1pt; margin-left: -1pt; } select { font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; } pre { font-size: ##WT_BROWSER.charSize#px; font-family: courier new, monospace; margin: 0; } </style> </wtif> </head> <body bgcolor="#336666" text="#000000"> Web Frontend for Web Services and Business Objects 65

66 Generated templates Editing templates <form WebTransactions name="babelfishservice"> <table cellspacing="1" cellpadding="2"> <tr> <td colspan="3" align="right"> <img src="##wt_system.cgi.script_name#/logo" align="left"/> </tr> <tr> <td> <wtif (WSDL_0_system.FORMTPL)> <wtinclude Name="##WSDL_0_system.FORMTPL#"> </wtif> </tr> Button for general control <tr bgcolor="#99cccc"> <td colspan="3" align="center"> <h2>control</h2> <td align="center"><h3>return to component selection</h3> <td align="center"> <input type="submit" name="control" value="back"/> </tr> </table> General control <! > <!-- main template control section --> <! > <wtonreceivescript> if (WT_POSTED.Control) { WT_SYSTEM.FORMAT = WT_SYSTEM.PREVIOUS_CONTROL_FORMAT; delete WT_SYSTEM.PREVIOUS_CONTROL_FORMAT; exitreceiveprocessing(); } if (WT_POSTED.SetParameter) { if (WT_POSTED.Proxy) { if (WT_POSTED.ProxyPort) WSDL_0.setProxy(WT_POSTED.Proxy, WT_POSTED.ProxyPort); else WSDL_0.setProxy(WT_POSTED.Proxy); } if (WT_POSTED.ProxyUser) { 66 Web Frontend for Web Services and Business Objects

67 Editing templates Generated templates if (WT_POSTED.ProxyPwd) WSDL_0.setProxyAuthorization(WT_POSTED.ProxyUser, WT_POSTED.ProxyPwd); else WSDL_0.setProxyAuthorization(WT_POSTED.ProxyUser); } } </wtonreceivescript> web service header <! > <!-- begin of service operations section --> <! > <wtc name="wtctabs" type="inline" version="7.0"> <wtctitle>tab Control <wtcpar name="objectname">componenttabs</wtcpar></wtctitle> <script language="javascript" src="##wt_system.wwwdocs_virtual#/javascript/wtctabs_browserfunctions.js" type="text/javascript"> </script> <script> <wtcpar name="objectname">componenttabs</wtcpar> = new wtctabs(<wtcpar name="width">950</wtcpar>,<wtcpar name="tabheight">20</wtcpar>,'<wtcpar name="ident">comptabs</wtcpar>',<wtcpar name="foregroundcolor">'#333333'</wtcpar>,<wtcpar name="backgroundcolor">'#dddddd'</wtcpar>,<wtcpar name="bordercolor">'#ffffff'</wtcpar>,<wtcpar name="foregroundcolordimmed">'#999999'</wtcpar>,<wtcpar name="backgroundcolorselecteddimmed">'#cccccc'</wtcpar>,<wtcpar name="bordercolordimmed">'#dddddd'</wtcpar>); </script> <! > <!-- begin of list of tabs --> <! > <wtclist name="tab-list" minlength="1"> <wtctitle>list of Tabs</wtcTitle> Web Frontend for Web Services and Business Objects 67

68 Generated templates Editing templates Tab sheets for controlling access via HTTP <! > <!-- begin of list item --> <! > <wtclistitem> <script language="javascript" type="text/javascript"> <wtcpar name="objectname">componenttabs</wtcpar>.addtab(<wtcpar name="titlename">'babelfishservice'</wtcpar>, <wtcpar name="titlewidth">150</wtcpar>); </script> <wtcblock> <wtctitle><wtcpar name="titlename">'babelfishservice'</wtcpar></wtctitle> <table cellspacing="3" cellpadding="2"> <tr bgcolor="#669999"> <td> further parameters: <td> HTTP parameters: </tr> <tr bgcolor="#99cccc"> <td> <table> <tr> <td>##wt_posted.proxy ' '# <td> </tr> <tr> <td>##wt_posted.proxyport ' '# <td> </tr> <tr> <td>##wt_posted.proxyuser ' '# <td> </tr> <tr> <td> <td> </tr> </TABLE> <td> <TABLE> <tr> <td>proxy: <td><input type="text" name="proxy" size="32"/> </tr> <tr> <td>proxy-port: <td><input type="text" name="proxyport" size="6"/> </tr> <tr> 68 Web Frontend for Web Services and Business Objects

69 Editing templates Generated templates <td>proxy-user: <td><input type="text" name="proxyuser" size="32"/> </tr> <tr> <td>proxy-password: <td><input type="password" name="proxypwd" size="32"/> </tr> </table> <td> <input type="submit" name="setparameter" value="set parameters"/> </tr> </table> </wtcblock> </div> </wtclistitem> <! > <!-- end of list item --> <! > There are blocks such as the one shown below for each method <! > <!-- begin of list item --> <! > <wtclistitem> <script language="javascript" type="text/javascript"> <wtcpar name="objectname">componenttabs</wtcpar>.addtab(<wtcpar name="titlename">'babelfishporttype_babelfish'</wtcpar>, <wtcpar name="titlewidth">120</wtcpar>); </script> <wtcblock> <wtctitle><wtcpar name="titlename">'babelfishporttype_babelfish'</wtcpar></wtctitle> Web Frontend for Web Services and Business Objects 69

70 Generated templates Editing templates User interface displaying return information displaying the last parameters specified generating entry fields for the method input parameters button for initiating the method <table cellspacing="3" cellpadding="2"> <tr bgcolor="#669999"> <td> return value: <td> previous parameters: <td> input parameters: <td>&nbsp </tr> Displaying return information <tr bgcolor="#99cccc"> <td> <table> <tr><td>##wt_system.wsdl_0["babelfishservice"].ret_babelfishporttype_babelfish# </tr> </table> Displaying the last parameters specified <td> <table bgcolor="#99cccc"> <tr> <td> ##WT_POSTED.translationmode_BabelFishPortType_BabelFish ' '# </tr> <tr> <td> ##WT_POSTED.sourcedata_BabelFishPortType_BabelFish ' '# </tr> </table> 70 Web Frontend for Web Services and Business Objects

71 Editing templates Generated templates Generating entry fields for the method input parameters <td> <table bgcolor="#99cccc"> <tr> <td>translationmode: <td><input type="text" name="translationmode_babelfishporttype_babelfish" size="32"/> </tr> <tr> <td>sourcedata: <td><input type="text" name="sourcedata_babelfishporttype_babelfish" size="32"/> </tr> </table> Button for initiating the method <td> <input type="submit" name="babelfishporttype_babelfish" value="execute"/> </tr> </table> Calling the proxy method with type-specific parameters (corresponding sections generated for each method) <wtonreceivescript> if ( WT_POSTED.BabelFishPortType_BabelFish) { try { WT_SYSTEM.WSDL_0["BabelFishService"].ret_BabelFishPortType_BabelFish = WSDL_0.service.BabelFishService.port.BabelFishPort.operation.BabelFish( WT_POSTED.translationmode_BabelFishPortType_BabelFish, WT_POSTED.sourcedata_BabelFishPortType_BabelFish); } catch ( exc ) { WT_System.WSDL_0["BabelFishService"].ret_BabelFishPortType_BabelFish = exc;} exitreceiveprocessing(); } </wtonreceivescript> </wtcblock> </div> </wtclistitem> <! > <!-- end of list item --> <! > Web Frontend for Web Services and Business Objects 71

72 Generated templates Editing templates End of the template: activating the tab sheets </wtclist> <! > <!-- end of list of tabs --> <! > </span> <script language="javascript" type="text/javascript"> <wtcpar name="objectname">componenttabs</wtcpar>.adjust(); <wtcpar name="objectname">componenttabs</wtcpar>.redefinefocus(); <wtcpar name="objectname">componenttabs</wtcpar>.activate(##wt_posted['wtctabs_<wtcpar name="ident">comptabs</wtcpar>_activetab'] 0#); </script> </wtc> <! > <!-- end of service operations section --> <! > </form> </body> <wtif (WSDL_0_system.EPILOG)> <wtinclude Name="##WSDL_0_system.EPILOG#"> </wtif> </html> 72 Web Frontend for Web Services and Business Objects

73 7 Communication sharing of Java business objects and WebTransactions An integration of Java business objects generated with BizTransactions, generally uses a separate connection between business object and host application. This procedure can cause problems, if only one user ID is available for each WebTransactions session: the host application can only be connected to either WebTransactions or the business object. With WebTransactions you can run Java business objects via the WebTransactions communication objects. You can assign the communication objects completely to the business objects, or integrate business objects in the current connection during a running WebTransactions dialog. WebTransactions offers this procedure for WebTransactions for OSD and WebTransactions for MVS. In the sections below you find a description of the required business object properties for communication sharing how such a Java business object is called how a business object can utilize the WebTransactions communication object assigned to it. Web Frontend for Web Services and Business Objects 73

74 Defining properties Communication Sharing 7.1 Defining Java business object properties When creating a Java business object to be run via a WebTransactions communication oject, the followng points must be observed (see also the BizTransactions manual Application Integration with Business Objects ): Ê Ê When creating a business object, select the value Business Object or Extern for the Connection property If you want to proceed the dialog with a host application, already started by WebTransactions, make sure the send and receive methods of WebTransactions and the business object interlock. Generally, business object methods must begin with send and end with receive. This procedure is absolutely necessary if you are going to use WebTransactions and Biz- Transactions communication simultaneously. Use this procedure if, for example, you wish to provide additional functions for Automask via business objects during dialog mode. 74 Web Frontend for Web Services and Business Objects

75 Communication Sharing Calling business objects 7.2 Calling Java business objects If you create a Java business object in WTScript, specify via the constant de.siemens.bizta.runtime.biztabasiccommunication.webta, that you want to apply a WebTransactions communication object for the communication with the host application: Example mybo=newwt_java.fsc.app9750.mybo.mybo (WT_JAVA.de.siemens.bizta.runtime.BizTaBasicCommunication.WebTa); If you want to open an new connection to the host application, you must create a communication object. Example newcomm = new WT_Communication ("BOCOMM"); If you want to proceed an existing dialog, apply the communication object used in this dialog. You must assign the communication object which is to be used to the Java business object before calling a business method. This is done with the method attachcommobject(): void attachcommobject (comobject [, mode]) comobject link to a communication object mode mode for controlling the connection (see section Defining the communication mode on page 76) Default value: false Example mybo.attachcommobject (newcomm, false); Now you can call the business methods of Java business objects as usual. If you have specified the Extern option for the Connection property with providing i a business object, you have to indicate a communication server for the business object before calling the first method: var objio = new WT_JAVA.de.siemens.bizta.runtime.BizTaConnection(); MyBO.setCommunicationServer (objio); Web Frontend for Web Services and Business Objects 75

76 Defining a communication mode Communication Sharing 7.3 Defining the communication mode A Java business object can use the assigned WebTransactions communication object in two different ways: The business object itself executes open and close. The business object uses the current WebTransactions connection. Executing open and close within the business object This mode is activated if you omit the mode parameter or set it explicitly to false (default) on calling attachcommobject(). In this case the connection parameters defined in the business object are applied. Open connections on the assigned WebTransactions communication object are disconnected. Using an open WebTransactions connection This mode is activated, if the mode parameter is set to true on calling attachcommobject(). In this case every business object call of open or close is suppressed. The current WebTransactions connection is continued by the business object. 76 Web Frontend for Web Services and Business Objects

77 Communication Sharing Example 7.4 Example for a host application with communication sharing A host application for the administration and display of order numbers will serve as an example. Every order number is displayed as a link. A click on the link opens a popup window with a brief description of the corresponding article. A business object ON is used with the business method getinfoshort to display the brief description. This method has the order number as input parameter and the brief description as output parameter. Every order number has the format A This requires the following link to be programmed in the Automask template: output = hostobject.htmlvalue.replace(/a0\d\d\d\d\d\d/gi, '<a href="javascript:void window.open(\'' + WT_SYSTEM.HREF_ASYNC + '&WT_ASYNC_PAGE=show_oninfo&ON=$&\',\'ONINF\',\'width=400 height=70\')">$&</a>'); Web Frontend for Web Services and Business Objects 77

78 Example Communication Sharing The business object is called in the template show_oninfo.htm: <html> <head> <title>info for ON ##WT_POSTED.ON#</Title> ##WT_BROWSER.is_ie '<META HTTP-EQUIV="Pragma" CONTENT="no-cache">' : '<META HTTP-EQUIV="Cache-Control" CONTENT="no-cache">'# </HEAD> <body bgcolor="#400080" text="#ffffff" style="font-family: Arial"> <wtoncreatescript> <!- // //Java-BO was created with generated template as WT_SYSTEM.Java_0.ON.instance // try { bo = WT_SYSTEM.Java_0.ON.instance; bo.attachcommobject (WT_HOST.active true); WT_SYSTEM.Java_0.ON.ret_ON_getInfoShort = bo.getinfoshort( WT_POSTED.ON, WT_SYSTEM.Java_0.StringHolder_ON_getInfoShort); document.writeln ('\n<b>',wt_posted.on, ': ', WT_SYSTEM.Java_0.StringHolder_ON_getInfoShort.value,'</b>'); } catch ( exc ) { document.writeln (exc); } //--> </wtoncreatescript> </BODY> </HTML> 78 Web Frontend for Web Services and Business Objects

79 Glossary A term in ->italic font means that it is explained somewhere else in the glossary. active dialog In the case of active dialogs, WebTransactions actively intervenes in the control of the dialog sequence, i.e. the next ->template to be processed is determined by the template programming. You can use the ->WTML language tools, for example, to combine multiple ->host formats in a single ->HTML page. In this case, when a host ->dialog step is terminated, no output is sent to the ->browser and the next step is immediately started. Equally, multiple interactions between the Web ->browser and WebTransactions are possible within one and the same host dialog step. array ->Data type which can contain a finite set of values of one data type. This data type can be: ->scalar a ->class an array The values in the array are addressed via a numerical index, starting at 0. asynchronous message In WebTransactions, an asynchronous message is one sent to the terminal without having been explicitly requested by the user, i.e. without the user having pressed a key or clicked on an interface element. attribute Attributes define the properties of ->objects. In WebTransactions, an attribute may be, for example, the color, size or position of an object or it can itself be an object. Attributes are also interpreted as ->variables and their values can be queried or modified. In BizTransactions, an attribute may be a ->property of a ->catalog object or ->catalog element. Web Frontend for Web Services and Business Objects 79

80 Glossary Automask template A WebTransactions ->template created by WebLab either implicitly when generating a base directory or explicitly with the command Generate Automask. It is used whenever no format-specific template can be identified. An Automask template contains the statements required for dynamically mapping formats and for communication. Different variants of the Automask template can be generated and selected using the system object attribute AUTOMASK. base directory The base directory is located on the WebTransactions server and forms the basis for a ->WebTransactions application. The base directory contains the ->templates and all the files and program references (links) which are necessary in order to run a WebTransactions application. BCAM application name Corresponds to the openutm generation parameter BCAMAPPL and is the name of the >openutm application through which >UPIC establishes the connection. BizTransactions application Application, which integrates -> host applications for COM or Java access. A BizTransactions application consists of: ->host adapters ->business objects a ->client, which addresses the business objects BizTransactions catalog Central database used and processed by the BizTransactions Studio during the development phase. For instance, the BizTransactions catalog contains a description of the ->host applications and of the messages (->services) exchanged with the host application. browser Program which is required to call and display ->HTML pages. Familiar browsers include, for example, Netscape Navigator or Microsoft Internet Explorer. browser display print The WebTransactions browser display print prints the information displayed in the ->browser. browser platform Operating system of the host on which a ->browser runs as a client for WebTransactions. 80 Web Frontend for Web Services and Business Objects

81 Glossary buffer Definition of a record, which is transmitted from a ->service. The buffer is used for transmitting and receiving messages. In addition there is a specific buffer for storing the ->recognition criteria and for data for the representation on the screen. business object (BO) Object-oriented view of a ->host application: Business Objects in BizTransactions combine a number of ->services of an application to form a logical object. A description of each business object is stored in the ->BizTransactions catalog. This description then forms the basis for generating an ActiveX component,.net component or ->JavaBean which then represents the business object. business object class Java,.NET or Visual Basic class generated by the BizTransactions Studio on the basis of a business object stored in the ->BizTransactions catalog. capturing To enable WebTransactions to identify the received ->formats at runtime, you can open a ->session in ->WebLab and select a specific area for each format and name the format. The format name and ->recognition criteria are stored in the ->capture database. A ->template of the same name is generated for the format. Capturing forms the basis for the processing of format-specific templates for the WebTransactions for OSD, MVS, As400 and UNIX product variants. capture database The WebTransactions capture database contains all the format names and the associated ->recognition criteria generated using the ->capturing technique. You can use ->WebLab to edit the sequence and recognition criteria of the formats. catalog element Subordinate ->catalog objects in BizTransactions, such as ->buffers, ->records or ->fields. The ->properties of catalog elements are ->attributes. catalog object Descriptions saved in the ->BizTransactions catalog for ->Host applications ->Services ->Business objects ->Classes ->Functions ->Catalog-elements are subordinate to the catalog-objects. The ->properties of catalog objects and elements are ->attributes. A separate ->XML schema is assigned to each catalog object. Web Frontend for Web Services and Business Objects 81

82 Glossary CGI class (Common Gateway Interface) Standardized interface for program calls on ->Web servers. In contrast to the static output of a previously defined->html page, this interface permits the dynamic construction of HTML pages. Contains definitions of the ->properties and ->methods of an ->object. It provides the model for instantiating objects and defines their interfaces. In BizTransactions the ->catalog object of the type class contains only properties which means that a class is also considered as a user-defined data structure. Access methods for the class properties are added through generation. A class can be used by the following catalog elements: Properties of ->business objects Properties of other classes ->Method parameters ->Function parameters class directory A directory in BizTransactions which contains the generated ->business object classes and ->service classes. class template In WebTransactions, a class template contains valid, recurring statements for the entire object class (e.g. input or output fields). Class templates are processed when the ->evaluation operator or the tostring method is applied to a ->host data object. client cluster COM Requestors and users of services in a network. A BizTransactions client accesses ->business objects within a ->client application. Set of identical ->WebTransactions applications on different servers which are interconnected to form a load-sharing network. Component Object Model. The COM defines a standard governing the way in which software components can access the services or data provided by other software components. 82 Web Frontend for Web Services and Business Objects

83 Glossary communication object This controls the connection to an ->host application and contains information about the current status of the connection, the last data to be received etc. conversion tools Utilities supplied with WebTransactions and BizTransactions. These tools are used to analyze the data structures of ->openutm applications and store the information in files. These files can then be imported in the form of an object description into the ->BizTransactions catalog or used in WebLab as ->format description sources in order to generate WTML templates and ->FLD files. COBOL data structures or IFG format libraries form the basis for the conversion tools. The conversion tool for DRIVE programs is supplied with the product DRIVE. daemon Name of a process type in UNIX/POSIX systems which runs in the background and performs no I/O operations at terminals. data access control Monitoring of the accesses to data and ->objects of an application. data type DCOM Definition of the way in which the contents of a storage location are to be interpreted. Each data type has a name, a set of permitted values (value range), and a defined number of operations which interpret and manipulate the values of that data type. Distributed Component Object Model This is based on the ->COM standard and defines the way in which COM objects can provide their services or data outside system boundaries. Web Frontend for Web Services and Business Objects 83

84 Glossary dialog In WebTransactions, a dialog describes the entire communication between browser, WebTransactions and ->host application. It will usually comprise multiple ->dialog cycles. WebTransactions supports a number of different types of dialog. ->passive dialog ->active dialog ->synchronized dialog ->non-synchronized dialog In BizTransactions a dialog is defined as a series of ->dialog steps. A method of a ->Business Object is the same as a dialog with the ->host application. dialog cycle Cycle that comprises the following steps when a ->WebTransactions application is executed: construct an ->HTML page and send it to the ->browser wait for a response from the browser evaluate the response fields and possibly send them to the->host application for further processing A number of dialog cycles are passed through while a ->WebTransactions application is executing. dialog step In BizTransactions, a dialog step begins by sending a dialog message to the ->host application, and ends with a response from the host application. distinguished name The Distinguished Name (DN) in ->LDAP is hierarchically organized and consists of a number of different components (e.g. country, and below country: organization, and below organization: organizational unit, followed by: usual name ). Together, these components provide a unique identification of an object in the directory tree. Thanks to this hierarchy, the unique identification of objects is a simple matter even in a worldwide directory tree: The DN "Country=DE/Name=Emil Person" reduces the problem of achieving a unique identification to the country DE (=Germany). The DN "Organization=FSC/Name=Emil Person" reduces it to the organization FSC. The DN "Country=DE/Organization=FSC/Name=Emil Person" reduces it to the organization FSC located in Germany (DE). 84 Web Frontend for Web Services and Business Objects

85 Glossary document directory ->Web server directory containing the documents that can be accessed via the network. WebTransactions stores files for download in this directory, e.g. the WebLab client or general start pages. Domain Name Service (DNS) Procedure for the symbolic addressing of computers in networks. Certain computers in the network, the DNS or name server, maintain a database containing all the known host names and IP numbers in their environment. dynamic data In WebTransactions, dynamic data is mapped using the WebTransactions object model, e.g. as a ->system object, host object or user input at the browser. EHLLAPI EJB Enhanced High-Level Language API Program interface, e.g. of terminal emulations for communication with the SNA world. Communication between the transit client and SNA computer, which is handled via the TRANSIT product, is based on this interface. (Enterprise JavaBean) This is a Java-based industry standard which makes it possible to use in-house or commercially available server components for the creation of distributed program systems within a distributed, object-oriented environment. entry page The entry page is an ->HTML page which is required in order to start a ->WebTransactions application This page contains the call which starts WebTransactions with the first ->template, the so-called start template. evaluation operator In WebTransactions the evaluation operator replaces the addressed ->expressions with their result (object attribute evaluation). The evaluation operator is specified in the form ##expression#. expression A combination of ->literals, ->variables, operators and expressions which return a specific result when evaluated. FHS Format Handling System Formatting system for BS2000/OSD applications. Web Frontend for Web Services and Business Objects 85

86 Glossary field A field is the smallest component of a service and element of a ->record or ->buffer. field file (*.fld file) In WebTransactions, this contains the structure of a ->format record (metadata). filter format Program or program unit (e.g. a library) for converting a given ->format into another format (e.g. XML documents to ->WTScript data structures). Optical presentation on alphanumeric screens (sometimes also referred to as screen form or mask). In WebTransactions each format is represented by a ->field file and a ->template. format type (only relevant in the case of ->FHS applications and communication via ->UPIC) Specifies the type of format: #format, +format, -format or *format. format description sources Description of multiple ->formats in one or more files which were generated from a format library (FHS/IFG) or are available directly at the ->host for the use of expressive names in formats. function A function is a user-defined code unit with a name and ->parameters. Functions can be called in ->methods by means of a description of the function interface (or signature). holder task A process, a task or a thread in WebTransactions depending on the operating system platform being used. The number of tasks corresponds to the number of users. The task is terminated when the user logs off or when a time-out occurs. A holder task is identical to a ->WebTransactions session. host The computer on which the- >host application is running. 86 Web Frontend for Web Services and Business Objects

87 Glossary host adapter Host adapters are used to connect existing ->host applications to WebTransactions and BizTransactions. At runtime, for example, they have the task of establishing and terminating connections and converting all the exchanged data. host application Application that is integrated with WebTransactions or BizTransactions. host control object In WebTransactions, host control objects contain information which relates not to individual fields but to the entire ->format. This includes, for example, the field in which the cursor is located, the current function key or global format attributes. host data object In WebTransactions, this refers to an ->object of the data interface to the ->host application. It represents a field with all its field attributes. It is created by WebTransactions after the reception of host application data and exists until the next data is received or until termination of the ->session. host data print During WebTransactions host data print, information is printed that was edited and sent by the ->host application, e.g. printout of host files. host platform Operating system of the host on which the ->host applications runs. HTML HTTP HTTPS hypertext (Hypertext Markup Language) see ->Hypertext Markup Language (Hypertext Transfer Protocol) This is the protocol used to transfer ->HTML pages and data. (Hypertext Transfer Protocol Secure) This is the protocol used for the secure transfer of ->HTML pages and data. Document with links to other locations in the same or another document. Users click the links to jump to these new locations. Web Frontend for Web Services and Business Objects 87

88 Glossary Hypertext Markup Language (Hypertext Markup Language) Standardized markup language for documents on the Web. Java Bean Java programs (or ->classes) with precisely defined conventions for interfaces that allow them to be reused in different applications. KDCDEF LDAP literal openutm tool for generating ->openutm applications. (Lightweight Directory Access Protocol) The X.500 standard defines DAP (Directory Access Protocol) as the access protocol. However, the Internet standard LDAP has proved successful specifically for accessing X.500 directory services from a PC. LDAP is a simplified DAP protocol that does not support all the options available with DAP and is not compatible with DAP. Practically all X.500 directory services support both DAP and LDAP. In practice, interpretation problems may arise since there are various dialects of LDAP. The differences between the dialects are generally small. Character sequence that represents a fixed value. Literals are used in source programs to specify constant values ( literal values). master template WebTransactions template used to generate the Automask and the formatspecific templates. message queuing (MQ) A form of communication in which messages are not exchanged directly, rather via intermediate queues. The sender and receiver can work at separate times and locations. Message transmission is guaranteed regardless of whether or not a network connection currently exists. method Object-oriented term for a ->function. A method is applied to the ->object in which it is defined. In BizTransactions, the method of a ->business object conducts a ->dialog with the associated ->host application. 88 Web Frontend for Web Services and Business Objects

89 Glossary module template In WebTransactions, a module template is used to define ->classes, ->functions and constants globally for a complete ->session. A module template is loaded using the import() function. MT tag (Master Template tag) Special tags used in the dynamic sections of ->master templates. multitier architecture All client/server architectures are based on a subdivision into individual software components which are also known as layers or tiers. We speak of 1-tier, 2-tier, 3-tier and multitier models. This subdivision can be considered at the physical or logical level: We speak of logical software tiers when the software is subdivided into modular components with clear interfaces. Physical tiers occur when the (logical) software components are distributed across different computers in the network. With WebTransactions and a host connection in BizTransactions, multitier models are possible both at the physical and logical level. name/value pair In the data sent by the ->browser, the combination, for example, of an ->HTML input field name and its value. non-synchronized dialog Non-synchronized dialogs in WebTransactions permit the temporary deactivation of the checking mechanism implemented in ->synchronized dialogs. In this way, ->dialogs that do not form part of the synchronized dialog and have no effect on the logical state of the ->host application can be incorporated. In this way, for example, you can display a button in an ->HTML page that allows users to call help information from the current host application and display it in a separate window. Web Frontend for Web Services and Business Objects 89

90 Glossary object Elementary unit in an object-oriented software system. Every object possesses a name via which it can be addressed, ->attributes, which define its status together with the ->methods that can be applied to the object. In BizTransactions objects only exist as instances of ->classes during run time. However, for simplicity s sake, the object definitions created during development are also referred to as objects. Thus, we speak of, for example, ->business objects stored in the ->BizTransactions catalog although these are actually only definitions. These definitions are used by BizTransactions to generate ->business object classes which serve to instantiate the actual business objects at runtime. openutm (Universal Transaction Monitor) Transaction monitor from Fujitsu Siemens Computers, which is available for BS2000/OSD and a variety of UNIX and Windows platforms. openutm application A ->host application which provides services that process jobs submitted by ->clients or other ->host applications. openutm responsibilities include transaction management and the management of communication and system resources. Technically speaking, the UTM application is a group of processes which form a logical unit at runtime. openutm applications can communicate both via the client/server protocol ->UPIC and via the emulation interface (9750). openutm-client (UPIC) The openutm-client (UPIC) is a product used to create client programs for openutm. openutm-client (UPIC) is available, for example, for UNIX, BS2000/OSD and Windows platforms. openutm program unit The services of an ->openutm application are implemented by one or more openutm program units. These can be addressed using transaction codes and contain special openutm function calls (e.g. KDCS calls). parameter Data which is passed to a ->function or a ->method for processing (input parameter) or data which is returned as a result of a function or method (output parameter). 90 Web Frontend for Web Services and Business Objects

91 Glossary passive dialog In the case of passive dialogs in WebTransactions, the dialog sequence is controlled by the ->host application, i.e. the host application determines the next ->template which is to be processed. Users who access the host application via WebTransactions pass through the same dialog steps as if they were accessing it from a terminal. WebTransactions uses passive dialog control for the automatic conversion of the host application or when each host application format corresponds to precisely one individual template. password String entered for a ->user id in an application which is used for user authentication (->system access control). polling pool post Cyclical querying of a given event. In WebTransactions, this term refers to a shared directory in which WebLab can create and maintain ->base directories. You control access to this directory with the administration program. To send data. posted object (wt_posted) List of the data returned by the ->browser. This ->object is created by WebTransactions and exists for the duration of a ->dialog cycle. process project property The term process is used as a generic term for process (in Solaris, Linux and Windows) and task (in BS2000/OSD). In the WebTransactions development environment, a project contains various settings for a ->WebTransactions application. These are saved in a project file (suffix.wtp). You should create a project for each WebTransactions application you develop, and always open this project for editing. Properties define the nature of an ->object, e.g. the object Customer could have a customer name and number as its properties. These properties can be set, queried, and modified within the program. Web Frontend for Web Services and Business Objects 91

92 Glossary protocol Agreements on the procedural rules and formats governing communications between remote partners of the same logical level. protocol file BizTransactions: Messages about specific program status conditions are written during the program execution into a log file. openutm-client: File into which the openutm error messages as are written in the case of abnormal termination of a conversation. In WebTransactions, protocol files are called trace files. roaming session ->WebTransactions sessions which are invoked simultaneously or one after another by different ->clients. record A record is the definition of a set of related data which is transferred to a ->buffer. It describes a part of the buffer which may occur one or more times. recognition criteria Recognition criteria are used to identify ->formats of a ->terminal application and can access the data of the format. The recognition criteria selected should be one or more areas of the format which uniquely identify the content of the format. scalar ->variable made up of a single value, unlike a ->class, an ->array or another complex data structure. 92 Web Frontend for Web Services and Business Objects

93 Glossary service In BizTransactions, services are messages exchanged with the ->host application. In the case of access via the terminal interface (9750/3270), they are ->formats. In program-to-program communication, they correspond to message structures. Services are created using the BizTransactions Studio. They are automatically entered in the ->BizTransactions catalog and can be used by the (COM) ->clients. Depending on the type of server application, a service may represent: a 9750 emulation screen a 3270 emulation screen an openutm ->dialog step (in the case of interconnection via UPIC) which is distinguished by: the FHS format the data structure of a DRIVE procedure the data structure of a COBOL program (structure of the UPIC message buffer) a message sent or received by the ->host adapter service (openutm) In ->openutm, this is the processing of a request using an ->openutm application. There are dialog services and asynchronous services. The services are assigned their own storage areas by openutm. A service is made up of one or more ->transactions. service application ->WebTransactions session which can be called by various different users in turn. service data description of a ->service in the BizTransactions catalog. The service data contain a description of the structure of the service and either a ->recognition criterion or data for the presentation of the service while recording a ->dialog service node Instance of a ->service. During development and runtime of a ->method a service can be instantiated several times. During modelling and code editing those instances are named service nodes. Web Frontend for Web Services and Business Objects 93

94 Glossary session SOAP style When an end user starts to work with a ->WebTransactions application this opens a WebTransactions session for that user on the WebTransactions server. This session contains all the connections open for this user to the ->browsers, special ->clients and ->hosts. A session can be started as follows: Input of a WebTransactions URL in the browser. Using the START_SESSION method of the WT_REMOTE client/server interface. A session is terminated as follows: The user makes the corresponding input in the output area of this ->WebTransactions application (not via the standard browser buttons). Whenever the configured time that WebTransactions waits for a response from the ->host application or from the ->browser is exceeded. Termination from WebTransactions administration. Using the EXIT_SESSION method of the WT_REMOTE client/server interface. A WebTransactions session is unique and is defined by a ->WebTransactions application and a session ID. During the life cycle of a session there is one ->holder task for each WebTransactions session on the WebTransactions server. (originally Simple Object Access Protocol) The ->XML based SOAP protocol provides a simple, transparent mechanism for exchanging structured and typecast information between computers in a decentralized, distributed environment. SOAP provides a modular package model together with mechanisms for data encryption within modules. This enables the uncomplicated description of the internal interfaces of a ->Web-Service. In WebTransactions this produces a different layout for a ->template, e.g. with more or less graphic elements for different->browsers. The style can be changed at any time during a ->session. synchronized dialog In the case of synchronized dialogs (normal case), WebTransactions automatically checks whether the data received from the web browser is genuinely a response to the last ->HTML page to be sent to the ->browser. For example, if the user at the web browser uses the Back button or the History function to return to an earlier HTML page of the current ->session and then returns this, WebTransactions recognizes that the data does not correspond to the current ->dialog cycle and reacts with an error message. The last page to have been sent to the browser is then automatically sent to it again. 94 Web Frontend for Web Services and Business Objects

95 Glossary system access control Check to establish whether a user under a particular ->user ID is authorized to work with the application. system object (wt_system) The WebTransactions system object contains ->variables which continue to exist for the duration of an entire ->session and are not cleared until the end of the session or until they are explicitly deleted. The system object is always visible and is identical for all name spaces. TAC tag TCP/IP See ->transaction code ->HTML, ->XML and ->WTML documents are all made up of tags and actual content. The tags are used to mark up the documents e.g. with header formats, text highlighting formats (bold, italics) or to give source information for graphics files. (Transport Control Protocol/Internet Protocol) Collective name for a protocol family in computer networks used, for example, in the Internet. Web Frontend for Web Services and Business Objects 95

96 Glossary template A template is used to generate specific code. A template contains fixed information parts which are adopted unchanged during generation, as well as variable information parts that can be replaced by the appropriate values during generation. In WebTransactions, a ->WTML file is a file with special tags for controlling the dynamic generation of a ->HTML page and for the processing of the values entered at the ->browser. It is possible to maintain multiple template sets in parallel. These then represent different ->styles (e.g. many/few graphics, use of Java, etc.). WebTransactions uses different types of template: ->Automask templates for the automatic conversion of the ->formats of AS400, MVS, OSD and UNIX applications. Custom templates, written by the programmer, for example, to control an ->active dialog. Format-specific templates which are generated for subsequent postprocessing. Include templates which are inserted in other templates. ->Class templates ->Master templates to ensure the uniform layout of fixed areas on the generation of the Automask and format-specific templates. Start template, this is the first template to be processed in a WebTransactions application. In BizTransactions, templates are supplied files which contain code sections that can be used as patterns for the generation functions of BizTransactions. template object ->Variables are used to buffer values for a ->dialog cycle in WebTransactions. terminal application Application on a ->host computer which is accessed via a 9750 or 3270 interface. terminal hardcopy print A terminal hardcopy print in WebTransactions prints the alphanumeric representation of the ->format as displayed by a terminal or a terminal emulation. transaction Processing step between two synchronization points (in the current operation) which is characterized by the ACID conditions (Atomicity, Consistency, Isolation and Durability). The intentional changes to user information made within a transaction are accepted either in their entirety or not at all (all-or-nothing rule). 96 Web Frontend for Web Services and Business Objects

97 Glossary transaction code/tac Name under which an openutm service or ->openutm program unit can be called. The transaction code is assigned to the openutm program unit during configuration. A program unit can be assigned several transaction codes. UDDI UPIC URI URL user exit user ID UTM variable (Universal Description, Discovery and Integration) Refers to directories containing descriptions of ->Web services. This information is available to web users in general. (Universal Programming Interface for Communication) Carrier system for openutm clients which uses the X/Open interface, which permity CPI-C client/server communication between a CPI-C-Client application and the openutm application. (Uniform Resource Identifier) Blanket term for all the names and addresses that reference objects on the Internet. The generally used URIs are->urls. (Uniform Resource Locator) Description of the location and access type of a resource in the ->Internet. Functions implemented in C/C++ which the programmer calls from a ->template. User identification which can be assigned a password (->system access control) and special access rights (->data access control). See ->openutm Memory location for variable values which requires a name and a ->data type. visibility of variables ->Objects and ->variables of different dialog types are managed by WebTransactions in different address spaces. This means that variables belonging to a ->synchronized dialog are not visible and therefore not accessible in a ->asynchronous dialog or in a dialog with a remote application. Web Frontend for Web Services and Business Objects 97

98 Glossary web server Computer and software for the provision of ->HTML pages and dynamic data via ->HTTP. web service Service provided on the Internet, for example a currency conversion program. The SOAP protocol can be used to access such a service. The interface of a web service is described in ->WSDL. WebTransactions application This is an application that is integrated with ->host applications for internet/ intranet access. A WebTransactions application consists of: a ->base directory a start template the ->templates that control conversion between the ->host and the ->browser. protocol-specific configuration files. WebTransactions platform Operating system of the host on which WebTransactions runs. WebTransactions server Computer on which WebTransactions runs. WebTransactions session See ->session WSDL WTBean (Web Service Definition Language) Provides ->XML language rules for the description of ->web services. In this case, the web service is defined by means of the port selection. In WebTransactions ->WTML components with a self-descriptive interface are referred to as WTBeans. A distinction is made between inline and standalone WTBeans: An inline WTBean corresponds to a part of a WTML document A standalone WTBean is an autonomous WTML document A number of WTBeans are included in of the WebTransactions product, additional WTBeans can be downloaded from the WebTransactions homepage ( 98 Web Frontend for Web Services and Business Objects

99 Glossary WTML (WebTransactions Markup Language) Markup and programming language for WebTransactions ->templates. WTML uses additional ->WTML tags to extend ->HTML and the server programming language ->WTScript, e.g. for data exchange with ->host applications. WTML tags are executed by WebTransactions and not by the ->browser (serverside scripting). WTML tag (WebTransactions Markup Language-Tag) Special WebTransactions tags for the generation of the dynamic sections of an ->HTML page using data from the->host application. WTScript XML Serverside programming language of WebTransactions. WTScripts are similiar to client-side Java scripts in that they are contained in sections that are introduced and terminated with special tags. Instead of using ->HTML-SCRIPT tags you use ->WTML-Tags: wtoncreatescript and wtonreceivescript. This indicates that these scripts are to be implemented by WebTransactions and not by the ->browser and also indicates the time of execution. OnCreate scripts are executed before the page is sent to the browser. OnReceive scripts are executed when the response has been received from the browser. (extensible Markup Language) Defines a language for the logical structuring of documents with the aim of making these easy to exchange between various applications. XML schema An XML schema basically defines the permissible elements and attributes of an XML description. XML schemas can have a range of different formats, e.g. DTD (Document Type Definition), XML Schema (W3C standard) or XDR (XML Data Reduced). In BizTransactions, an XDR schema defines the permitted elements and attributes of a catalog object. Web Frontend for Web Services and Business Objects 99

100 Eine Dokuschablone von Frank Flachenecke

101 Abbreviations BO CGI DN DNS EJB FHS HTML HTTP HTTPS IFG ISAPI LDAP MT tag MVS OSD SGML SOAP SSL Business Object Common Gateway Interface Distinguished Name Domain Name Service Enterprise JavaBean Format Handling System Hypertext Markup Language Hypertext Transfer Protocol Hypertext Transfer Protocol Secure Interactive Format Generator Internet Server Application Programming Interface Lightweight Directory Access Protocol Master Template tag Multiple Virtual Storage Open Systems Direction Standard Generalized Markup Language Simple Object Access Protocol Secure Socket Layer Web Frontend for Web Services and Business Objects 101

102 Abbreviations TCP/IP Upic UDDI URI URL UTM WSDL WTML wtc XML Transport Control Protocol/Internet Protocol Universal Programming Interface for Communication Universal Description, Discovery and Integration Uniform Resource Identifier Uniform Resource Locator Universal Transaction Monitor Web Service Definition Language WebTransactions Markup Language WebTransactions Component extensible Markup Language 102 Web Frontend for Web Services and Business Objects

103 Related publications You can download all the WebTransactions manuals from the following Web address [1] WebTransactions Concepts and Functions Introduction Target group Users who want information on the functional scope and performance of WebTransactions. Contents The manual contains a general description of the concepts behind the product, as well as information on the object concept and the dynamic session procedure. [2] WebTransactions Template Language Reference Manual Target group Users who wish to actively create WebTransactions applications. Contents The manual contains a description of all the language resources in the template language WTML. When you integrate host applications into the Web, this language allows you to adapt the results of automatic conversion to suit your requirements. [3] WebTransactions Connection to OSD Applications User Guide Target group Users who wish to use WebTransactions to connect OSD dialog applications to the Web. Contents The manual describes all the steps required for connecting OSD dialog applications to the Web. It supplements the introductory manual Concepts and Functions and the Reference Manual Template Language by providing all the information relating to OSD. Web Frontend for Web Services and Business Objects 103

104 Related Publications [4] WebTransactions Connection to MVS Applications User Guide Target group Users who wish to use WebTransactions to connect MVS dialog applications to the Web. Contents The manual describes all the steps required for connecting MVS dialog applications to the Web. It supplements the introductory manual Concepts and Functions and the Reference Manual Template Language by providing all the information relating to MVS. [5] WebTransactions Connection to openutm Applications via UPIC User Guide Target group Users who wish to use WebTransactions to connect openutm dialog applications to the Web. Contents The manual describes all the steps required for connecting openutm dialog applications to the Web. It supplements the introductory manual Concepts and Functions and the Reference Manual Template Language by providing all the information relating to openutm. [6] WebTransactions Connection to AS400 Applications User Guide Target group Users who wish to use WebTransactions to connect AS400 dialog applications to the Web. Contents The manual describes all the steps required for connecting AS400 dialog applications to the Web via the 5250 protocol. This manual supplements the introductory manual Concepts and Functions and the reference manual Template Language and provides all the information relating to AS400. [7] WebTransactions Connection to UNIX Applications User Guide Target group Users who wish to use WebTransactions to connect UNIX dialog applications to the Web. Contents The manual describes all the steps required for connecting UNIX-dialog applications to the Web via Telnet or the rlogin protocol. This manual supplements the introductory manual Concepts and Functions and the reference manual Template Language and provides all the information relating to UNIX. 104 Web Frontend for Web Services and Business Objects

105 Related Publications [8] WebTransactions Access to Dynamic Web Contents User Guide Target group Users who wish to use WebTransactions to access dynamic Web contents. Contents The manual describes all the steps required for accessing dynamic web contents via the HTTP protocol. It supplements the introductory manual Concepts and Functions and the Reference Manual Template Language by providing all the information relating to HTTP. [9] WebTransactions Client APIs for WebTransactions User Guide Target group Anyone who wishes to implement Clients for WebTransactions. Contents The manual describes all the interfaces WebTransactions provides developing client programs. You can develop not only your own Java clients with the suppiled classes, but also clients in any programming language which communicate with WebTransactions via the client protocol. WebTransactions itself can function as a client of a WebTransactions application. [10] BizTransactions Application Integration with Business Objects User Guide Target group This manual addresses users wishing to create business objects for accessing host applications in order to develop graphical interfaces for host applications (e.g. via GUIs, created using WebTransactions, Visual Basic, Visual C++, Microfocus NetExpress or Java). make the host application available as a Web service, for example, on the Internet. integrate interactions with host applications into Microsoft Office products (e.g. current data of an openutm mainframe application to Excel tables). Contents This manual describes the concept, functions and components of BizTransactions. It explains all steps required to create business objects and Web services. Web Frontend for Web Services and Business Objects 105

106 Eine Dokuschablone von Frank Flachenecke

107 Index A access objects 35 active dialog 79, 84 architecture web frontend 7 array 79 asynchronous message 79 attribute 79 automask template 80 B base data type 79 base directory 80 converting to a new version 16 creating 15 basic interface general web frontend 13 BCAM application name 80 BCAMAPPL 80 BizTransactions web frontend 30, 31 BizTransactions application 80 BizTransactions catalog 80 BO see business object browser 80 browser display print 80 browser platform 80 buffer 81 business object 81 communication sharing 73 generated as web service 13 generated template via SOAP 45 Java 13 testing template 30 business object as web service flowchart for frontend 27 generated template 18 generating template 21 master template 18 prerequisites for testing 27 web frontend 31 business object class 81 C capture database 81 capturing 81 catalog element 81 catalog object 81 CGI (Common Gateway Interface) 82 class 82 business object 81 directory 82 templates 82 WT_JAVA 36 WT_SOAP 39 client 82 cluster 82 COM 82 communication mode 76 communication object 83 communication sharing with Java business objects 73 complex data types, WT_JAVA 38 concept of the web frontend 13 conversion tools 83 Web Frontend for Web Services and Business Objects 107

108 Index D daemon 83 data dynamic 85 data access control 83 data type 83 complex (WT_JAVA) 38 WT_JAVA 37 WT_SOAP 40 DCOM 83 dialog 84 active 84 non-synchronized 84, 89 passive 84, 91 synchronized 84, 94 types 84 dialog cycle 84 dialog step 84 distinguished name 84 document directory 85 Domain Name Service (DNS) 85 E edit templates 35 EHLLAPI 85 EJB 85 entry page 85 evaluation operator 85 expression 85 F FHS 85 field 86 field file 86 filter 86 fld file 86 flowchart frontend (business object as web service) 27 frontend (Java business object) 26 frontend (web service) 32 format 86 #format 86 *format 86 +format 86 -format 86 format description source 86 format type 86 function 86 G generate template for business objects as web service 21 template for Java business objects 19 template for web services 23 generated template 44 business object (via SOAP) 45 Java business object 45 web service 45 H holder task 86 host 86 host adapter 87 host application 87 host control object 87 host data object 87 host data print 87 host platform 87 HTML 88 HTTP 87 HTTPS 87 hypertext 87 Hypertext Markup Language (HTML) 88 I inline WTBean Web Frontend for Web Services and Business Objects

109 Index J java subdirectory 16 Java Bean 88 Java business object 13 call 75 communication sharing 73 defining a communication mode 76 flowchart for frontend 26 generated template 18, 45 generating template 19 integration via communication objects 73 master template 18 prerequisites for testing 26 web frontend 30 K KDCDEF 88 L LDAP 88 literals 88 M master template 18, 35, 88, 96 JAVA_BO.wmt 19 tag 89 WSDL.wmt 21 message queuing 88 method 88 module template 89 MT tag 44, 89 multitier architecture 89 N name/value pair 89 non-synchronized dialog 84, 89 O object 90 accessing 35 generated as web service 13 Java 13 openutm 90 application 90 Client 90 program unit 90 service 93 operations 83 P parameter 90 passive dialog 84, 91 password 91 polling 91 pool 91 posted object 91 posting 91 prerequisites testing (business object as web service) 27 testing (Java business object) 26 process 91 project 91 property 91 protocol 92 protocol file 92 R recognition criteria 92 record 92 record structure 86 S scalar 92 service 93 service (openutm) 93 service data 93 service node 93 session 94 WebTransactions 94 SOAP 94 SOAP protocol 13 standalone WTBean 98 start template 96 openseas 29 web service 33 style 94 Web Frontend for Web Services and Business Objects 109

110 Index subdirectory java 16 wsdl 16 synchronized dialog 84, 94 system access control 95 system object 95 T TAC 97 tag 95 TCP/IP 95 template 96 class 82 edit 35 generating for business objects as web service 21 generating for Java business objects 19 generating for web services 23 master 96 object 96 start 96 testing for business object 30 testing for web service 33 terminal application 96 terminal hardcopy printing 96 test template for business object 30 template for web service 33 Thread 86 transaction 96 transaction code/tac 97 U UDDI 97 UPIC 97 URI 97 URL 97 user exits 97 user ID 97 UTM see openutm V value range of a data type 83 variable 97 visibility 97 W web frontend architecture 7 basic interface 13 business object as web service 31 concept 13 flowchart 14 flowchart for business object as web service 27 flowchart for Java business object 26 flowchart for web service 32 Java business object 30 testing (openseas) 25 web service 34 web server 98 web service 13, 98 flowchart for frontend 32 generated template 18, 45 generating template 23 master template 18 testing template 33 web frontend 34 WebTransactions session 94 WebTransactions application 98 WebTransactions platform 98 WebTransactions server 98 WSDL 98 wsdl subdirectory 16 WSDL file 13, 17 WT_JAVA 36 complex data types 38 data types 37 WT_SOAP 39 data types 40 WTBean 98 WTML 99 WTML tag 99 WTScript Web Frontend for Web Services and Business Objects

111 Index WWW browser 80 WWW server 98 X XML 99 XML schema 99 Web Frontend for Web Services and Business Objects 111

112

113 Fujitsu Siemens Computers GmbH User Documentation Munich Germany Fax: (++49) 700 / Comments Suggestions Corrections manuals@fujitsu-siemens.com Submitted by Comments on WebTransactions V7.0 Web Frontend for Web Services and Business Objects Web Frontend for Web Services and Business Objects

114 Information on this document On April 1, 2009, Fujitsu became the sole owner of Fujitsu Siemens Computers. This new subsidiary of Fujitsu has been renamed Fujitsu Technology Solutions. This document from the document archive refers to a product version which was released a considerable time ago or which is no longer marketed. Please note that all company references and copyrights in this document have been legally transferred to Fujitsu Technology Solutions. Contact and support addresses will now be offered by Fujitsu Technology Solutions and have the The Internet pages of Fujitsu Technology Solutions are available at and the user documentation at Copyright Fujitsu Technology Solutions, 2009 Hinweise zum vorliegenden Dokument Zum 1. April 2009 ist Fujitsu Siemens Computers in den alleinigen Besitz von Fujitsu übergegangen. Diese neue Tochtergesellschaft von Fujitsu trägt seitdem den Namen Fujitsu Technology Solutions. Das vorliegende Dokument aus dem Dokumentenarchiv bezieht sich auf eine bereits vor längerer Zeit freigegebene oder nicht mehr im Vertrieb befindliche Produktversion. Bitte beachten Sie, dass alle Firmenbezüge und Copyrights im vorliegenden Dokument rechtlich auf Fujitsu Technology Solutions übergegangen sind. Kontakt- und Supportadressen werden nun von Fujitsu Technology Solutions angeboten und haben die Die Internetseiten von Fujitsu Technology Solutions finden Sie unter und unter finden Sie die Benutzerdokumentation. Copyright Fujitsu Technology Solutions, 2009