khanh.pndc/odoo-docs
1
0
Fork 0
mirror of https://github.com/odoo/documentation.git synced 2026-01-04 10:46:04 +07:00
Code Issues Packages Projects Releases Wiki Activity

[IMP] administration: new db manager ui

Browse Source
This commit is contained in:
xpl-odoo
2025-11-26 17:37:05 +01:00
parent aa44548368
commit 1ebd43e532
4 changed files with 134 additions and 159 deletions
Download Patch File Download Diff File Expand all files Collapse all files

293
content/administration/odoo_online.rst
View File

@@ -2,204 +2,179 @@
Odoo Online
===========
`Odoo Online <https://www.odoo.com/trial>`_ 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 <https://www.odoo.com/trial>`_ 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 <https://demo.odoo.com>`_ 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
<https://apps.odoo.com/apps>`_.
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 <https://demo.odoo.com>`_ instances are available. No
registration is required, but each instance only lives for a few hours.
Database manager
================
Database management
===================
To manage an Odoo Online database, open to the `database manager
<https://www.odoo.com/my/databases>`_ and sign in as the database administrator.
To manage a database, go to the `database manager <https://www.odoo.com/my/databases>`_ and sign in
as the database administrator.
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.
.. image:: odoo_online/database-manager.png
:alt: Accessing the database management options
- :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/upgrade:
Upgrade
=======
Trigger a database upgrade.
.. seealso::
For more information about the upgrade process, check out the :ref:`Odoo Online upgrade
documentation <upgrade-request-test>`.
.. _odoo_online/duplicate:
Duplicate
=========
Create an exact copy of the database, which can be used to perform testing without compromising
daily operations.
.. 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 <https://www.odoo.com/help>`_ to raise the limit.
.. _odoo_online/rename:
Rename
======
Rename the database and its URL.
.. _odoo_online/download:
Download
========
Download a ZIP file containing a backup of the database.
.. note::
Databases are backed up daily as per the `Odoo Cloud Hosting SLA
<https://www.odoo.com/cloud-sla>`_.
.. _odoo_online/domains:
.. _odoo-online/domain-names:
Domain names
============
------------
Use a custom :doc:`domain name </applications/websites/website/configuration/domain_names>` to
access the database via another URL.
:doc:`Configure a custom domain name <../applications/websites/website/configuration/domain_names>`
by selecting a database and clicking :icon:`fa-globe` :guilabel:`Domain Names`.
.. tip::
You can :ref:`register a domain name for free <domain-name/register>`.
:ref:`Register a domain name for free <domain-name/register>`.
.. _odoo_online/tags:
.. _odoo-online/tags:
Tags
====
----
Add tags to easily identify and sort your databases.
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`.
.. tip::
You can search for tags in the search bar.
Search for tags in the :icon:`fa-search` search bar at the top right.
.. _odoo_online/delete:
.. _odoo-online/hide:
Delete
======
Hide
----
Delete a database instantly.
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`.
.. 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.
.. Note::
It is possible to access a hidden database through its URL.
Carefully read the warning message and only proceed if the implications of deleting a database are
fully understood.
.. _odoo-online/manage:
.. image:: odoo_online/delete.png
:alt: The warning message displayed before deleting a database
Manage
------
Access all other database management options by selecting it and clicking :icon:`fa-gears`
:guilabel:`Manage`.
Switch plans
~~~~~~~~~~~~
Switch `pricing plans <https://www.odoo.com/pricing>`_ by clicking :guilabel:`Switch` under the
desired plan.
.. _odoo-online/upgrade:
Upgrade
~~~~~~~
Launch a :ref:`database upgrade <upgrade-request-test>` by clicking :guilabel:`Upgrade`.
.. 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 <https://www.odoo.com/help>`_.
This option is only displayed when an upgrade is available.
.. _odoo_online/contact-support:
.. _odoo-online/rename:
Contact us
==========
Rename
~~~~~~
Access the `Odoo.com support page <https://www.odoo.com/help>`_ with the database's details already
pre-filled.
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`.
.. _odoo_online/users:
.. _odoo-online/duplicate:
Invite / remove users
=====================
Duplicate
~~~~~~~~~
To invite users, fill out the new user's email address and click :guilabel:`Invite`. To add multiple
users, click :guilabel:`Add more users`.
Create a copy of the database by clicking :guilabel:`Duplicate`. In the dialog box, enter a
:guilabel:`New name` and click :guilabel:`Duplicate`.
.. image:: odoo_online/invite-users.png
:alt: Inviting a user on a database
.. 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 <https://www.odoo.com/help>`_ to extend the limit.
To remove users, select them and click :guilabel:`Remove`.
.. _odoo-online/download:
.. seealso::
- :doc:`/applications/general/users`
- :doc:`odoo_accounts`
Download a backup
~~~~~~~~~~~~~~~~~
.. _odoo_online/web-services:
Download a ZIP file containing a database backup by clicking :guilabel:`Download Backup`.
Web Services
.. note::
- Databases are backed up daily as per the `Odoo Cloud Hosting SLA
<https://www.odoo.com/cloud-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 <https://www.odoo.com/help>`_ to
request an alternative download solution.
.. _odoo-online/activity-logs:
View admin activity logs
~~~~~~~~~~~~~~~~~~~~~~~~
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::
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/transfer-ownership:
Transfer ownership
~~~~~~~~~~~~~~~~~~
Create a support ticket to request a database ownership transfer by clicking :guilabel:`Transfer
Ownership`.
.. _odoo-online/delete:
Delete
~~~~~~
Delete the database and close its related subscription by clicking :guilabel:`Delete`. In the dialog
box, click :guilabel:`Delete`.
.. 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 <odoo-online/download>` before deleting a database.
.. note::
After deletion, the database's name becomes available to anyone.
.. _odoo-online/web-services:
Web services
============
In order to programmatically retrieve the list of the databases displayed in the
`database manager <https://www.odoo.com/my/databases>`_, call the method `list` of the model
`odoo.database` via a :doc:`Web Service </developer/howtos/web_services>` call.
To retrieve a list of all databases displayed under the `database manager
<https://www.odoo.com/my/databases>`_ programmatically, call the `list` method of the
`odoo.database` model via an :doc:`external JSON-2 API <../developer/reference/external_api>` call.
Inspired from the examples provided in the :doc:`Web Services </developer/howtos/web_services>`
section, this is how to retrieve this list with the library ``xmlrpc.client``::
.. example::
.. code:: python
import xmlrpc.client
import requests
USER = 'user@domain.tld'
APIKEY = 'your_apikey'
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')
requests.post(
"https://www.odoo.com/json/2/odoo.database/list",
headers={
"Authorization": f"bearer {APIKEY}",
"X-Odoo-Database": "openerp",
}
json={},
)

BIN
content/administration/odoo_online/database-manager.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 2.8 KiB

BIN
content/administration/odoo_online/delete.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 19 KiB

BIN
content/administration/odoo_online/invite-users.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 6.0 KiB