ITrack/How to change MAPI EMail preferences

What is MAPI?

MAPI, the Messaging Application Program Interface, is a way for us to tell Windows to do email-related things. Essentially, we tell Windows, "Open an email!" and it follows its own configuration for how to do so.

Why would I want to change this?

Some portions of ITrack (AX, Pro, and Enterprise) can create specialized email content for you, mostly for sending to customers. If there's a button that says EMAIL on it, it most likely uses MAPI. In the case where you want it to open a different email interface, instead of the default one Windows provides, this lets you do it!

How to change MAPI settings

Vista/Windows 7

1. Click the Start button at the edge of your taskbar.
2. Go to Control Panel
3. Click 'Default Programs'
   • If you don't see this setting, look for 'View By' and set it to 'Large Icons'
   • If THAT doesn't work, look for 'Classic View' and click on it
4. Click 'Set program access and computer defaults'
5. Click the double-arrow on 'Custom'
6. Scroll to 'Choose a default e-mail program' and expand it if there are no options there
7. Choose what you want to use instead, and press OK

Potential Issues

Operation Failed

• You might get this error in ITrack when the user is using Outlook, it means that their are two copies of Outlook running, close one. More info
• It might mean that the partsemailtemplate setting in their host.ini > email section is set to a path/file that doesn't exist. Just set it to empty.
• There might be an error when Mapi tries adding attachments to the email: Unable to send email, MapiSendMail failed. Error Code 11(attachment not found).
  • There may be a bug in ITrack where it cannot use a relative path to attach images to an email. To fix, set the images directory path to be absolute instead of relative.
  •