ZDOC serisinin dördüncü aracı ZDOCCDSMANAGER
Başlangıç: tabloların üzerine bir CDS katmanı
ZDOC serisinde üç aracı tamamlamıştım: AI destekli teknik dokümantasyon, code review ve ST22 dump analizörü. Hepsi verisini kendi Z tablolarına yazıyordu. Sıradaki adım, bu tabloların üzerine bir CDS katmanı kurmaktı.
Sistemim SAP NetWeaver 7.52 (veritabanı ASE). Bu sürümde klasik DEFINE VIEW var; view entity, RAP ve AMDP yok. Association, text association, path ifadeleri, parametreler ve aggregate'ler ise kullanılabiliyor.
Eclipse'e ABAP Development Tools'u kurup sisteme bağladım ve ZABAP paketinde 11 view oluşturdum:
| Katman | View'lar | Ne yapıyor |
|---|---|---|
| Temel (I_) | Severity, AIConfig, RevRule, RevFinding, AIDocument, RevHeader, DumpAnalysis, DumpByProgram | Her tabloyu anlamlı alan adları ve association'larla açar |
| Tüketim (C_) | FindingStats, ObjectQuality, ReviewsByPeriod | Kural bazında istatistik, nesne kalite panosu, parametreli tarih aralığı sorgusu |
İhtiyaç: CDS'leri taşımak ve izlemek
View'lar hazırlanırken iki soru ortaya çıktı:
- Bu 11 view'ı dosya olarak dışarı alıp başka bir sisteme toplu ve doğru sırayla nasıl kurarım?
- Bir rapor ya da sınıf hangi CDS'leri kullanıyor, bu CDS'ler de başka hangilerine bağlı?
Altyapı: IFDDDDL_HANDLER
abapGit, CDS'leri Git'e taşırken CL_DD_DDL_HANDLER_FACTORY sınıfını kullanıyor. Bu sınıf IF_DD_DDL_HANDLER arayüzünü döndürüyor ve arayüzde gereken her şey var:
READ: DDL kaynağını okurSAVE: kaynağı kaydederACTIVATEveMASS_ACTIVATE: tek tek ya da toplu aktivasyonGET_DDL_NAME_4_DD_ARTEFACT: SQL view adından DDL kaynağını bulur
MASS_ACTIVATE sınıfta değil arayüzde tanımlı; ilk aramada bu yüzden gözden kaçtı.Üç iş, tek program
1. İçe aktar
Klasördeki .ddls.asddls dosyalarını okumak kolay; önemli olan onları doğru sırayla kaydetmek. ZDOC_C_ObjectQuality, ZDOC_I_DumpByProgram'a join ile bağlı; ZDOC_I_RevHeader dört farklı view'a association kuruyor. Bağımlı bir view'ı bağımlılığından önce aktive etmek hata verir.
Çözüm iki aşamalı:
- Topolojik sıralama: Her dosyadaki
from,joinveassociationhedefleri çıkarılır; önce bağımsız view'lar, sonra onlara bağlı olanlar kaydedilir. - Önce toplu, sonra tek tek aktivasyon: Hepsi
MASS_ACTIVATEile aktive edilmeye çalışılır. Kalanlar, her turda en az biri başarılı olduğu sürece tek tek yeniden denenir.
2. Dışa aktar
Seçilen CDS'ler abapGit dosya adı kalıbıyla yazılır: zdoc_c_findingstats.ddls.asddls. Dosyalar bu programla başka bir sisteme aktarılabilir ya da bir Git deposuna konabilir.



3. Programdaki CDS'ler
Rapor, sınıf ya da fonksiyon grubu adı verilir; program kullanılan CDS'leri üç kaynaktan bulur:
| Kaynak | Nasıl çalışıyor | Neden gerekli |
|---|---|---|
| Kullanım indeksi | [[S19]] tablosunda include'lara ait tip kullanımları | Hızlı ve kesin |
| Kaynak tarama | Kodda [[S20]] / [[S21]] sonrası gelen adlar | İndeks güncel değilse eksiği kapatır |
| Bağımlılık | Bulunan CDS'lerin kendi kaynağındaki hedefler | Dolaylı kullanılan view'ları da gösterir |
DDLDEPENDENCY tablosu üzerinden tek bir DDL kaynağına eşlenir.Bağımlılık zinciri seviye seviye izlenir ve olası bir döngüye karşı 10 seviyede durur. ALV'de her satırın seviyesi görünür: 0 programda doğrudan kullanım, 1 ve üstü başka bir CDS'in bağımlılığı. CDS adına tıklayınca DDL kaynağı ayrı pencerede açılır.



Karşılaştığım konular
Karşılıklı association. İlk tasarımda RevFinding başlığa, AIDocument review'a geri bağlanıyordu. İki yönlü bağımlılık aktivasyon sırasını çözülemez hâle getirdiği için geri bağlantılar kaldırıldı; association'lar artık tek yönlü.
Güvenlik sınırı. DDL kaynağı yazabilen bir program ciddi bir yetki taşır. Bu yüzden içe aktarma yalnızca yerel ($) paketlerle sınırlandı ve yetki kontrolü eklendi. Transport'a bağlı kurulum kapsam dışı.
Aktivasyon hatasının ayrıntısı. MASS_ACTIVATE hatayı dönüş değerinde değil, aktivasyon logunda tutuyor. Log adı ALV'nin mesaj kolonuna yazılıyor.
Tablo tipi uyumsuzluğu. Sistemde derlerken satır içi tanımlanan (@DATA(...)) bir tablonun metot parametresinin tipiyle uyuşmadığı görüldü. Tipi açıkça tanımlamak ve tablo anahtarını DEFAULT KEY yapmak yeterli oldu.
ADT ve CDS Manager birlikte
İki araç birbirinin yerine geçmiyor, birbirini tamamlıyor:
- ADT: view yazmak, F8 ile Data Preview, association'ları izlemek
- CDS Manager: SAP GUI'den toplu içe/dışa aktarma, bir programın CDS bağımlılıklarını çıkarmak
Teknik özet
| Başlık | Detay |
|---|---|
| Program | [[S29]] (TCode: [[S30]]) |
| Yapı | Ana program + TOP, SEL ve üç sınıf include'u (repo, tarayıcı, uygulama) |
| API | [[S31]] → [[S32]] |
| Tablolar | [[S33]], [[S34]], [[S35]], [[S36]] |
| Arayüz | SALV tam ekran, hotspot ile kaynak görüntüleme |
| Sistem | SAP NetWeaver 7.52, klasik [[S37]] |
| Ek DDIC | Yok |
Şeffaflık notu
Bu aracın kodunu ben yazmadım; yapay zekâ asistanı yazdı. Benim payım şunlar oldu:
- Fikir ve ihtiyacın tanımı
- Eclipse/ADT kurulumu, CDS view'ların ve programın sisteme kurulumu
- API parametrelerinin sistemden kontrol edilip asistana iletilmesi
- Test, hataların ekran görüntüsüyle bildirilmesi ve düzeltmelerin doğrulanması