Skip to content

Commit c9f3856

Browse files
committed
[IMP] Export: Updated quotations template for order lines
closes #15458 Signed-off-by: Megan Valenzuela (meval) <[email protected]>
1 parent 7c361d5 commit c9f3856

File tree

8 files changed

+43
-49
lines changed

8 files changed

+43
-49
lines changed

content/applications/essentials/export_import_data.rst

Lines changed: 37 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -20,19 +20,17 @@ can aid in reporting on activities, although, Odoo provides a precise and easy r
2020
each available application.
2121

2222
With Odoo, the values can be exported from any field in any record. To do so, activate the list view
23-
(:guilabel:`☰ (three horizontal lines)` icon), on the items that need to be exported, and then
24-
select the records that should be exported. To select a record, tick the checkbox next to the
25-
corresponding record. Finally, click on :guilabel:`⚙️ Action`, and then :guilabel:`Export`.
23+
:icon:`fa-list` :guilabel:`(List)` icon, on the items that need to be exported, and then select
24+
the records that should be exported. To select a record, tick the checkbox next to the corresponding
25+
record. Finally, click on :icon:`fa-cog` :guilabel:`(Action)` icon, and then :guilabel:`Export`.
2626

2727
.. image:: export_import_data/list-view-export.png
28-
:align: center
2928
:alt: View of the different things to enable/click to export data.
3029

3130
When clicking on :guilabel:`Export`, an :guilabel:`Export Data` pop-over window appears, with
3231
several options for the data to export:
3332

3433
.. image:: export_import_data/export-data-overview.png
35-
:align: center
3634
:alt: Overview of options to consider when exporting data in Odoo..
3735

3836
#. With the :guilabel:`I want to update data (import-compatable export)` option ticked, the system
@@ -42,17 +40,17 @@ several options for the data to export:
4240
#. When exporting, there is the option to export in two formats: `.csv` and `.xls`. With `.csv`,
4341
items are separated by a comma, while `.xls` holds information about all the worksheets in a
4442
file, including both content and formatting.
45-
#. These are the items that can be exported. Use the :guilabel:`> (right arrow)` icon to display
46-
more sub-field options. Use the :guilabel:`Search` bar to find specific fields. To use the
47-
:guilabel:`Search` option more efficiently, click on all the :guilabel:`> (right arrows)` to
48-
display all fields.
49-
#. The :guilabel:`+ (plus sign)` icon button is present to add fields to the :guilabel:`Fields to
50-
export` list.
51-
#. The :guilabel:`↕️ (up-down arrow)` to the left of the selected fields can be used to move the
52-
fields up and down, to change the order in which they are displayed in the exported file.
53-
Drag-and-drop using the :guilabel:`↕️ (up-down arrow)` icon.
54-
#. The :guilabel:`🗑️ (trash can)` icon is used to remove fields. Click on the :guilabel:`🗑️ (trash
55-
can)` icon to remove the field.
43+
#. These are the items that can be exported. Use the :icon:`fa-chevron-right` :guilabel:`(Show
44+
sub-fields)` icon to display more sub-field options. Use the :guilabel:`Search` bar to find
45+
specific fields. To use the :guilabel:`Search` option more efficiently, click on all the
46+
:icon:`fa-chevron-right` :guilabel:`(Show sub-fields)` icon to display all fields.
47+
#. The :icon:`fa-plus` :guilabel:`(Select field)` icon button is present to add fields to the
48+
:guilabel:`Fields to export` list.
49+
#. The :icon:`fa-sort` :guilabel:`(Sort)` icon to the left of the selected fields can be used to
50+
move the fields up and down, to change the order in which they are displayed in the exported
51+
file. Drag-and-drop using the :icon:`fa-sort` :guilabel:`(Sort)` icon.
52+
#. The :icon:`fa-trash` :guilabel:`(Remove field)` icon is used to remove fields. Click the
53+
:icon:`fa-trash` :guilabel:`(Remove field)` icon to remove the field.
5654
#. For recurring reports, it is helpful to save export presets. Select all the needed fields, and
5755
click on the template drop-down menu. Once there, click on :guilabel:`New template`, and give a
5856
unique name to the export just created. The next time the same list needs to be exported, select
@@ -101,7 +99,6 @@ Open the view of the object to which the data should be imported/populated, and
10199
:menuselection:`⭐ Favorites --> Import records`.
102100

103101
.. image:: export_import_data/import-button.png
104-
:align: center
105102
:alt: Favorites menu revealed with the import records option highlighted.
106103

107104
After clicking :guilabel:`Import records`, Odoo reveals a separate page with templates that can be
@@ -115,7 +112,6 @@ Customers` at the center of the page.
115112
`.xlsx`).
116113

117114
.. image:: export_import_data/formatting.png
118-
:align: center
119115
:alt: Formatting options presented when a CVS file is imported in Odoo.
120116

121117
Make necessary adjustments to the *Formatting* options, and ensure all columns in the
@@ -138,30 +134,28 @@ Once the template is downloaded, proceed to follow these steps:
138134
(ID) column.
139135

140136
.. image:: export_import_data/dragdown.gif
141-
:align: center
142137
:alt: An animation of the mouse dragging down the ID column, so each record has a unique ID.
143138

144139
.. note::
145140
When a new column is added, Odoo may not be able to map it automatically, if its label does not
146141
fit any field within Odoo. However, new columns can be mapped manually when the import is tested.
147142
Search the drop-down menu for the corresponding field.
148143

149-
.. image:: export_import_data/field_list.png
150-
:align: center
144+
.. image:: export_import_data/field-list.png
151145
:alt: Drop-down menu expanded in the initial import screen on Odoo.
152146

153147
Then, use this field's label in the import file to ensure future imports are successful.
154148

155149
.. tip::
156-
Another useful way to find out the proper column names to import is to export a sample file
157-
using the fields that should be imported. This way, if there is not a sample import template,
158-
the names are accurate.
150+
Another useful way to find out the proper column names to import is to export a sample file using
151+
the fields to be imported. This way, if there is not a sample import template, the names are
152+
accurate.
159153

160154
Import from another application
161155
-------------------------------
162156

163-
The :guilabel:`External ID` (ID) is a unique identifier for the line item. Feel free to use one
164-
from previous software to facilitate the transition to Odoo.
157+
The :guilabel:`External ID` (ID) is a unique identifier for a line item. It is possible to use an
158+
:guilabel:`External ID` (ID) from previous software to facilitate the transition to Odoo.
165159

166160
Setting an ID is not mandatory when importing, but it helps in many cases:
167161

@@ -195,8 +189,7 @@ the column may be mapped to a field that is not proposed by default.
195189
If this happens, check the :guilabel:`Show fields of relation fields (advanced) option`, then a
196190
complete list of fields becomes available for each column.
197191

198-
.. image:: export_import_data/field_list.png
199-
:align: center
192+
.. image:: export_import_data/field-list.png
200193
:alt: Searching for the field to match the tax column.
201194

202195
Change data import format
@@ -366,7 +359,7 @@ The tags should be separated by a comma, without any spacing. For example, if a
366359
linked to both tags: `Manufacturer` and `Retailer` then 'Manufacturer,Retailer' needs to be encoded
367360
in the same column of the :abbr:`CSV (Comma-separated Values)` file.
368361

369-
- :download:`CSV file for Manufacturer, Retailer <export_import_data/m2m_customers_tags.csv>`
362+
- :download:`CSV file for Manufacturer, Retailer <export_import_data/m2m-customers-tags.csv>`
370363

371364
Import one2many relationships
372365
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -376,23 +369,24 @@ reserved in the :abbr:`CSV (Comma-separated Values)` file for each order line. T
376369
is imported on the same row as the information relative to order. Any additional lines need an
377370
additional row that does not have any information in the fields relative to the order.
378371

379-
As an example, here is a :abbr:`CSV (Comma-separated Values)` file of some quotations that can be
380-
imported, based on demo data:
372+
.. example::
373+
A company imports quotations using a :abbr:`CSV (Comma-separated Values)` file, based on demo
374+
data:
375+
376+
- :download:`File for some quotations <export_import_data/o2m-quotations-order-lines.csv>`
381377

382-
- :download:`File for some Quotations
383-
<export_import_data/purchase.order_functional_error_line_cant_adpat.csv>`
378+
A company imports purchase orders with their respective purchase order lines using a :abbr:`CSV
379+
(Comma-separated Values)` file:
384380

385-
The following :abbr:`CSV (Comma-separated Values)` file shows how to import purchase orders with
386-
their respective purchase order lines:
381+
- :download:`Purchase orders with their respective purchase order lines
382+
<export_import_data/o2m-purchase-order-lines.csv>`
387383

388-
- :download:`Purchase orders with their respective purchase order lines
389-
<export_import_data/o2m_purchase_order_lines.csv>`
384+
A company imports customers and their respective contacts using a :abbr:`CSV (Comma-separated
385+
Values)` file:
390386

391-
The following :abbr:`CSV (Comma-separated Values)` file shows how to import customers and their
392-
respective contacts:
387+
- :download:`Customers and their respective contacts
388+
<export_import_data/o2m-customers-contacts.csv>`
393389

394-
- :download:`Customers and their respective contacts
395-
<export_import_data/o2m_customers_contacts.csv>`
396390

397391
Import records several times
398392
----------------------------
@@ -473,5 +467,5 @@ the original database).
473467

474468
The two files produced are ready to be imported in Odoo without any modifications. After having
475469
imported these two :abbr:`CSV (Comma-separated Values)` files, there are four contacts and three
476-
companies (the first two contacts are linked to the first company). Keep in mind to first import
477-
the companies, and then the people.
470+
companies (the first two contacts are linked to the first company). Keep in mind to first import the
471+
companies, and then the people.
8.03 KB
Loading
-19.2 KB
Binary file not shown.

content/applications/essentials/export_import_data/m2m_customers_tags.csv renamed to content/applications/essentials/export_import_data/m2m-customers-tags.csv

File renamed without changes.

content/applications/essentials/export_import_data/o2m_customers_contacts.csv renamed to content/applications/essentials/export_import_data/o2m-customers-contacts.csv

File renamed without changes.

content/applications/essentials/export_import_data/o2m_purchase_order_lines.csv renamed to content/applications/essentials/export_import_data/o2m-purchase-order-lines.csv

File renamed without changes.
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
Activities,Company,Customer,Order Date,Order Reference,Pricelist,Order Lines/Product Template,Order Lines/Quantity,Order Lines/Unit Price,Order Lines/Discount (%),Order Lines/Taxes
2+
Answer questions,My Company (San Francisco),Ready Mat,2025-12-01 10:37:22,S00003,Public Pricelist (USD),Virtual Interior Design,10,30.75,0,Tax 10%
3+
,,,,,,[FURN_7777] Office Chair,1,70,0,Tax 10%
4+
,,,,,,Deposit,5,150,0,
5+
,My Company (San Francisco),Ready Mat,2025-11-01 11:37:00,S00002,Public Pricelist (USD),Virtual Interior Design,24,75,0,Tax 10%
6+
,,,,,,Virtual Home Staging,30,38.25,0,Tax 10%

content/applications/essentials/export_import_data/purchase.order_functional_error_line_cant_adpat.csv

Lines changed: 0 additions & 6 deletions
This file was deleted.

0 commit comments

Comments
 (0)