Using IBM WebSphere Host Access Transformation Services V5

198 Using IBM WebSphere Host Access Transformation Services V5

3.3 Creating, deploying, testing a basic HATS portlet

This section describes a simple HATS portlet end-to-end development and

testing scenario. First we create a HATS project with default transformation

settings. Then we generate a portlet from the HATS project. Finally we deploy it

to the portal server and test it.

3.3.1 Creating a basic HATS portlet

We create our first HATS portlet project. In HATS V5, there are two methods to

create a HATS portlet project:

򐂰 Create a new project using the HATS Create a Project wizard and

designate

that the project should be created as a portlet.

򐂰 Convert an existing HATS application to a portlet. This ensures that all of our

efforts on existing HATS applications are not wasted when moving them to

WebSphere Portal.

In this section, we use the second method. We create a normal HATS project,

and then convert it to a HATS portlet project. We use the first method in 3.4.4,

“Creating the HATS credential integration portlet” on page 238.

Creating the base HATS application

To create the base HATS application, follow these steps:

1. Start HATS Studio. Click Start

→Programs →IBM WebSphere

HATS

→HATS Studio.

2. In the white space area of the HATS Project View, right-click and select New

HATS

→Project.

Note: If you have an existing HATS V4 application, you must migrate it to

HATS V5 before you convert to your new portlet. For migration instructions,

see Chapter 2 in IBM WebSphere Host Access Transformation Services

(HATS) V5 User’s and Administrator’s Guide, SC31-6575.

Chapter 3. Integrating HATS with WebSphere Portal Server 199

3. The Create a Project wizard (Figure 3-7) opens. In the Create a Project panel,

type the name for the new HATS project and a description for the project. For

our example, we enter mydfw. You may want to change the name of the

Enterprise Application project name. The default is HATS.ear. The name that

you enter is also shown in the WebSphere Application Server when the

application is deployed on WebSphere. Click Next.

Figure 3-7 HATS Create a Project wizard

200 Using IBM WebSphere Host Access Transformation Services V5

4. In the Create a Project – Connections Settings window (Figure 3-8), specify

the connection properties for the HATS application. For Host name, we

specify iseriesd.dfw.ibm.com and for Type, we select 5250. For the other

settings, leave the default values. Click Next.

Figure 3-8 Connection Setting panel

Note: After you create the HATS project, you can edit the connection

properties and configure the advanced connection properties in the project

setting view.

Chapter 3. Integrating HATS with WebSphere Portal Server 201

5. On the Create a Project – Select Default Template window (Figure 3-9), select

the template you want to use. We select Swirl.jsp. Click Finish.

Figure 3-9 Select Default Template panel

202 Using IBM WebSphere Host Access Transformation Services V5

The HATS Project Wizard completes the creation of the HATS project. You see

the new HATS project in the HATS Project View of HATS Studio (Figure 3-10).

Figure 3-10 HATS project view with new HATS project (mydfw)