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. (On the Processes tab of the Task Manager, if there are two OUTLOOK.EXEs, then one of the processes needs to be ended) 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.
  •