Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
• AddressDoctor®
• IBM InfoSphere Information Server
• IBM InfoSphereDataStage®
• IBM InfoSphere WebSphere QualityStageTM.
This techdoc describes how to create and apply an address data-cleansing job that standardizes
address data for use by IBM Identity Insight. The job is defined in DataStage and uses QS-AVI
Data Quality stages. Note that the steps are described and illustrated in a Windows client
environment.
The basic steps for implementing this address cleansing job as a Web service are:
STEP 2: Define a QS-AVI Data stage Job to cleanse the address data.
Start -> All Programs -> IBM Information Server -> IBM WebSphere DataStage and
QualityStage Designer
2. In the Palette pane, open the Data Quality folder to browse through the
available stages. Make sure you are able to find the QS-AVI “Address Verification”
stage as shown in figure 2.
Figure 2 - Address Verification in the Data Quality folder
3. Copy the AddressValidateWS.dsx file from the QS-AVI package to your local hard
drive (C:\).
5. In the Repository pane, select the job AddressValidateWS in the Jobs folder,
and open it by selecting Edit.
One more step must be performed before the new job is enabled for Information Services.
You must change the properties of the job and specify that multiple instances of the job can
be run, and that the job can be made available as a Web service.
1. In the Repository pane, open the job properties by selecting the Edit menu and
then Job Properties).
2. On the General page of the job properties, check the following 3 boxes:
5. Compile the job by selecting Compile from File menu, or press F7.
Step 4: Define a DataStage job as a service using the Information Server Console
The Console for IBM Information Server allows you to define a data transformation or
cleansing job (DataStage job) as a service. The job must have been set in DataStage with
the property “Enabled for Information Services”. The tool includes a wizard to guide you
through the task.
Verify that the IBM WebSphere Application Server service is already started. The service
name is IBM WebSphere Application Server V6 – bhapatelNode02. If it is not started, start
the service.
1. Open the Console for IBM Information Server. From the Windows Start button,
select All Programs -> IBM Information Server -> IBM Information Server Console.
a. When you are prompted for user name and password, enter:
d. You can use the wizard to help you create and deploy the new service. The
wizard lets you fill in information about the general properties of the new
service, the binding used by the service, and the operation that the service
invokes.
Note that currently the system offers you a choice between SOAP over HTTP
and EJB as binding.
h. A new window is displayed, which lets you specify the operation to invoke.
j. Click Select to choose the information provider for this operation. In the
Information Provider window, select DataStage and QualityStage, as type of
information provider.
k. Navigate now through the folders to find the job named
AddressValidateWS, which were enabled for information services earlier
when you set up the job in DataStage and QualityStage Designer. Select the
job located in the Job folder: IaaS_Proj.
If the job name is not listed, it is likely that you did not compile the
DataStage job. If so, go back to the DataStage and QualityStage Designer
and compile the job.
l. Click OK.
Figure 11 - new operation detail pane.
You can browse through the Inputs, Outputs and Provider Properties tabs to
review input and output parameters for the service. Remember that this
DataStage job is enabled to Information Services and includes a WISD_Input
and a WISD_Output stage. During the definition of these stages, you should
have identified the columns that would be used as input and output.
o. Click Close Application. You are now returned to the Application window,
which should look like this:
Figure 12 - a defined service.
You have now completed the registration of the service and can deploy the
job as a service. The deployment is also performed using the Console for IBM
Information Server.
Step 5: Use the Information Server Console to deploy this new job as a service
2. Click Deploy.
3. The window with the Service Objects to deploy is displayed. Deploy the service
object named AddressValidateService.
Figure 13 - Deploying the application.
4. You can browse the Manage Providers section. For this example, keep all of the
default options.
5. Click Deploy (located at the bottom of the window). Note that deploying an
application can take a very long time, especially if your system does not have 3GB
or more of system memory.
6. The bottom of the screen has an activity status window, which you can expand by
selecting Details.
7. Once the deployment completes, the deployment status window shows a change
in status from “Executing” to “Completed”.
8. Close the Activity Status window. The application is now successfully deployed.
Step 6: Examine the WSDL file
Verify the deployment by generating the Web service definition language (WSDL) document
for the new service. WSDL contains all the necessary descriptions (meta data) that a client
application would need to invoke the service.
WISD generates the WSDL “on the fly”. If your application was not deployed successfully,
you will not be able to generate the definition.
2. In the Deployed Applications window, you should see the name of the application
AddressValidateApp that you just deployed. Expand the AddressValidateApp
folder.
6. The above window contains the general properties of the service. You can browse
through the various pages to see the information related to bindings, attributes and
operations. To find the WSDL document, open the Bindings page, and expand the
SOAP over HTTP box.
Figure 17 - Bindings view.
7. Click the link Open WSDL Document to generate the WSDL file for the
AddressValidateService service. The file is being displayed in a new browser
window.
Figure 18 - Generated WSDL file.
http://bhapatel:9080/wisd/AddressValidateApp/AddressValidateService/wsdl/Address
ValidateService.wsdl
10. Close the window displaying the WSDL file and the window labeled Header
Microsoft Internet Explorer, and exit the Console for IBM Information Server.
You can use the WebSphere Integration Developer environment provides to easily verify
that a service is working properly, without having to write an application.
http://bhapatel:9080/wisd/AddressValidateApp/AddressValidateService/wsdl/Address
ValidateService.wsdl
Figure 19 - Open the WSDL URL
This is the address that is associated with the service. You generated that address by
opening the WSDL document from the View Service in Catalog in the Information
Server Administrator Web Client at the end of the previous section.
7. The next screen displays the operation name(s) associated with the service. Click
the operation named addressValidateOps.
In the Status window, you should see the result containing the standardized named
and address for the customer entered as input. In the Status window, switch from a
Source view to a Form view to get a nicely formatted response document.
Figure 22 - a form view of a response document.
Figure 22 shows that service has been successfully invoked and that you have
successfully enabled a data-cleansing job as a Service.