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
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
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
2. In the white space area of the HATS Project View, right-click and select New
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