The article presents the most important issues related to the Outlook add-in for YetiForce CRM, so it is important to read it carefully and follow the guidelines for the add-in to work properly.
The add-in suports the following Outlook application types:
The client must be connected to an Exchange server or Microsoft 365 using a direct connection. When configuring the client, the user must choose an Exchange, Office, or Outlook.com account type.
Verify the Outlook version, because the add-in is based on a web browser engine.
Old versions still support the "Internet Explorer" engine, for which the CRM system will not work 100% properly.
https://docs.microsoft.com/en-us/office/dev/add-ins/concepts/browsers-used-by-office-web-add-ins
After the purchase, you need to activate the add-in. When the "Requires intervention" button appears in the Marketplace, go to the "Integration" tab, click "Activate", enter the required data, and download the installation file.
During activation, the system will be configured for integration with Outlook.
The following parameters will be changed:
Installation instructions are available at https://support.microsoft.com/en-us/office/installed-add-ins-a61762b7-7a82-47bd-b14e-bbc15eaeb70f
Please follow the instructions from the link above for proper installation.
You must permit cookies from other websites on the Outlook Web App page.
By default, the browser blocks unwanted scripts from additional websites.
If you do not change it, it will not be possible to log into CRM and the user will only see the login page despite entering access data.
In order for users to be able to use the integration panel, they require access to the "E-mail integration panel" module.
Module access is configured in System settings> Permissions> Profiles and the permissions to this module must be granted for the appropriate profile. If the user does not have access to the module, he will see the information "Error !!! No permissions".
In order for the email import button to appear, the user must have the "create" option ticked for the "Email history" module.
In order to be able to bind data from an e-mail message to CRM data, it is necessary to define how the system can find the data.
Each user that will use the integration panel should have fields from the available modules set in the "Record relation fields (Outlook)", in which the system will search for data to bind.
Enter fields here depending on which modules/fields you use and which modules/fields a given user can use.
The fields will be used to search for related records when displaying an email and when importing an email.
Otherwise, you will not see any data in the integration panel, because the system will not know where to search for information.
Standard fields are: Contacts - Primary email, Accounts - Primary email, Leads - Primary email, Tickets - No., Employees - Business email.
For the "Import email manually" button to appear, it is required to configure actions.
Actions are configured in the Users module in the "Available e-mail scanner actions (Outlook)" field, select "Create email message" and "Creating links to e-mail message".
Standard actions are:
Debugging should take place each time there are issues related to the integration panel.
Below you can find a list of the possible issues we encountered.
Set the following value config/Security.php in the config/Security.php configuration file in the $allowedDomainsLoadInFrame variable:
/** Allowed domains for loading script, used in CSP. */ public static $allowedScriptDomains = ['https://appsforoffice.microsoft.com', 'https://ajax.aspnetcdn.com']; /** * Specifies valid sources for nested browsing contexts loading using elements such as <frame> and <iframe>. * CSP: frame-src. */ public static $allowedDomainsLoadInFrame = ['https://appsforoffice.microsoft.com'];
When the panel is not displayed correctly or data is missing: https://docs.microsoft.com/en-US/outlook/troubleshoot/user-interface/office-add-ins-not-displayed-correctly
Debugging: https://docs.microsoft.com/en-us/office/dev/add-ins/testing/test-debug-office-add-ins
Debugging using Microsoft Edge DevTools: https://docs.microsoft.com/en-us/office/dev/add-ins/testing/debug-add-ins-using-f12-developer-tools-on-windows-10#debug-using-microsoft-edge-devtools