RAP — Geliştirme Nesneleri için Adlandırma Kuralları
Modern SAP uygulamalarında sürdürülebilirlik, okunabilirlik ve ekip içi uyumluluk açısından tutarlı bir geliştirme yaklaşımı kritik önem taşır. SAP’nin RESTful Application Programming Model (RAP) mimarisi, geliştirme sürecinde çok sayıda nesne türünü içerdiğinden, bu nesnelerin adlandırılması için belirli kuralların takip edilmesi büyük bir gerekliliktir. Bu yazımda, ABAP RAP geliştirme sürecinde kullanılan sözlük nesneleri, CDS görünümleri, davranış tanımları, servis katmanı ve kaynak kod nesneleri için SAP’nin önerdiği adlandırma kurallarını detaylı ve teknik bir biçimde ele alacağım. Bu rehber, hem ekip içi uyumu artırmak hem de uzun vadeli bakım süreçlerini kolaylaştırmak isteyen geliştiriciler için bir başvuru niteliğindedir.
Genel Adlandırma Kuralı
RAP nesneleri için adlar aşağıdaki şablona göre yapılandırılmalıdır:
[/<ad_alanı>/][<önek>]_<anlamlı_kısaltma>_[<sonek>]
Bu yapı; ad alanı, ön ek, anlamlı isimlendirme ve isteğe bağlı soneklerden oluşur.
Ad Alanı
Nesnenin özel mi yoksa standart bir SAP içeriği mi olduğunu ayırt etmek için kullanılır.
- Özel geliştirme nesneleri için genellikle Z veya müşteri/organizasyon bazlı bir ön ek (ör. ZSB_, ZAB_) kullanılır.
- Tüm özel RAP nesneleri bu ad alanıyla başlatılmalıdır. Örneğin: /ZSB/, /ZAB/.
Önek
Nesne türünü belirtir ve aynı iş alanına ait farklı nesne türlerinin birbirinden ayırt edilmesini sağlar.
Anlamlı Kısaltma (Semantic Identifier)
Geliştirilen nesnenin işlevini açıkça ifade eden, “_” ile ayrılmış açıklayıcı bir metindir.
- Bu ifade kısa, öz ve domain’e uygun olmalıdır.
- Örneğin: customer_name, sales_order, plant_material.
Sonek (Suffix)
Sonek, aynı nesne yapısının farklı versiyonlarını veya teknik varyasyonlarını belirtmek için kullanılır.
- Örneğin, OData servis versiyonları için _V2, _V4 sonekleri kullanılır.
Örnek Adlandırma
Aşağıda ZJP_ ad alanı kullanılarak oluşturulmuş bazı RAP nesne adlandırmaları verilmiştir:
Bu yapı, SAP RAP projelerinde adlandırma standardını oturtarak hem ekip içi geliştirme süreçlerini kolaylaştırır hem de sistematik bir yapının korunmasını sağlar.
ABAP Sözlük Nesneleri (ABAP Dictionary Objects)
CDS Görünümleri (CDS Views)
İş Hizmetleri (Service Layer Objects)
Kaynak Kod Nesneleri (ABAP Source Code Artifacts)
Ek Referans
SAP tarafından sağlanan örnek uygulamalarda bu adlandırma kurallarının nasıl kullanıldığını gözlemlemek mümkündür. Özellikle ABAP Uçuş Referans Senaryosu (Flight Reference Scenario), adlandırma yapısını incelemek ve RAP uygulamalarını derinlemesine anlamak için önemli bir kaynaktır.
İlgili Paket: /DMO/FLIGHT_LEGACY
