You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

82 lines
2.4 KiB

  1. .. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
  2. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  3. :alt: License: AGPL-3
  4. =========================
  5. External Database Sources
  6. =========================
  7. This module allows you to define connections to foreign databases using ODBC,
  8. Oracle Client or SQLAlchemy.
  9. Installation
  10. ============
  11. No installation required.
  12. Configuration
  13. =============
  14. Database sources can be configured in Settings > Configuration -> Data sources.
  15. Depending on the database, you need:
  16. * to install unixodbc and python-pyodbc packages to use ODBC connections.
  17. * to install FreeTDS driver (tdsodbc package) and configure it through ODBC toconnect to Microsoft SQL Server.
  18. * to install and configure Oracle Instant Client and cx_Oracle python library to connect to Oracle.
  19. Usage
  20. =====
  21. To use this module:
  22. * Go to Settings > Database Structure > Database Sources
  23. * Click on Create to enter the following information:
  24. * Datasource name 
  25. * Pasword
  26. * Connector: Choose the database to which you want to connect
  27. * Connection string : Specify how to connect to database
  28. .. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
  29. :alt: Try me on Runbot
  30. :target: https://runbot.odoo-community.org/runbot/149/9.0 for server-tools
  31. Known issues / Roadmap
  32. ======================
  33. Bug Tracker
  34. ===========
  35. Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-tools/issues>`_.
  36. In case of trouble, please check there if your issue has already been reported.
  37. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback `here <https://github.com/OCA/
  38. server-tools/issues/new?body=module:%20
  39. base_external_dbsource%0Aversion:%20
  40. 9.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  41. Credits
  42. =======
  43. Contributors
  44. ------------
  45. * Daniel Reis <dreis.pt@hotmail.com>
  46. * Maxime Chambreuil <maxime.chambreuil@savoirfairelinux.com>
  47. * Gervais Naoussi <gervaisnaoussi@gmail.com>
  48. Maintainer
  49. ----------
  50. .. image:: https://odoo-community.org/logo.png
  51. :alt: Odoo Community Association
  52. :target: https://odoo-community.org
  53. This module is maintained by the OCA.
  54. OCA, or the Odoo Community Association, is a nonprofit organization whose
  55. mission is to support the collaborative development of Odoo features and
  56. promote its widespread use.
  57. To contribute to this module, please visit http://odoo-community.org.