SAP
n8n ile SAP OData: İlk Veri Okuma ve Bağlantı Seçimi
SAP OData servisini n8n HTTP Request ile okumak için servis sözleşmesi, kimlik bilgileri, sorgu parametreleri, sayfalama ve connector seçimi.
SAP tarafında yayınlanmış ve erişimine izin verilmiş bir OData servisi varsa, n8n HTTP Request node’u ile veri okuyabilirsiniz. Önce servis adresini, OData sürümünü, entity set’i ve kullanıcı yetkisini doğrulayın. Bir community node kurmak bu servisleri kendiliğinden yayınlamaz.
Bu rehber genel bir OData okuma akışını anlatır. NeKu AI’nin n8n-nodes-sap paketi ise kendi SAP wrapper modülü üzerinden çalışır. Bu ürünün kurulumunu n8n SAP Connector rehberinde bulabilirsiniz. Aşağıdaki örnekler temsilidir; çalışan bir müşteri akışı veya gerçek SAP testi değildir.
HTTP Request mi, SAP connector mı?
| Başlangıç durumu | Uygun inceleme yolu | Doğrulanacak konu |
|---|---|---|
| Belirli bir SAP OData servisi hazır | n8n HTTP Request ile servis sözleşmesini kullanmak | URL, kimlik doğrulama, entity set, alanlar ve sayfalama |
| Genel OData işlemleri için community node aranıyor | İlgili paketin kendi dokümantasyonunu incelemek | V2/V4 desteği, işlemler, bakım ve n8n ortamıyla uyumluluk |
| NeKu AI SAP modülü üzerinden rapor çağrısı gerekiyor | NeKu AI n8n SAP Connector | SAP modülü, lisans, Execute Report sözleşmesi ve rapor yetkisi |
Bu seçenekler aynı ürün değildir. HTTP Request node’u sorgu parametreleri ve sayfalama ayarları sunar; genel bir OData node’unun otomatik servis keşfi gibi özellikleri NeKu AI paketine aktarılamaz.
1. SAP servis sözleşmesini hazırlayın
SAP sorumlusundan test ortamındaki HTTPS servis kökünü, OData sürümünü, entity set adını, izin verilen alanları ve kimlik doğrulama yöntemini isteyin. Servis destekliyorsa $metadata belgesi veri modelini incelemeye yardımcı olur. OData V2 ile V4 yanıtları ve desteklenen sorgular aynı olmayabilir.
İlk görev için sınırlı bir veri kümesi seçin: örneğin izin verilen birkaç kaydın yalnız gerekli alanlarını okumak. Test kullanıcısının veri okuma yetkisi ayrıca kontrol edilmelidir. Servisin açılması, kullanıcının bütün verilere erişebildiği anlamına gelmez.
2. n8n HTTP Request node’unu ayarlayın
Bir Manual Trigger ve ardından HTTP Request ekleyin:
- Method:
GET. - URL: Kurumun sağladığı servis ve entity set adresi. Temsili biçim:
https://sap-test.example.com/<service-root>/<entity-set>. - Authentication: Servisin gerçekten desteklediği credential türü. HTTP Request, Basic ve OAuth2 dahil farklı seçenekler sunar; hedef SAP servisinin hangi yöntemi kullandığını doğrulayın.
- Send Query Parameters: Etkinleştirin ve servis sözleşmesinin desteklediği parametreleri ayrı alanlarda girin.
- Response Format: JSON yanıtı isteniyorsa JSON seçin; servisin döndürdüğü içerik türünü de kontrol edin.
Örnek adres bir yer tutucudur. Parolayı veya token’ı URL’ye, workflow metnine ya da paylaşılacak örneğe eklemeyin; n8n credential kaydını kullanın.
3. Okunacak veri miktarını sınırlandırın
| Parametre | İlk deneme | Kontrol |
|---|---|---|
$top | 5 | Servisin desteklediği kayıt sınırı |
$select | Onaylı alan adlarının virgülle ayrılmış listesi | Alan adlarını metadata veya servis sözleşmesinden alın |
$filter | Yalnız gerekliyse sözleşmeye uygun koşul | Alan türü, sözdizimi ve filtre desteği |
Bu parametreler bir yetkilendirme mekanizması değildir. Kullanıcının SAP yetkisi ve veri kapsamı sunucuda uygulanır. Servis desteklemiyorsa bir parametreyi zorlamak yerine dönen hatayı ve sözleşmeyi inceleyin.
4. V2/V4 yanıtını ve sayfalamayı kontrol edin
Yaygın JSON koleksiyon biçimleri OData V2’de d.results, V4’te value alanıdır. Gerçek yanıtın sürümünü, biçimini ve n8n node’unun çıktısını kontrol ederek sonraki adımın okuyacağı listeyi belirleyin; her servisin aynı zarfı döndürdüğünü varsaymayın.
İlk beş kayıt başarılıysa bütün kayıtların geldiği sonucunu çıkarmayın. Sunucu bir sonraki sayfa bağlantısı döndürüyorsa HTTP Request’in Pagination ayarı bu bağlantıyı kullanacak biçimde kurulabilir. V4 JSON yanıtında bu bağlantı genellikle @odata.nextLink, V2’de __next alanında bulunur. Alanın gerçek konumunu yanıttan doğrulayın. Bağlantının beklenen servis adresine ait olduğunu ve credential kapsamını kontrol edin; sayfa ve süre sınırı koyun.
n8n sayfalama dokümanı sonraki URL veya parametre tabanlı sayfalama ayarlarını açıklar. Servisin verdiği devam bağlantısını keyfi bir $skip hesabıyla değiştirmeyin.
5. Sonucu kabul ölçütüyle karşılaştırın
İlk akış Manual Trigger → HTTP Request → izin verilen alanları inceleme → beklenen sonuçla karşılaştırma olabilir. Veri okuma doğrulandıktan sonra bildirimi, AI yorumunu veya başka sisteme yazmayı ayrı bir adım olarak tasarlayın.
| Gözlem | İlk kontrol |
|---|---|
401 veya 403 | Credential, kullanıcı, servis erişimi ve veri yetkisi |
404 | Servis kökü, entity set ve servisin yayın durumu |
400 | Sorgu sözdizimi, alan adları ve desteklenen parametreler |
| Eksik kayıt | Sunucu sayfalaması, kayıt sınırı ve kullanıcı kapsamı |
| Zaman aşımı veya servis hatası | Ağ, servis durumu, süre sınırı ve kontrollü tekrar politikası |
Hataları boş bir “başarılı sonuç” listesine çevirmeyin. Okuma çağrısının tekrar davranışını değerlendirin; bu rehber SAP yazma, CSRF veya idempotency tasarımını kapsamaz.
NeKu AI wrapper akışı ne zaman seçilir?
NeKu AI’nin açık kaynak README’si Execute Report işlemini /ZNEKUAI_WRAPPER_SRV/ReportSet üzerinden tarif eder. Bu yol genel OData servis adresinden farklı bir sözleşmedir; SAP tarafındaki ticari modül ve onaylı rapor gerekir. Gerçek kurulum videosu, connector ürün sayfası ve demo kontrol listesi seçim için birlikte kullanılabilir.
Daha geniş mimari kararı için n8n, SAP Integration Suite ve MCP karşılaştırmasını okuyun. Mevcut OData servisi ile wrapper yaklaşımını aynı pilot görevi üzerinden değerlendirmek için ekibimizle görüşün.