The parameter values are set for illustrating purposes.
- -When running the script, an amount of threads are spawned. Each of them handles an amount of records by transaction. Each transaction inserts or updates records in the Odoo instance defined in the configuration file. - -## Import Parameters - -### --config CONFIG -The configuration file `CONFIG` is a text file that defines the parameters used in the import. Here is an example. - -``` -[Connection] -hostname = mydb.odoo.com -database = mydb -login = admin -password = admin -protocol = jsonrpcs -port = 443 -uid = 2 -``` -The section `[connection]` is mandatory. Then the following parameters must be set accordingly. -| Parameter | Description |
| - hostname - | -- Name of the host where the Odoo resides. - | -
| - database - | -- Name of the Postgresql database. - | -
| - login - | -- The login used to create or update the records. - | -
| - password - | -- The login's password. - | -
| - protocol - | -
- Protocol used for RPC calls. It can be one of the following values: xmlrpc, xmlrpcs, jsonrpc, jsonrpcs. - For a remote database, it's strongly advised to used an encrypted protocol (xmlrcps or jsonrpcs). - |
-
| - port - | -- TCP port where Odoo can be reached. Usually 443 for encrypted remote connections, or 8069 for a local Odoo with its default configuration. - | -
| - uid - | -
- This is the database id of the res.user identified by the parameter 'login'. - Well known ids are: - 1 = admin user prior to V12. - 2 = admin user as of V12. - |
-
| Key | Description |
| - write_metadata - | -- When True, allow to import audit log fields (create_uid, create_date, write_uid, write_date). The import must run with the `admin` user. Requires the module import_metadata available here. - | -
| - update_many2many - | -
- Set it to True when the data file contains a many2many relationship splitted as one record per line instead of a comma separated list of XML_IDs in one column. Suppose we want to assign categories to products, a regular record is: - product1;categ1,categ2,categ3 - With 'update_many2many': True, you can import a file with the following structure: - product1;categ1 - product1;categ2 - product1;categ3 - |
-
| Key | Description |
| - tracking_disable - | -- When True, don't create messages in the chatter - | -
| - defer_fields_computation - | -- When True, recompute the computed fields at the end of the transaction instead of after each record. Useless if --size=1. Requires the module defer_fields_computation available here. - | -
| - defer_parent_store_computation - | -- Defer the computation of the fields parent_left and parent_right at the end of the transaction. - Valid up to Odoo 11. - | -
| - lang - | -- Set the current language. Ex: 'lang': fr_FR - | -
| - force_company - | -- Set the current company. Use the database identifier of the company. - | -
| Key | Description |
| - check_move_validity - | -- Set it to False when you import account moves and account move lines. Refer to "Importing Account Move Lines" for more details. - | -
| - create_product_product - | -- Set it to True when you import product templates and also the variants. Without this key, the ORM will automatically create the variants when the templates are imported. - | -
| Client File | Mapper | Import File |
|
- my_column - my_value1 - my_value2 - |
-
- { - 'my_field': mapper.const('forced_value'), - } - |
-
- my_field - forced_value - forced_value - |
-
| Client File | Mapper | Import File |
|
- my_column - my_value1 - my_value2 - |
-
- { - 'my_field': mapper.val('my_column'), - } - |
-
- my_field - my_value1 - my_value2 - |
-
| Client File | Mapper | Import File |
|
- my_column - key1 - key2 - |
-
- mapping = { - 'key1': 'value1', - 'key2': 'value2' - } - { - 'my_field': mapper.map_val('my_column', mapping), - } - |
-
- my_field - value1 - value2 - |
-
| Client File | Mapper | Import File |
|
- my_column - 01; - 2,3; - |
-
- { - 'my_field': mapper.num('my_column'), - } - |
-
- my_field - 01 - 2.3 - |
-
| Client File | Mapper | Import File |
|
- my_column - Yes - No - - something else - |
-
- { - 'my_field': mapper.bool_val('my_column', ['Yes'], ['No']), - } - |
-
- my_field - 1 - 0 - 0 - 1 - |
-
| Client File | Mapper | Import File |
|
- my_column - pict_1.png - pict_2.png - |
-
- { - 'my_field': mapper.binary('my_column', '/home/Pictures/'), - } - |
-
- my_field - kllkxqlxsqnxqxhHJVJSFSVSJDYVDV...... - KKjdsndb77573çinjhffxxcdkllkxq...... - |
-
| Client File | Mapper | Import File |
|
- my_column1;my_column2 - val1;val2 - val3,val4 - |
-
- { - 'my_field': mapper.concat('_','my_column1','my_column2'), - } - |
-
- my_field - val1_val2; - val3_val4; - |
-
| Client File | Mapper | Import File |
|
- my_column - my_value1 - my_value2 - |
-
- { - 'my_field/id': mapper.m2o('my_import_my_model','my_column'), - } - |
-
- my_field/id - my_import_my_model.my_value1 - my_import_my_model.my_value2 - |
-
| Client File | Mapper | Import File |
|
- my_column1;my_column2 - val1,val2 - val3,val4 - |
-
- { - 'my_field/id': mapper.m2o_map('my_import_my_model',mapper.concat('_','my_column1','my_column2')), - } - |
-
- my_field/id - my_import_my_model.val1_val2; - my_import_my_model.val3_val4; - |
-
| Client File | Mapper | Import File |
|
- my_column1;my_column2 - val1,val2;val3 - |
-
- { - 'my_field/id': mapper.m2m('my_import_my_model','my_column1', 'my_column2')), - } - |
-
- my_field/id; - my_import_my_model.val1,my_import_my_model.val2,my_import_my_model.val3 - |
-
| Client File | Mapper | Import File (1) |
|
- my_column1 - val1,val2 - val1,val3 - val4 - |
-
- { - 'my_field/id': mapper.m2m_id_list('my_import_my_model','my_column1')), - } - |
-
- my_field/id - my_import_my_model.val1 - my_import_my_model.val2 - my_import_my_model.val3 - my_import_my_model.val4 - |
-
| Client File | Mapper | Import File (1) |
|
- my_column1 - val1,val2 - val1,val3 - val4 - |
-
- { - 'my_field': mapper.m2m_value_list('my_column1')), - } - |
-
- my_field - val1 - val2 - val3 - val4 - |
-
| Client File | Mapper | Import File |
|
- product_template_ref;color;size - template_1;red;medium - template_1;blue;large - template_2;green;small - |
-
- { - 'my_field/id': mapper.m2m_template_attribute_value('PRODUCT_ATTRIBUTE_VALUE', 'product_template_ref', 'color', 'size'), - } - |
-
- my_field/id - PRODUCT_ATTRIBUTE_VALUE_template_1_color_red,PRODUCT_ATTRIBUTE_VALUE_template_1_size_medium - PRODUCT_ATTRIBUTE_VALUE_template_1_color_blue,PRODUCT_ATTRIBUTE_VALUE_template_1_size_large - PRODUCT_ATTRIBUTE_VALUE_template_2_color_green,PRODUCT_ATTRIBUTE_VALUE_template_2_size_small - |
-
