This section contains the following information:
Table 5-3 Command Description
Table 5-4 Description of Add Command
Table 5-5 Description of Attribute
Use With |
Advanced Web Application Definition |
SecureLogin Version |
3.5 |
Type |
Specifier |
Usage |
Attribute <Attribute Name> <Attribute Name> |
Arguments |
< Attribute Name> Name of the HTML Attribute to discover. < Attribute Value> The value the above HTML Attribute must contain for the condition to be true. |
Description |
Use the Attribute specifier in conjunction with the Tag/EndTag com-mand to specify which HTML attributes and attribute values must exist for that particular HTML tag. For more information, see Section 5.2.81, Tag/EndTag. |
Example |
This example finds the form that has an attribute of name with a value of log on. Tag "Form" Attribute "Name" "Log on" EndTag |
Table 5-6 Description of AuditEvent
Table 5-7 BeginSplashScreen/EndSplashScreen Description
Table 5-8 Description of Break
Table 5-9 Description of Boolean Input
Table 5-10 Description of Call
Table 5-11 Description of ChangePassword
Use With |
Startup, Terminal Launcher, Web and Windows |
SecureLogin Version |
All |
Type |
Action |
Usage |
ChangePassword <Variable> [<Text>] "Random" |
Arguments |
<Variable> A normal or runtime variable in which the password is stored. [Text] The text you want displayed in the change password dialog box. [Random] Random invokes the random password generator. |
Description |
Use ChangePassword to change a single vari-able and is used in scenarios where password expiry is an issue. Set the <Variable> to the new password. The flag for this command is Random. If Random is:
|
Syntax Examples |
ChangePassword $NewPassword ChangePassword ?NewPassword "Please enter a new password" ChangePassword ?NewPassword Random |
Example |
Windows Application Definition This example detects the change password event. The application requires the current username and password, and then the new pass-word and confirmation of the new password. The Application Def-inition creates a backup of the old password in case the password change fails (which is detected by the message that is displayed), and then generates and enters a new password. # Change Password Dialog BoxDialog Class #32770 Title "Change Password" EndDialog Set $PasswordBackup $Password Type $Password #1015 ChangePassword $Password Random Type $Password #1005 Type $Password #1006 Click #1# Change Password Failed Dialog Box Dialog Class #32770 Title "Change Password Failed" EndDialog # Set the password back as the password change failedSet $Password $PasswordBackupMessageBox "The change password process failed. Please retry the pass-word change at your next log on. IT x453." |
Table 5-12 Description of Class
For each dialog block in an Application Definition, the chosen User ID is reset and you must select it again. Select it again by using a SetPlat command or by having the user select again from a list.
When an application first presents a log on screen, SecureLogin directs the user to select an appropriate User ID from a list. SecureLogin enters the selected User ID's credentials into the application and submits them.
If the log on fails due to incorrect credentials, SecureLogin prompts the user to change the credentials. SecureLogin does not retain User ID details and prompts the user to enter them again. However, this could result in changing the wrong credentials if the user selects the incorrect User ID.
To resolve this issue, you can use the SetPlat, ReLoadPlat and ClearPlat commands. ReloadPlat sets the current User ID to the one which was chosen last for the given application, or leaves the User ID unset if a User ID has not been selected previously. ClearPlat resets the last chosen User ID.
For more information see Section 5.2.61, ReLoadPlat and Section 5.2.12, ClearPlat.
Table 5-13 Description of ClearPlat
Table 5-14 Description of ClearSite
Table 5-15 Description of Click
Use With |
Java, Web, Windows |
SecureLogin Version |
All |
Type |
Action |
Windows Usage |
Usage One:Click <#Ctrl-ID> [-Raw] [-Right] Usage Two:Click <# Ctrl-ID > [-Raw [-x < X Co-ordinate > -y <Y Co-ordinate >]] |
Web Usage |
Click <#Number> |
Arguments |
|
Description |
When used with Windows applications, the Click command sends a click instruction to the specified <#Ctrl-ID>. NOTE:If the button to be clicked does not have a control ID, the Type "\N" command often clicks the default button in a Windows application. You can set the –Raw flag if the button or control does not respond to the Click command. The –Raw flag causes SecureLogin Single Sign-On to emulate the mouse and send a direct click message to the control. Using the -Right flag with the -Raw flag sends a right-click to the control. Setting the <#Ctrl-ID> to 0 (zero) sends the click instruction to the win-dow on which the Application Definition is running. If -Raw is specified, then you can set the X coordinate and the Y coor-dinates. These coordinates are relative to the client area of the application, not the screen. When used with Web Application Definitions, the Click command takes a single argument, which is the sequential number on the page of the button to be pressed. Click #3 will click the third button on the page. Keep in mind that due to Web page layout and design, the sequential order of the buttons may not be obvious, and that you may have to use the DumpPage command to discover the field layout. For more information see Section 5.2.24, EndScript. |
Syntax Examples |
Click #1 Click #1 -Raw -Right Click -X 12 -Y 24 |
Example 1 |
Windows Application Definition This example detects the login dialog box, enters the username and pass-word, and clicks the button number 1. # Log on Dialog Box Dialog Class #32770 Title "Log on" EndDialog Type $Username #1001 Type $Password #1002 Click #1 |
Example 2 |
Web Application Definition This example enters the username and password, and clicks the login button. Type $Username Type $Password Password Click #1 |
Example 3 |
Windows Application Definition This example uses the Java application, so there is no Control ID. Instead, the Click command is told to click a particular place on the win-dow. # Log on Dialog Box Dialog Class #32770 Title "Log on" End Dialog Type $Username Type $Password Click -X 12 -Y 24 |
Table 5-16 Description of ConvertTime
Table 5-17 Description of Ctrl
Table 5-18 Description of DebugPrint
Table 5-19 Description of Decrement
Use with |
All |
SecureLogin Version |
3.5.1 to 6.0 |
Type |
Variable Manipulator |
Usage |
Decrement <variable> |
Arguments |
<variable> The name of the variablle to decrease in value. |
Description |
Use the Decrement command to subtract from a specified variable. For example, you can use decrement to count the number of passes a particularApplication Definition has made. Once the number of instances is equal to the specified number, you can instruct the Application Definition to run another task or end the Application Definition. This is useful when configuring an application whose logon panel is similar to other windows within the application, or to easily control the number of attempts a user can have to access an application. For more information, see Section 5.2.41, Increment/Decrement. |
Syntax Examples |
Decrement ?RunCount |
Example |
Windows Application Definition Each time the Application Definition is run, a variable is incremented. This example counts the number of times the dialog box is displayed. If the dialog box is displayed more than three times, the application is closed. If the log on is successful, the count is reset. #Log on Dialog Box Dialog Class #32770 Title “Log on” EndDialog Decrement ?RunCount If ?RunCount Gt “3” MessageBox “Log on has been attempted too many times. The application will be closed.” KillApp “app.exe” Else Type $Username #1001 Type $Password #1002 Click #1 EndIf # Log on Successful Message Dialog Ctrl #1 Title “Log on Successful” EndDialog Set ?RunCount “0” |
Table 5-20 Description of Delay
Table 5-21 Description of Dialog/EndDialog
Table 5-22 Description of Display Variables
Table 5-23 Description of Divide
Table 5-24 Description of Dump Page
Table 5-25 Description of EndScript
Table 5-26 Description of Event
For details on Windows Event commands, see the Microsoft* MSDN Web site located at http://msdn.microsoft.com. Microsoft's Spy++, or similar Windows* message spy tools, are also useful for trapping event names in specific windows. Information regarding Spy ++ is also available on the MSDN Web site.
Table 5-27 Description of FocusInput
Table 5-28 Description of GenerateOTP
Table 5-29 Description of GetCheckBoxState
Table 5-30 Description of GetCommandLine
Table 5-31 Description of GetEnv
Table 5-32 Description of GetIni
Table 5-33 Description of GetMD5
Table 5-34 Description of GetReg
Table 5-35 Description of GetSessionName
Table 5-36 Description of GetText
Table 5-37 Description of GetURL
Table 5-38 Description of GoToURL
Table 5-39 Description of If/Else/Endif
Table 5-40 Description of Include
Table 5-41 Description of Increment/Decrement
Table 5-42 Description of KillApp
Table 5-43 Description of Local
Table 5-44 Description of MatchDomain
Table 5-45 Description of MatchForm
Table 5-46 Description of MatchField
Table 5-47 Description of MatchForm
Table 5-48 Description of MatchOption
Table 5-49 Description of MatchReferer
Table 5-50 Description of MatchURL
Table 5-51 Description of Message Box
Table 5-52 Description of Multiply
Table 5-53 Description of OnException/ClearException
Table 5-54 Description of Parent/EndParent
Table 5-55 Description of PickListAdd
Table 5-56 Description of PickListDisplay
Table 5-57 Description of Position Character
Table 5-58 Description of PressInput
Table 5-59 Description of ReadText
Use With |
Terminal Launcher, Windows. This command applies specifically to HLLAPI, WinHLLAPI and HLLAPI 16 terminal emulators. |
SecureLogin Version |
All |
Type |
Action |
Windows Usage Terminal Launcher Usage |
ReadText <#Ctrl-ID> <?Variable> ReadText <?Variable> <Character-Number> <Row-Number> <Column-Number> |
Arguments |
<#Ctrl-ID> The control ID number of the text to read. <?Variable> The variable that receives the text that is read. <Character-Number> The number of characters to read. <Row-Number> The horizontal position number of the first character to read (for exam-ple, row). <Column-Number> The vertical position number of the first character to read (for example, column). |
Description |
Use the ReadText command to run in both Windows and Terminal Launcher Application Definitions. While the usage and arguments for the use of ReadText with Windows and Terminal Launcher are differ-ent, the results of each command are the same. Windows Application Definition In a Windows Application Definition, the ReadText command reads the text from any given <#Ctrl-ID>, and sends it to the specified variable. For this command to function correctly, the <#Ctrl-ID> must be valid. Terminal Launcher Application Definition In a Terminal Launcher Application Definition, the ReadText command reads a specified number of characters, starting at the <Row-Num-ber>, and sends those characters to the specified <Variable>. The ReadText command will not work with Generic or Advanced Generic emulators, it only works with HLLAPI and some DDE emulators. For Generic or Advanced Generic emulators use the If -Text or Gettext commands. For more information, see Section 5.2.39, If/Else/Endif and Section 5.2.36, GetText. |
Example 1 |
HLLAPI emulator Readtext ?result "X" "Y" "Z" X = The number of characters to read.Y= The row from which the characters are read.Z= The column from which the characters are read |
Example 2 |
Windows script ReadText #1004 ?result |
Syntax examples |
ReadText #301 ?Text ReadText ?Text 4 6 |
Example 1 |
Windows Application Definition The same Title and Class appear in the error message dialog box when a user fails to log on. This example distinguishes between errors and provides users with more specific information, rather than a general message stating their username and password is incorrect, or the account is locked. In this case, the example reads the error message, clicks OK, and prompts the user with a customized message. # Log on Failed Message Dialog Class #32770 Title "Log on Failed" EndDialog ReadText #65535 ?ErrorMsg Click #1 If "Invalid Username" -In ?ErrorMsg Display-Variables "Please verify your Username and try again." $Username Type $Username #1001 Type $Password #1002 Click #1 EndIf If "Invalid Password" -In ?ErrorMsg Display-Variables "Please verify your Password and try again." $Password Type $Username #1001 Type $Password #1002 Click #1 EndIf If "Account Locked" -In ?ErrorMsg MessageBox "Your account is locked. Please contact the Help-desk on x3849." Endscript EndIf |
Example 2 |
Windows Application Definition This example reads the text from a Control ID and sets the database variable so the user is not prompted to set the variable. # Log on Dialog Box Dialog Class #32770 Title "Log on" EndDialog ReadText #15 ?Database If -Exists $Database Else Set $Database ?Database EndIf Type $Username #1001 Type $Password #1002 Type $Database #1003 Click #1 |
Example 3 |
Terminal Launcher Application Definition This example reads a message in a Terminal Emulator and displays the message in a user friendly format. ReadText ?Message 30 24 2 MessageBox ?Message |
Table 5-60 Description of RegSplit
When an application first presents a logon screen, SecureLogin displays a message box prompting the user to select an appropriate platform from a list. Once selected, SecureLogin enters the chosen platform's credentials into the application and submits them.
If log on fails due to incorrect credentials, SecureLogin prompts the user to change their credentials. SecureLogin does not retain the platform details and prompts the user to reenter the information. This could result in the user changing the wrong credentials if they select the incorrect platform.
The SetPlat, ReLoadPlat and ClearPlat commands resolve this issue. ReloadPlat sets the current platform to the one which was last chosen (for the given application), or if a platform not previously selected, the command leaves it unset.
For more information see Section 5.2.61, ReLoadPlat and Section 5.2.12, ClearPlat.
Table 5-61 Description of ReLoadPlat
Table 5-62 Description of Repeat/EndRepeat
Table 5-63 Description of RestrictVariable
Table 5-64 Description of Run
Table 5-65 Description of SelectListBoxItem
Use With |
Advanced Web Application Definitions |
SecureLogin Version |
All |
Type |
Action |
Usage |
SelectListBoxItem <Text of Item to set to> [<#Item Number>] [<-multiselect>] |
Arguments |
<Text of Item to set to> The text item that you want SecureLogin to select in the list box. <#Item Number> When multiple list boxes are found, this specifies which list box to address. <-multiselect> Used to select multiple list box entries by using a subsequent SelectListBoxItem command. |
Description |
Use the SelectListBoxItem command to select entries from a list box. For instruction on determining item numbers, see Section 5.2.24, EndScript. |
Example |
SelectListBoxItem "Remember Defects" #2 -multise-lect SelectListBoxItem "Remember Enhancements" #2 -multiselect |
Table 5-66 Description of SendKey
Use With |
Terminal Launcher |
SecureLogin Version |
All |
Type |
Action |
Usage |
SendKey <Text> |
Arguments |
<Text> The text typed into the emulator screen. |
Description |
Use the SendKey command to work only with Generic and Advanced Generic emulators. You can use the SendKey command in the same manner as the Type command. Generally, the Type command is the preferred command to use. The Type command places the text into the clip-board, and then pastes it into the emulator screen. The Send-Key command enters the text directly into the emulator screen. About using the Type Command Variables do not work with the SendKey command. If you want to use variables, use the Type command. The Type command has many special functions, and some you can use with the SendKey command. For more information, see Section 5.2.85, Sending Keyboard Commands Using Type and Section 5.2.84, Type. For more information on these func-tions, see Section 7.0, Reference Commands and Keys. |
Example |
Terminal Launcher Application Definition The example sends the username and password to the terminal emu-lator. #Send Username SendKey "DJones" SendKey "\N"# Send Password SendKey "Hu7%f" SendKey "\N" |
Table 5-67 Description of Set
Table 5-68 Description of SetCheckBox
Table 5-69 Description of SetCursor
Table 5-70 Description of SetFocus
Table 5-71 Description of SetPlat
Use With |
All |
SecureLogin Version |
All |
Type |
Action |
Usage 1 |
SetPlat <Application-Name> |
Usage 2 |
SetPlat <RegEx> <Variable> <#Ctrl-ID> |
Arguments |
<Application-Name> Application name from which to read the variables. <RegEx> Regular expression to use as application name. <Variable> Use a previously set ?Variable, for example using a PickList (For more information see Section 5.2.61, ReLoadPlat) <#Ctrl-ID> The control ID number of the regular expression. |
Description |
By default, variables are stored directly against the platform or applica-tion on which you have SecureLogin enabled. For example, if you enable Groupwise.exe, the Groupwise credentials are stored against the Groupwise.exe platform. SetPlat sets the platform or application from which variables are read and saved if you have:
Other uses of SetPlat include:
|
Example 1 |
Web Application Definition A dialog box appears when you try to access a password‐pro-tected site using Netscape Navigator. When you specify the Title, Class, Username, and Password fields for this dialog box they are always the same. If you stored the Username and Password against this platform without using the SetPlat com-mand, the same Username and Password for www.serversys-tems.com is entered to log on to any site (and are obvi-ously invalid for any other site). However, the previous dialog box always contains the name of the Web site to which to log on. You can use this name as the unique identi-fier in order to set a new platform and to save the log on creden-tials. Using a Dialog Block with a SetPlat Statement The solution is to use a dialog block with a SetPlat statement such as: Dialog Ctrl #330 Ctrl #214 Ctrl #331 Ctrl #1 Ctrl #2 Title "Username and Password Required" SetPlat #331 "Enter username for .* at (.*):" EndDialog Type $Username #214 Type $Password #330 Click #1 |
Example 1 (Contd) |
The power of this Application Definition is the line: SetPlat #331 "Enter username for .* at (.*):" This reads the line from dialog control ID 331, enters the username for Control Panel at www.serversystems.comNext, and applies the regular expression to this text. Regular expressions are a way of manipulating text strings, however, for most purposes a few very basic commands work When the user has run the Application Definition, they will see the Username and Password saved as www.serversystems.com.The text matched inside the brackets then becomes the symbol application. If a dialog <#Ctrl-ID> is not specified, the symbol application is uncondi-tionally changed to the application specified in <RegEx>. An unconditional SetPlat command is only valid if specified before Dialog/EndDialog statements. |
Example 2 |
Windows Application Definition This example displays a pick list and sets a new platform so multiple users can log on to the application. In this case, SetPlat creates a new platform called Default User, Global Administrator, or Regional Admin-istrator, and the respective $Username and $Password is saved there. # log on Dialog Box Dialog Class #32770 Title "Log on" EndDialog PickListAdd "Default User" PickListAdd "Global Administrator" PickListAdd "Regional Administrator" PickListDisplay ?Choice "Please select the account you wish to use"-NoEdit SetPlat ?Choice Type $Username #1001 Type $Password #1002 Click #3 |
Table 5-72 Description of SetPrompt
Use with |
All |
SecureLogin Version |
All |
Type |
Action |
Usage |
SetPrompt <Prompt-Text> |
Arguments |
<Prompt-Text> The customized text prompt displayed in the Enter SecureLogin Vari-ables dialog box. |
Description |
Use the SetPrompt command to customize the text in the Enter SecureLogin Variables dialog boxes. These dialog boxes are used to prompt the user for new variables. You can also use the DisplayVari-ables command to customize the prompt text in the dialog box (for previously stored variables). For more information, see Section 5.2.21, DisplayVariables. NOTE:Positioning of the setprompt command is crucial. Position it before the first usage of each variable to name that variable, and apply the final Setprompt to the text displayed at the top of the prompt screen. |
Example 1 |
Windows Application Definition This example replaces the default text prompt in the Enter SecureLogin Variables dialog box, and places the SetPrompt command at the bot-tom of the Application Definition. # Log on Dialog Box Dialog Class #32770 Title "Log on" EndDialog Type $Username #1001 Type $Password #1002 Click #1 SetPrompt "Please enter your Username and Pass-word for accessing the Human Resources sys-tem. These credentials will be remembered by SecureLogin and you will be automatically logged on in future. IT Helpdesk x4564" |
Example 2 |
Windows Application Definition This example replaces the text prompt next to any variable entry field in the Enter SecureLogin Variables box, and places the SetPrompt com-mand immediately before the variable in the Application Definition. # Log on Dialog Box Dialog Class #32770 Title "Log on" EndDialog SetPrompt "Enter Username==>" Type $Username #1001 SetPrompt "Enter Password==> "Type $Password #1002 Click #1 SetPrompt "Please enter your Username and Pass-word for accessing the Human Resources sys-tem. These credentials will be remembered by SecureLogin and you will be automatically logged on in future. IT Helpdesk x4564" |
Table 5-73 Description of Site/EndSite
Table 5-74 Description of StrCat
Table 5-75 Description of StrLength
Table 5-76 Description of StrLower
Table 5-77 Description of StrUpper
Table 5-78 Description of Sub/EndSub
Use With |
Startup, Terminal Launcher, Web and/or Windows |
SecureLogin Version |
3.5.1 |
Type |
Flow Control |
Usage |
Sub <Name> EndSub |
Arguments |
<Name> Any name entered to identify the subroutine. |
Description |
Use the Sub/EndSub commands around a block of lines within an Application Definition to denote a subroutine. You can also call a subroutine using the Call command. For more infor-mation, see Section 5.2.10, ChangePassword. |
Example |
Terminal Launcher Application Definition This example checks the emulator screen for the text Log on or Wrong Password. If either is found, the appropriate subroutine is called and run before the next part of the Application Definition. If -Text "Log on" Call "Log on" EndIf If -Text "Wrong Password" Call "WrongPassword" EndIf Sub Login Type $Username Type @E Type $Password Type @E EndSub Sub WrongPassword DisplayVariables "Enter correct password" $Password Call Login EndSub |
Table 5-79 Description of Submit
Table 5-80 Description of Subtract
Use With |
Startup, Terminal Launcher, Web and/or Windows |
SecureLogin Version |
3.0 |
Type |
Variable Manipulator |
Usage |
Subtract <Start-Value> <Subtract-Value> [?Result] |
Arguments |
<Start-Value> The <Start-Value> argument is the start number from which the second argument is subtracted. This argument contains the result if the optional [?Result] argument is not passed in. If used:
<Subtract-Value> The <Subtract-Value> argument is the number subtracted from the first argument. <Subtract-Value> can be a SecureLogin variable or a numeric value. [?Result] The result of the equation. This argument is optional, but If used, set to <Start-Value> - <Subtract-Value>. The [?Result] must be a SecureLo-gin variable, for example, $Result or ?Result. |
Description |
Use the Subtract command to subtract one value from another. This is useful if you are implementing periodic password change functionality for an application. You can use the Subtract command (in conjunction with the Divide function and the Slina DLL) to determine the number of days that have elapsed since the last password change. Other numeric commands include the Add, Divide, and Multiply. For more information see Section 5.2.4, Attribute and Section 5.2.22, Divide. NOTE:The Subtract command correctly subtracts when <Start-Value>, <Subtract-Value> and <Result-Value> are between -2147483648 and +2147483647. |
Syntax Examples |
Subtract "1" "2" ?Result Subtract ?LoginAttempts ?LoginFailures Subtract ?LoginAttempts ?LoginFailures ?Result Subtract ?LoginAttempts "3" Subtract ?LoginAttempts "3" ?Result |
Example |
Windows Application Definition This example reads the values of Control IDs 103 and 104 into vari-ables. From there they are subtracted, and typed into Control ID 1. ReadText #103 ?Number1 ReadText #104 ?Number2 Subtract ?Number1 ?Number2 ?Result Type ?Result |
Table 5-81 Description of Tag/End Tag
Table 5-82 Description of TextInput
Table 5-83 Description of Title
Use With |
Java, Windows |
SecureLogin Version |
All |
Type |
Dialog Specifier |
Usage |
Title <Window-Title> |
Arguments |
<Window-Title> The text to test against the window title. |
Description |
Use the Title command to retrieve the title of a window and compare it against the string specified in the <Window-Title> argument. For this block of the Application Definition to run, the retrieved window title and the <Window-Title> argument must match the text supplied to the Title command in the dialog block. Title is one of the main commands to identify a window. However, the Title command alone may not be enough - if there is more than one window in a platform (application) with the specified title, the SecureLogin Application Definition will run every time that window is detected. Always place the Title command after all other commands in the Dialog block. Uniquely Identifying a Window To uniquely identify a window, the Title command is typically used with the Class or Ctrl commands. For more information, see Section 5.2.11, Class and Section 5.2.16, Ctrl. NOTE:Use the SecureLogin Window Finder tool to determine the win-dow title. |
Example |
Windows Application Definition This example tests the dialog box to see if it has the correct title. If the title is not correct, the Application Definition passes on to the next Dia-log block. # Log on Dialog Box Dialog Class #32770 Title "Logon" EndDialog Type $Username #1001 Type $Password #1002 Click #1 |
Table 5-84 Description of Type
Use With |
Java, Terminal Launcher, Web and/or Windows |
SecureLogin version |
All |
Type |
Action |
Terminal Usage |
Type [-Raw] <Text> |
Windows Usage |
Type <Text> [<#Ctrl-ID>] Type [-Raw] <Text> |
Web Usage |
Type <Text> [<#Field-ID>] Type <Text> ["password"] |
Arguments |
[-Raw] By default, when typing into a Terminal Emulator or Windows applica-tion, SecureLogin verifies that the window exists before continuing. This verification process is disabled when the -Raw argument is provided. Further, instead of trying to set the text in the field directly, this option simulates actual keystrokes, causing SecureLogin to type into whichever window has focus. <Text> The text to type into this area. This text can be static text, such as ABC or any SecureLogin variable, such as $Username. [<#Ctrl-ID>] For Windows Application Definitions, this optional argument specifies the control into which to type the text. Use the Windows Finder Tool to extract these control IDs. For more information, see Windows Specific on page 151. [<#Field-ID>] For Web Application Definitions, this optional argument specifies the text field into which to type the text. For more information, see Web Specific on page 151. [password] For Web Application Definitions, this optional argument specifies to perform this type into the password field on this form. If [password] is used, that application's Application Definition cannot use a <#Ctrl-ID> argument. For more information, see Web Specific on page 151. |
Description |
Use the Type command to enter data, such as usernames and pass-words into applications. There are reserved character sequences that are used to type special characters, for example TAB and ENTER. If it is not possible to determine Control IDs in a Windows application, and the Type command is not working, use the SendKey command instead. For more information see Section 5.2.66, SendKey. Windows Specific In Windows, if the <#Ctrl-ID> argument is:
Web Specific For Web pages there are two ways to specify which field receives <Text>.
|
Example 1 |
Windows Application Definition This example is a typical use of the Type command in a Windows Application Definition. # Log on Dialog Box Dialog Class #32770 Title "Log on" EndDialog Type $Username #1001 Type $Password #1002 Type "DB2" #1003 Click #1 |
Example 2 |
Windows Application Definition This example shows the use of the -Raw switch. This switch is not actually required in this instance, and is only there as an example. # Calculator Is Active Dialog Class #SciCalc Title "Calculator" EndDialog Type -Raw "15" Type -Raw "+" Type -Raw "20" Type -Raw "=" |
Example 3 |
Web Application Definition This example uses the SecureLogin agent to automati-cally generate this Application Definition for the mail.yahoo.com site. This example shows the use of Password as the [<Field Name>] argument. Type $Username Type $Password Password In the Application Definition above, the SecureL-ogin agent locates the first password field. The first Type command sends $Username to the field immediately before the password field. The second Type command sends $Password to the password field. The same Application Definition could be rewritten using absolute placement as shown below. In the following example, the Submit command is also used to automatically submit the page. Type $Username #1 Type $Password #2 Submit |
SecureLogin can send special keyboard keystrokes to Windows and Internet based applications to emulate the user's keyboard entry. The Type command can pass keystrokes through to the window that the Application Definition is working. These special commands include the ability to select Menu items, send ALT, and send other keyboard combinations.
Table 5-85 Description of Special Key Commands
You can also use the Type command to send a combination of raw key commands. For more information on available keyboard sequences you can use with the Type command see Section 7.1, Windows Keyboard Functions.
Terminal Launcher uses the High Level Language Application Programming Interface (HLLAPI) to interface with a wide range of mainframe emulators that implement this programming standard. The list are the @ commands that you can use in the SecureLogin Application Definition Type command. These commands perform specific emulator and mainframe functions. For example, you can send an ENTER, TAB, or cursor key or issue a mainframe emulator print screen or reset function.
The @ commands are used in Application Definition language in the following format:
For more information on the available terminal emulator commands that you can use within a terminal emulator Application Definition see Section 7.0, Reference Commands and Keys.
Table 5-87 Description of WaitForFocus
Table 5-88 Description for WaitForText