Web Services in Ac-on. Mark Schroeder 2E Track

Transcription

1 Web Services in Ac-on Mark Schroeder 2E Track

2 FOR INFORMATION PURPOSES ONLY Terms of this presenta3on This presenta-on was based on current informa-on and resource alloca-ons as of April 2013 and is subject to change or withdrawal by CA at any -me without no-ce. Notwithstanding anything in this presenta-on to the contrary, this presenta-on shall not serve to (i) affect the rights and/or obliga-ons of CA or its licensees under any exis-ng or future wrilen license agreement or services agreement rela-ng to any CA somware product; or (ii) amend any product documenta-on or specifica-ons for any CA somware product. The development, release and -ming of any features or func-onality described in this presenta-on remain at CA s sole discre-on. Notwithstanding anything in this presenta-on to the contrary, upon the general availability of any future CA product release referenced in this presenta-on, CA will make such release available (i) for sale to new licensees of such product; and (ii) to exis-ng licensees of such product on a when and if- available basis as part of CA maintenance and support, and in the form of a regularly scheduled major product release. Such releases may be made available to current licensees of such product who are current subscribers to CA maintenance and support on a when and if- available basis. In the event of a conflict between the terms of this paragraph and any other informa-on contained in this presenta-on, the terms of this paragraph shall govern. Certain informa-on in this presenta-on may outline CA s general product direc-on. All informa-on in this presenta-on is for your informa-onal purposes only and may not be incorporated into any contract. CA assumes no responsibility for the accuracy or completeness of the informa-on. To the extent permiled by applicable law, CA provides this presenta-on as is without warranty of any kind, including without limita-on, any implied warran-es or merchantability, fitness for a par-cular purpose, or non- infringement. In no event will CA be liable for any loss or damage, direct or indirect, from the use of this document, including, without limita-on, lost profits, lost investment, business interrup-on, goodwill, or lost data, even if CA is expressly advised in advance of the possibility of such damages. CA confiden-al and proprietary. No unauthorized copying or distribu-on permiled.

3 Abstract Mark Schroeder CMFirst Group 2E Architect/Senior 2E Consultant This presenta-on is about implemen-ng 2E Web Services. Examples will be given from how a real life scenario was used at Intui-on, including both posi-ves and nega-ves and recommenda-ons were created from the experience. 3 Copyright 2013 CA. All rights reserved.

4 Agenda Intro Company Overview Situa-on Solu-on Issues Encountered Recommenda-ons Wrap- up

5 Intro

6 Intro In this session, we will discuss the implementa-on of web services in a new 2E enterprise applica-on. We will look at lessons learned and how the 2E team was able to provide real -me access to live data to the web team through their web services. We will look at recommenda-ons for improvements.

7 Company Overview

8 Company Overview Intui-on The na-on s largest independent service provider with the longest standing history and commitment to the 529 Industry. We were the first company to enter this business in 1988 and the only one that has sustained a long- term commitment to it since then currently providing services for nine 529 plans and to over one million account holders. Our fundamental belief is that technology is an expression of crea-vity. Peter Angus, President

9 Company Overview 529 Solu-ons Prepaid Tui-on Collage Savings Flexible Technology must be able Adaptable. Integrate Mul-ple Systems Simple to Use Internal Company Employees Customers Plan Owners

10 The Situa-on

11 The Situa3on Owners CAP Web Applica-on States Company Fire Wall RAS Tandem Intui-on Prima IBMi Omni Prima Direct IBMi

12 CAP System CAP Web Applica-on CAP is a web application written in ASP.NET with VB and C#. ASP.NET was chosen to provide flexibility in the user interface yet provide excellent connectivity multiple systems. Web Services provide the flexibility to be able to get data more easily from multiple systems.

13 CAP System

14 CAP System

15

16 RAS Tandem Existing 529 prepaid system. At present it is running concurrently with Prima which will be replacing it. Prima is a 529 prepaid system written with 2E.

17 Prima System Prima IBMi Omni is the old 529 Prepaid system which is being replacing RAS. Prima is a 529 Saving system written with 2E.

18 Prima Direct System Omni Prima Direct IBMi Omni is the old 529 Savings system which is being replaced by Prima Direct. Prima Direct is a 529 Saving system written with 2E.

19 Solu-on

20 Solu3on Use Web Services Communicate between CAP and Other Systems From Prima and Prima Direct use 2E Web Services Types of Ac-ons Return a Record Return a List of Values Update Database on the IBMi 2E Web Services Develop a PaLern Simple to Duplicate Do not need extensive experience in Web Services

21 Web Services Approach 2E was used to create the programs that exposed business logic Lookup and return single records. Lookup and returned mul-ple records. Create and Update func-onality. 2E was used to create the Modules 2E was used to create the Service Program

22 Web Services Approach IBM Web Server Manager was used to deploy the Web Service IBM Web Server Manager was used for developer tes-ng.

23 The Program PGM The program used to manage the business logic. It could be RPG, RP4 or COBOL equivalents. By the time this program is run the library list is set up. Return Array is loaded in this function.

24 The Program This sample builds a list to return in the Web Service. Steps 1. Set Up parameters. a. WS Acct Lookup In Input b. Element is returned. c. WS Acc Lookup Out - returns a list.

25 The Program Steps 1. Clear build array. 2. Set LCL fields to blank/zero to be used in clearing the array. 3. Clear all elements of the array. 4. Load the Output Array

26 The Control Module CTL The module must be an ILE External Function. Sets up the library list and user for database updates. Return Array is populated in the PGM and passed to the CLT.

27 The Control Module This sample builds a list to return in the Web Service. Steps 1. Set Up parameters. 1. WS Acct Lookup In Input 2. Element is returned. 3. WS Acc Lookup Out - returns a list.

28 The Control Module Steps 1. Set Library List and User. 2. Clear elements of the array. 3. Call the PGM to build the array. 4. Set Return Code.

29 The Service Program SPS Create an object of type Service Program. The Service Program is the object the Web Service calls. It must point to the needed CTL program.

30 The Service Program The Service program links the module to the Web Service. Steps 1. No Parameters 2. Add module

31 Web Services Web Service IBMi Service Manager

32 Issues Encountered

33 Issues Encountered WS do not always act the way you expect. WS output arrays that contain numeric data are challenging. WS that output numeric data can be challenging. It can be difficult to keep programs, module and service program in sync. Libraries and mul-ple environments can be tricky. Debugging can be challenging since there are mul-ple layers where the issue can occur.

34 Recommenda-ons

35 Recommenda3ons Have a well defined process Have the Module call another program with business logic so you do not have to redeploy the WS all the -me Use arrays to Send and Receive Parameters Ini-alize all Output Array Lists to Zero/Blank Return code P0RTN can be cleared in exit program so you may have to use LCL.*Return Code and an exit program Determine a process to return error messages Create clear communica-on with Web team

36 Recommenda3ons Recommended 2E Updates Friendly Names for fields Control the order of the fields in the WSDL Allow a variable number of returned array elements.

37 Wrap- up

38 Thank You The Intui-on Team Marshall Goldstein Andrew Ford Mark Schroeder