Bookmark & Template Attributes
The Desktop Scripting Language supports reading values from the application’s desktop bookmark record and its associated template.
These values are treated as string literals when used inside commands.
Template values can support environment variables and have special behaviours for running 32 bit and 64 bit apps.
List of Attributes
The following tokens represent data from a My1Login bookmark and may be used in place of string literals inside a script.
Attribute | Data Source |
|---|---|
bmAppArgument | Template: Command Line Arguments field |
bmAppPath | Template: Path to App field |
bmEnc1 | Bookmark: Extra Encrypted 1 field |
bmEnc2 | Bookmark: Extra Encrypted 2 field |
bmTitle | Bookmark: Title field |
bmNewPassword | Forces new password generation, if policy available |
bmOldPassword | Current password, or password prior to last bmNewPassword reference |
bmNotes | Bookmark: Notes field |
bmPassword | Bookmark: Password field |
bmUsername | Bookmark: Username field |
bmTemplateName | Template: Name field |
bmTemplateDescription | Template: Description field |
Examples
// Show an alert with the app title as the popup
// header and username in the content.
AlertInfo "Username is " bmUsername , "App:" bmTitle
// Start the bookmark process and wait for it
// to initialise
StartProcess bmAppPath
WaitProcess bmAppPath
Password Change Attributes
bmNewPassword and bmOldPassword attributes are used, along with a template’s password policy, to generate and return a new password.See also Password Change Example
bmNewPassword triggers the generation of a new password while storing the previous password in the bmOldPassword attribute. Each reference to bmNewPassword generates a new password. The bmPassword attribute always reflects the current value.
Important
Changes made by bmNewPassword are not permanently stored in the user’s My1Login bookmark until the SaveChanges command is used in the script.
See SaveChanges
Generated Password Policy
The password settings policy (length, permissible characters, etc.) is defined in the My1Login administration area by clicking on the shield icon on the desktop application’s template.
How the Different Attributes are Affected
SendKeys bmNewPassword
SendKeys bmNewPassword
will affect the password attributes (bmPassword, bmNewPassword & bmOldPassword) as follows:
|
|
| |
|---|---|---|---|
Initial Values: | Pwd123 | -no value- | Pwd123 |
1st command | RandomPwd1 | RandomPwd1 | Pwd123 |
2nd command | RandomPwd2 | RandomPwd2 | RandomPwd1 |
Note
If bmPassword is used after the password change, then it will return the new password.
Therefore, change password scripts must send bmPassword (if it means the old password) prior to sending bmNewPassword. Or use bmOldPassword which will contain the original value of bmPassword prior to bmNewPassword being called.
E.g. in a normal change password scenario use
SendKeys bmPassword bmNewPassword bmPassword
which sends the original password value, generates and sends the new password, then sends the new password again. That is (using the values from the table above):
“Pwd123” “RandomPwd1” “RandomPwd1”
Related Articles
Defining a Desktop App Template
Desktop Template Definition The desktop application template is defined in the My1Login admin area (the script has been omitted from this view). Setting Explanation Name The template name, user bookmarks have their title defaulted to this value. ...Desktop Client Commands
Table of Script Commands Command Description AlertInfo / AlertError Commands to show text messages to users. BringToForeground Attempt to force the main app window to desktop’s foreground. InteractiveSelectBookmark Allows manual intervention when ...String (Text) Literals
Literal strings are text that you wish to pass straight through to a command, i.e. the text is not interpreted in any way. Types of Strings Strings may either be literal (fully defined in the script) or may come from values stored in bookmark ...Error Directive, Alerting & Logging Commands
OnError Controls the processing of a script in the event of a runtime error. Multiple OnError commands may be used to control behaviour at different points in the script. Syntax Diagram Parameters Terminate - stop script execution Continue - continue ...Injecting Text Into Controls
The commands in this section are responsible for assisting the user to select credentials for an app, emulate the user typing into the app and for injecting text into the controls of a window. SelectBookmark Instructs the Desktop Agent to find the ...