[BOT] post-merge updates

README.md

@@ -21,7 +21,7 @@ Available addons
 ----------------
 addon | version | maintainers | summary
 --- | --- | --- | ---
-[pattern_import_export](pattern_import_export/) | 14.0.2.7.0 |  | Pattern for import or export
+[pattern_import_export](pattern_import_export/) | 14.0.2.8.0 |  | Pattern for import or export
 [pattern_import_export_csv](pattern_import_export_csv/) | 14.0.1.1.0 |  | Pattern for import or export from to CSV files
 [pattern_import_export_custom_header](pattern_import_export_custom_header/) | 14.0.1.0.1 |  | Allow to use custom headers names in export files
 [pattern_import_export_synchronize](pattern_import_export_synchronize/) | 14.0.1.0.0 | [![kevinkhao](https://github.com/kevinkhao.png?size=30px)](https://github.com/kevinkhao) [![sebastienbeau](https://github.com/sebastienbeau.png?size=30px)](https://github.com/sebastienbeau) | Attachment Synchronize using patterns

pattern_import_export/README.rst

@@ -7,7 +7,7 @@ Pattern Import Export
    !! This file is generated by oca-gen-addon-readme !!
    !! changes will be overwritten.                   !!
    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-   !! source digest: sha256:1d0435b3d5c600c08f64b1cab35bef10122bf3bdd927445ea3b54000a0f718f2
+   !! source digest: sha256:3705d1bfe3c899c7c2037cad5305a0a6f080ddd8ca1d03bc732613a481115d2e
    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 
 .. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
@@ -82,16 +82,29 @@ You have two options:
 
 * Open the tree view of any model and tick some record selection boxes (for this step, these don't matter, we only just want to show the sidebar).
 * In the sidebar, click on the "Import with Pattern" button
-* Select the pattern that you used to generate the export, upload your file and click import.
+* Select a pattern, upload your file and click import.
 * A "Pattern file" is created, and its job along with it. Depending on the success or failure of the job, you
   will receive a red/green notification on your window. You can check the details in the appropriate Import/Export menu.
 
 Or:
 
 * Access the Import wizard through the Import/Export menu
-* Select the Pattern that you want to use
+* Select a pattern
 * Click on the "Import" button
 
+
+Import syntax
+-------------
+
+One of the strength of pattern_import_export module is the ability to
+reference records by natural keys (business keys) instead of technical keys (xmlid or database id).
+
+One or more columns can be the natural key of the record to find and update or to create a new record.
+Each column in the natural key has to be suffixed by "#key".
+
+One or more columns can be used as foreign keys can be accessed with "|" syntax.  (for instance on partner: country_id|code )
+
+
 Example
 -------
 

pattern_import_export/__manifest__.py

@@ -3,7 +3,7 @@
 {
     "name": "Pattern Import Export",
     "summary": "Pattern for import or export",
-    "version": "14.0.2.7.0",
+    "version": "14.0.2.8.0",
     "category": "Extra Tools",
     "author": "Akretion",
     "website": "https://github.com/Shopinvader/pattern-import-export",

pattern_import_export/static/description/index.html

@@ -367,7 +367,7 @@ <h1 class="title">Pattern Import Export</h1>
 !! This file is generated by oca-gen-addon-readme !!
 !! changes will be overwritten.                   !!
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-!! source digest: sha256:1d0435b3d5c600c08f64b1cab35bef10122bf3bdd927445ea3b54000a0f718f2
+!! source digest: sha256:3705d1bfe3c899c7c2037cad5305a0a6f080ddd8ca1d03bc732613a481115d2e
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
 <p><a class="reference external image-reference" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external image-reference" href="https://github.com/shopinvader/pattern-import-export/tree/14.0/pattern_import_export"><img alt="shopinvader/pattern-import-export" src="https://img.shields.io/badge/github-shopinvader%2Fpattern--import--export-lightgray.png?logo=github" /></a></p>
 <div class="section" id="overview">
@@ -427,17 +427,25 @@ <h2>Importing</h2>
 <ul class="simple">
 <li>Open the tree view of any model and tick some record selection boxes (for this step, these don’t matter, we only just want to show the sidebar).</li>
 <li>In the sidebar, click on the “Import with Pattern” button</li>
-<li>Select the pattern that you used to generate the export, upload your file and click import.</li>
+<li>Select a pattern, upload your file and click import.</li>
 <li>A “Pattern file” is created, and its job along with it. Depending on the success or failure of the job, you
 will receive a red/green notification on your window. You can check the details in the appropriate Import/Export menu.</li>
 </ul>
 <p>Or:</p>
 <ul class="simple">
 <li>Access the Import wizard through the Import/Export menu</li>
-<li>Select the Pattern that you want to use</li>
+<li>Select a pattern</li>
 <li>Click on the “Import” button</li>
 </ul>
 </div>
+<div class="section" id="import-syntax">
+<h2>Import syntax</h2>
+<p>One of the strength of pattern_import_export module is the ability to
+reference records by natural keys (business keys) instead of technical keys (xmlid or database id).</p>
+<p>One or more columns can be the natural key of the record to find and update or to create a new record.
+Each column in the natural key has to be suffixed by “#key”.</p>
+<p>One or more columns can be used as foreign keys can be accessed with “|” syntax.  (for instance on partner: country_id|code )</p>
+</div>
 <div class="section" id="example">
 <h2>Example</h2>
 <p>Here is an example of a simple update on <tt class="docutils literal">product.product</tt>: