diff --git a/content/administration/odoo_online.rst b/content/administration/odoo_online.rst index cb5c3ce012..a5bc7b0d46 100644 --- a/content/administration/odoo_online.rst +++ b/content/administration/odoo_online.rst @@ -2,209 +2,179 @@ Odoo Online =========== -`Odoo Online `_ provides private databases which are fully managed and -hosted by Odoo. It can be used for long-term production or to test Odoo thoroughly, including -customizations that don't require code. +`Odoo Online `_ offers private databases hosted and managed by Odoo. +Odoo Online databases can be accessed using any web browser and do not require a local installation. +They can be used for long-term production or to thoroughly test Odoo, including customizations that +do not require custom code. + +.. tip:: + To quickly try out Odoo, shared `demo databases `_ are available for + testing. No registration is required; however, each database is only available for a few hours. .. note:: - Odoo Online is incompatible with custom modules or the Odoo App Store. + Odoo Online is incompatible with custom modules or modules from the `Odoo Apps Store + `_. -Odoo Online databases are accessed using any web browser and do not require a local installation. +.. _odoo-online/database-manager: -To quickly try out Odoo, shared `demo `_ instances are available. No -registration is required, but each instance only lives for a few hours. +Database manager +================ -.. _odoo_online/database-management: +To manage an Odoo Online database, open to the `database manager +`_ and sign in as the database administrator. -Database management -=================== +.. _odoo-online/domain-names: -To manage a database, go to the `database manager `_ and sign in -as the database administrator. +Domain names +------------ -All the main database management options are available by clicking the database name, except the -upgrade option, which can be accessed by clicking the **arrow in a circle** icon next to the -database name. It is only displayed if an upgrade is available. +:doc:`Configure a custom domain name <../applications/websites/website/configuration/domain_names>` +by selecting a database and clicking :icon:`fa-globe` :guilabel:`Domain Names`. -.. image:: odoo_online/database-manager.png - :alt: Accessing the database management options +.. tip:: + :ref:`Register a domain name for free `. -- :ref:`odoo_online/upgrade` -- :ref:`odoo_online/duplicate` -- :ref:`odoo_online/rename` -- :ref:`odoo_online/download` -- :ref:`odoo_online/domains` -- :ref:`odoo_online/tags` -- :ref:`odoo_online/delete` -- :ref:`odoo_online/contact-support` -- :ref:`odoo_online/users` -- :ref:`odoo_online/web-services` +.. _odoo-online/tags: -.. _odoo_online/upgrade: +Tags +---- -Upgrade -======= +Add tags to identify and sort databases by selecting a database and clicking :icon:`fa-tags` +:guilabel:`Tags`. In the dialog box, enter a tag, click the :icon:`fa-plus-circle` +(:guilabel:`plus`) button, and click :guilabel:`Save`. -Trigger a database upgrade. +.. tip:: + Search for tags in the :icon:`fa-search` search bar at the top right. -.. seealso:: - For more information about the upgrade process, check out the :ref:`Odoo Online upgrade - documentation `. +.. _odoo-online/hide: -.. _odoo_online/duplicate: +Hide +---- -Duplicate -========= +Permanently hide the database from the database manager by selecting it and clicking +:icon:`fa-eye-slash` :guilabel:`Hide`. In the dialog box, click :guilabel:`Yes, I don't need it +anymore`. -Create an exact copy of the database, which can be used to perform testing without compromising -daily operations. +.. Note:: + It is possible to access a hidden database through its URL. -.. important:: - - By checking :guilabel:`For testing purposes`, all external actions (emails, payments, delivery - orders, etc.) are disabled by default on the duplicated database. - - Duplicated databases expire automatically after 15 days. - - A maximum of five duplicates can be made per database. Under extraordinary circumstances, - contact `support `_ to raise the limit. +.. _odoo-online/manage: -.. _odoo_online/rename: +Manage +------ -Rename -====== +Access all other database management options by selecting it and clicking :icon:`fa-gears` +:guilabel:`Manage`. + +Switch plans +~~~~~~~~~~~~ -Rename the database and its URL. +Switch `pricing plans `_ by clicking :guilabel:`Switch` under the +desired plan. -.. _odoo_online/download: +.. _odoo-online/upgrade: -Download -======== +Upgrade +~~~~~~~ -Download a ZIP file containing a backup of the database. +Launch a :ref:`database upgrade ` by clicking :guilabel:`Upgrade`. .. note:: - - Databases are backed up daily as per the `Odoo Cloud Hosting SLA - `_. - - If the :guilabel:`Download` option is disabled, it means your database is too large to be - downloaded through this method. In this case, please contact `Odoo Support - `_ to request an alternative download solution. + This option is only displayed when an upgrade is available. -.. _odoo_online/domains: +.. _odoo-online/rename: -Domain names -============ +Rename +~~~~~~ -Use a custom :doc:`domain name ` to -access the database via another URL. +Rename and change the URL of a database by clicking :guilabel:`Rename`. In the dialog box, enter a +:guilabel:`New name` and click :guilabel:`Rename`. -.. tip:: - You can :ref:`register a domain name for free `. +.. _odoo-online/duplicate: -.. _odoo_online/tags: +Duplicate +~~~~~~~~~ -Tags -==== +Create a copy of the database by clicking :guilabel:`Duplicate`. In the dialog box, enter a +:guilabel:`New name` and click :guilabel:`Duplicate`. -Add tags to easily identify and sort your databases. +.. important:: + - By default, the :guilabel:`For testing purposes` option is enabled. It disables all external + actions (emails, payments, delivery orders, etc.) on the duplicated database. + - Duplicates expire after 15 days. + - A maximum of five duplicates can be created per database. Under extraordinary circumstances, + contact `Odoo Support `_ to extend the limit. -.. tip:: - You can search for tags in the search bar. +.. _odoo-online/download: -.. _odoo_online/delete: +Download a backup +~~~~~~~~~~~~~~~~~ -Delete -====== +Download a ZIP file containing a database backup by clicking :guilabel:`Download Backup`. -Delete a database instantly. +.. note:: + - Databases are backed up daily as per the `Odoo Cloud Hosting SLA + `_. + - If the :guilabel:`Download Backup` option is disabled, it means the database is too large to be + downloaded using the database manager. Contact `Odoo Support `_ to + request an alternative download solution. -.. danger:: - Deleting a database means that all data is permanently lost. The deletion is instant and applies - to all users. It is recommended to create a backup of the database before deleting it. +.. _odoo-online/activity-logs: -Carefully read the warning message and only proceed if the implications of deleting a database are -fully understood. +View admin activity logs +~~~~~~~~~~~~~~~~~~~~~~~~ -.. image:: odoo_online/delete.png - :alt: The warning message displayed before deleting a database +View the logs of all actions taken by Odoo employees or the database administrator on the database +by clicking :guilabel:`View Admin Activity Logs`. .. note:: - - Only an administrator can delete a database. - - The database name is immediately made available to anyone. - - Deleting a database if it has expired or is linked to a subscription is impossible. In that - case, contact `Odoo Support `_. + Actions taken by Odoo employees are typically the result of requests submitted to Odoo support, + done within the context of a quick start project, or necessary to maintain the database. -.. _odoo_online/contact-support: +.. _odoo-online/transfer-ownership: -Contact us -========== +Transfer ownership +~~~~~~~~~~~~~~~~~~ -Access the `Odoo.com support page `_ with the database's details already -pre-filled. +Create a support ticket to request a database ownership transfer by clicking :guilabel:`Transfer +Ownership`. -.. _odoo_online/users: +.. _odoo-online/delete: -Invite / remove users -===================== - -To invite users, fill out the new user's email address and click :guilabel:`Invite`. To add multiple -users, click :guilabel:`Add more users`. +Delete +~~~~~~ -.. image:: odoo_online/invite-users.png - :alt: Inviting a user on a database +Delete the database and close its related subscription by clicking :guilabel:`Delete`. In the dialog +box, click :guilabel:`Delete`. -To remove users, select them and click :guilabel:`Remove`. +.. danger:: + All the database's data will be deleted instaneously for all users and **cannot be restored**. It + is recommended to :ref:`download a backup ` before deleting a database. -.. seealso:: - - :doc:`/applications/general/users` - - :doc:`odoo_accounts` +.. note:: + After deletion, the database's name becomes available to anyone. -.. _odoo_online/web-services: +.. _odoo-online/web-services: -Web Services +Web services ============ -In order to programmatically retrieve the list of the databases displayed in the -`database manager `_, call the method `list` of the model -`odoo.database` via a :doc:`Web Service ` call. - -Inspired from the examples provided in the :doc:`Web Services ` -section, this is how to retrieve this list with the library ``xmlrpc.client``:: - - import xmlrpc.client - - USER = 'user@domain.tld' - APIKEY = 'your_apikey' - - root = 'https://www.odoo.com/xmlrpc/' - uid = xmlrpc.client.ServerProxy(root + 'common').login('openerp', USER, APIKEY) - sock = xmlrpc.client.ServerProxy(root + 'object') - databases_list = sock.execute('openerp', uid, APIKEY, 'odoo.database', 'list') - -And here is the equivalent example with JSON-RPC:: - - import json - import random - import urllib.request - - USER = 'user@domain.tld' - APIKEY = 'your_apikey' - - def json_rpc(url, method, params): - data = { - 'jsonrpc': '2.0', - 'method': method, - 'params': params, - 'id': random.randint(0, 1000000000), - } - req = urllib.request.Request(url=url, data=json.dumps(data).encode(), headers={ - "Content-Type": "application/json", - }) - reply = json.loads(urllib.request.urlopen(req).read().decode('UTF-8')) - if reply.get('error'): - raise Exception(reply['error']) - return reply['result'] - - def call(url, service, method, *args): - return json_rpc(url, 'call', {'service': service, 'method': method, 'args': args}) - - url = 'https://www.odoo.com/jsonrpc' - uid = call(url, 'common', 'login', 'openerp', USER, APIKEY) - databases_list = call(url, 'object', 'execute', 'openerp', uid, APIKEY, 'odoo.database', 'list') +To retrieve a list of all databases displayed under the `database manager +`_ programmatically, call the `list` method of the +`odoo.database` model via an :doc:`external JSON-2 API <../developer/reference/external_api>` call. + +.. example:: + .. code:: python + + import requests + + APIKEY = "your_apikey" + + requests.post( + "https://www.odoo.com/json/2/odoo.database/list", + headers={ + "Authorization": f"bearer {APIKEY}", + "X-Odoo-Database": "openerp", + } + json={}, + ) diff --git a/content/administration/odoo_online/database-manager.png b/content/administration/odoo_online/database-manager.png deleted file mode 100644 index a3254d29ad..0000000000 Binary files a/content/administration/odoo_online/database-manager.png and /dev/null differ diff --git a/content/administration/odoo_online/delete.png b/content/administration/odoo_online/delete.png deleted file mode 100644 index fb4a83687b..0000000000 Binary files a/content/administration/odoo_online/delete.png and /dev/null differ diff --git a/content/administration/odoo_online/invite-users.png b/content/administration/odoo_online/invite-users.png deleted file mode 100644 index 73270d05e7..0000000000 Binary files a/content/administration/odoo_online/invite-users.png and /dev/null differ diff --git a/content/applications/studio/automated_actions/webhooks.rst b/content/applications/studio/automated_actions/webhooks.rst index 2cd4c9ad07..4983bb3a56 100644 --- a/content/applications/studio/automated_actions/webhooks.rst +++ b/content/applications/studio/automated_actions/webhooks.rst @@ -36,7 +36,7 @@ Create a webhook in Odoo .. important:: Before implementing a webhook in a live database, configure and test it using a :ref:`duplicate - database ` to ensure the webhook performs as intended. + database ` to ensure the webhook performs as intended. .. tip:: :ref:`Activating developer mode ` before creating up a webhook gives greater