The renewal maintenance has officially ended for Progress iMacros effective November 30, 2023.
This Wiki site will also no longer be moderated from the Progress side.
Thank you again for your business and support.
Sincerely, The Progress Team
Difference between revisions of "ONLOGIN"
(→Notes) |
|||
(12 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
Handles login dialogs. The ONLOGIN command must appear before the macro command that navigates to the site that brings up the login dialog. | Handles login dialogs. The ONLOGIN command must appear before the macro command that navigates to the site that brings up the login dialog. | ||
− | The password is stored with the method you selected on the Security tab of the options dialog. More details about the different password storage options can be found in the [[ | + | The password is stored with the method you selected on the Security tab of the options dialog. More details about the different password storage options can be found in the [[Password Security|Security]] chapter. |
− | Note | + | Note: You need to use ONLOGIN '''before''' the [[URL]] GOTO or [[TAG]] command that triggers the login dialog. |
+ | === Syntax [[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]]=== | ||
− | + | ONLOGIN USER=username PASSWORD=password RETRY=[YES|NO] | |
− | |||
− | |||
− | ONLOGIN USER=username PASSWORD=password | ||
=== Parameters === | === Parameters === | ||
Line 15: | Line 13: | ||
*:Specifies the user name with which to log in. | *:Specifies the user name with which to log in. | ||
*PASSWORD | *PASSWORD | ||
− | *:Specifies the password with which to log in. Can be [[ | + | *:Specifies the password with which to log in. Can be [[Password Security|in plain text or encrypted]]. |
+ | *RETRY [[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] | ||
+ | *:Instructs iMacros to handle the login dialog as long as it appears (RETRY=YES), or to press the cancel button if failed the first time (RETRY=NO). Default is YES. | ||
=== Security === | === Security === | ||
[[Image:Password options.png|thumb|right|350px|iMacros Password Security Options]] | [[Image:Password options.png|thumb|right|350px|iMacros Password Security Options]] | ||
− | Just like with normal website passwords, the ONLOGIN password can be [[ | + | Just like with normal website passwords, the ONLOGIN password can be [[Password Security|stored in plain text or encrypted]]. To create an encrypted password, please make sure that you have the password security options set to one of the two "Store password encrypted" options ''before you start recording''. |
=== Examples === | === Examples === | ||
ONLOGIN USER=username PASSWORD=password | ONLOGIN USER=username PASSWORD=password | ||
− | URL GOTO=http://www.mysavesite.com | + | URL GOTO=http://www.mysavesite.com |
+ | |||
+ | === Notes === | ||
+ | |||
+ | # To automate the login dialog on Windows 7, you first need to remove any saved credentials for the site using [[IE_Nags#How_to_remove_credentials_from_the_Windows_Credentials_Manager|these steps]]. | ||
+ | # If iMacros does not recognize the login dialog in Internet Explorer, either during recording or replay, check if Enhanced Protected Mode is turned on (IE 10 and above). In this case iMacros is not allowed to handle the Windows Security Dialog. Please turn EPM off if you need to automate the login dialog in Internet Explorer ([[IE_Nags#How_to_turn_off_Enhanced_Protected_Mode_.28EPM.29_in_IE10_and_above|IE Nags]]). | ||
=== See Also === | === See Also === | ||
[[ONCERTIFICATEDIALOG]], [[ONDIALOG]], [[ONDOWNLOAD]], [[ONERRORDIALOG]], [[ONSECURITYDIALOG]], [[ONWEBPAGEDIALOG]] | [[ONCERTIFICATEDIALOG]], [[ONDIALOG]], [[ONDOWNLOAD]], [[ONERRORDIALOG]], [[ONSECURITYDIALOG]], [[ONWEBPAGEDIALOG]] |
Revision as of 14:26, 20 February 2017
Handles login dialogs. The ONLOGIN command must appear before the macro command that navigates to the site that brings up the login dialog. The password is stored with the method you selected on the Security tab of the options dialog. More details about the different password storage options can be found in the Security chapter.
Note: You need to use ONLOGIN before the URL GOTO or TAG command that triggers the login dialog.
Syntax
ONLOGIN USER=username PASSWORD=password RETRY=[YES|NO]
Parameters
- USER
- Specifies the user name with which to log in.
- PASSWORD
- Specifies the password with which to log in. Can be in plain text or encrypted.
- RETRY
- Instructs iMacros to handle the login dialog as long as it appears (RETRY=YES), or to press the cancel button if failed the first time (RETRY=NO). Default is YES.
Security
Just like with normal website passwords, the ONLOGIN password can be stored in plain text or encrypted. To create an encrypted password, please make sure that you have the password security options set to one of the two "Store password encrypted" options before you start recording.
Examples
ONLOGIN USER=username PASSWORD=password URL GOTO=http://www.mysavesite.com
Notes
- To automate the login dialog on Windows 7, you first need to remove any saved credentials for the site using these steps.
- If iMacros does not recognize the login dialog in Internet Explorer, either during recording or replay, check if Enhanced Protected Mode is turned on (IE 10 and above). In this case iMacros is not allowed to handle the Windows Security Dialog. Please turn EPM off if you need to automate the login dialog in Internet Explorer (IE Nags).
See Also
ONCERTIFICATEDIALOG, ONDIALOG, ONDOWNLOAD, ONERRORDIALOG, ONSECURITYDIALOG, ONWEBPAGEDIALOG