If you are using HCL OneTest™ API 8.6.0 or later, you
can use the HCL OneTest™ API user interface (UI) to import service
or transaction data from IBM® Tivoli® Composite Application
Manager for
Transactions.
About this task
Using the HCL OneTest™ API UI to import data from Tivoli® Composite Application
Manager for
Transactions involves creating a connection in HCL OneTest™ API
to Tivoli® Enterprise Portal,
connecting to the portal, and selecting and importing the data to
be imported.
Procedure
- To create a connection to Tivoli® Enterprise Portal,
complete the following tasks:
- In HCL OneTest™ API, click in the menu
bar.
The Project Settings window
is displayed.
- Click the APM preferences tab.
The APM preferences tab is displayed.
- Click Add.
The Select
Provider window is displayed.
By default, IBM
Tivoli APM Connection Provider is selected in the Available
Providers list.
- Click OK.
The new
connection is displayed under Connected APM Servers.
- Under APM Connection Details,
enter the following information:
- In the Name field, enter a name for the
new connection.
Note: Assigning a name helps to identify the connection
if there is more than one Tivoli® Enterprise Portal connection
in your HCL OneTest™ API project.
- In the Url field, enter the URL of the Tivoli® Enterprise Portal instance
to which you want to connect.
Note: The URL must include the relevant
port number; for example, http://<server>:15210/
.
- In the Username field, enter the required Tivoli® Enterprise Portal user
name.
- In Password field, enter the required Tivoli® Enterprise Portal password.
- Click Connect.
HCL OneTest™ API attempts to connect to the specified Tivoli® Enterprise Portal instance.
If
HCL OneTest™ API connects to Tivoli® Enterprise Portal successfully,
the lists under Connect are populated.
If
HCL OneTest™ API fails to connect to Tivoli® Enterprise Portal successfully,
an error message is displayed and you must check the connection details.
- In the Default Provider list,
click the Tivoli® Composite Application
Manager provider
that you want to use.
- In the Default Data Source list,
click the Tivoli® Composite Application
Manager data
source that you want to use; for example, Transaction Reporter.
- In the Default Data Set list,
click the Tivoli® Composite Application
Manager data
set that you want to use; for example, Aggregates.
- Click OK.
- To import data from the specified Tivoli® Enterprise Portal instance,
complete the following tasks:
- Open the Test Factory perspective.
- Open a performance profile.
The
Performance
Profile pane is displayed.
Note: If you have not already
created a performance profile, right-click a stub and click on the shortcut menu, enter a name
for the profile, and click OK.
- On the Settings tab, click Import
phases ().
The Import Data
wizard is displayed.
- Under Import data from, click APM
Server.
- Click Next.
The
second screen of the Import Data wizard is displayed.
- Select the Tivoli® Enterprise Portal connection
that you want to use.
Note: If you want to create a
new Tivoli® Enterprise Portal connection
or to modify an existing Tivoli® Enterprise Portal connection,
clicking Manage Connections opens the APM
preferences tab on the Project Settings window.
- Click Next.
The Import
from APM Server screen of the Import Data wizard is displayed.
This screen enables you to configure the query that will be used to
retrieve the service or transaction data that you want to import.
- Click Select Agent.
The Agent window
is displayed.
- Select the agent that you want to use.
- Click OK.
- In the Transaction Group list,
click the required transaction group; for example, Transaction.
- In the Operation list, click
the required operation.
- Optional: To retrieve history data, complete the following
tasks:
- Click Next.
HCL OneTest™ API uses the query to retrieve the required data from the specified Tivoli® Enterprise Portal instance.
If
the query is successful, HCL OneTest™ API imports the data and the Applying
data screen of the Import Data wizard is displayed.
If the query is unsuccessful, you might have to modify
the query you created or verify that the connection to the Tivoli® Enterprise Portal instance
is working correctly.
- Using the lists provided on the Applying data screen,
make any required changes to the mapping between the columns in the
performance profile and the imported data.
- Under Options, click Replace
existing data if you want to overwrite the existing data
in the performance profile with the imported data or click Append
to existing data if you want to add the imported data
to the existing data in the performance profile.
- Click Finish.
Results
The imported data is added to the performance profile.