Loading

Integrate Office 365 and Microsoft Outlook with PRISMAdirect

You can create orders based on emails received from Office 365 and Microsoft Outlook. Furthermore, when the customer accepts the order, you can receive that status change via an email.

NOTE

Multiple order managers can work in the order processing console:

  • If the order managers share one email account, then you have to configure and install the "Office 365 add-in" or the "Outlook add-in" once.

  • If the order managers each use their own email account, then you have to configure and install the "Office 365 add-in" or the "Outlook add-in" for each email account.

  • Since Office 365 is web-based, the order managers can access their Office 365 account from any available computer.

Precondition to integrate Office 365 with PRISMAdirect

You have to enable secure connections:

  1. Click [System] - [Security] - [Connection].

  2. Enable [Use secure connections (HTTPS)].

    Enable this option to use a secure HTTPS connection between the server and the web server. If you enable this option you have to have a certificate. A certificate guarantees a secure (HTTPS) connection.

    The certificate must be valid.

Add the OrderID to the subject of each email

It is recommended to add the OrderID to the subject of each email which is sent from the application. Add the OrderID for easy identification of the job.

  1. Click [Order processing] - [General settings] - [General settings].

  2. Enable the [Always add the OrderID to the email subject] option.

  3. Click [Save].

Integrate Office 365

You can install the Office 365 add-in on Windows and iOS operating systems.

Register PRISMAdirect on the Microsoft developers site

  1. Open a browser on a computer that has access to the PRISMAdirect server.

  2. Go to https://apps.dev.microsoft.com.

  3. Create an account and log in.

  4. Click "Add an app".

  5. Type a name for the application and click "Create". The name is used internally by Microsoft and will not be visible for customers.

  6. Scroll to section "Microsoft Graph Permissions" and click "Add" for option "Delegated Permissions".

  7. Enable “Mail.Read” and click OK.

  8. Scroll to section "Platforms" and click "Add Platform".

  9. Select "Web" as platform type.

  10. Click [Save]. Do not close the web page.

    The [Save] button is available in the bottom of the web page.

Integrate Office 365 with PRISMAdirect

During registration, Microsoft generates the [Application ID] and the [Application secret]. The [Redirect URL] is always available in PRISMAdirect. You'll need these settings to integrate Office 365 with PRISMAdirect.

PRISMAdirect always generates a redirect URL. You can edit the URL, for example, when you want to use a friendly URL. When you register the add-in, you have to use the redirect URL in both PRISMAdirect and the add-in. The redirect URL establishes the communication between the add-in and PRISMAdirect.

The [LDAP attribute for user name:] is automatically retrieved from the LDAP server. If required, you can change the attribute manually in this dialog. PRISMAdirect uses this attribute to retrieve the user profile of the current user when sending emails. The server of PRISMAdirect is registered in a certain domain. The LDAP server that is registered in the same domain will be used to retrieve the user data. There can be only one LDAP server registered in the same domain as the PRISMAdirect server.

  1. Copy the "Application Id" displayed in the Microsoft developers site.

  2. Click [System] - [Connectivity] - [Office 365 add-in].

  3. Paste the "Application Id" into option [Application ID] in the [Office 365 add-in] dialog of PRISMAdirect.

  4. Click [Save].

  5. Copy the [Redirect URL] displayed in the [Office 365 add-in] dialog.

    PRISMAdirect automatically fills in the [Redirect URL] and the [LDAP attribute for user name:].

  6. Go to the Microsoft developers site.

  7. Scroll to section "Platforms" and paste the [Redirect URL] into option "Redirect URLs".

  8. Click [Save]. Do not close the web page.

    The [Save] button is available in the bottom of the web page.

  9. Scroll to section "Application Secrets" and click "Generate New Password".

  10. Copy the password. It is recommended that you store the password in a file. Click OK.

  11. Click [System] - [Connectivity] - [Office 365 add-in].

  12. Paste the password into option [Application secret] in the [Office 365 add-in] dialog of PRISMAdirect.

  13. Click [Save].

Install the add-in

You can install the add-in in every Office 365 environment that has access to the PRISMAdirect server.

  1. Click [System] - [Downloads].

  2. Download the "PRISMAdirect Office 365 AddIn". Select option "Save File" if a dialog opens to ask you what to do with the file. The default download location for the file is the "Downloads" folder.

    PRISMAdirect will not notify you when the download is completed.

  3. Open a browser on a computer that has access to the PRISMAdirect server.

  4. Go to outlook.office365.com.

  5. Log in with an account that is valid for the Office 365 environment.

  6. Click the cogwheel icon to open the settings.

  7. Select "Manage add-ins".

  8. Select "My add-ins".

  9. Select "+ Add a custom add-in", then select "Add from file..." in section "Custom add-ins".

  10. Browse to the folder that contains the downloaded "PRISMAdirect Office 365 AddIn.xml" file. By default, that is the "Downloads" folder.

  11. Select the file and click "Open".

  12. Click "Install".

  13. When installation is completed, the custom add-in "PRISMAdirect" is added to Office 365.

    To create an order from an email, click the small icon of the PRISMAdirect add-in. In the right-hand side, a dialog expands and you can click "Create order from email".

Integrate Microsoft Outlook

You can install the Microsoft Outlook add-in only on Windows operating systems.

  1. Open workspace [Configuration] and go to [Downloads].

  2. Download the "PRISMAdirect Outlook AddIn".

    Wait until the "OutlookAddInInstallerZip.exe" has been downloaded.

  3. Run the executable on each computer that connects to the order processing workspace. The Outlook Addin allows the order manager and operator can create orders from emails.