Skip to content

Commit 75ff3db

Browse files
committed
[IMP] Outlook: update setup steps
closes #15367 Signed-off-by: Felicia Kuan (feku) <feku@odoo.com>
1 parent fe49f03 commit 75ff3db

File tree

9 files changed

+43
-50
lines changed

9 files changed

+43
-50
lines changed

content/applications/general/integrations/mail_plugins/outlook.rst

Lines changed: 43 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ The Outlook :doc:`Mail Plugin <../mail_plugins>` needs to be configured both on
1616
Enable Mail Plugin
1717
------------------
1818

19-
First, enable the *Mail Plugin* feature in the database. Go to :menuselection:`Settings --> General
19+
First, enable the *Mail Plugin* module in the database. Go to :menuselection:`Settings --> General
2020
Settings --> Integrations`, enable :guilabel:`Mail Plugin`, and :guilabel:`Save` the configuration.
2121

2222
.. _mail-plugin/outlook/install-plugin:
@@ -29,36 +29,26 @@ later: `https://download.odoocdn.com/plugins/outlook/manifest.xml
2929
<https://download.odoocdn.com/plugins/outlook/manifest.xml>`_.
3030

3131
Next, open the Outlook mailbox, and select any email. After completing this, click on the
32-
:guilabel:`More actions` button in the upper right-side and select :guilabel:`Get Add-ins`.
32+
:guilabel:`Apps` button in the upper right-side, then click :guilabel:`Get add-ins`.
3333

3434
.. image:: outlook/more-actions.png
35-
:align: center
36-
:alt: More actions button in Outlook
37-
38-
.. tip::
39-
For locally installed versions of Microsoft Outlook, access the :guilabel:`Get Add-ins` menu item
40-
while in preview mode (**not** with a message open). First, click on the :guilabel:`...
41-
(ellipsis)` icon in the upper right of the previewed message, then scroll down, and click on
42-
:guilabel:`Get Add-ins`.
35+
:alt: Apps button in Outlook
4336

4437
Following this step, select the :guilabel:`My add-ins` tab on the left-side.
4538

4639
.. image:: outlook/my-add-ins.png
47-
:align: center
4840
:alt: My add-ins in Outlook
4941

50-
Under :guilabel:`Custom add-ins` towards the bottom, click on :guilabel:`+ Add a custom add-in`, and
51-
then on :guilabel:`Add from file...`
42+
Under :guilabel:`Custom Addins` towards the bottom, click on :guilabel:`+ Add a custom add-in`, then
43+
select :guilabel:`Add from file...`
5244

5345
.. image:: outlook/custom-add-ins.png
54-
:align: center
5546
:alt: Custom add-ins in Outlook
5647

5748
For the next step, attach the `manifest.xml` file downloaded above, and press :guilabel:`OK`. Next,
5849
read the warning and click on :guilabel:`Install`.
5950

6051
.. image:: outlook/add-in-warning.png
61-
:align: center
6252
:alt: Custom add-in installation warning in Outlook
6353

6454
.. _mail-plugin/outlook/connect-database:
@@ -67,18 +57,16 @@ Connect the database
6757
--------------------
6858

6959
Now, Outlook will be connected to the Odoo database. First, open any email in the Outlook mailbox,
70-
click on the :guilabel:`More actions` button in the upper right-side, and select :guilabel:`Odoo for
71-
Outlook`.
60+
click on the :guilabel:`Apps` button in the upper right-side, and select :guilabel:`Odoo Inbox
61+
Addin`.
7262

7363
.. image:: outlook/odoo-for-outlook.png
74-
:align: center
7564
:alt: Odoo for Outlook add-in button
7665

7766
The right-side panel can now display **Company Insights**. At the bottom, click on
7867
:guilabel:`Login`.
7968

8069
.. image:: outlook/panel-login.png
81-
:align: center
8270
:alt: Logging in the Odoo database
8371

8472
.. note::
@@ -88,69 +76,74 @@ The right-side panel can now display **Company Insights**. At the bottom, click
8876
.. tip::
8977
If, after a short while, the panel is still empty, it is possible that the browser cookie
9078
settings prevented it from loading. Note that these settings also change if the browser is in
91-
"Incognito" mode.
79+
*Incognito* mode.
9280

9381
To fix this issue, configure the browser to always allow cookies on Odoo's plugin page.
9482

9583
For Google Chrome, change the browser cookie settings by following the guide at:
9684
`https://support.google.com/chrome/answer/95647
97-
<https://support.google.com/chrome/answer/95647>`_
98-
and adding `download.odoo.com` to the list of :guilabel:`Sites that can always use cookies`.
85+
<https://support.google.com/chrome/answer/95647>`_ and adding `download.odoo.com` to the list of
86+
:guilabel:`Sites that can always use cookies`.
9987

10088
Once this is complete, the Outlook panel needs to be opened again.
10189

10290
Now, enter the Odoo database URL and click on :guilabel:`Login`.
10391

10492
.. image:: outlook/enter-database-url.png
105-
:align: center
10693
:alt: Entering the Odoo database URL
10794

10895
Next, click on :guilabel:`Allow` to open the pop-up window.
10996

11097
.. image:: outlook/new-window-warning.png
111-
:align: center
11298
:alt: New window pop-up warning
11399

114100
If the user isn't logged into the database, enter the credentials. Click on :guilabel:`Allow` to let
115101
the Outlook Plugin connect to the database.
116102

117103
.. image:: outlook/odoo-permission.png
118-
:align: center
119104
:alt: Allowing the Outlook Plugin to connect to a database
120105

121106
.. _mail-plugin/outlook/add-shortcut:
122107

123-
Add a shortcut to the plugin
124-
----------------------------
108+
Using the inbox plugin
109+
======================
110+
111+
To use the plugin, open any email in the Outlook mailbox, click on the :guilabel:`Apps` button in
112+
the upper right-side, and select :guilabel:`Odoo Inbox Addin` to open the panel.
113+
114+
.. note::
115+
The options available in the panel will vary based on the applications installed in the database.
125116

126-
By default, the Outlook Plugin can be opened from the *More actions* menu. However, to save time,
127-
it's possible to add it next to the other default actions.
117+
Create a contact
118+
----------------
128119

129-
In the Outlook mailbox, click on :guilabel:`Settings`, then on :guilabel:`View all Outlook
130-
settings`.
120+
To create a contact record in Odoo from an email, click the :icon:`fa-plus-circle`
121+
:guilabel:`(circle plus)` icon.
131122

132-
.. image:: outlook/all-outlook-settings.png
133-
:align: center
134-
:alt: Viewing all Outlook settings
123+
.. note::
124+
A contact record **must** be created before a lead/opportunity can be created.
135125

136-
Now, select :guilabel:`Customize actions` under :guilabel:`Mail`, click on :guilabel:`Odoo for
137-
Outlook`, and then :guilabel:`Save`.
126+
Create an opportunity
127+
---------------------
138128

139-
.. image:: outlook/customize-actions.png
140-
:align: center
141-
:alt: Odoo for Outlook customized action
129+
To create an opportunity from an email, click the :icon:`fa-plus` :guilabel:`(plus)` icon next to
130+
:guilabel:`Opportunities`. Doing so opens a new opportunity record in Odoo in a new tab. The subject
131+
of the email is used as the opportunity title, and the content of the email is added to the
132+
:guilabel:`Notes` tab of the opportunity.
142133

143-
Following this step, open any email; the shortcut should be displayed.
134+
Create a task
135+
-------------
144136

145-
.. image:: outlook/odoo-outlook-shortcut.png
146-
:align: center
147-
:alt: Odoo for Outlook customized action
137+
To create a task from an email, click the :icon:`fa-plus` :guilabel:`(plus)` icon next to
138+
:guilabel:`Tasks`. Then, enter the title of the project where the task should be created in the
139+
resulting field, and select the appropriate project from the resulting list. This opens a new task
140+
record in Odoo in a new tab. The subject of the email is used as the task title, and the content of
141+
the email is added to the :guilabel:`Description` tab.
148142

149-
Using the plugin
150-
----------------
143+
Create a ticket
144+
---------------
151145

152-
Now that the plug-in is installed and operational, all that needs to be done to create a lead is to
153-
click on the `O` [Odoo icon] or navigate to :guilabel:`More actions` and click on :guilabel:`Odoo
154-
for Outlook`. The side panel will appear on the right-side, and under :guilabel:`Opportunities`
155-
click on :guilabel:`New`. A new window with the created opportunity in the Odoo database will
156-
populate.
146+
To create a task from an email, click the :icon:`fa-plus` :guilabel:`(plus)` icon next to
147+
:guilabel:`Tickets`. Doing so opens a new ticket record in Odoo in a new tab. The subject of the
148+
email is used as the ticket title, and the content of the email is added to the
149+
:guilabel:`Description` tab of the ticket.
Binary file not shown.
1.7 KB
Loading
Binary file not shown.
3.86 KB
Loading
24.6 KB
Loading
2.67 KB
Loading
5.3 KB
Loading
Binary file not shown.

0 commit comments

Comments
 (0)