3
.. i18n: single: Thunderbird (Mozilla)
7
single: Thunderbird (Mozilla)
9
.. i18n: Mozilla Thunderbird interface
10
.. i18n: =============================
13
Mozilla Thunderbird interface
14
=============================
16
.. i18n: With the Mozilla Thunderbird plugin you can carry out a series of OpenERP operations directly from Thunderbird, such as:
19
With the Mozilla Thunderbird plugin you can carry out a series of OpenERP operations directly from Thunderbird, such as:
21
.. i18n: * create a contact or partner from an e-mail,
23
.. i18n: * save an e-mail and its attachments in OpenERP,
25
.. i18n: * send any attachment to an OpenERP document (such as proposals, projects, and tasks).
28
* create a contact or partner from an e-mail,
30
* save an e-mail and its attachments in OpenERP,
32
* send any attachment to an OpenERP document (such as proposals, projects, and tasks).
34
.. i18n: This might be useful for sending documents about a customer project to the corresponding project in OpenERP, attaching documents to an order (such as proof of payment and order receipts), attaching documents to an employee file (such as a CV or annual appraisal).
37
This might be useful for sending documents about a customer project to the corresponding project in OpenERP, attaching documents to an order (such as proof of payment and order receipts), attaching documents to an employee file (such as a CV or annual appraisal).
39
.. i18n: Installing the Thunderbird plugin
40
.. i18n: ---------------------------------
43
Installing the Thunderbird plugin
44
---------------------------------
46
.. i18n: * Step 1: install the Thunderbird plugin in OpenERP
49
* Step 1: install the Thunderbird plugin in OpenERP
51
.. i18n: Use the OpenERP Configuration Wizard and install the ``Customer Relationship Management`` application. In the *CRM Application Configuration* dialog under Plug-In, select Thunderbird.
52
.. i18n: Then the *Thunderbird Plug-In* wizard appears. Next to the ``Thunderbird Plug-in`` field, click the ``Save As`` button to save the plugin to your desktop (or any other location on your computer).
55
Use the OpenERP Configuration Wizard and install the ``Customer Relationship Management`` application. In the *CRM Application Configuration* dialog under Plug-In, select Thunderbird.
56
Then the *Thunderbird Plug-In* wizard appears. Next to the ``Thunderbird Plug-in`` field, click the ``Save As`` button to save the plugin to your desktop (or any other location on your computer).
58
.. i18n: You can also download the installation manual by clicking the orange arrow next to ``Installation Manual``.
61
You can also download the installation manual by clicking the orange arrow next to ``Installation Manual``.
63
.. i18n: Another way to use the Thunderbird plugin, is by installing the OpenERP module \
64
.. i18n: ``thunderbird``\. When you install this module, the same Configuration Wizard as explained before will be displayed. Follow the same instructions.
67
Another way to use the Thunderbird plugin, is by installing the OpenERP module \
68
``thunderbird``\. When you install this module, the same Configuration Wizard as explained before will be displayed. Follow the same instructions.
70
.. i18n: * Step 2: install the OpenERP extension in Thunderbird.
73
* Step 2: install the OpenERP extension in Thunderbird.
75
.. i18n: To do that, use the file \``openerp_plugin.xpi``\ that you saved on your desktop.
78
To do that, use the file \``openerp_plugin.xpi``\ that you saved on your desktop.
80
.. i18n: Then proceed as follows:
83
Then proceed as follows:
85
.. i18n: #. From Thunderbird, open the menu :menuselection:`Tools --> Add-ons`.
87
.. i18n: #. Click Extensions, then click the `Install` button.
89
.. i18n: #. Go to your desktop and select the file \ ``openerp_plugin.xpi``\. Click Open.
91
.. i18n: #. Click `Install Now` then restart Thunderbird.
94
#. From Thunderbird, open the menu :menuselection:`Tools --> Add-ons`.
96
#. Click Extensions, then click the `Install` button.
98
#. Go to your desktop and select the file \ ``openerp_plugin.xpi``\. Click Open.
100
#. Click `Install Now` then restart Thunderbird.
102
.. i18n: Once the extension has been installed, a new ``OpenERP`` menu item is added to your Thunderbird menubar.
105
Once the extension has been installed, a new ``OpenERP`` menu item is added to your Thunderbird menubar.
107
.. i18n: .. tip:: Thunderbird version
109
.. i18n: The OpenERP plugin for Thunderbird works as from Thunderbird version 2.0.
111
.. i18n: So check your Thunderbird version before installing, and download the latest version that you need
112
.. i18n: from the following address: http://www.mozilla.org/products/thunderbird/
115
.. tip:: Thunderbird version
117
The OpenERP plugin for Thunderbird works as from Thunderbird version 2.0.
119
So check your Thunderbird version before installing, and download the latest version that you need
120
from the following address: http://www.mozilla.org/products/thunderbird/
122
.. i18n: Configuring the Thunderbird plugin
123
.. i18n: ----------------------------------
126
Configuring the Thunderbird plugin
127
----------------------------------
129
.. i18n: When you have executed Installation Step 1 and Step 2, the first thing to do is connect Thunderbird to OpenERP.
130
.. i18n: A little configuration needs to be done.
133
When you have executed Installation Step 1 and Step 2, the first thing to do is connect Thunderbird to OpenERP.
134
A little configuration needs to be done.
136
.. i18n: .. note:: Before starting the configuration, make sure your gtk server and web server are running (xml-rpc should be allowed).
139
.. note:: Before starting the configuration, make sure your gtk server and web server are running (xml-rpc should be allowed).
141
.. i18n: Go to the ``OpenERP`` menubar and select ` Configuration`.
144
Go to the ``OpenERP`` menubar and select ` Configuration`.
146
.. i18n: A configuration window appears enabling you to enter configuration data about your OpenERP server.
149
A configuration window appears enabling you to enter configuration data about your OpenERP server.
151
.. i18n: .. figure:: images/thunderbird_config.png
153
.. i18n: :align: center
155
.. i18n: *How to Connect to the Server*
157
.. i18n: #. On the ``Configuration Settings`` tab, under *Connection Parameters* click the `Change` button
158
.. i18n: and type your server settings and xml-rpc port, e.g. ``http://127.0.0.1:8069``,
160
.. i18n: #. Select the database you want to connect to, and type the user and the password required to log in to the database,
162
.. i18n: #. Click the `Connect` button,
164
.. i18n: #. On the ``Configuration Settings`` tab, under *Webserver Parameters* click the `Change` button
165
.. i18n: and type your web server settings, e.g. ``http://localhost:8080``,
167
.. i18n: #. Click the `Open` button to test the connection.
170
.. figure:: images/thunderbird_config.png
174
*How to Connect to the Server*
176
#. On the ``Configuration Settings`` tab, under *Connection Parameters* click the `Change` button
177
and type your server settings and xml-rpc port, e.g. ``http://127.0.0.1:8069``,
179
#. Select the database you want to connect to, and type the user and the password required to log in to the database,
181
#. Click the `Connect` button,
183
#. On the ``Configuration Settings`` tab, under *Webserver Parameters* click the `Change` button
184
and type your web server settings, e.g. ``http://localhost:8080``,
186
#. Click the `Open` button to test the connection.
188
.. i18n: When your connection has succeeded, you would typically want to configure Thunderbird to fit your needs.
191
When your connection has succeeded, you would typically want to configure Thunderbird to fit your needs.
193
.. i18n: To define extra document types, go to the `Document Settings` tab. This is the place where you can add objects from OpenERP that you wish to link mails to. The default installation comes with a number of predefined documents, such as Partners, Leads and Sales Orders.
196
To define extra document types, go to the `Document Settings` tab. This is the place where you can add objects from OpenERP that you wish to link mails to. The default installation comes with a number of predefined documents, such as Partners, Leads and Sales Orders.
198
.. i18n: Here is an example of how to configure extra document types. Suppose you would like to link mails to a purchase order.
201
Here is an example of how to configure extra document types. Suppose you would like to link mails to a purchase order.
203
.. i18n: #. In the `Title`, type Purchase Order,
205
.. i18n: #. In the `Document`, type the object from OpenERP, in this example ``purchase.order``,
207
.. i18n: #. In the `Image`, select an icon you would like to use,
209
.. i18n: #. Click the `Add` button to actually create the document type.
212
#. In the `Title`, type Purchase Order,
214
#. In the `Document`, type the object from OpenERP, in this example ``purchase.order``,
216
#. In the `Image`, select an icon you would like to use,
218
#. Click the `Add` button to actually create the document type.
220
.. i18n: .. note:: To find the object you need in OpenERP, go to the menu :menuselection:`Administration --> Customization --> Database Structure --> Objects`. OpenERP will only show objects for which the corresponding Business Applications / Modules have been installed. You can only add objects to Thunderbird that are available in the selected database.
223
.. note:: To find the object you need in OpenERP, go to the menu :menuselection:`Administration --> Customization --> Database Structure --> Objects`. OpenERP will only show objects for which the corresponding Business Applications / Modules have been installed. You can only add objects to Thunderbird that are available in the selected database.
225
.. i18n: .. figure:: images/thunderbird_document.png
227
.. i18n: :align: center
229
.. i18n: *How to Add Extra OpenERP Document Types to Thunderbird?*
232
.. figure:: images/thunderbird_document.png
236
*How to Add Extra OpenERP Document Types to Thunderbird?*
238
.. i18n: Using the Thunderbird plugin
239
.. i18n: ----------------------------
242
Using the Thunderbird plugin
243
----------------------------
245
.. i18n: You can use the menu :menuselection:`OpenERP` for several things.
248
You can use the menu :menuselection:`OpenERP` for several things.
250
.. i18n: The `Push` option allows you to archive e-mails to OpenERP, either to new document types or to existing ones. It also allows you to create a new contact.
253
The `Push` option allows you to archive e-mails to OpenERP, either to new document types or to existing ones. It also allows you to create a new contact.
255
.. i18n: The `Partner` allows you to open the Partner in OpenERP according to the e-mail (i.e. contact e-mail address) selected.
258
The `Partner` allows you to open the Partner in OpenERP according to the e-mail (i.e. contact e-mail address) selected.
260
.. i18n: With `Document`, you can open the document concerned in OpenERP. Make sure you are logged in to the web version to use this functionality. You have to open the mail to use this feature.
263
With `Document`, you can open the document concerned in OpenERP. Make sure you are logged in to the web version to use this functionality. You have to open the mail to use this feature.
265
.. i18n: * Link a mail to an existing document in OpenERP
268
* Link a mail to an existing document in OpenERP
270
.. i18n: .. figure:: images/thunderbird_selection.png
272
.. i18n: :align: center
274
.. i18n: *How to Access OpenERP from Thunderbird?*
277
.. figure:: images/thunderbird_selection.png
281
*How to Access OpenERP from Thunderbird?*
283
.. i18n: To archive an e-mail in OpenERP from Thunderbird, select the e-mail and click the `Push` button. Alternatively you can open the menu :menuselection:`OpenERP --> Push`: the ``Push to OpenERP`` screen will open.
286
To archive an e-mail in OpenERP from Thunderbird, select the e-mail and click the `Push` button. Alternatively you can open the menu :menuselection:`OpenERP --> Push`: the ``Push to OpenERP`` screen will open.
288
.. i18n: In the ``Link to an Existing Document`` section, select an object to which you like to add to your email and its attachments. You
289
.. i18n: can select any object you defined in the ``Document Settings`` section and attach the selected mail to the selected record.
290
.. i18n: The plugin also allows you to select several documents at once, simply by selecting a document and pressing the ``ctrl`` button when selecting the next document.
293
In the ``Link to an Existing Document`` section, select an object to which you like to add to your email and its attachments. You
294
can select any object you defined in the ``Document Settings`` section and attach the selected mail to the selected record.
295
The plugin also allows you to select several documents at once, simply by selecting a document and pressing the ``ctrl`` button when selecting the next document.
297
.. i18n: Do not forget to click the ``Search`` button to refresh the Documents list when you have selected a different document type.
300
Do not forget to click the ``Search`` button to refresh the Documents list when you have selected a different document type.
302
.. i18n: * Create a New Document
305
* Create a New Document
307
.. i18n: This feature can be used to create any of the configured document types in the ``Document Settings`` tab.
308
.. i18n: Suppose you would like to create a new lead from an e-mail. In the ``Create a New Document`` section, select ``CRM Lead``, then click the ``Create`` button. A new lead will be created in OpenERP from the selected e-mail.
311
This feature can be used to create any of the configured document types in the ``Document Settings`` tab.
312
Suppose you would like to create a new lead from an e-mail. In the ``Create a New Document`` section, select ``CRM Lead``, then click the ``Create`` button. A new lead will be created in OpenERP from the selected e-mail.
314
.. i18n: * Create a New Contact / Partner
317
* Create a New Contact / Partner
319
.. i18n: If you cannot find a partner or contact for your e-mail in OpenERP, the Thunderbird plugin allows you to
320
.. i18n: create one on the fly simply by using the information contained in the e-mail.
323
If you cannot find a partner or contact for your e-mail in OpenERP, the Thunderbird plugin allows you to
324
create one on the fly simply by using the information contained in the e-mail.
326
.. i18n: Select the e-mail from which you want to create a new contact, then click the ``Push`` button.
327
.. i18n: In the ``Create a New Contact`` section, click the ``New Contact`` button. This option offers two possibilities:
328
.. i18n: either you just create a contact (address), or you create a partner with the contact linked to it.
331
Select the e-mail from which you want to create a new contact, then click the ``Push`` button.
332
In the ``Create a New Contact`` section, click the ``New Contact`` button. This option offers two possibilities:
333
either you just create a contact (address), or you create a partner with the contact linked to it.
335
.. i18n: - When you just want to create a new contact, complete the address data in the dialog box and click the ``Save`` button.
336
.. i18n: The contact will then be created in OpenERP.
338
.. i18n: - When you also want to create a new partner, complete the contact data.
339
.. i18n: Then click the ``Create Partner`` button, add the partner's name and click the ``Save`` button.
341
.. i18n: - You can also add a new contact to an existing partner. Click the ``Search`` button next to the Partner field
342
.. i18n: and select the corresponding partner from the list. Then complete the contact data and click the ``Save`` button.
345
- When you just want to create a new contact, complete the address data in the dialog box and click the ``Save`` button.
346
The contact will then be created in OpenERP.
348
- When you also want to create a new partner, complete the contact data.
349
Then click the ``Create Partner`` button, add the partner's name and click the ``Save`` button.
351
- You can also add a new contact to an existing partner. Click the ``Search`` button next to the Partner field
352
and select the corresponding partner from the list. Then complete the contact data and click the ``Save`` button.
354
.. i18n: .. figure:: images/thunderbird_creation.png
356
.. i18n: :align: center
358
.. i18n: *Creating a contact on the fly from Thunderbird*
361
.. figure:: images/thunderbird_creation.png
365
*Creating a contact on the fly from Thunderbird*
367
.. i18n: * Open the Document created in OpenERP
370
* Open the Document created in OpenERP
372
.. i18n: To access archived data from different documents in OpenERP you can use the menu :menuselection:`OpenERP --> Document` which allows you to access the document in OpenERP directly from your e-mail.
375
To access archived data from different documents in OpenERP you can use the menu :menuselection:`OpenERP --> Document` which allows you to access the document in OpenERP directly from your e-mail.
377
.. i18n: .. tip:: Knowledge Management
379
.. i18n: The Thunderbird plugin is compatible with OpenERP's Knowledge (i.e. Document) Management. If you install the
380
.. i18n: Knowledge application you will be able to:
382
.. i18n: * search through the content of your company's documents (those that have the type .doc, .pdf, .sxw
383
.. i18n: and .odt) and also in archived emails,
385
.. i18n: * have a shared file system that is connected to various OpenERP documents to share information and
386
.. i18n: access it with your favorite browser,
388
.. i18n: * organize and structure your documents (such as projects, partners and users) in OpenERP's
392
.. tip:: Knowledge Management
394
The Thunderbird plugin is compatible with OpenERP's Knowledge (i.e. Document) Management. If you install the
395
Knowledge application you will be able to:
397
* search through the content of your company's documents (those that have the type .doc, .pdf, .sxw
398
and .odt) and also in archived emails,
400
* have a shared file system that is connected to various OpenERP documents to share information and
401
access it with your favorite browser,
403
* organize and structure your documents (such as projects, partners and users) in OpenERP's
406
.. i18n: .. note:: Testing the Thunderbird plugin
408
.. i18n: If you install the Thunderbird plugin as described,
409
.. i18n: explore its functionality as described in this section using the database you
413
.. note:: Testing the Thunderbird plugin
415
If you install the Thunderbird plugin as described,
416
explore its functionality as described in this section using the database you
419
.. i18n: .. Copyright © Open Object Press. All rights reserved.
422
.. Copyright © Open Object Press. All rights reserved.
424
.. i18n: .. You may take electronic copy of this publication and distribute it if you don't
425
.. i18n: .. change the content. You can also print a copy to be read by yourself only.
428
.. You may take electronic copy of this publication and distribute it if you don't
429
.. change the content. You can also print a copy to be read by yourself only.
431
.. i18n: .. We have contracts with different publishers in different countries to sell and
432
.. i18n: .. distribute paper or electronic based versions of this book (translated or not)
433
.. i18n: .. in bookstores. This helps to distribute and promote the OpenERP product. It
434
.. i18n: .. also helps us to create incentives to pay contributors and authors using author
435
.. i18n: .. rights of these sales.
438
.. We have contracts with different publishers in different countries to sell and
439
.. distribute paper or electronic based versions of this book (translated or not)
440
.. in bookstores. This helps to distribute and promote the OpenERP product. It
441
.. also helps us to create incentives to pay contributors and authors using author
442
.. rights of these sales.
444
.. i18n: .. Due to this, grants to translate, modify or sell this book are strictly
445
.. i18n: .. forbidden, unless Tiny SPRL (representing Open Object Press) gives you a
446
.. i18n: .. written authorisation for this.
449
.. Due to this, grants to translate, modify or sell this book are strictly
450
.. forbidden, unless Tiny SPRL (representing Open Object Press) gives you a
451
.. written authorisation for this.
453
.. i18n: .. Many of the designations used by manufacturers and suppliers to distinguish their
454
.. i18n: .. products are claimed as trademarks. Where those designations appear in this book,
455
.. i18n: .. and Open Object Press was aware of a trademark claim, the designations have been
456
.. i18n: .. printed in initial capitals.
459
.. Many of the designations used by manufacturers and suppliers to distinguish their
460
.. products are claimed as trademarks. Where those designations appear in this book,
461
.. and Open Object Press was aware of a trademark claim, the designations have been
462
.. printed in initial capitals.
464
.. i18n: .. While every precaution has been taken in the preparation of this book, the publisher
465
.. i18n: .. and the authors assume no responsibility for errors or omissions, or for damages
466
.. i18n: .. resulting from the use of the information contained herein.
469
.. While every precaution has been taken in the preparation of this book, the publisher
470
.. and the authors assume no responsibility for errors or omissions, or for damages
471
.. resulting from the use of the information contained herein.
473
.. i18n: .. Published by Open Object Press, Grand Rosière, Belgium
476
.. Published by Open Object Press, Grand Rosière, Belgium