Cara menggunakan python rpc

Pada kesempatan ini saya akan sedikit berbagi mengenai penerapan web service API Odoo 11 (OpenERP) menggunakan Python. Python yang akan saya gunakan pada tutorial kali ini menggunakan Python 3. Banyak fitur dan data pada Odoo yang dapat diakses dari eksternal sistem Odoo. Hal ini dimungkinkan untuk memudahkan pengembang (developer) untuk melakukan pengintegrasian Odoo dengan beragam sistem yang ada. Bagian dari model refrensi API  pada Odoo mudah didapatkan dengan menggunakan fungsi XML-RPC dan dapat diakses menggunakan beragam bahasa. Adapun berama bahasa yang dapat digunakan diantaranya : Python, Ruby, PHP, dan Java.

Sebagai awalan, yang perlu kita persiapkan adalah Odoo 11 dan environment python 3  yang telah terinstall di PC/Laptop kita. Kemudian pastikan bahwa Modul Sales Management telah terinstall dengan baik pada Odoo kita.

Tujuan : Kustomisasi Sales Order pada Odoo 11

1. Melakukan Logging in pada Server Odoo 11
2. Melakukan Fungsi Read Sales Order
3. Melakukan Fungsi Create Sales Order
4. Melakukan Fungsi Update Sales Order
5. Melakukan Fungsi Delete Sales Order

A. Loggin in

Pada tahap ini, kita akan perlu untuk melakukan set up untuk keperluan authentifikasi identitas kita untuk masuk kedalam sistem Odoo. Untuk diketahui, dalam Odoo,  Sales Order (SO) merupakan 1 dari 329 total table yang ada.

Langkah 1 – Insiasi

Masuklah kedalam directory Odoo, kemudian jalankan environment Python. Alternatif masuk kedalam environment python bisa juga mengunakan CMD bawaan python secara langsung atau masuk ke directory python dalam file Odoo 11 “C:\Program Files (x86)\Odoo 11.0\python” pada CMD kemudia jalankan “python” kemudian enter.

url = "http://localhost:8069"
db = "XXXXXXXX"
username = "YYYYYYYYY"
password = "ZZZZZZZZZ"

Langkah 2 – Import XMLRPC & Autentifikasi
#Using python 3.6
import xmlrpc.client
from xmlrpc.server import SimpleXMLRPCServer
common = xmlrpc.client.ServerProxy('{}/xmlrpc/2/common'.format(url))
uid = common.authenticate(db, username, password, {})

Pada banyak contoh yang ada, selalu menggunakan “import xmlrpclib”. Namun module “xmlrpclib” hanya dimiliki oleh python 2, sedangkan untuk python 3 perlu mendapatkan penyesuaian. Lakukan “import xmlrpc.client” dan “from xmlrpc.server import SimpleXMLRPCServer” seperti contoh diatas 

Setelah import, kemudian lakukan aktifasi server dengan menjalankan url “http://localhost:8069/xmlrpc/2/common” dan dilanjutkan dengan authentifikasi pada sistem odoo untuk Logging in. Ketika “uid” untuk memastikan apakah bernilai satu (1). satu menunjukan bahwa kita telah berhasil masuk kedalam sistem.

B. Create Sales Order

Langkah 3 –  cek jumlah Sales Order awal

#Count Records
count = models.execute_kw(db, uid, password,
'sale.order','search_count',
[[]])


untuk mengecek jumlah sales order yang kita miliki, kita dapat menggunakan fungsi search_count.

Langkah 4 – Create Sales Order

#Create_SO
id_baru = models.execute_kw(db, uid, password, 'sale.order', 'create', [ {'partner_id': 10, 'pricelist_id':1}])


pada bagian ini, saya menginisiasi sebuah SO baru dengan fungsi “create” dengan inputan partner_id = 10 (“partner_id” merupakan id identitas dari customer yang membeli produk kita) sedangkan “pricelist_id” merupakan id identitas untuk jenis mata uang yang digunakan 1, menunjukan USD. Seperti pada gambar kita telah berhasil membuat id baru dengan id “10” dengan nama SO010.

Lakukan lagi pengecekan jumlah SO, maka jumlah SO bisa dipastikan akan bertambah.

C. Read Sales Order

#Baca SO id 1
id = 1
baca_order = models.execute_kw(db, uid, password,
'sale.order', 'read',
[id], {})

Untuk membaca Sales Order (SO) kita bisa menggunakan fungsi “Read”. Pada contoh di atas saya melakukan pembacaan SO dengan “id = 1″.

D. Update Sales Order

Pada tutorial ini kita akan melakukan perubahan data pada SO010 bagian state : draft menjadi state : sale.
#Update ID = 10
id = 10
update = models.execute_kw(db, uid, password, 'sale.order', 'write', [[id],
{
'state':'sale', 'invoice_status':'invoiced'
}])

Untuk melakukan perubahan data pada SO kita dapat menggunakan fungsi “write”, seperti contoh diatas. Kemudia cek menggunaka fungsi “read” untuk mengecek perubahan yang terjadi.

E. Delete Sales Order

Untuk mengawali fungsi ini, kita perlu mengetahui list id Sales Order yang kita miliki. Kita memiliki list id SO [10,9,8,7,6,5,4,3,2,1]. Kemudian dalam case ini kita akan menghapus SO ber id “6”

 #delete id = 6
id = 6
models.execute_kw(db, uid, password, 'sale.order', 'unlink', [[id]])

Kita melakukan fungsi hapus dengan metode “unlink”. Jika berhasil, maka kita akan mendapatkan balikan “TRUE” seperti contoh di atas.

Untuk memastikan bahwa id 6 telah berhasil di hapus, lakukan pengecekan dengan memanggil daftar SO.

Id 6 telah hilang dari list id Sales Order yang kita miliki.

Sekian tutorial penerapan Web Service Python 3 untuk penerapan kustemisasi (CREATE, READ, UPDATE dan DELETE) pada Sales Order Odoo 11. Semoga bermanfaat.