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 "Command Reference"
(→') |
|||
(229 intermediate revisions by 10 users not shown) | |||
Line 1: | Line 1: | ||
− | + | A high-level overview of the different versions of iMacros can be found [https://imacros.net/store/compare-versions/ here] | |
− | |||
− | + | The browser icons [[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]] listed below and on each command detail page denote browser compatibility. Commands that are supported in all browsers work exactly the same in each browser, so macros created in the iMacros Browser (or Internet Explorer) can be replayed in iMacros for Firefox and vice versa. Browser specific differences are automatically handled by iMacros. | |
− | + | == iMacros Commands Reference == | |
− | + | {| | |
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[' (Comment)]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[ADD]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[BACK]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[CLEAR]] | ||
+ | |- | ||
+ | |[[Image:Ff-icon.png|Firefox]]||[[CLICK]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[DISPLAY]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[DS]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[EVAL]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[EVENT]] | ||
+ | |- | ||
+ | | ||[[EXTRACT]] (Part of the [[TAG]] command) | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[FILEDELETE]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]]||[[FILTER]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[FORWARD]] (version 12.6 and above) | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[FRAME]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[IMAGECLICK]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[IMAGESEARCH]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[ONCERTIFICATEDIALOG]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] <!--[[Image:Ff-icon.png|Firefox]]--> [[Image:NGIM-icon.png|iMacros 2021.0]]||[[ONDIALOG]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[ONDOWNLOAD]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]]||[[ONERRORDIALOG]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] ||[[ONINSECURECONNECTION]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[ONLOGIN]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[ONPRINT]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[ONSECURITYDIALOG]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[ONWEBPAGEDIALOG]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[PAUSE]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[PRINT]] | ||
+ | |- | ||
+ | |[[Image:NGIM-icon.png|iMacros 2021.0]]||[[PRINTPDF]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[PROMPT]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[PROXY]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[REFRESH]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[SAVEAS]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]]||[[SAVEITEM]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[SCREENSHOT]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[SEARCH]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[set|SET]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[SIZE]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[STOPWATCH]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[TAB]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[TAG]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[TRAY]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[URL]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[VERSION]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[WAIT]] | ||
+ | |- | ||
+ | | ||[[Error-Codes|Error Codes]] | ||
+ | |- | ||
+ | | ||Tip: [[FAQ#Q:_Are_there_conditional_statements_like_if..._then...else_in_the_iMacros_macro_language.3F| How to make if/then decisions with iMacros]]. | ||
+ | |} | ||
− | + | ==Built-In Variables == | |
− | + | Built-in variable names always start with an exclamation mark ("'''!'''"). See also this [[Variables|iMacros variable types overview]]. | |
+ | {| | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!CLIPBOARD]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]]||[[!COLn]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!DATASOURCE]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]]||[[!DATASOURCE_COLUMNS]] | ||
+ | |- | ||
+ | |[[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!DATASOURCE_DELIMITER]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!DATASOURCE_LINE]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!DOWNLOADED_FILE_NAME]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!DOWNLOADED_SIZE]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!ENCRYPTION]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[!ENDOFPAGE]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!ERRORIGNORE]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!EXTRACT]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!EXTRACT_TEST_POPUP]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!EXTRACTDIALOG]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!FAIL_ON_ALL_NAVIGATEERRORS]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!FILELOG]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]]||[[!FILESTOPWATCH]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]]||[[!FILE_PROFILER]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!FOLDER_DATASOURCE]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!FOLDER_DOWNLOAD]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!FOLDER_LOG]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] ||[[!FOLDER_MACROS]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]]||[[!FOLDER_STOPWATCH]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] ||[[!HTTP_ERRORCODE]] Version 11.5 and above | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!IMAGEX]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!IMAGEY]] | ||
+ | |- | ||
+ | |[[Image:NGIM-icon.png|iMacros 2021.0]]||[[!IGNORE_ELEMENTNOTFOUND]] | ||
+ | |- | ||
+ | |[[Image:NGIM-icon.png|iMacros 2021.0]]||[[!IGNORE_TIMEOUT]] | ||
+ | |- | ||
+ | |[[Image:NGIM-icon.png|iMacros 2021.0]]||[[!IRTIME]] | ||
+ | |- | ||
+ | |[[Image:NGIM-icon.png|iMacros 2021.0]]||[[!LOG_EXTRACTED_DATA]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!LOOP]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[!MARKOBJECT]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]]||[[!NOW]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!PLAYBACKDELAY]] | ||
+ | |- | ||
+ | |[[Image:Ff-icon.png|Firefox]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!POPUP_ALLOWED]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!REPLAYSPEED]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[!REGION_BOTTOM]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[!REGION_LEFT]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[!REGION_RIGHT]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[!REGION_TOP]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!SINGLESTEP]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!STOPWATCHTIME]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!STOPWATCH_HEADER]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[!TAGSOURCEINDEX]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!TAGX]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!TAGY]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!TIMEOUT]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!TIMEOUT_DOWNLOAD]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!TIMEOUT_MACRO]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!TIMEOUT_PAGE]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!TIMEOUT_STEP]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!URLCURRENT]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] ||[[!USE_DOWNLOADMANAGER]] Version 10.3 and above | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]]||[[!USERAGENT]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]]||[[!VAR0...!VAR9]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[!WAITPAGECOMPLETE]] | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]||[[!WINDOW_TITLE]] Version 11.5 and above | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]]||[[!X_PERFLOG_NOTARGETPATH]] Version 10.3 and above | ||
+ | |- | ||
+ | |[[Image:IMacros-icon.png|iMacros Browser]]||[[!X_PERM_NEW_WINDOW_BEHAVIOR]] | ||
+ | |} | ||
− | + | ==User-defined Variables == | |
− | + | User-defined variables are created with the [[set|SET]] and [[iimSet]] commands. Use [[iimSet]] to pass variables from [[Web Scripting|script code]] to a macro, and [[iimGet]] to retrieve variables from a macro. See also this [[Variables|iMacros variable types overview]]. | |
− | |||
− | |||
− | ==== | + | ==Scripting Interface Command Overview [[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]] [[Image:Cr-icon.png|Chrome]] [[Image:NGIM-icon.png|iMacros 2021.0]]== |
− | + | The Scripting Interface works with the iMacros Browser, Internet Explorer, Firefox and Chrome (see [[iimOpen]] for details on how to switch between the browsers). | |
− | + | #[[iimOpen]] (old: [[iimInit()]]) | |
+ | #[[iimGetBrowserPid]] | ||
+ | #[[iimDisplay]] | ||
+ | #[[iimGet]] (iMacros 12.6) | ||
+ | #[[iimGetInterfaceVersion()]] | ||
+ | #[[iimGetErrorText]] (old: [[iimGetLastError()]]) | ||
+ | #[[iimGetExtract]] (old: [[iimGetLastExtract()]]) | ||
+ | #[[iimGetStopwatch]] (Old: [[iimGetLastPerformance]]) | ||
+ | #[[iimGetPerformance]] | ||
+ | #[[iimPlay]] and [[iimPlayCode]]() | ||
+ | #[[iimSet]] | ||
+ | #[[iimSetWindowTitle]]() [[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] | ||
+ | #[[iimTakeBrowserScreenshot]] | ||
+ | #[[iimClose]] (old: [[iimExit]]) | ||
+ | # Error handling: [[Scripting Interface Return Codes]] | ||
− | + | Refer to the [https://imacros.net/store/compare-versions/ iMacros Editions Comparison Table] to see which editions support the scripting interface (API) | |
− | |||
− | ==== | + | ==Command Line Interface Overview [[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:NGIM-icon.png|iMacros 2021.0]]== |
− | + | #[[-delay]] | |
+ | #[[-help]] | ||
+ | #[[-kioskmode]] | ||
+ | #[[-logfile]] | ||
+ | #[[-loop]] | ||
+ | #[[-macro]] | ||
+ | #[[-noexit]] | ||
+ | #[[-playlist]] (iMacros 12.6) | ||
+ | #[[-profiler]] | ||
+ | #[[-silent]] | ||
+ | #[[-simpleui]] | ||
+ | #[[-title]] | ||
+ | #[[-tray]] | ||
+ | #[[-variables]] (iMacros 12.6, deprecated: [[-var_varname]]) | ||
− | + | In addition to the switches above, the following switches can be used with the iMacros Sidebar for IE: | |
− | + | #[[-timeout]] [[Image:Ie-icon.png|IE Plug-in]] | |
+ | #[[-iePrivate]] [[Image:Ie-icon.png|IE Plug-in]] | ||
− | + | Refer to the [https://imacros.net/store/compare-versions/ iMacros Editions Comparison Table] to see which iMacros editions support the command-line interface (CLI). | |
− | |||
− | + | ===Syntax=== | |
− | |||
− | + | Switch names can be prefixed with either a single hyphen, two hyphens, or a forward slash. Some switches also have abbreviations (or aliases). For switches that take a value, the value can be specified using a space, equals sign, or colon character after the switch name. All of the following examples are valid: | |
− | |||
− | + | imacros.exe -macro MyMacro | |
− | |||
− | |||
− | + | imacros.exe --macro=MyMacro | |
− | |||
− | + | imacros.exe /m:MyMacro | |
− | |||
− | + | To see a table of all of the command line switches along with their descriptions and aliases, enter: | |
− | |||
− | + | imacros.exe /? | |
− | + | or | |
+ | imacros.exe -h | ||
− | + | ==Error Handling== | |
− | + | iMacros includes detailed error handling. | |
− | + | === iMacros Error Codes === | |
− | + | Please see the list of general iMacros [[Error-Codes]]. | |
− | + | === Scripting Interface Error Codes === | |
− | + | Even a web browser crash or freeze does not stop the Scripting Interface. Instead, it will simply return an error code and you can start a new instance. | |
+ | Please see the list of [[Scripting Interface Return Codes]]. | ||
− | + | === Component for .NET === | |
− | |||
− | + | For details on the iMacros WebBrowser Component for .NET, please see the [[Component]] wiki page. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Revision as of 05:00, 20 April 2021
A high-level overview of the different versions of iMacros can be found here
The browser icons listed below and on each command detail page denote browser compatibility. Commands that are supported in all browsers work exactly the same in each browser, so macros created in the iMacros Browser (or Internet Explorer) can be replayed in iMacros for Firefox and vice versa. Browser specific differences are automatically handled by iMacros.
iMacros Commands Reference
' (Comment) | |
ADD | |
BACK | |
CLEAR | |
CLICK | |
DISPLAY | |
DS | |
EVAL | |
EVENT | |
EXTRACT (Part of the TAG command) | |
FILEDELETE | |
FILTER | |
FORWARD (version 12.6 and above) | |
FRAME | |
IMAGECLICK | |
IMAGESEARCH | |
ONCERTIFICATEDIALOG | |
ONDIALOG | |
ONDOWNLOAD | |
ONERRORDIALOG | |
ONINSECURECONNECTION | |
ONLOGIN | |
ONPRINT | |
ONSECURITYDIALOG | |
ONWEBPAGEDIALOG | |
PAUSE | |
PRINTPDF | |
PROMPT | |
PROXY | |
REFRESH | |
SAVEAS | |
SAVEITEM | |
SCREENSHOT | |
SEARCH | |
SET | |
SIZE | |
STOPWATCH | |
TAB | |
TAG | |
TRAY | |
URL | |
VERSION | |
WAIT | |
Error Codes | |
Tip: How to make if/then decisions with iMacros. |
Built-In Variables
Built-in variable names always start with an exclamation mark ("!"). See also this iMacros variable types overview.
User-defined Variables
User-defined variables are created with the SET and iimSet commands. Use iimSet to pass variables from script code to a macro, and iimGet to retrieve variables from a macro. See also this iMacros variable types overview.
Scripting Interface Command Overview
The Scripting Interface works with the iMacros Browser, Internet Explorer, Firefox and Chrome (see iimOpen for details on how to switch between the browsers).
- iimOpen (old: iimInit())
- iimGetBrowserPid
- iimDisplay
- iimGet (iMacros 12.6)
- iimGetInterfaceVersion()
- iimGetErrorText (old: iimGetLastError())
- iimGetExtract (old: iimGetLastExtract())
- iimGetStopwatch (Old: iimGetLastPerformance)
- iimGetPerformance
- iimPlay and iimPlayCode()
- iimSet
- iimSetWindowTitle()
- iimTakeBrowserScreenshot
- iimClose (old: iimExit)
- Error handling: Scripting Interface Return Codes
Refer to the iMacros Editions Comparison Table to see which editions support the scripting interface (API)
Command Line Interface Overview
- -delay
- -help
- -kioskmode
- -logfile
- -loop
- -macro
- -noexit
- -playlist (iMacros 12.6)
- -profiler
- -silent
- -simpleui
- -title
- -tray
- -variables (iMacros 12.6, deprecated: -var_varname)
In addition to the switches above, the following switches can be used with the iMacros Sidebar for IE:
Refer to the iMacros Editions Comparison Table to see which iMacros editions support the command-line interface (CLI).
Syntax
Switch names can be prefixed with either a single hyphen, two hyphens, or a forward slash. Some switches also have abbreviations (or aliases). For switches that take a value, the value can be specified using a space, equals sign, or colon character after the switch name. All of the following examples are valid:
imacros.exe -macro MyMacro
imacros.exe --macro=MyMacro
imacros.exe /m:MyMacro
To see a table of all of the command line switches along with their descriptions and aliases, enter:
imacros.exe /?
or
imacros.exe -h
Error Handling
iMacros includes detailed error handling.
iMacros Error Codes
Please see the list of general iMacros Error-Codes.
Scripting Interface Error Codes
Even a web browser crash or freeze does not stop the Scripting Interface. Instead, it will simply return an error code and you can start a new instance. Please see the list of Scripting Interface Return Codes.
Component for .NET
For details on the iMacros WebBrowser Component for .NET, please see the Component wiki page.