Odoo põhidokumentatsioon ütleb, et pärandandmebaasi RPC-teenus eemaldatakse Odoo 20-s. Laiemad XML-RPC ja JSON-RPC API-d on alates versioonist 19.0 aegunud, kuid Odoo 20 ei eemalda kõiki pärandteenuseid. Odoo dokumenteerib, et common- ja object-teenused jäävad kättesaadavaks kuni Odoo 22-ni. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API) Seetõttu peavad integratsioonimeeskonnad tuvastama iga välise ühenduse kasutatava teenuse, mitte käsitlema pärand RPC tuge ühe funktsioonina, millel on vaid üks eemaldamiskuupäev.
Odoo Ameerika sündmuste leht ütles, et Odoo 20 avaldatakse San Francisco üritusel 2. ja 3. septembril 2026. (Oxp26 Americas Introduction) Uuenduse planeerimisel saab nüüd arvestada dokumenteeritud andmebaasiteenuse eemaldamisega, kuid tootmisotsuseid tuleks kontrollida Odoo 20 lõpliku väljalaske dokumentatsiooni vastu.
Eemaldamine kehtib konkreetsele teenusele
Odoo nimetab `/xmlrpc`, `/xmlrpc/2` ja `/jsonrpc` pärand lõpp-punktideks, mis on alates versioonist 19.0 aegunud. Nendes API-des eemaldatakse andmebaasiteenus Odoo 20-s, samas kui common- ja object-teenused on kavandatud jääma kuni Odoo 22-ni. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API) Üks allesjäävat teenust kasutav integratsioon võib pärast Odoo 20-le uuendamist edasi töötada, kuid lõpp-punkt üksi ei tõenda ühilduvust.
Süsteem võib pärand RPC-liidese kaudu kasutada erinevaid teenuseid. Integratsiooni ülevaatus peaks seetõttu kirja panema nii lõpp-punkti kui ka kasutatud teenuse. Rakenduse kirjeldamine ainult XML-RPC või JSON-RPC integratsioonina ei näita, kas see sõltub Odoo 20-s eemaldatud toimingust. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API)
Common- ja object-teenuste jätkuv kättesaadavus on ajutine. Odoo kavandab mõlema eemaldamist Odoo 22-s. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API) Meeskonnad saavad eraldada kiireloomulise töö andmebaasiteenuse päringutega allesjäävate teenuste migratsioonist, kuid mõlemad vajavad plaani.
JSON-2 muudab päringu lepingut
Odoo dokumenteerib JSON-2 asendus-API-na. Selle lõpp-punkti vorming on `/json/2/<model>/<method>`, kus mudel ja meetod on URL-is kaasatud. (Odoo master Docs: Reference External API) Seetõttu tähendab migratsioon enamat kui olemasoleva RPC-kliendi baasitee asendamist. Iga toiming tuleb siduda sobiva mudeli ja meetodi marsruudiga.
JSON-2 nõuab JSON-päringukehas nimega argumente, mitte positsioonilisi RPC argumente. (Odoo master Docs: Reference External API) Olemasolevad ümbrised, vaherakenduskihid ja genereeritud kliendid võivad eeldada, et argumentide järjekord määrab tähenduse. Need komponendid vajavad eraldi ülevaatust. Pärandpäringu ümbersuunamine uuele lõpp-punktile ei tööta, kui klient jätkab positsiooniliste parameetrite koostamist.
Iga migreeritud toimingu puhul peaksid meeskonnad dokumenteerima sihtmudeli, meetodi ja JSON-2 jaoks vajalikud nimega argumendid. (Odoo master Docs: Reference External API) Seejärel tuleks päringuid testida vastavas Odoo 20 keskkonnas, eriti siis, kui jagatud integratsiooniteek koostab päringuid mitme rakenduse jaoks. Staatilised koormuse võrdlused ei kinnita, kuidas server või klient tervet päringut käsitleb.
Autentimine peab samuti muutuma
JSON-2 kasutab bearer API-võtme autentimist. (Odoo master Docs: Reference External API) Migreerimistöö peaks hõlmama võtme loomist, turvalist salvestamist, autoriseerimis-päise käsitlemist ja võtme asendamist. Proksid, väravad ja kliendiraamatukogud tuleks üle kontrollida, et veenduda, et need säilitavad päise päringute edastamisel. Läbivaatamist vajavad ka logimine, jälgimine ja veahaldus, et volitusi ei avaldataks.
Dokumentatsioon määratleb autentimismeetodi, kuid iga organisatsioon peab ise otsustama, kuidas API-võtmed sobivad nende volituste kontrollidega. (Odoo master Docs: Reference External API) See hõlmab vastutuse määramist võtmete eest, kontrollimist, kus neid võib kasutada, ning määratlemist, kuidas mõjutatud integratsioonid uuendatakse, kui võti asendatakse.
Binaarväljade puhul on eraldi ühilduvusmuudatus
Odoo ORM-i muudatuste logi registreerib veel ühe Odoo 20 RPC muudatuse: binaarväljade esitus lisab `BinaryValue.filename`. (Odoo master Docs: Orm Changelog) See on andmebaasiteenuse eemaldamisest eraldi, kuna see muudab tagastatavaid andmeid, mitte teenuse kättesaadavust. Rakendused, mis loevad, teisendavad või valideerivad binaarvälju sisaldavaid vastuseid, tuleks kaasata ühilduvuse testimisse.
Muudatuste logi kinnitab, et lisatakse `filename` liige, kuid selle praktiline mõju sõltub kliendist. (Odoo master Docs: Orm Changelog) Testides tuleks kontrollida, kas ranged skeemid, serialiseerijad, vastuste võrdlused ja allavoolu teisendused aktsepteerivad seda lisaliiget. Kliendid, mis eiravad tundmatuid välju, ei pruugi vajada kohandamist, kuid seda käitumist tuleb kinnitada, mitte eeldada.
Kuidas integratsiooniauditi ulatust määratleda
Alustage ühenduste tuvastamisest, mis kasutavad `/xmlrpc`, `/xmlrpc/2` või `/jsonrpc`, mida Odoo märgib aegunud lõpp-punktidena. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API) Inventuur peaks hõlmama ettevõttesiseselt arendatud rakendusi, vahendustarkvara, ajastatud protsesse ja kolmanda osapoole ühendusi, kus konfiguratsioon või lähtekood on kättesaadav. Määrake igale ühendusele omanik, et selle eesmärki ja olekut saaks kontrollida.
Järgmisena klassifitseerige iga ühendus pärandteenuse järgi. Andmebaasiteenuse kasutamine vajab Odoo 20 puhul kõrvaldamist, samas kui üld- ja objektiteenuse kasutus on dokumentatsiooni järgi saadaval kuni Odoo 22-ni. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API) See toetab etapiviisilist plaani: lahendage esmalt Odoo 20 ühildamatus, seejärel määrake ülejäänud aegunud kõnedele migratsioonikuupäevad.
JSON-2-le liikuvate integratsioonide puhul salvestage `/json/2/<model>/<method>` marsruut, nimega päringuargumendid ja kandja API-võtme autentimine, mida asendusliides nõuab. (Odoo master Docs: Reference External API) Testjuhtumid peaksid katma edukad päringud, tagasi lükatud autentimise, kehtetud nimega argumendid ja rakenduse poolse tagastatud andmete töötlemise. Lisage binaarvälja juhud kõikjal, kus need väljad esinevad.
Kinnitage Odoo 20 lõplik käitumine
Eemaldamise üksikasjad pärinevad Odoo master-arendaja dokumentatsioonist, samas kui välja kuulutatud väljalaskeaeg pärineb sündmuse lehelt, mis teatas, et Odoo 20 avaldatakse 2026. aasta septembri Americas ürituse ajal. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API; Oxp26 Americas Introduction) Enne juurutamist peaksid meeskonnad kontrollima uuesti vabastatud Odoo 20 versiooni dokumentatsiooni ning täpset väljaannet ja koostet, mida nad kavatsevad kasutada.
Aegunud RPC-lõpp-punkti kasutamine ei tõesta iseenesest, et integratsioon lakkab Odoo 20-s töötamast, sest üld- ja objektiteenused on dokumentatsiooni järgi saadaval kuni Odoo 22-ni. Vastupidi, edukas töö varasemas versioonis ei kinnita ühilduvust andmebaasiteenuse kõne puhul pärast selle eemaldamist. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API)
Uuenduse otsuse kontrollnimekiri
Enne Odoo 20 uuenduse heakskiitmist peaksid otsustajad küsima integratsiooniregistrit, mis näitab iga aegunud lõpp-punkti, kasutatud teenust, selle omanikku ja kavandatud kõrvaldamist. Andmebaasiteenuse sõltuvustel peaks olema testitud asendus. Üld- või objektiteenustele jäävatel integratsioonidel peaks olema eraldi migratsioonikuupäev, mis peegeldab nende dokumenteeritud eemaldamist Odoo 22-s. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API)
Ülevaatus peaks kinnitama, et JSON-2 rakendused paigutavad mudeli ja meetodi URL-i, kasutavad nimetatud JSON-argumente ning autentivad end bearer API võtmega. Kui esinevad binaarfailiväljad, peaks testimisel arvestama `BinaryValue.filename` lisandumisega. (Odoo master Docs: Reference External API; Odoo master Docs: Orm Changelog) Need kontrollid eristavad Odoo 20 andmebaasiteenuse kohese eemaldamise ülejäänud pärandteenuste hilisemast lõpetamisest.