8.2.2: Readme for UI Automation extension V2.0.0.0

Product Lifecycle

Abstract

This document provides an overview of the UI Automation extension and procedures to install the extension.

Content

The UI Automation extension enables IBM® Security Access Manager for Enterprise Single Sign-On administrators or profilers to create AccessProfiles for applications that support the Windows UI Automation accessibility framework.

For example, applications that are written using .NET Windows Presentation Foundation support Windows UI Automation, out-of-the-box, to access basic controls like Text Fields and Buttons.

The UIAExtension_2.0.0.0.exe file automatically installs the UI Automation extension.

Downloading the UI Automation extension

Download the package from Observer Extensions for IBM Security Access Manager for Enterprise Single Sign-On.

Requirements and compatibility

Before you install the UI Automation extension, ensure that you have installed the following versions of AccessAgent and AccessStudio:

AccessAgent 8.2.2
AccessStudio 8.2.2- optional; required for creating AccessProfiles.
Microsoft .NET 3.5 - optional; required for AccessStudio.

Installing the UI Automation extension

Download the extension to your local computer as an UIAExtension_2.0.0.0.exe file.
Double-click the UIAExtension_2.0.0.0.exe file to install the extension.
Verify that the installation is successful by viewing the UIAExtensionInstaller.log file in <AA Installation Folder>\logs\UIAExtensionInstaller.log. The UIAExtensionInstaller.log file contains the following lines:
===== Install starting <Time> =====

...
...
UIAExtension Installation Succeeded

Uninstalling the UI Automation extension

Delete <AA Installation Folder>\ECSS\ObserverExtension\UIAExtension to uninstall the extension. For example, C:\Program Files\IBM\ISAM ESSO\AA\ECSS\ObserverExtension\UIAExtension.

Triggers

The table lists the new triggers provided by the UIAExtension and explains the conceptual information for each trigger.

Triggers	Description
On Button Clicked - UI Automation	This trigger is fired when a button is clicked. Use this trigger to detect when the specified button is clicked. The application must support the accessibility feature specified by Windows UI Automation.
Element is Found - UI Automation	This trigger is fired when an element is found. Use this trigger to poll for the element that is specified by the signature. The application must support the accessibility feature that is specified by Windows UI Automation.

Actions

The table lists the new actions provided by the UIAExtension and explains the conceptual information for each action.

Actions	Description
Click a Button - UI Automation	This action is used to click the specified button. Use this action to click the specified button.
Inject Credentials - UI Automation	This action is used to fetch user account data from the Wallet and inject user credentials into an application. Use this action whenever user data (for example, user name, password, and so on) must be filled-in automatically. This action lets you specify the account data bag that holds the credentials, the fields into which these credentials are injected, and the authentication service that is used to authenticate credentials.

[{"Product":{"code":"SS9JLE","label":"IBM Security Access Manager for Enterprise Single Sign-On"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"AccessStudio","Platform":[{"code":"PF033","label":"Windows"}],"Version":"8.2.2","Edition":"","Line of Business":{"code":"LOB24","label":"Security Software"}}]

Tips