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 "iMacros for Firefox"
(3 intermediate revisions by the same user not shown) | |||
Line 5: | Line 5: | ||
== License == | == License == | ||
− | [ | + | [https://www.progress.com/legal/license-agreements/imacros-imail-and-messageway iMacros End User License Agreement] |
== Installation == | == Installation == | ||
Line 91: | Line 91: | ||
==Version History== | ==Version History== | ||
+ | |||
+ | ===Version 10.1.0, released April 27, 2021=== | ||
+ | This is a minor maintenance release and Progress Software Corporation branding update (UI colors and logo changes). | ||
+ | |||
+ | * Consistency enhancements: | ||
+ | ** Macro variables are initialized to an empty string | ||
+ | ** Specifying duplicate attribute values in the ATTR parameter of the TAG command results in an error | ||
+ | ** !EXTRACT is cleared on each iteration when looping | ||
+ | ** Extraction popup is not displayed by default when looping | ||
+ | |||
+ | * Fixes: | ||
+ | ** Invalid variable reference causes PROMPT command to hang | ||
+ | ** The FOLDER parameter of the ONDOWNLOAD command no longer accepts a value if File Access is not installed | ||
===Version 10.0.2, released July 9, 2018=== | ===Version 10.0.2, released July 9, 2018=== | ||
− | This is the first version which supports Firefox Quantum (Firefox | + | This is the first version which supports Firefox Quantum (Firefox 57 and above). It is a complete new version for the Firefox Webextension API, which has more similarities with [[iMacros for Chrome]] than [[iMacros for Firefox Legacy|previous versions of iMacros for Firefox]]. In particular, there are some commands, variables, and functionality that were previously supported but currently are not mostly because the WebExtension API provided by Mozilla still lacks support for it. |
* Not supported in this version: | * Not supported in this version: | ||
Line 126: | Line 139: | ||
** Changed Play button text to Resume when macro is paused | ** Changed Play button text to Resume when macro is paused | ||
** Added setting to ignore UnsupportedCommand errors bypassing parsing of line (use with care!) | ** Added setting to ignore UnsupportedCommand errors bypassing parsing of line (use with care!) | ||
+ | |||
+ | ===[[iMacros_for_Firefox_Legacy#Version_History|Legacy versions (9.0.3 and older)]]=== | ||
==See Also== | ==See Also== | ||
[[Webextensions]], [[Personal Edition]], [[iMacros for Chrome]], [[Features Comparison]], [[iMacros for Firefox Legacy]] | [[Webextensions]], [[Personal Edition]], [[iMacros for Chrome]], [[Features Comparison]], [[iMacros for Firefox Legacy]] |
Latest revision as of 08:03, 17 June 2021
Scope
iMacros for Firefox (version 10 and above) is one of the iMacros Webextensions. A detailed documentation of features and limitations is found in that page. Here we document the few differences to that common page.
For the legacy versions (9 and below) refer to iMacros for Firefox Legacy.
License
iMacros End User License Agreement
Installation
Download from iMacros @ Mozilla Addons
Downloading Files
If you have iMacro File Access installed you can use the ONDOWNLOAD command to automate the download of files in Firefox. If the File Access is not installed, the ONDOWNLOAD parameters are ignored but the file is downloaded with its default file name, to Firefox default downloads folder. However, by default, Firefox will prompt you to choose between saving or opening a file upon download. iMacros cannot handle this prompt and will only be able to download the file if Firefox default action for this file type is Save File.
If the file type you are downloading is not listed under Content Type, you will have to edit Firefox handlers.js file manually. In the example below we included .exe and .msi in handlers.json, using "action":0 for save.
{ "defaultHandlersVersion": { "en-GB": 4 }, "mimeTypes": { "application/pdf": { "action": 3, "extensions": [ "pdf" ] }, "application/x-7z-compressed": { "action": 0, "extensions": [ "7z" ] }, "application/x-msi": { "action": 0, "extensions": [ "msi" ] }, "application/x-executable": { "action": 0, "extensions": [ "exe" ] } }, "schemes":{... } }
To locate the handlers.json file, type in Firefox navigation bar "about:support" and under General Information/Profile Folder you can click on the button Open Folder.
Clearing Cookies and Cache
When you clear the browser history in Firefox, iMacros stored data is also removed. Thus all your iMacros preferences are lost. iMacros will work again, but you preferences will be reset to their defaults. This also happens if you set Firefox to Clear history when Firefox closes in about:preferences#privacy.
The CLEAR command, on the other hand, does not delete iMacros data, while clearing cache and cookies. It also accepts an argument to filter the cookies to be cleared by domain name. Using CLEAR with no argument clears all cookies and cache. Using e.g.
CLEAR facebook.com
will clear all of the cache, but only cookies from Facebook. If you only want to clear the cache, then specify a nonexistent domain name
CLEAR xxx.yyy.zzz
Scripting Firefox
Due to the WebExtensions framework adopted by Mozilla and released with Firefox 56 (a.k.a. Quantum), iMacros for Firefox 10 no longer includes the built-in Javascript scripting interface for playing .js files directly from the iMacros sidebar. However, as mentioned in Scripting Chrome and Firefox, you can still control iMacros for Firefox via external scripts and programs.
iMacros for Firefox requires the latest version of the iMacros scripting interface (API) included with the File Access installer under the following scenario:
If you use the iMacros Enterprise (v12.0 or older) scripting interface to connect to iMacros for Firefox *and* specify a non-default Firefox profile using e.g.:
iimOpen("-fx -fxProfile MyProfile")
then you will need to copy and overwrite the following dlls first before this functionality will work with the current version of iMacros for Firefox. This is not required if you are already using a newer version of iMacros Enterprise (newer than v12.0) or if you are not using -fxProfile.
Source folder:
%localappdata%\Programs\iMacros
- On 64-bit systems
- Copy imtcp.dll to %programfiles(x86)%\Ipswitch\iMacros
- Copy imtcp64.dll to %programfiles%\Ipswitch\iMacros
- On 32-bit systems
- Copy imtcp.dll to %programfiles%\Ipswitch\iMacros
Known Issues
Current known issues with the latest version of iMacros for Firefox:
- Docking the iMacros panel (sidebar) can break the ability to drag and drop tabs in Firefox.
- Search and replace dialog no longer work in the macro editor due to Firefox CSP (Content Security Policy) for Web Extensions.
Version History
Version 10.1.0, released April 27, 2021
This is a minor maintenance release and Progress Software Corporation branding update (UI colors and logo changes).
- Consistency enhancements:
- Macro variables are initialized to an empty string
- Specifying duplicate attribute values in the ATTR parameter of the TAG command results in an error
- !EXTRACT is cleared on each iteration when looping
- Extraction popup is not displayed by default when looping
- Fixes:
- Invalid variable reference causes PROMPT command to hang
- The FOLDER parameter of the ONDOWNLOAD command no longer accepts a value if File Access is not installed
Version 10.0.2, released July 9, 2018
This is the first version which supports Firefox Quantum (Firefox 57 and above). It is a complete new version for the Firefox Webextension API, which has more similarities with iMacros for Chrome than previous versions of iMacros for Firefox. In particular, there are some commands, variables, and functionality that were previously supported but currently are not mostly because the WebExtension API provided by Mozilla still lacks support for it.
- Not supported in this version:
- CLICK
- EVENT, EVENTS
- FILEDELETE
- FILTER
- ONDIALOG
- PROXY
- !POPUP_ALLOWED
- !SINGLESTEP
- File upload is not supported
- iMacros for Firefox is disabled in Private Browsing mode due to restrictions in Firefox
- The built-in Javascript scripting interface for playing .js files is no longer available. Please use the iMacros Scripting Interface (API) included with some of the iMacros paid editions. This API allows you to control Chrome and Firefox from external scripts and programs (C++, C#, Javascript, Python, Perl, etc.)
- The imacros://run/ URI is no longer supported for running macros from the command line, however, a new method is described here.
- The following commands and variables are newly supported in iMacros 10:
- SIZE
- !FOLDER_DOWNLOAD
- !FOLDER_MACROS
- !IMAGEX, !IMAGEY
- !PLAYBACKDELAY
- Known Issues:
- Docking the iMacros panel (sidebar) can break the ability to drag and drop tabs in Firefox
- Search and replace dialog no longer work in the macro editor due to Firefox CSP (Content Security Policy) for Web Extensions.
- For security reasons in Firefox, you cannot navigate using URL GOTO to a privileged URL such as file:, data:, and about: (although about:home and about:blank are allowed)
- Additional tweaks/enhancements made during the beta period:
- Accept input and confirm PROMPT and other dialogs with a keyboard Enter
- Editor Save and Save As buttons feedback on successful save
- Changed Play button text to Resume when macro is paused
- Added setting to ignore UnsupportedCommand errors bypassing parsing of line (use with care!)
Legacy versions (9.0.3 and older)
See Also
Webextensions, Personal Edition, iMacros for Chrome, Features Comparison, iMacros for Firefox Legacy