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.

134 lines
4.9 KiB

  1. =======================
  2. MuK Large Objects Field
  3. =======================
  4. PostgreSQL offers support for large objects, which provide stream-style access
  5. to user data that is stored in a special large-object structure. They are useful
  6. with data values too large to be manipulated conveniently as a whole.
  7. Psycopg allows access to the large object using the `lobject` class. Objects are
  8. generated using the `connection.lobject()` factory method. Data can be retrieved
  9. either as bytes or as Unicode strings.
  10. Psycopg large object support efficient import/export with file system files using
  11. the `lo_import()` and `lo_export()` libpq functions.
  12. Changed in version 2.6: added support for large objects greated than 2GB. Note
  13. that the support is enabled only if all the following conditions are verified:
  14. * the Python build is 64 bits;
  15. * the extension was built against at least libpq 9.3;
  16. * the server version is at least PostgreSQL 9.3 (server_version must be >= 90300).
  17. If Psycopg was built with 64 bits large objects support (i.e. the first two
  18. contidions above are verified), the `psycopg2.__version__` constant will contain
  19. the lo64 flag. If any of the contition is not met several lobject methods will
  20. fail if the arguments exceed 2GB.
  21. Installation
  22. ============
  23. To install this module, you need to:
  24. Download the module and add it to your Odoo addons folder. Afterward, log on to
  25. your Odoo server and go to the Apps menu. Trigger the debug mode and update the
  26. list by clicking on the "Update Apps List" link. Now install the module by
  27. clicking on the install button.
  28. Another way to install this module is via the package management for Python
  29. (`PyPI <https://pypi.org/project/pip/>`_).
  30. To install our modules using the package manager make sure
  31. `odoo-autodiscover <https://pypi.org/project/odoo-autodiscover/>`_ is installed
  32. correctly. Then open a console and install the module by entering the following
  33. command:
  34. ``pip install --extra-index-url https://nexus.mukit.at/repository/odoo/simple <module>``
  35. The module name consists of the Odoo version and the module name, where
  36. underscores are replaced by a dash.
  37. **Module:**
  38. ``odoo<version>-addon-<module_name>``
  39. **Example:**
  40. ``sudo -H pip3 install --extra-index-url https://nexus.mukit.at/repository/odoo/simple odoo11-addon-muk-utils``
  41. Once the installation has been successfully completed, the app is already in the
  42. correct folder. Log on to your Odoo server and go to the Apps menu. Trigger the
  43. debug mode and update the list by clicking on the "Update Apps List" link. Now
  44. install the module by clicking on the install button.
  45. The biggest advantage of this variant is that you can now also update the app
  46. using the "pip" command. To do this, enter the following command in your console:
  47. ``pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple <module>``
  48. When the process is finished, restart your server and update the application in
  49. Odoo. The steps are the same as for the installation only the button has changed
  50. from "Install" to "Upgrade".
  51. You can also view available Apps directly in our `repository <https://nexus.mukit.at/#browse/browse:odoo>`_
  52. and find a more detailed installation guide on our `website <https://mukit.at/page/open-source>`_.
  53. For modules licensed under OPL-1, you will receive access data when you purchase
  54. the module. If the modules were not purchased directly from
  55. `MuK IT <https://www.mukit.at/>`_ please contact our support (support@mukit.at)
  56. with a confirmation of purchase to receive the corresponding access data.
  57. Upgrade
  58. ============
  59. To upgrade this module, you need to:
  60. Download the module and add it to your Odoo addons folder. Restart the server
  61. and log on to your Odoo server. Select the Apps menu and upgrade the module by
  62. clicking on the upgrade button.
  63. If you installed the module using the "pip" command, you can also update the
  64. module in the same way. Just type the following command into the console:
  65. ``pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple <module>``
  66. When the process is finished, restart your server and update the application in
  67. Odoo, just like you would normally.
  68. Configuration
  69. =============
  70. No additional configuration is needed to use this module.
  71. Usage
  72. =============
  73. This module has no direct visible effect on the system. It adds a new field type,
  74. which can be used in other modules.
  75. Credits
  76. =======
  77. Contributors
  78. ------------
  79. * Mathias Markl <mathias.markl@mukit.at>
  80. Images
  81. ------------
  82. Some pictures are based on or inspired by the icon set of Font Awesome:
  83. * `Font Awesome <https://fontawesome.com>`_
  84. Author & Maintainer
  85. -------------------
  86. This module is maintained by the `MuK IT GmbH <https://www.mukit.at/>`_.
  87. MuK IT is an Austrian company specialized in customizing and extending Odoo.
  88. We develop custom solutions for your individual needs to help you focus on
  89. your strength and expertise to grow your business.
  90. If you want to get in touch please contact us via mail
  91. (sale@mukit.at) or visit our website (https://mukit.at).