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.