From c544781acc665d65700e5724bfaa910fed7d35cc Mon Sep 17 00:00:00 2001 From: tiku-odoo Date: Tue, 14 Nov 2023 11:47:00 -0500 Subject: [PATCH] [IMP] Productivity: Outlook Plugin edits closes odoo/documentation#6480 X-original-commit: 71aabb2618ba6864a7ea0ba1ca6b5b1af1525419 Signed-off-by: Timothy Kukulka (tiku) --- .../productivity/mail_plugins/outlook.rst | 171 ++++++++++-------- .../mail_plugins/outlook/custom-add-ins.png | Bin 4360 -> 6403 bytes .../mail_plugins/outlook/enter-add-in-url.png | Bin 4719 -> 0 bytes 3 files changed, 92 insertions(+), 79 deletions(-) delete mode 100644 content/applications/productivity/mail_plugins/outlook/enter-add-in-url.png diff --git a/content/applications/productivity/mail_plugins/outlook.rst b/content/applications/productivity/mail_plugins/outlook.rst index de7d78115..d330bbcd3 100644 --- a/content/applications/productivity/mail_plugins/outlook.rst +++ b/content/applications/productivity/mail_plugins/outlook.rst @@ -2,6 +2,10 @@ Outlook Plugin ============== +Outlook allows for third-party applications to connect in order to execute database actions from +emails. Odoo has a plugin for Outlook that allows for the creation of an opportunity from the email +panel. + Configuration ============= @@ -12,126 +16,135 @@ The Outlook :doc:`Mail Plugin <../mail_plugins>` needs to be configured both on Enable Mail Plugin ------------------ -First, you need to enable the *Mail Plugin* feature in your database. Go to :menuselection:`Settings ---> General Settings --> Integrations`, enable *Mail Plugin*, and *Save* the configuration. +First, enable the *Mail Plugin* feature in the database. Go to :menuselection:`Settings --> General +Settings --> Integrations`, enable :guilabel:`Mail Plugin`, and :guilabel:`Save` the configuration. .. _mail-plugin/outlook/install-plugin: Install the Outlook Plugin -------------------------- -#. Open your Outlook mailbox and select any email. +Download (:menuselection:`Save Page As --> Web Page XML only`) the following XML file to upload +later: `https://download.odoocdn.com/plugins/outlook/manifest.xml +`_. -#. Click on the *More actions* button and select *Get Add-ins*. +Next, open the Outlook mailbox, and select any email. After completing this, click on the +:guilabel:`More actions` button in the upper right-side and select :guilabel:`Get Add-ins`. - .. image:: outlook/more-actions.png - :align: center - :alt: More actions button in Outlook +.. image:: outlook/more-actions.png + :align: center + :alt: More actions button in Outlook -#. Select the *My add-ins* tab. +Following this step, select the :guilabel:`My add-ins` tab on the left-side. - .. image:: outlook/my-add-ins.png - :align: center - :alt: My add-ins in Outlook +.. image:: outlook/my-add-ins.png + :align: center + :alt: My add-ins in Outlook -#. Under *Custom add-ins*, click on *+ Add a custom add-in*, and then on *Add from URL...* +Under :guilabel:`Custom add-ins` towards the bottom, click on :guilabel:`+ Add a custom add-in`, and +then on :guilabel:`Add from file...` - .. image:: outlook/custom-add-ins.png - :align: center - :alt: Custom add-ins in Outlook +.. image:: outlook/custom-add-ins.png + :align: center + :alt: Custom add-ins in Outlook -#. Enter the following URL `https://download.odoocdn.com/plugins/v15/outlook/manifest.xml` and press - *OK*. +For the next step, attach the `manifest.xml` file downloaded above, and press :guilabel:`OK`. Next, +read the warning and click on :guilabel:`Install`. - .. image:: outlook/enter-add-in-url.png - :align: center - :alt: Entering the add-in URL in Outlook - -#. Read the warning and click on *Install*. - - .. image:: outlook/add-in-warning.png - :align: center - :alt: Custom add-in installation warning in Outlook +.. image:: outlook/add-in-warning.png + :align: center + :alt: Custom add-in installation warning in Outlook .. _mail-plugin/outlook/connect-database: -Connect your database ---------------------- +Connect the database +-------------------- -#. Open any email in your Outlook mailbox, click on the *More actions* button, and select *Odoo for - Outlook*. +Now, Outlook will be connected to the Odoo database. First, open any email in the Outlook mailbox, +click on the :guilabel:`More actions` button in the upper right-side, and select :guilabel:`Odoo for +Outlook`. - .. image:: outlook/odoo-for-outlook.png - :align: center - :alt: Odoo for Outlook add-in button +.. image:: outlook/odoo-for-outlook.png + :align: center + :alt: Odoo for Outlook add-in button -#. The right-side panel can now display **Company Insights**. At the bottom, click on *Login*. +The right-side panel can now display **Company Insights**. At the bottom, click on +:guilabel:`Login`. - .. image:: outlook/panel-login.png - :align: center - :alt: Logging in your Odoo database +.. image:: outlook/panel-login.png + :align: center + :alt: Logging in the Odoo database - .. note:: - Only a limited amount of *Company Insights* (*Lead Enrichment*) requests are available as a - trial. This feature requires :ref:`prepaid credits `. +.. note:: + Only a limited amount of **Company Insights** (*Lead Enrichment*) requests are available as a + trial database. This feature requires :ref:`prepaid credits `. - .. tip:: - If, after a short while, the panel is still empty, it is possible that your browser cookie - settings prevented it from loading. - Note that these settings also change if you are in "Incognito" mode on your - browser. +.. tip:: + If, after a short while, the panel is still empty, it is possible that the browser cookie + settings prevented it from loading. Note that these settings also change if the browser is in + "Incognito" mode. - To fix this issue, configure your browser to always allow cookies on Odoo's plugin page. + To fix this issue, configure the browser to always allow cookies on Odoo's plugin page. - For Google Chrome, you can do so by following the guide at: - `https://support.google.com/chrome/answer/95647 `_ - and adding `download.odoo.com` to the list of `Sites that can always use cookies`. + For Google Chrome, change the browser cookie settings by following the guide at: + `https://support.google.com/chrome/answer/95647 + `_ + and adding `download.odoo.com` to the list of :guilabel:`Sites that can always use cookies`. - Once done, the Outlook panel needs to be opened again. + Once this is complete, the Outlook panel needs to be opened again. +Now, enter the Odoo database URL and click on :guilabel:`Login`. -#. Enter your Odoo database URL and click on *Login*. +.. image:: outlook/enter-database-url.png + :align: center + :alt: Entering the Odoo database URL - .. image:: outlook/enter-database-url.png - :align: center - :alt: Entering your Odoo database URL +Next, click on :guilabel:`Allow` to open the pop-up window. -#. Click on *Allow* to open the pop-up window. +.. image:: outlook/new-window-warning.png + :align: center + :alt: New window pop-up warning - .. image:: outlook/new-window-warning.png - :align: center - :alt: New window pop-up warning +If the user isn't logged into the database, enter the credentials. Click on :guilabel:`Allow` to let +the Outlook Plugin connect to the database. -#. If you aren't logged into your database, enter your credentials. - -#. Click on *Allow* to let the Outlook Plugin connect to your database. - - .. image:: outlook/odoo-permission.png - :align: center - :alt: Allowing the Outlook Plugin to connect to a database +.. image:: outlook/odoo-permission.png + :align: center + :alt: Allowing the Outlook Plugin to connect to a database .. _mail-plugin/outlook/add-shortcut: Add a shortcut to the plugin ---------------------------- -By default, the Outlook Plugin can be opened from the *More actions* menu. However, to save -time, it's possible to add it next to the other default actions. +By default, the Outlook Plugin can be opened from the *More actions* menu. However, to save time, +it's possible to add it next to the other default actions. -#. In your Outlook mailbox, click on *Settings*, then on *View all Outlook settings*. +In the Outlook mailbox, click on :guilabel:`Settings`, then on :guilabel:`View all Outlook +settings`. - .. image:: outlook/all-outlook-settings.png - :align: center - :alt: Viewing all Outlook settings +.. image:: outlook/all-outlook-settings.png + :align: center + :alt: Viewing all Outlook settings -#. Select *Customize actions* under *Mail*, click on *Odoo for Outlook*, and then *Save*. +Now, select :guilabel:`Customize actions` under :guilabel:`Mail`, click on :guilabel:`Odoo for +Outlook`, and then :guilabel:`Save`. - .. image:: outlook/customize-actions.png - :align: center - :alt: Odoo for Outlook customized action +.. image:: outlook/customize-actions.png + :align: center + :alt: Odoo for Outlook customized action -#. Open any email; the shortcut should be displayed. +Following this step, open any email; the shortcut should be displayed. - .. image:: outlook/odoo-outlook-shortcut.png - :align: center - :alt: Odoo for Outlook customized action +.. image:: outlook/odoo-outlook-shortcut.png + :align: center + :alt: Odoo for Outlook customized action + +Using the plugin +---------------- + +Now that the plug-in is installed and operational, all that needs to be done to create a lead is to +click on the `O` [Odoo icon] or navigate to :guilabel:`More actions` and click on :guilabel:`Odoo +for Outlook`. The side panel will appear on the right-side, and under :guilabel:`Opportunities` +click on :guilabel:`New`. A new window with the created opportunity in the Odoo database will +populate. diff --git a/content/applications/productivity/mail_plugins/outlook/custom-add-ins.png b/content/applications/productivity/mail_plugins/outlook/custom-add-ins.png index fd3abb534cdea77f2034afe1bf6b754099949763..40aa5adf52a5b93e4499a09e295c008542e8bc34 100644 GIT binary patch literal 6403 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 Rzo`bnGj(0HN)_v{{{hED8w3CV literal 4360 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