API Mapping Oluşturma

​

Mapping Listesi

Mapping listesinde tüm tanımlı eşleştirmeleri görebilirsiniz. Liste aşağıdaki filtreleme seçeneklerini sunar:

• Kaynak Instance / Proje / API: Belirli bir kaynağa göre filtreleme
• Hedef Instance / Proje / API: Belirli bir hedefe göre filtreleme
• Durum: Taslak, Uyarı veya Hazır durumuna göre filtreleme

Her mapping satırında kaynak ve hedef bilgileri, ortam değişkeni durumu (eksik değişken sayısı) ve son çalışma zamanı gösterilir.

​

Mapping Sihirbazı

Yeni bir mapping oluşturmak için Yeni Mapping butonuna tıkladığınızda çok adımlı bir sihirbaz açılır. Sihirbaz, seçtiğiniz promotion tipine göre farklı adımlar sunar.

​

Adım 1: Genel Bilgi & Variables

Bu adımda temel yapılandırma bilgilerini girersiniz:

​

Promotion Tipi Seçimi

İlk olarak ne aktarmak istediğinizi seçin:

​

Kaynak ve Hedef Tanımı

Promotion tipini seçtikten sonra kaynak ve hedef bilgilerini belirleyin:

1. Kaynak Instance ve Kaynak Proje seçin
2. Hedef Instance ve Hedef Proje seçin
3. Kaynak API’yi seçin

​

Bağımlılık Tespiti (API Proxy Tipinde)

Kaynak API seçildiğinde sistem, API’nin oluşturulma tipini analiz eder ve gerekli bağımlılıkları otomatik olarak gösterir:

• Manuel oluşturulan API Proxy: Bağımlılık yoktur, sadece proxy tanımı taşınır
• DB-2-API ile oluşturulan API Proxy: Creator + Veritabanı Bağlantısı zorunlu olarak birlikte taşınır
• Script-2-API ile oluşturulan API Proxy: Creator zorunlu olarak birlikte taşınır
• Mock API ile oluşturulan API Proxy: Creator zorunlu olarak birlikte taşınır

Bağımlılıklar sıralı adımlar halinde tamamlanır. Her adım, bir önceki tamamlandıktan sonra aktif olur.

​

Hedef API Seçimi

Hedef ortamda iki seçeneğiniz vardır:

• Mevcut API Güncelle: Hedef projeden mevcut bir API seçin. API’nin mevcut yapılandırması kaynak ortamdan gelen değerlerle değiştirilir
• Yeni API Oluştur: Hedef ortamda kaynak API’den yeni bir API oluşturun

Hedef ortamda karşılık gelecek bir API yoksa Kaynaktan Oluştur butonu ile kaynak API’den otomatik olarak hedef ortamda yeni bir API oluşturabilirsiniz.

​

Proxy Group Senaryosu

Proxy Group seçildiğinde, grup içindeki tüm proxy’ler listelenir. Her proxy için hedef eşleştirme yapılmalıdır:

• Taşıma sırası: Önce grup ayarları (CORS, kimlik doğrulama, hız limiti, client route), ardından her bir proxy ve bağımlılıkları sırayla taşınır
• Creator tabanlı proxy’lerde Creator + Bağlantı zorunludur
• Manuel proxy’lerde sadece proxy tanımı taşınır

​

Deployment Ortamları

Hedef instance üzerinde API’nin hangi ortamlara deploy edileceğini seçebilirsiniz.

​

Adım 2: API Proxy Karşılaştırma

Bu adımda kaynak ve hedef API yapılandırmaları arasındaki farklar görüntülenir.

​

Fark Özeti

Karşılaştırma sonucunda aşağıdaki bilgiler gösterilir:

• Toplam fark sayısı
• Değiştirilen alanlar: Hem kaynakta hem hedefte mevcut ancak değerleri farklı olan alanlar
• Eklenen alanlar: Kaynakta var, hedefte olmayan alanlar (hedef ortama eklenecek)
• Silinen alanlar: Hedefte var, kaynakta olmayan alanlar (hedef ortamdan kaldırılacak)

​

Find & Replace Kuralları

API tanımındaki belirli alanları veya değerleri aktarım sırasında otomatik olarak değiştirmek için kurallar tanımlayabilirsiniz. Her kural bir Bul ve bir Değiştir değerinden oluşur. Kurallar JSONPath ifadesi veya düz metin olarak tanımlanabilir:

• JSONPath örneği: $.routing.routingAddressWrapperList[0].address → Backend URL’ini değiştirir
• Düz metin: Belirli bir metin değerini başka bir değerle değiştirir

​

Hariç Tutulan Alanlar

Karşılaştırma ve aktarım sırasında belirli alanları hariç tutabilirsiniz. İki tür hariç tutulan alan vardır:

• Sistem Varsayılanları (değiştirilemez): Kimlik numarası, oluşturma/güncelleme tarihi, kullanıcı bilgisi gibi ortama özgü alanlar otomatik olarak hariç tutulur
• Kullanıcı Tanımlı Alanlar: Ek olarak hariç tutmak istediğiniz alanları kendiniz ekleyebilirsiniz

​

Adım 3: Variables Mapping

Kaynak API’de kullanılan ortam değişkenlerinin hedef ortamdaki karşılıkları bu adımda eşleştirilir. Sistem, kaynak API’deki ortam değişkenlerini otomatik olarak tespit eder ve hedef ortamda aynı anahtarla tanımlı değişkenleri otomatik eşleştirir. Her değişken için durum bilgisi gösterilir:

• Mevcut: Hedef ortamda aynı anahtarla tanımlı bir değişken var
• Eksik: Hedef ortamda bu anahtarla tanımlı bir değişken bulunamadı

Değişkenler arasında filtreleme yapabilirsiniz: Tümü, Mevcut veya Eksik.

​

Adım 4: Ön Kontrol (Pre-Flight Check)

Aktarım öncesinde yapılandırmanın eksiksiz olduğunu doğrulamak için ön kontroller çalıştırabilirsiniz. Kontroller üç kategoride yapılır: Her kontrol sonucu Başarılı, Uyarı veya Hata olarak raporlanır.

​

Adım 5: Summary & Done

Son adımda tüm yapılandırmanın özeti görüntülenir:

• Instance bilgileri (kaynak ve hedef)
• Mapping bilgileri (API eşleştirmesi)
• Ortam değişkenleri durumu
• Find & Replace kuralları
• Hariç tutulan alanlar
• Bağlantı durumu

Özeti inceledikten sonra Tamamla butonu ile mapping’i kaydedebilirsiniz.

​

Mapping Görüntüleme ve Düzenleme

Kaydedilmiş bir mapping’in detaylarını görüntüleyebilir ve düzenleyebilirsiniz. Mapping detay ekranında:

• Kaynak ve hedef bilgilerini görebilirsiniz
• Ortam değişkeni eşleştirmelerini güncelleyebilirsiniz
• Find & Replace kurallarını düzenleyebilirsiniz
• Karşılaştırma sonuçlarını yenileyebilirsiniz
• Mapping’i çalıştırabilirsiniz

​

Mapping Klonlama

Mevcut bir mapping’i klonlayarak benzer yapılandırmayı farklı bir API veya ortam için hızlıca oluşturabilirsiniz.