Odoo'nun master belgeleri, eski RPC veritabanı hizmetinin Odoo 20'de kaldırıldığını belirtiyor. Daha geniş XML-RPC ve JSON-RPC API'leri 19.0 sürümünden beri kullanım dışı bırakılmıştı, ancak Odoo 20 her eski hizmeti kaldırmıyor. Odoo, common ve object hizmetlerinin Odoo 22'ye kadar kullanılabilir kalacağını belgeliyor. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API) Bu nedenle entegrasyon ekipleri, eski RPC desteğini tek bir kaldırılma tarihine sahip tek bir özellik olarak görmek yerine her harici bağlantının kullandığı hizmeti belirlemelidir.
Odoo'nun Americas etkinlik sayfasında, Odoo 20'nin 2 ve 3 Eylül 2026 tarihlerinde San Francisco etkinliğinde yayınlanacağı belirtilmişti. (Oxp26 Americas Introduction) Yükseltme planlaması, belgelenmiş veritabanı hizmeti kaldırılmasını şimdi dikkate alabilir, ancak üretim kararları nihai Odoo 20 sürüm belgeleriyle doğrulanmalıdır.
Kaldırma belirli bir hizmeti kapsar
Odoo, `/xmlrpc`, `/xmlrpc/2` ve `/jsonrpc` uç noktalarını 19.0 sürümünden itibaren kullanım dışı bırakılmış eski uç noktalar olarak tanımlıyor. Bu API'ler içinde veritabanı hizmeti Odoo 20'de kaldırılırken, common ve object hizmetlerinin Odoo 22'ye kadar kalması planlanıyor. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API) Korunan bir hizmeti kullanan bir entegrasyon, Odoo 20 yükseltmesinden sonra çalışmaya devam edebilir, ancak yalnızca uç nokta uyumluluğu garanti etmez.
Bir sistem, eski RPC arayüzü üzerinden farklı hizmetleri kullanabilir. Bu nedenle bir entegrasyon incelemesi hem uç noktayı hem de çağrılan hizmeti kaydetmelidir. Bir uygulamayı yalnızca XML-RPC veya JSON-RPC entegrasyonu olarak tanımlamak, Odoo 20'de kaldırılan bir işleme bağımlı olup olmadığını göstermez. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API)
common ve object hizmetlerinin kullanılabilir kalması geçicidir. Odoo, her ikisinin de Odoo 22'de kaldırılacağını planlıyor. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API) Ekipler, veritabanı hizmeti çağrıları üzerindeki acil işleri korunan hizmetlerin geçişinden ayırabilir, ancak her ikisi de bir plan gerektirir.
JSON-2, istek sözleşmesini değiştirir
Odoo, yerine geçen API olarak JSON-2'yi belgeliyor. Uç nokta biçimi `/json/2/<model>/<method>` olup model ve method URL'nin içinde yer alır. (Odoo master Docs: Reference External API) Bu nedenle geçiş, mevcut bir RPC istemcisinde yalnızca temel yolu değiştirmekten daha fazlasını içerir. Her işlem uygun model ve method rotasına eşlenmelidir.
JSON-2, sıralı RPC argümanları yerine JSON istek gövdesinde adlandırılmış argümanlar gerektirir. (Odoo master Docs: Reference External API) Mevcut sarmalayıcılar, ara katman yazılımlar ve üretilen istemciler, argüman sırasının anlamı belirlediğini varsayabilir. Bu bileşenlerin tek tek incelenmesi gerekir. Bir eski isteği yeni uç noktaya yönlendirmek, istemci sıralı parametreler oluşturmaya devam ediyorsa çalışmaz.
Geçiş yapılan her işlem için ekipler, JSON-2 tarafından gereken hedef modeli, methodu ve adlandırılmış argümanları belgelemelidir. (Odoo master Docs: Reference External API) Ardından istekler ilgili Odoo 20 ortamında test edilmelidir, özellikle ortak bir entegrasyon kütüphanesi birkaç uygulama için çağrı oluşturuyorsa. Statik yük karşılaştırmaları, sunucunun veya istemcinin isteğin tamamını nasıl işlediğini doğrulayamaz.
Kimlik doğrulama da değişmelidir
JSON-2, bearer API-key kimlik doğrulaması kullanır. (Odoo master Docs: Reference External API) Geçiş çalışması, anahtar oluşturma, güvenli saklama, yetkilendirme üstbilgisi işleme ve anahtar değiştirmeyi kapsamalıdır. Yönlendiren isteklerde üstbilginin korunduğundan emin olmak için proxy'ler, gateway'ler ve istemci kütüphaneleri kontrol edilmelidir. Kimlik bilgileri açığa çıkmasın diye günlükleme, izleme ve hata işleme de gözden geçirilmelidir.
Dokümantasyon kimlik doğrulama yöntemini belirler, ancak her kuruluş API anahtarlarının kimlik bilgisi kontrollerine nasıl uyacağını kendisi belirlemelidir. (Odoo master Docs: Reference External API) Buna, anahtarların sorumluluğunu atamak, nerede kullanılabileceklerini denetlemek ve bir anahtar değiştirildiğinde etkilenen entegrasyonların nasıl güncelleneceğini tanımlamak da dahildir.
İkili alanlar için ayrı bir uyumluluk değişikliği var
Odoo'nun ORM değişiklik günlüğü, Odoo 20'deki bir başka RPC değişikliğini kaydediyor: ikili alanların gösterimi `BinaryValue.filename` ekleniyor. (Odoo master Docs: Orm Changelog) Bu durum veritabanı hizmetinin kaldırılmasından ayrıdır, çünkü hizmet kullanılabilirliğini değil, dönen veriyi değiştirir. İkili alan içeren yanıtları okuyan, dönüştüren veya doğrulayan uygulamalar uyumluluk testine dahil edilmelidir.
Değişiklik günlüğü `filename` öğesinin eklendiğini doğruluyor, ancak pratik etkisi istemciye bağlıdır. (Odoo master Docs: Orm Changelog) Testler, sıkı şemaların, serileştiricilerin, yanıt karşılaştırmalarının ve aşağı akış dönüşümlerinin ek üyeyi kabul edip etmediğini kontrol etmelidir. Bilinmeyen alanları yok sayan istemciler için ek ayarlama gerekmeyebilir, ancak bu davranış varsayılmamalı, doğrulanmalıdır.
Entegrasyon denetiminin kapsamı nasıl belirlenir
Odoo'nun kullanımdan kaldırılmış uç noktalar olarak işaretlediği `/xmlrpc`, `/xmlrpc/2` veya `/jsonrpc` kullanan bağlantıları belirleyerek başlayın. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API) Envanter, yapılandırma veya kaynak kodu mevcut olan kurum içi geliştirilen uygulamaları, ara yazılımları, zamanlanmış süreçleri ve üçüncü taraf bağlayıcıları kapsamalıdır. Amacının ve durumunun doğrulanabilmesi için her bağlantıya bir sorumlu atayın.
Ardından, her bağlantıyı eski hizmete göre sınıflandırın. Veritabanı hizmeti kullanımı Odoo 20 için düzeltme gerektirir, buna karşılık genel ve nesne hizmeti kullanımı Odoo 22'ye kadar kullanılabilir olarak belgelenmiştir. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API) Bu, aşamalı bir planı destekler: önce Odoo 20 uyumsuzluğunu ele alın, ardından kalan kullanımdan kaldırılmış çağrılar için geçiş tarihleri belirleyin.
JSON-2'ye geçen entegrasyonlar için, `/json/2/<model>/<method>` rotasını, adlandırılmış istek argümanlarını ve değişim arayüzü tarafından gereken bearer API anahtarı kimlik doğrulamasını kaydedin. (Odoo master Docs: Reference External API) Test senaryoları başarılı istekleri, reddedilen kimlik doğrulamayı, geçersiz adlandırılmış argümanları ve dönen verinin uygulama tarafından işlenmesini kapsamalıdır. İkili alanlar bulunduğu her yerde bu alanlar için de senaryo ekleyin.
Nihai Odoo 20 davranışını doğrulayın
Kaldırma ayrıntıları Odoo'nun master geliştirici dokümantasyonundan alınmıştır, duyurulan yayın zamanı ise Odoo 20'nin Eylül 2026 Americas etkinliği sırasında yayınlanacağını belirten bir etkinlik sayfasından gelmektedir. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API; Oxp26 Americas Introduction) Dağıtımdan önce ekipler, yayımlanan Odoo 20 sürümü için dokümantasyonu ve kullanmayı planladıkları tam edisyon ile build'i yeniden kontrol etmelidir.
Kullanımdan kaldırılmış bir RPC uç noktasını kullanmak, tek başına bir entegrasyonun Odoo 20'de çalışmayı durduracağını kanıtlamaz, çünkü genel ve nesne hizmetleri Odoo 22'ye kadar belgelenmiş olarak kalır. Tersine, önceki bir sürümde başarılı çalışma, bir veritabanı hizmeti çağrısının kaldırılmasından sonra uyumluluğu göstermez. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API)
Yükseltme karar kontrol listesi
Odoo 20 yükseltmesini onaylamadan önce, karar vericiler her kullanımdan kaldırılmış uç noktayı, çağrılan hizmeti, sorumlusunu ve planlanan düzeltmeyi gösteren bir entegrasyon kaydı istemelidir. Veritabanı hizmeti bağımlılıkları için test edilmiş bir alternatif olmalıdır. Genel veya nesne hizmetlerinde kalan entegrasyonlar için, Odoo 22'deki belgelenmiş kaldırmayı yansıtan ayrı bir geçiş tarihi bulunmalıdır. (Odoo master Docs: Reference External API; Odoo master Docs: Reference External Rpc API)
İnceleme, JSON-2 uygulamalarının model ve yöntemi URL içinde konumlandırdığını, adlandırılmış JSON argümanları kullandığını ve bir bearer API anahtarıyla kimlik doğruladığını doğrulamalıdır. İkili alanlar mevcut olduğunda, testler `BinaryValue.filename` eklenmesini dikkate almalıdır. (Odoo master Docs: Reference External API; Odoo master Docs: Orm Changelog) Bu kontroller, Odoo 20'de veritabanı hizmetinin hemen kaldırılmasını, kalan eski hizmetlerin daha sonra sonlandırılmasından ayırt eder.