To view the latest version of this file, see the readme at www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rft/html/61/rft61_Siebel/readme_Siebel.html.
1.0 About this release
2.0 Installation information
2.1 Hardware requirements
2.2 Verifying requirements
3.0 Feature highlights
3.1 Recording using UI name
3.2 Configuring CAS timeout
4.0 Known limitations, problems, and workarounds
4.1 Delayed recording of CAS events
4.2 Resetting JAVA Build Path
4.3 Delay Setting
Preferences are not available for Siebel testing
4.4 To Use RFT 6.1.1 with a Pre-existing RFT Project
5.0 Contacting customer support
6.0 Notices and trademarks
Important note about licensing
This Program is subject to a separate license fee that must be paid prior to use. Please log in to Passport Advantage Online to complete the purchase at
at
http://www-306.ibm.com/software/howtobuy/passportadvantage/pao_customers.htm.
Prerequisites -
- Microsoft .NET Framework 1.1.
- Siebel STA Installation
This solution requires the use of the Siebel Test Automation (STA) interface to retrieve Siebel object properties and hierarchy, as well as to record and play back events against Siebel UI elements. This add-on release has extended support for Siebel High Interactivity (HI/ActiveX) components and Standard Interactivity(SI) components. Available for Siebel 7.7, STA introduces a series of new test automation interfaces that optimize the testing platform. If you already have this interface you may use your existing copy of STA, provided you have an available license. If you do not have an available license or are in need of STA, please contact your Siebel Sales Representative for an evaluation copy.
RFT Installation
For information about installing IBM Rational Functional Tester, refer to the installation instructions at:
Verifying installation of STA -
Once you log into a Siebel application (such as Siebel Call Center), please make sure that the Siebel CAS is running. Bring up the Windows Task Manager, go to the Processes tab, and make sure that the Siebel Automation process is running. This could be SiebelAx_Test_Automation or SiebelAx_Desktop_Integration.
To Use RFT 6.1.1 with a Pre-existing RFT Project
If you install the latest Refresh Pack 6.1.1, you will need to perform a few actions before you can successfully use the new Siebel support with a pre-existing project. You will need to add two new templates (one for script headers and one for script helper headers) that must be added to the project. You will also need to update the build or reference information for the project. The specific details for each RFT platform follow.
RFT Java Scripting and Eclipse
1. If you are using RFT Java scripting, you can update to the latest templates by right-clicking on the project in the Functional Test Projects view and selecting Properties.2. In the Properties dialog, select “Functional Test Script Templates” from the list on the left. Select the template “Script Helper: Header of the file”. If you have not customized this template, you can upgrade it by clicking the Restore Defaults button. If you have customized the template already, add the line:
import com.rational.test.ft.object.interfaces.siebel.*;
to the top along with the other import statements.
After modifying the template, click the Apply button. Next, select the template “Script: Header of the file”. Add the same line to the imports section in this template as well. Click Apply and then OK.3. If you are using the integrated ClearCase support, after you edit the template files they will be checked out. You will need to check them back in so that other members of your team can use them. To do this, right-click on the project again in the Functional Test Projects view, and click Team > Show Checkouts. You will see a list of elements you have checked out. Select the two templates ft_script.java.rfttpl and ft_scripthelper.java.rfttpl and check them in (for example, you can right-click on the selected elements in the list and click Check in). Your other team members should update their project by right-clicking the project in the Functional Test Projects view and clicking Team > Get Latest Version….
4. Finally, right-click again on the project in the Functional Test Projects view and click Reset Java Build Path. Each member of your team will need to perform this last step, as the “Java Build Path” is local to each project on each machine.
VB.Net Scripting and Visual Studio
1. If you are using VB.Net scripting, you can update to the latest templates by right-clicking on the project in the Solution Explorer and clicking Properties.2. In the Properties dialog, select the Functional Test Script Templates tab. Select the template “Script Helper: Header of the file”. If you have not customized this template, you can upgrade it by clicking the Restore Defaults button. If you have customized the template already, add this line to the top along with the other import statements:
Imports Rational.Test.Ft.Object.Interfaces.Siebel
After modifying the template, click the Apply button. Next, select the template “Script: Header of the file”. Add the same line to the imports section in this template as well. Click Apply and then OK.3. If you are using the integrated ClearCase support, after you edit the template files they will be checked out. You will need to check them back in so that other members of your team can use them. To do this, right-click on the project again in the Solution Explorer, and click Team > Show Checkouts. You will see a list of elements you have checked out. Select the two templates ft_script.vb.rfttpl and ft_scripthelper.vb.rfttpl and check them in (for example, you can right-click on the selected elements in the list and click Check in). Your other team members should update their project by right-clicking the project in the Solution Explorer and clicking Team > Get Latest Version….
4. Finally, right-click again on the project in the Solution Explorer and click Reset Custom Reference. Each member of your team will need to perform this last step, as the “Custom References” are local to each project on each machine.2.1 Hardware requirements
There are no additional hardware requirements for installing the Siebel add-on to RFT.
2.2 Verifying Installation
File System Updates
New Files
File FileTarget Directory SiebelIEHelper.dll GAC (Global Assembly Cache) SiebelDomainProxies.dll GAC SiebelNotificationListener.dll GAC Interop.Shdocvw.dll GAC Interop.cascomLib.dll GAC Interop.msHTML.dll GAC
Files in Customization Directory
Customization Directory = in the Registry under HKEY_LOCAL_MACHINE -> Software -> Rational Software -> Rational Test -> 8 > you will find Rational FT Customization Directory. Typically this points to "C:\Documents and Settings\All Users\Application Data\IBM\RFT\customization".
File Target rational_ft_siebel.jar Customization Directory rational_ft_siebel.rftcust Customization Directory SiebelIEHelper.dll Customization Directory SiebelDomainProxies.dll Customization Directory SiebelNotificationListener.dll Customization Directory Registry Updates
In the registry make sure that under HKEY_LOCAL_MACHINE/SOFTWARE/Rational Software/Rational Test/8, the Value = Siebel Universal Agent for string DefaultSiebelApplicationName.
3.0 Feature highlights
The Siebel add-on for RFT allows users to capture and play back GUI-level interactions using Siebel's object model and events. Users can perform property and data verification points on Siebel custom components.
RFT also exposes Siebel script-only methods on GUI and non-GUI Siebel objects and includes a Siebel Automation Framework for Rational Functional Tester, which allows you to create robust functional test scripts without even having to use the recorder or the object map. Using this framework, you can programmatically develop your test scripts based on known screen definitions in Siebel. Refer to samples, which are included in the SDK Samples folder for details on how to use the framework. SDK Samples can be found in the Customization directory. Typically this is "C:\Documents and Settings\All Users\Application Data\IBM\RFT\customization".
3.1 Recording using UI name
In order for RFT to record Siebel HI controls using the UI name, set the Registry key as follows. By default, RFT records using the Repository name.
In the registry, make sure that under HKEY_CURRENT_USER/SOFTWARE/Rational Software/Rational Test/8, you create a new dWord named UINameInScript, and set the value to 1.3.2 Configuring CAS timeout
CAS provides a mechanism to configure timeout on calls which could result in a hung system. By default, this timeout is set to 1 second, but you can configure this using ivory.properties file by setting "rational.test.ft.siebel.cas_submit_timeout" to the desired value.
4.0 Known limitations, problems, and workarounds
4.1 Delayed recording of CAS events
In some cases, CAS throws events in a delayed manner. Rational Functional Tester will capture these events, but will not write the command to the record monitor until it receives the next GUI event. For example, when you interact with a checkbox, events like SetOn and SetOff are sent to the record monitor only when the focus is lost from the CheckBox. When RFT encounters this, "Event pending from CAS" will be shown in the record monitor window. The recorder will flush events only on a mouse-up event. To work around this problem, you need to click on another object to get the event recorded.
If you install the RFT Extension for Siebel Test Automation and use the Java Scripting platform with a project that was loaded into your workspace before you installed the Siebel Extension, you may see script compilation errors when you first record a test against Siebel. To resolve these errors, right-click on the project in the Functional Test Projects view, and then click Reset Java Build Path. Refer to the "To Use RFT 6.1.1 with a Pre-existing RFT Project" section in the Section 2.0 above for additional details.
4.3 Delay Setting Preferences are not available for Siebel testing
Some of the options under Windows > Preferences are not valid for the RFT Siebel implementation because they do not apply to the Siebel object model. For example, the options under Windows > Preferences > Functional Test > Playback > Mouse Delays and > Other Delays do not apply to Siebel testing.
4.4 To Use RFT 6.1.1 with a Pre-existing RFT Project
If you install the latest Refresh Pack 6.1.1, you will need to perform a few actions before you can successfully use the new Siebel support with a pre-existing project. See the instructions in the Installation section above.
5.0 Contacting customer support
The product home page for Rational Functional Tester is www.ibm.com/software/awdtools/tester/functional/index.html. For FAQs, lists of known problems and fixes, and for other support information, visit the Support page on the product home page.
6.0 Notices and trademarks
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this documentation in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this documentation. The furnishing of this documentation does not give you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
Intellectual Property Dept. for Rational Software
IBM Corporation
20 Maguire Road
Lexington, MA
02421-3112
USA
Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this documentation and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples may include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrates programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
(C) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (C) Copyright IBM Corp. 2000, 2005. All rights reserved.
If you are viewing this information softcopy, the photographs and color illustrations may not appear.
Programming interface information
Programming interface information is intended to help you create application software using this program.
General-use programming interfaces allow you to write application software that obtain the services of this program's tools.
However, this information may also contain diagnosis, modification, and tuning information. Diagnosis, modification and tuning information is provided to help you debug your application software.
Warning: Do not use this diagnosis, modification, and tuning information as a programming interface because it is subject to change.
Trademarks and service marks
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:
- developerWorks
- IBM
- Rational
- RequisitePro
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.
Intel is a trademark of Intel Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Other company, product or service names, may trademarks or service marks of others.