ReadyAPI'den Apidog'a Geçiş Nasıl Yapılır?

TL;DR

ReadyAPI'den Apidog'a geçiş, REST ağırlıklı test paketleri için kolaydır. ReadyAPI projenizi dışa aktarın, OpenAPI içe aktarma yoluyla dönüştürebildiklerinizi çevirin ve Groovy betiklerini JavaScript'te manuel olarak yeniden oluşturun. SOAP test senaryoları en çok manuel çalışma gerektirir. Test kapsamını sürekli tutmak için aşamalı bir geçiş planlayın.

💡

Apidog, OpenAPI spesifikasyonlarını ve Postman koleksiyonlarını içe aktaran ve JavaScript betikleriyle test işlem hatlarını çalıştıran ücretsiz, hepsi bir arada bir API geliştirme platformudur. Apidog'u ücretsiz deneyin, kredi kartı gerekmez.

Düğme

Giriş

API test altyapısını taşımak, başlayana kadar kolay görünen işlerden biridir. ReadyAPI projeleri, yılların birikmiş test senaryolarını, özel Groovy betiklerini, veri dosyalarını, ortamları ve karmaşık test paketi yapılarını içerebilir. Tüm bunları Apidog'a aktarmak, nelerin otomatik olarak aktarılacağını, nelerin manuel dönüştürme gerektireceğini ve neleri geride bırakacağını anlamayı gerektirir.

Bu rehber, geçiş sürecini adım adım anlatır. ReadyAPI projenizi dışa aktarmayı, sahip olduklarınızı analiz etmeyi, Apidog'a aktarmayı, Groovy'den JavaScript'e dönüşümü ele almayı, CI/CD kurmayı ve her iki aracın paralel çalıştığı geçiş dönemini yönetmeyi kapsar.

Adım 1: Başlamadan önce ReadyAPI projenizi denetleyin

Herhangi bir şeyi dışa aktarmadan önce, mevcut ReadyAPI projenizde nelerin olduğunu anlamak için zaman ayırın. Bu denetim, geçişin ne kadar süreceğini ve çabayı nereye odaklayacağınızı şekillendirir.

ReadyAPI projenizi açın ve şu soruları yanıtlayın:

Kaç adet test paketi, test senaryosu ve test adımı var? Gezgin panelini açın ve sayın. 50 test senaryosu olan bir proje saatler içinde taşınır. 500 test senaryosu olan bir proje günler sürer.

REST ve SOAP test senaryolarının yüzdesi nedir? REST test senaryoları çok daha temiz bir şekilde taşınır. SOAP test senaryoları, özellikle WS-Security politikaları veya karmaşık onaylamalar kullanıyorsa, daha fazla manuel çalışma gerektirir.

Test senaryolarınızda ne kadar Groovy betiği var? Test senaryolarınıza tıklayarak betik adımlarını arayın. Kaç test senaryosunun özel Groovy mantığına sahip olduğunu sayın. Her Groovy betiği, manuel olarak JavaScript'e dönüştürülmelidir.

DataSource adımlarıyla veri odaklı testler kullanıyor musunuz? Apidog, CSV ve JSON veri dosyalarıyla veri odaklı testleri destekler, ancak kurulum ReadyAPI'nin DataSource/DataSink modelinden farklıdır.

Properties veya Property Transfer adımlarını yoğun bir şekilde kullanıyor musunuz? Bu kalıplar Apidog'da farklı çalışır. Bunun yerine değişkenler ve ortam değişkenleri kullanacaksınız.

LoadUI Pro aracılığıyla yük testleri yapıyor musunuz? LoadUI Pro entegrasyonu Apidog'a aktarılmaz. Bu senaryolar için k6 veya başka bir yük testi aracını ayrı olarak kurmanız gerekecektir.

Bulgularınızı belgeleyin. Test senaryosu adı, türü (REST/SOAP), Groovy içeriyor mu (evet/hayır) ve karmaşıklığı (basit/orta/karmaşık) içeren bir e-tablo, başlamadan önce size bir geçiş tahmini verir.

Adım 2: ReadyAPI projenizi dışa aktarın

ReadyAPI, projeleri XML dosyaları olarak depolar. Bir projeyi analiz için dışa aktarmak için:

ReadyAPI'yi açın ve projenizi açın.
Dosya > Farklı Kaydet'e gidin ve projeyi bağımsız bir XML dosyası olarak kaydedin.
Testlerinizin referans verdiği tüm harici veri dosyalarını (CSV, Excel, XML test verileri) kaydedin.
Ortamlar bölümü altında ayarladığınız tüm ortam yapılandırmalarını not alın.

Proje XML'i tüm test paketlerini, test senaryolarını, test adımlarını, betikleri ve yapılandırmayı içerir. Test projenizin eksiksiz bir temsilidir.

Adım 3: API tanımlarınızı çıkarın

REST API'ler için en temiz geçiş yolu, doğrudan ReadyAPI proje XML'inden değil, bir OpenAPI spesifikasyonu aracılığıyladır.

Seçenek A: ReadyAPI'den dışa aktarın. ReadyAPI'de bir REST hizmetiniz varsa, Gezgin'de sağ tıklayın ve bir dışa aktarma veya API tanımı oluşturma seçeneği arayın. ReadyAPI, hizmet tanımlarından Swagger/OpenAPI spesifikasyonlarını dışa aktarabilir.

Seçenek B: Arka ucunuzun OpenAPI spesifikasyonunu kullanın. Arka uç hizmetiniz zaten bir OpenAPI spesifikasyonu (/openapi.json veya benzeri bir yerde) sunuyorsa, doğrudan indirin. Bu size en doğru ve güncel tanımı verir.

Seçenek C: Manuel olarak çıkarın. Mevcut bir spesifikasyonu olmayan API'ler için, ReadyAPI REST isteklerinizi kaynak olarak kullanın. Uç noktaları, istek gövdelerini, başlıkları ve yanıt yapılarını not alın. Bunları Apidog'da yeniden oluşturacaksınız.

Adım 4: Apidog'a aktarın

OpenAPI spesifikasyonunuz hazır olduğunda, onu Apidog'a aktarın.

Apidog'u açın ve yeni bir proje oluşturun.
API'ler > İçe Aktar'a gidin ve biçiminizi seçin (OpenAPI 3.0, Swagger 2.0, vb.).
Spesifikasyon dosyasını yükleyin veya URL'yi yapıştırın.
Apidog, spesifikasyonu ayrıştırır ve tüm uç noktalar için API tanımları oluşturur.

İçe aktarmadan sonra, tüm uç noktaları, parametreleri, istek gövdelerini ve yanıt şemalarını içeren yapılandırılmış bir API tanımınız olur. Bu, test senaryolarınızın temelidir.

Mevcut Postman koleksiyonlarınız varsa (belki önceki bir araçtan taşınmış), Apidog bunları da Dosya > İçe Aktar > Postman yoluyla içe aktarır.

Adım 5: REST uç noktaları için test senaryolarını yeniden oluşturun

REST test senaryoları için geçiş süreci şöyledir:

Bir ReadyAPI REST test senaryosunu açın.
Kullandığı istekleri, onaylamaları ve tüm veri kaynaklarını belirleyin.
API uç noktasını seçerek ve test adımları ekleyerek Apidog'da ilgili bir test senaryosu oluşturun.

Onaylamalar şu şekilde çevrilir:

İçerir onaylaması (gövde dize içeriyor) bir JavaScript onaylaması haline gelir: pm.test('değer içeriyor', () => { pm.expect(pm.response.text()).to.include('beklenen dize'); });
Durum kodu onaylaması: pm.test('durum 200', () => { pm.response.to.have.status(200); });
JSONPath onaylamaları: pm.test('alan değeri', () => { pm.expect(pm.response.json().fieldName).to.equal('beklenen'); });

Groovy içermeyen basit GET ve POST testleri için bu geçiş hızlıdır. 5 ila 10 onaylamalı basit bir test senaryosu 15 ila 30 dakikada yeniden oluşturulabilir.

Adım 6: Groovy betiklerini JavaScript'e dönüştürün

Bu, önemli özel betiklemeye sahip projeler için geçişin en yoğun emek gerektiren kısmıdır.

Yaygın Groovy kalıpları ve JavaScript eşdeğerleri:

Bir yanıt değerini okuma:

// Groovy (ReadyAPI)
def response = context.expand('${TestStep#Response}')
def json = new groovy.json.JsonSlurper().parseText(response)
def value = json.fieldName

// JavaScript (Apidog)
const response = pm.response.json();
const value = response.fieldName;

Bir değişken ayarlama:

// Groovy
testRunner.testCase.setPropertyValue('myVariable', someValue)

// JavaScript
pm.variables.set('myVariable', someValue);

Koşullu onaylamalar:

// Groovy
if (statusCode == 200) {
  assert responseBody.contains("success")
}

// JavaScript
if (pm.response.code === 200) {
  pm.test('yanıt başarı içeriyor', () => {
    pm.expect(pm.response.text()).to.include('success');
  });
}

Tarih manipülasyonu:

// Groovy
def now = new Date()
def formatted = now.format('yyyy-MM-dd')

// JavaScript
const now = new Date();
const formatted = now.toISOString().split('T')[0];

Java kütüphanesi içe aktarımları veya karmaşık mantık içeren karmaşık Groovy betikleri için dönüşüm dikkatli analiz gerektirir. Her betiği okuyun, ne yaptığını anlayın ve eşdeğer JavaScript yazın. Otomatik çeviriye kalkışmayın — anlambilim sizi yanıltacak kadar benzer ancak sessiz hatalara neden olacak kadar farklıdır.

Adım 7: SOAP test senaryolarını ele alın

SOAP test senaryoları, herhangi bir ReadyAPI geçişinin en zorlu kısmıdır. Apidog'un özel SOAP araçları yoktur, bu yüzden farklı bir yaklaşım gerektirir.

Aynı zamanda bir REST arayüzü sunan SOAP hizmetleri için (giderek daha yaygın), testleri REST uç noktalarını kullanacak şekilde taşıyın ve SOAP katmanını bırakın.

REST alternatifi olmayan SOAP hizmetleri için iki seçeneğiniz vardır:

SOAP için ReadyAPI'yi tutun. SOAP test senaryoları için ReadyAPI'yi paralel olarak çalıştırın ve REST için Apidog'u kullanın. Bu, REST geçişini engellemeden SOAP kapsamını koruyan pratik bir orta yoldur.

SoapUI Açık Kaynak kullanın. SoapUI Açık Kaynak ücretsizdir ve SOAP testlerini halleder. ReadyAPI'nin tüm özelliklerini değiştiremez, ancak lisans maliyeti olmadan temel SOAP fonksiyonel testlerini kapsar.

SOAP geçişini aceleye getirmeyin. Özellikle WS-Security test senaryoları, onaylamaları dikkatlice yeniden üretilmezse önemli risk taşır.

Adım 8: Ortamları ve değişkenleri kurun

ReadyAPI'nin Ortam özelliği, Apidog'un Ortam sistemine karşılık gelir. Yapılandırdığınız her ReadyAPI ortamı için:

Apidog'da eşleşen bir ortam oluşturun (Ayarlar > Ortamlar).
Aynı değişkenleri ekleyin: temel URL'ler, kimlik doğrulama belirteçleri, paylaşılan başlıklar vb.
Test senaryolarının URL alanlarında ve istek gövdelerinde değişkenlere doğru Apidog sözdizimiyle ({{variableName}}) referans verdiğini doğrulayın.

Adım 9: CI/CD'yi Yapılandırın

ReadyAPI'nin CI kurulumu genellikle derleme aracıları üzerinde testrunner komutunu içerir. Apidog farklı bir yaklaşım kullanır.

Apidog CLI'yi CI aracınıza yükleyin:

npm install -g apidog-cli

Bir test koleksiyonunu çalıştırın:

apidog run "path/to/collection.json" -e "environment-id"

GitHub Actions için, bir iş akışı adımı şöyle görünebilir:

- name: API testlerini çalıştır
  run: apidog run collection.json --environment staging

Jenkins için, işlem hattınıza Apidog CLI'yı çağıran bir shell adımı ekleyin. Derleme aracısında ReadyAPI kurulumu gerekmez.

Yeni komutu kullanmak için CI yapılandırma dosyalarınızı güncelleyin. Apidog çalıştırmaları doğru şekilde doğrulandıktan sonra ReadyAPI testrunner referanslarını kaldırın.

Adım 10: Geçiş sırasında her iki aracı da paralel olarak çalıştırın

ReadyAPI'den Apidog'a tek bir günde geçiş yapmayın. En az bir sürüm döngüsü boyunca her iki aracı da paralel olarak çalıştırın.

Paralel dönem boyunca:

ReadyAPI testlerini yetkili test kapısı olarak CI'da çalıştırın.
Apidog testlerini yanında çalıştırın ve sonuçları karşılaştırın.
ReadyAPI'de görünmeyen Apidog'daki tüm hataları araştırın.
Yeni test senaryolarını aşamalı olarak yalnızca Apidog'a ekleyin.

Apidog'un ReadyAPI ile aynı hataları yakaladığına güvendiğinizde, ReadyAPI'yi CI işlem hattından kaldırın. Birkaç ay boyunca ReadyAPI kurulumunu bir geri dönüş seçeneği olarak saklayın.

Sıkça Sorulan Sorular

ReadyAPI'den Apidog'a geçiş tipik olarak ne kadar sürer?Minimum Groovy betiklemeye sahip yalnızca REST projesi bir ila üç gün içinde taşınabilir. Kapsamlı Groovy betikleri, SOAP test senaryoları ve karmaşık test yapıları olan büyük bir proje iki ila altı hafta sürebilir. Adım 1'deki denetim, taahhütte bulunmadan önce size en net tahmini verir.

ReadyAPI test veri dosyalarım Apidog'da çalışacak mı?CSV veri dosyaları, Apidog'un veri odaklı test özelliğiyle çalışır. İçe aktarma formatı benzerdir. Excel dosyaları önce CSV'ye dönüştürme gerektirir. XML veri dosyalarının ReadyAPI'de nasıl kullanıldığına bağlı olarak yeniden yapılandırılması gerekir.

Geçiş sırasında ReadyAPI ve Apidog'u aynı CI işlem hattında çalıştırabilir miyim?Evet ve bu önerilen yaklaşımdır. Mevcut işlem hattınıza ReadyAPI testrunner adımının yanına Apidog CLI adımını ekleyin. Geçiş döneminde her çalıştırmayı karşılaştırın.

Ortamları manuel olarak mı yeniden oluşturmam gerekiyor, yoksa otomatik bir yolu var mı?Ortam yapılandırması Apidog'da manuel olarak yeniden oluşturulmalıdır. ReadyAPI ortam ayarlarının otomatik içe aktarımı yoktur. ReadyAPI ortamlarınızı bir pencerede açık tutarken Apidog'da yeniden oluşturun.

REST eşdeğeri olmayan ReadyAPI testlerine ne olur?REST alternatifi olmayan yalnızca SOAP test senaryoları için, pratik seçenekler arasında bu özel testler için ReadyAPI'yi sürdürmek (muhtemelen daha az lisansla), SoapUI Açık Kaynak'a geçmek veya hizmetler eski ve düşük riskliyse bir test boşluğunu kabul etmek yer alır.

Apidog, ReadyAPI ile aynı onaylama türlerini destekliyor mu?Apidog, ReadyAPI'nin yerleşik onaylama türleriyle aynı mantıksal koşulları ifade edebilen JavaScript onaylamalarını destekler. Sözdizimi farklıdır, ancak REST testi için yetenekler karşılaştırılabilir. Bazı ReadyAPI'ye özgü onaylama türlerinin (SOAP Hatası, WS-Security) Apidog eşdeğeri yoktur.

ReadyAPI'den Apidog'a geçiş, öğleden sonra yapılacak bir iş değil, anlamlı bir projedir. Bunu dikkatlice planlayan, net bir denetimle başlayan, önce REST test senaryolarını taşıyan ve geçiş sırasında her iki aracı da paralel çalıştıran ekipler, kapsama boşlukları veya test regresyonları olmadan tamamlar.