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.

89 lines
2.5 KiB

  1. .. image:: https://img.shields.io/badge/licence-LGPL--3-blue.svg
  2. :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
  3. :alt: License: LGPL-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. Usage
  16. =====
  17. To use this module:
  18. -------------------
  19. * Go to Settings > Database Structure > Database Sources
  20. * Click on Create to enter the following information:
  21. * Data source name 
  22. * Password
  23. * Connector: Choose the database to which you want to connect
  24. * Connection string: Specify how to connect to database
  25. To extend this module:
  26. ----------------------
  27. .. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
  28. :alt: Try me on Runbot
  29. :target: https://runbot.odoo-community.org/runbot/149/10.0 for server-tools
  30. Known issues / Roadmap
  31. ======================
  32. * Find a way to remove or default the CA certs dir
  33. * Add concept of multiple connection strings for one source (multiple nodes)
  34. * Add a ConnectionEnvironment that allows for the reuse of connections
  35. * Message box should be displayed instead of error in ``connection_test``
  36. * Remove old api compatibility layers (v11)
  37. * Instead of returning list of results, we should return iterators. This will support
  38. larger datasets in a more efficient manner.
  39. * Implement better CRUD handling
  40. Bug Tracker
  41. ===========
  42. Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-tools/issues>`_.
  43. In case of trouble, please check there if your issue has already been reported.
  44. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback.
  45. Credits
  46. =======
  47. Contributors
  48. ------------
  49. * Daniel Reis <dreis.pt@hotmail.com>
  50. * Maxime Chambreuil <maxime.chambreuil@savoirfairelinux.com>
  51. * Gervais Naoussi <gervaisnaoussi@gmail.com>
  52. * Michell Stuttgart <michellstut@gmail.com>
  53. * Dave Lasley <dave@laslabs.com>
  54. Maintainer
  55. ----------
  56. .. image:: https://odoo-community.org/logo.png
  57. :alt: Odoo Community Association
  58. :target: https://odoo-community.org
  59. This module is maintained by the OCA.
  60. OCA, or the Odoo Community Association, is a nonprofit organization whose
  61. mission is to support the collaborative development of Odoo features and
  62. promote its widespread use.
  63. To contribute to this module, please visit http://odoo-community.org.