HP LeanFT Readme

Software Version: 12.50

Document Release Date: July 2015

Software Release Date: July 2015

This file provides the following information about LeanFT 12.50:

• Minimum and Recommended System Requirements and Supported Environments

• Installing LeanFT 12.50

• LeanFT Help Center

• Notes and Limitations

• Security Information

• HP Support

• Legal Notices

Minimum and Recommended System Requirements and Supported Environments

This section includes:

• Minimum System Requirements. To successfully install and run LeanFT, your computer must meet these requirements.
• Recommended System Requirements. Performance may be improved by using systems with these stronger/later setups.

For a complete list of all supported operating systems, browsers, and development environments, see the LeanFT Product Availability Matrix (requires an HP Passport).

Installing LeanFT 12.50

To install LeanFT manually, follow the instructions below.

For details on silent installation, see Installing LeanFT Silently.

1. Prerequisites:

   • Make sure your computer meets the system requirements.

   • If you plan to use the LeanFT IDE plugin, make sure the relevant IDE is already installed.

     For supported IDE versions, see the LeanFT Product Availability Matrix (requires an HP Passport).

   • Make sure you have the required permissions on the computer.

2. Run the LeanFT installation and follow on-screen instructions.  While you install, consider the following:

   • You can change the default LeanFT installation path in the End-User License Agreement screen.

   • In the Custom Setup screen:

     • LeanFT runtime engine only. Select for computers where you plan to run existing LeanFT tests.

     • Full installation. Select for computers where you plan to develop and run LeanFT tests.

       • If you select the Eclipse IDE, a path field is displayed.  Click the Change button to browse to the folder where your Eclipse IDE is installed.
       • When the full installation is complete, a new LeanFT menu is added to Visual Studio and/or Eclipse and new LeanFT project templates are available in the IDE.
       • If you select Full installation, but do not select any IDEs for the LeanFT plugin, the Java and .NET versions of the LeanFT SDK are still installed in <LeanFT installation>\SDK
3. If you plan to test Web-based applications, open your browser and make sure the HP Functional Testing Agent extension is enabled. For additional details, see the topic on setting up Web browsers in the LeanFT Help Center.

Additional Installation Information

This section includes:

• Enterprise Deployment
• Installing LeanFT Silently
• Setting Required Access Permissions

Enterprise Deployment

When installing LeanFT in an enterprise business model across many computers in a network or company, note the following:

Installing LeanFT Silently

A silent installation (or quiet installation) is an installation that is performed in the background. You can install LeanFT silently on your computer or on a remote computer.

You must have administrator privileges to run the silent installation.

To install the default full installation silently:

<extracted setup folder>\setup.exe /s

You can also append any of the following options:

• Specify a Functional Testing concurrent license server: LICSVR=<server name or IP>

• Specify specific components to install: ADDLOCAL = <component name>, where <component name> is one or more of the following, separated by commas:

  • LeanFT runtime engine: LeanFT_Engine

  • LeanFTClient (SDK): LeanFT_Client
  • Visual Studio 2012 or 2013 Plugin: RegVS2012 or RegVS2013
  • Eclipse Plugin and location: RegEclipse ECLIPSE_INSTALLDIR=<path>

Example:

The following command installs the LeanFT runtime engine, client, and installs the LeanFT plug-in on Visual Studio 2012 and on the Eclipse IDE in the specified folder:

When you use the setup.exe /s command, there is no visual indication of the installation progress. To verify completion, monitor the process in the Windows Task Manager or check the installation log file.

Alternatively, you can use any of the following to install specific elements of the installation silently.

When you use msiexec /qb as shown for the UFT below, a progress bar displays during the installation.

Setting Required Access Permissions

Make sure the following access permissions are set to run LeanFT .

Permissions Required When Working with LeanFT

You must have the following file system permissions:

• Full read and write permissions to the C:\Temp folder

• Read permissions to the Windows folder and to the System folder

• Full read and write permissions to the folder on which you are saving solutions, tests, or run results
• If you are working on Windows 7 or Windows Server 2008 operating systems: Full read and write permissions to the <Program Data>\HP folder
• Full read and write permissions to the User Profile folders
• Full read and write permissions to the <Windows>\mercury.ini file

• Full read and write permissions to: %appdata%\Hewlett-Packard\

  Note: Read/write permissions to these folders should also enable permission to any subfolders contained in the folders listed above. If not, the system administrator must grant administrative permissions to the subfolders contained in these folders.

   

You must have the following registry key permissions:

LeanFT Help Center

The LeanFT Help Center teaches you how to use LeanFT to create and run C# or Java-based LeanFT tests and provides the LeanFT .NET and Java SDK References.

Access the LeanFT Help Center at: http://leanft-help.saas.hp.com/en/12.50/HelpCenter/Default.htm.

Notes and Limitations

This section includes the following important notes, known limitations and workarounds:

General

• The LeanFT Eclipse plugin currently does not provide the application model functionality.

• The LeanFT HTML Report cannot be viewed in a Firefox browser.

• When using the Highlight option in the application model for a test object with VRI objects defined, the highlight operation succeeds only if exactly one object matches the description (including the VRI definitions). If multiple objects match, nothing is highlighted.

  Workaround: Use the VRI Preview option to check the description.

.NET SDK/Visual Studio

• If you have an application model open in Visual Studio with changes that have not been saved, the generated code is updated with the unsaved changes. If you close the unsaved application model in Visual Studio without saving, the generated code will not be reverted back to the last saved application model.

  Additionally, if you have an application model open in Visual Studio with saved changes, but then edit and save the file outside Visual Studio, even after you confirm reloading the .tsrx file in Visual Studio, the generated code for the application model is not updated with the external changes.

  Workaround: Build the project containing the application model or close and reopen the application model.

• Do not add a LeanFT test file inside a LeanFT application model project. The project will not compile.

Web Technologies

• If your IDE is in front of your AUT when you click the Highlight option from the Application Model or from the Object Identification Center, the Highlight rectangle appears, but the IDE window stays in focus and may block the object.

  Workaround: Arrange your screen so that the IDE does not block your application.

• The FireEvent OnMouseEnter and OnMouseLeave events are not supported in Firefox.  

  For example, you cannot run the following statement in Firefox:
  edit.FireEvent( EventInfoFactory .CreateMouseEventInfo( MouseEventTypes .OnMouseEnter));

  Similarly, the FireEvent OnBlur event is not supported in Chrome and Internet Explorer.

• You cannot use IsReadOnly or IsEnabled properties in the test object descriptions of Web EditField or Web Button test objects.
• If a Chrome browser is open and has an alert message box displayed prior to the start of a LeanFT test run, you must manually close the message box before starting the run.
• When using Internet Explorer 11 on a computer with UAC enabled: If a step in the test navigates from a permitted zone to a non-permitted zone, the navigation step succeeds, but any subsequent step will fail.
• If two objects on a page have the same value for their id attribute, the x-paths generated for those objects may be identical.

• The styles property (C#) and getStyles property (in Java) will return an empty collection when run against Internet Explorer 8 or when the document mode of another Internet Explorer version is set to Internet 8 or earlier.

• In some cases, the Attributes collection returned by Attributes property (C#) or getAttributes (Java) may be different between Internet Explorer and other browsers such as Chrome or Firefox.

.NET Windows Forms and WPF Technologies

• If a Windows Forms or WPF calendar object has a check box that enables it, the calendar must be enabled (check box selected) before you can run a Calendar.SetDate step on it.
• You cannot use Items, SelectedItem, or SelectedItems C# properties, or the corresponding getItems, getSelectedItem, getSelectedItems methods in Java to create the test object descriptions of WPF ComboBox or WPF List test objects.
• LeanFT cannot identify a WinForms Button test object if WindowId is the only property in its test object description.

• If you try to retrieve a date value from a WPF calendar object (e.g. calendar.Date; calendar.Date.Month; calendar.Date.Year) before performing an operation on it, LeanFT returns an exception of type: InvalidOperationException.

  Workaround: Precede the retrieve value step with a step that performs an operation on the calendar, such as setting the date on the calendar to the current date.

Standard Windows Technology

• If a Windows calendar object has a check box that enables it, the calendar must be enabled (check box selected) before you can run a Calendar.SetDate step on it.
• The IListBox.SelectRange method does not select the expected range of items.
• The ListViewItem.EnableLabelEditing method works only if it is preceded by an ActivateItem step.

Security Information

LeanFT can potentially be used to simulate user actions on the host machine via the network. Therefore, it is strongly recommended to run LeanFT on dedicated test machines that do not contain or provide access to sensitive information. In addition, you should also thoroughly review your lab network topology and access permissions before using LeanFT.

For additional security information about LeanFT, see the LeanFT 12.50 Security Reference, available in the <LeanFT>\help folder after you install LeanFT or from the HP Software Support Manuals library (requires an HP Passport).

HP Support

You can visit the HP Software Support web site at: https://softwaresupport.hp.com

This web site provides contact information and details about the products, services, and support that HP Software offers.

HP Software support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can: search for knowledge documents of interest, submit and track progress on support cases, submit enhancement requests online, download software patches, and more.

To access the self-solve knowledge base or to search for the latest versions of HP Software manuals, visit the Knowledge and Manuals Library.

Most of the support areas require that you register as an HP Passport user and sign in. Many also require a support contract. To register for an HP Passport ID, go to: https://softwaresupport.hp.com and click Register.

To find more information about access levels, go to: https://softwaresupport.hp.com/web/softwaresupport/access-levels.

Send documentation feedback to HP