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.

84 lines
2.5 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, Firebird,
  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 to connect to Microsoft SQL Server.
  18. * to install and configure Oracle Instant Client and cx_Oracle python library to connect to Oracle.
  19. * to install fdb package to connect in Firebird.
  20. Usage
  21. =====
  22. To use this module:
  23. * Go to Settings > Database Structure > Database Sources
  24. * Click on Create to enter the following information:
  25. * Data source name 
  26. * Password
  27. * Connector: Choose the database to which you want to connect
  28. * Connection string : Specify how to connect to database
  29. .. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
  30. :alt: Try me on Runbot
  31. :target: https://runbot.odoo-community.org/runbot/149/9.0 for server-tools
  32. Known issues / Roadmap
  33. ======================
  34. Bug Tracker
  35. ===========
  36. Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-tools/issues>`_.
  37. In case of trouble, please check there if your issue has already been reported.
  38. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback `here <https://github.com/OCA/
  39. server-tools/issues/new?body=module:%20
  40. base_external_dbsource%0Aversion:%20
  41. 9.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  42. Credits
  43. =======
  44. Contributors
  45. ------------
  46. * Daniel Reis <dreis.pt@hotmail.com>
  47. * Maxime Chambreuil <maxime.chambreuil@savoirfairelinux.com>
  48. * Gervais Naoussi <gervaisnaoussi@gmail.com>
  49. * Michell Stuttgart <michellstut@gmail.com>
  50. Maintainer
  51. ----------
  52. .. image:: https://odoo-community.org/logo.png
  53. :alt: Odoo Community Association
  54. :target: https://odoo-community.org
  55. This module is maintained by the OCA.
  56. OCA, or the Odoo Community Association, is a nonprofit organization whose
  57. mission is to support the collaborative development of Odoo features and
  58. promote its widespread use.
  59. To contribute to this module, please visit http://odoo-community.org.