Author: |
SHS-AV s.r.l. |
License: |
no license |
Branch: |
10.0-devel |
Repository: |
zeroincombenze/connector |
Dependencies: |
account,
base,
l10n_it_ddt,
product,
purchase,
sale,
stock,
stock_picking_package_preparation,
and
stock_picking_package_preparation_line |
Languages: |
HTML (152, 1.0%),
PO File (13, 0.1%),
Python (12002, 78.3%),
XML (2760, 18.0%),
and
reStructuredText (394, 2.6%) |
Other branches: |
10.0,
12.0,
and
12.0-devel |
=====================================
|icon| universal_connector 10.0.0.3.0
=====================================
**Universal connector**
.. |icon| image:: https://raw.githubusercontent.com/zeroincombenze/connector/10.0/universal_connector/static/description/icon.png
|Maturity| |Build Status| |Codecov Status| |license gpl| |Try Me|
.. contents::
Overview / Panoramica
=====================
|en| This module makes available some functions to synchronize external data
with Odoo data.
Characteristics
~~~~~~~~~~~~~~~
* Multi-channels interchange
* JSON, XMLRPC and CSV files protocols
* Push and/or Pull logic
* Many2one, One2Many and Many2Many managed with external references
* Automatic field value translation
* Odoo version from 6.1 to 12.0 field name and values automatic translation
* Anti-recurse checks
* Two phases create in order to create hierarchical record structure
* Dynamic translation database
This module can be used for:
* Upgrade Odoo DB from a version to another version (even beck upgrade)
* Import data from files without duplicating records
* Connect Odoo with other software (current version supports until 4 counterparts)
* Populate Odoo DB in the first installation migrated from another software
Synchro
~~~~~~~
The function synchro return the ID of record found or created. Negative values
are error codes.
The function synchro accepts a data dictionary with field values, like create
and write functions.
Every field name may be:
* `id` (integer): the Odoo ID of record; if supplied means write specific existent record (deprecated)
* `PFX_id` (integer): the external partner ID of record (PFX is the channel prefix)
* External name as format `PFX:FIELD` where PFX is the channel prefix and FIELD is the external name which is translated into Odoo name based on dictionary
Every field value may be:
* Value as is, i.e. partner name; the value is acquired as is
* External references: ID of external reference
* Text of reference: key of reference key, i.e. "admin" in user_id field
Synchronizer behavior:
* If `PFX_id` field is supplied, record with `PFX_id` is searched
* Otherwise Synchronizer search for a record matching values passed; the function execute a fallback search algorithm
* If record found, Synchronizer executes the Odoo function write
* If record not found, Synchronizer executes the Odoo function create and assign external 'id' to `PFX_id`
|
|it| Connettore con VG7
Questo modulo rende disponibile alucne funzioni per sincronizzare con l'esterno.
Caratteristiche
~~~~~~~~~~~~~~~
* Scambio multi-canale
* Protocolli JSON, XMLRPC e file CSV
* Logica Push o Pull
* Many2one, One2Many e Many2Many gestiti con referenze esterne
* Traduzione automatica dei campi
* Traduzione automatica dei campi e dei valori di Odoo dalla 6.1 alla 12.0
* Controllo anti-ricorsione
* Creazione a due fasi
* Traduttore dinamico
Questo modulo può essere usato per:
* Aggiornare database di Odoo tra versioni (anche all'indietro)
* Importare dati da file senza duplicazioni
* Connettere Odoo con altri software (sino a 4 contemporaneamente)
* Popolare il DB di Odoo nella prima installazione quando migrazione da altro software
|
|
Getting started / Come iniziare
===============================
|Try Me|
|
Installation / Installazione
----------------------------
+---------------------------------+------------------------------------------+
| |en| | |it| |
+---------------------------------+------------------------------------------+
| These instructions are just an | Istruzioni di esempio valide solo per |
| example; use on Linux CentOS 7+ | distribuzioni Linux CentOS 7+, |
| Ubuntu 14+ and Debian 8+ | Ubuntu 14+ e Debian 8+ |
| | |
| Installation is built with: | L'installazione è costruita con: |
+---------------------------------+------------------------------------------+
| `Zeroincombenze Tools `__ |
+---------------------------------+------------------------------------------+
| Suggested deployment is: | Posizione suggerita per l'installazione: |
+---------------------------------+------------------------------------------+
| $HOME/10.0 |
+----------------------------------------------------------------------------+
::
cd $HOME
# *** Tools installation & activation ***
# Case 1: you have not installed zeroincombenze tools
git clone https://github.com/zeroincombenze/tools.git
cd $HOME/tools
./install_tools.sh -p
source $HOME/devel/activate_tools
# Case 2: you have already installed zeroincombenze tools
cd $HOME/tools
./install_tools.sh -U
source $HOME/devel/activate_tools
# *** End of tools installation or upgrade ***
# Odoo repository installation; OCB repository must be installed
odoo_install_repository connector -b 10.0 -O zero -o $HOME/10.0
vem create $HOME/10.0/venv_odoo -O 10.0 -a "*" -DI -o $HOME/10.0
From UI: go to:
* |menu| Setting > Activate Developer mode
* |menu| Apps > Update Apps List
* |menu| Setting > Apps |right_do| Select **universal_connector** > Install
|
Upgrade / Aggiornamento
-----------------------
::
cd $HOME
# *** Tools installation & activation ***
# Case 1: you have not installed zeroincombenze tools
git clone https://github.com/zeroincombenze/tools.git
cd $HOME/tools
./install_tools.sh -p
source $HOME/devel/activate_tools
# Case 2: you have already installed zeroincombenze tools
cd $HOME/tools
./install_tools.sh -U
source $HOME/devel/activate_tools
# *** End of tools installation or upgrade ***
# Odoo repository upgrade
odoo_install_repository connector -b 10.0 -o $HOME/10.0 -U
vem amend $HOME/10.0/venv_odoo -o $HOME/10.0
# Adjust following statements as per your system
sudo systemctl restart odoo
From UI: go to:
* |menu| Setting > Activate Developer mode
* |menu| Apps > Update Apps List
* |menu| Setting > Apps |right_do| Select **universal_connector** > Update
|
Support / Supporto
------------------
|Zeroincombenze| This module is maintained by the `SHS-AV s.r.l. `__
|
|
Get involved / Ci mettiamo in gioco
===================================
Bug reports are welcome! You can use the issue tracker to report bugs,
and/or submit pull requests on `GitHub Issues
`_.
In case of trouble, please check there if your issue has already been reported.
Proposals for enhancement
-------------------------
|en| If you have a proposal to change this module, you may want to send an email to for initial feedback.
An Enhancement Proposal may be submitted if your idea gains ground.
|it| Se hai proposte per migliorare questo modulo, puoi inviare una mail a per un iniziale contatto.
ChangeLog History / Cronologia modifiche
----------------------------------------
10.0.0.2.9 (2022-07-27)
~~~~~~~~~~~~~~~~~~~~~~~
* [IMP] Enhanced search
10.0.0.2.8 (2022-07-18)
~~~~~~~~~~~~~~~~~~~~~~~
* [FIX] Partner: check for parent_id / Controlli su import clienti
10.0.0.2.7 (2022-03-18)
~~~~~~~~~~~~~~~~~~~~~~~
* [IMP] Purchase orders / Ordini a fornitore
|
|
Credits / Didascalie
====================
Copyright
---------
Odoo is a trademark of `Odoo S.A. `__ (formerly OpenERP)
|
Authors / Autori
----------------
* `SHS-AV s.r.l. `__
Contributors / Collaboratori
----------------------------
* Antonio Maria Vigliotti
Maintainer / Manutenzione
-------------------------
|
----------------
|en| **zeroincombenze®** is a trademark of `SHS-AV s.r.l. `__
which distributes and promotes ready-to-use **Odoo** on own cloud infrastructure.
`Zeroincombenze® distribution of Odoo `__
is mainly designed to cover Italian law and markeplace.
|it| **zeroincombenze®** è un marchio registrato da `SHS-AV s.r.l. `__
che distribuisce e promuove **Odoo** pronto all'uso sulla propria infrastuttura.
La distribuzione `Zeroincombenze® `__ è progettata per le esigenze del mercato italiano.
|chat_with_us|
|
This module is part of connector project.
Last Update / Ultimo aggiornamento: 2022-08-20
.. |Maturity| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt:
.. |Build Status| image:: https://travis-ci.org/zeroincombenze/connector.svg?branch=10.0
:target: https://travis-ci.com/zeroincombenze/connector
:alt: github.com
.. |license gpl| image:: https://img.shields.io/badge/licence-LGPL--3-7379c3.svg
:target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
:alt: License: LGPL-3
.. |license opl| image:: https://img.shields.io/badge/licence-OPL-7379c3.svg
:target: https://www.odoo.com/documentation/user/14.0/legal/licenses/licenses.html
:alt: License: OPL
.. |Coverage Status| image:: https://coveralls.io/repos/github/zeroincombenze/connector/badge.svg?branch=10.0
:target: https://coveralls.io/github/zeroincombenze/connector?branch=10.0
:alt: Coverage
.. |Codecov Status| image:: https://codecov.io/gh/zeroincombenze/connector/branch/10.0/graph/badge.svg
:target: https://codecov.io/gh/zeroincombenze/connector/branch/10.0
:alt: Codecov
.. |Tech Doc| image:: https://www.zeroincombenze.it/wp-content/uploads/ci-ct/prd/button-docs-10.svg
:target: https://wiki.zeroincombenze.org/en/Odoo/10.0/dev
:alt: Technical Documentation
.. |Help| image:: https://www.zeroincombenze.it/wp-content/uploads/ci-ct/prd/button-help-10.svg
:target: https://wiki.zeroincombenze.org/it/Odoo/10.0/man
:alt: Technical Documentation
.. |Try Me| image:: https://www.zeroincombenze.it/wp-content/uploads/ci-ct/prd/button-try-it-10.svg
:target: https://erp10.zeroincombenze.it
:alt: Try Me
.. |OCA Codecov| image:: https://codecov.io/gh/OCA/connector/branch/10.0/graph/badge.svg
:target: https://codecov.io/gh/OCA/connector/branch/10.0
:alt: Codecov
.. |Odoo Italia Associazione| image:: https://www.odoo-italia.org/images/Immagini/Odoo%20Italia%20-%20126x56.png
:target: https://odoo-italia.org
:alt: Odoo Italia Associazione
.. |Zeroincombenze| image:: https://avatars0.githubusercontent.com/u/6972555?s=460&v=4
:target: https://www.zeroincombenze.it/
:alt: Zeroincombenze
.. |en| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/flags/en_US.png
:target: https://www.facebook.com/Zeroincombenze-Software-gestionale-online-249494305219415/
.. |it| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/flags/it_IT.png
:target: https://www.facebook.com/Zeroincombenze-Software-gestionale-online-249494305219415/
.. |check| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/check.png
.. |no_check| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/no_check.png
.. |menu| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/menu.png
.. |right_do| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/right_do.png
.. |exclamation| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/exclamation.png
.. |warning| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/warning.png
.. |same| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/same.png
.. |late| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/late.png
.. |halt| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/halt.png
.. |info| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/info.png
.. |xml_schema| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/certificates/iso/icons/xml-schema.png
:target: https://github.com/zeroincombenze/grymb/blob/master/certificates/iso/scope/xml-schema.md
.. |DesktopTelematico| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/certificates/ade/icons/DesktopTelematico.png
:target: https://github.com/zeroincombenze/grymb/blob/master/certificates/ade/scope/Desktoptelematico.md
.. |FatturaPA| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/certificates/ade/icons/fatturapa.png
:target: https://github.com/zeroincombenze/grymb/blob/master/certificates/ade/scope/fatturapa.md
.. |chat_with_us| image:: https://www.shs-av.com/wp-content/chat_with_us.gif
:target: https://t.me/Assitenza_clienti_powERP