Webszolgáltatások¶

A webszolgáltatás modul közös felületet kínál minden webszolgáltatáshoz:

XML-RPC
JSON-RPC

Az üzleti objektumok elérhetők az elosztott objektum mechanizmuson keresztül is. Mindegyik módosítható az ügyfél felületen keresztül kontextuális nézetekkel.

Az Odoo elérhető XML-RPC/JSON-RPC interfészeken keresztül, amelyekhez számos nyelven léteznek könyvtárak.

XML-RPC Könyvtár¶

A következő példa egy Python 3 program, amely az xmlrpc.client könyvtárral lép kapcsolatba egy Odoo szerverrel:

import xmlrpc.client

root = 'http://%s:%d/xmlrpc/' % (HOST, PORT)

uid = xmlrpc.client.ServerProxy(root + 'common').login(DB, USER, PASS)
print("Logged in as %s (uid: %d)" % (USER, uid))

# Create a new note
sock = xmlrpc.client.ServerProxy(root + 'object')
args = {
    'color' : 8,
    'memo' : 'This is a note',
    'create_uid': uid,
}
note_id = sock.execute(DB, uid, PASS, 'note.note', 'create', args)

Exercise

Új szolgáltatás hozzáadása az ügyfélhez

Írjon egy Python programot, amely képes XML-RPC kéréseket küldeni egy Odoo-t futtató PC-hez (az Önéhez vagy az oktatóéhez). Ennek a programnak meg kell jelenítenie az összes ülést és azok megfelelő ülőhelyszámát. Emellett létre kell hoznia egy új ülést az egyik kurzushoz.

Lásd még

Külső API: Az XML-RPC részletes oktatóanyaga, példákkal több programozási nyelven.

JSON-RPC Könyvtár¶

A következő példa egy Python 3 program, amely egy Odoo szerverrel kommunikál a standard Python könyvtárak urllib.request és json segítségével. Ez a példa feltételezi, hogy a Productivity alkalmazás (note) telepítve van:

import json
import random
import urllib.request

HOST = 'localhost'
PORT = 8069
DB = 'openacademy'
USER = 'admin'
PASS = 'admin'

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})

# log in the given database
url = "http://%s:%s/jsonrpc" % (HOST, PORT)
uid = call(url, "common", "login", DB, USER, PASS)

# create a new note
args = {
    'color': 8,
    'memo': 'This is another note',
    'create_uid': uid,
}
note_id = call(url, "object", "execute", DB, uid, PASS, 'note.note', 'create', args)

A példák könnyen adaptálhatók XML-RPC-ről JSON-RPC-re.

Megjegyzés

Számos magas szintű API létezik különböző nyelveken, amelyek lehetővé teszik az Odoo rendszerek elérését anélkül, hogy kifejezetten XML-RPC-n vagy JSON-RPC-n keresztül kellene menni, mint például: