15.05.27.00 - Apigee Geliştirici Hizmetleri Portalı Sürüm Notları

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
info

2 Haziran 2015 Salı günü, Apigee Developer Services Portal'ın yeni bir bulut sürümünü yayınladık.

Sorularınız varsa Apigee Edge Destek Ekibi ile iletişime geçin.

Tüm Apigee Edge sürüm notlarının listesi için Apigee Sürüm Notları'na bakın.

Yeni özellikler

SmartDocs'un genel kullanıma sunulması

SmartDocs, beta sürümünden genel kullanıma geçiş yapıyor. Güncellemeler ve yeni özellikler şunlardır:

  • Dosya veya URL ile içe aktarma dahil olmak üzere Swagger 2.0 desteği. Özel adlandırılmış güvenlik nesneleri de desteklenir.
  • SmartDocs oluşturan şablonlarda görsel tasarım iyileştirmeleri yapıldı.
  • Drupal'daki İçerik > SmartDocs menüsünden erişilebilen Geliştirici Portalı'nda kullanılabilirlik ve iş akışı iyileştirmeleri.
  • "Özel jeton" kimlik doğrulaması olarak bilinen yöntem artık "API anahtarı" olarak adlandırılıyor.
  • Revizyon düzeyinde tanımlanan kimlik doğrulama "güvenlik" nesneleri.
  • İstemci kimlik doğrulamasının şablon düzeyinde yapılandırılması. Yeni düzeltmeler, önceden yapılandırılmış SmartDocs istemci kimlik bilgilerini artık sıfırlamıyor.

Diğer özellik açıklamaları için bu blog yayınına göz atın.

SmartDocs belgeleri için API'leri belgelemek üzere SmartDocs'u kullanma başlıklı makaleyi inceleyin.

SmartDocs yükseltme süreci

Beta döneminde SmartDocs'u zaten kullanıyorsanız genel kullanıma sunulan sürümdeki yeni özellikler ve işlevler için geliştirici portalınızda SmartDocs'u yükseltmeniz gerekir.

Geliştirici portalınızda daha önce yayınlanmış olan tüm SmartDocs sayfaları çalışmaya devam eder. Ancak mevcut veya yeni sayfalarda değişiklik yapmadan ya da bu değişiklikleri yayınlamadan önce güncelleme sürecini uygulamanız gerekir.

SmartDocs'u geliştirici portalınızda oluşturup yayınlayabileceğinizi ancak SmartDocs'un Apigee'nin Edge API Yönetim Hizmetleri'nde bulunan API modelinden oluşturulduğunu unutmayın. Edge'de bir API modelinde yaptığınız tüm değişiklikler, tüm Pantheon ortamlarınızda aynı olur (geliştiricilerin Pantheon ortamlarında bulunmasına benzer şekilde).

SmartDocs beta sürümünden genel kullanıma geçiş yapma

  1. Pantheon'da 15.05.27 sürümünü geliştirme veya test ortamlarınızda güncelleyin ve test edin.
  2. Kullandığınız mevcut API modellerinin yerine yeni bir model oluşturun.
    • Swagger veya WADL dokümanlarını içe aktarıyorsanız bunları yeni bir düzeltmeye tekrar aktarın.
    • API modelinizi SmartDocs modülü üzerinden yönetiyorsanız SmartDocs JSON olarak dışa aktarın ve dosya eki kullanarak yeni modelinize aktarın.
  3. Modelinizin revizyonunun güvenlik özelliklerini ayarlayın. İçerik > SmartDocs > model sayfasında Güvenlik Ayarları'nı seçin.
  4. İşlemler sütununda Ayarlar'ı tıklayarak model ayarları sayfasındaki (İçerik > Smart Docs) önceden yapılandırılmış tüm kimlik doğrulama işlemlerini kontrol edin.
  5. CSS ve JS öğelerinin 6. sürümünü kullanmak için tüm özel şablonları güncelleyin ve authSchemes ile apiSchema gibi yeni nesne adlarını yansıtacak şekilde değişiklikler yapın. SmartDocs şablonlarını güncelleme hakkında bilgi edinmek için API'leri belgelemek için SmartDocs'u kullanma başlıklı makaleyi inceleyin.
  6. Model revizyonunuzu yeniden oluşturun ve yayınlayın.
  7. Yeni dokümanları doğruladıktan sonra üretim portalınızı 15.05.27 sürümüne güncelleyin.

Edge Enterprise müşterisiyseniz ve yükseltme süreciyle ilgili sorularınız veya endişeleriniz varsa lütfen marsh@apigee.com ve cnovak@apigee.com adreslerine e-posta gönderin. Aksi takdirde, en iyi yanıtı almak için lütfen Apigee Topluluğu'nu kullanın.

Düzeltilen hatalar

Bu sürümde aşağıdaki hatalar düzeltilmiştir.

Sorun Kimliği Açıklama
DEVSOL-487 Para kazanma bölümündeki gün biçimi yöneticiler tarafından yapılandırılabilmelidir
Tarih biçimi artık para kazanma ayarları bölümünde Avrupa ve ABD tarih biçimleri için yapılandırılabilir.
DEVSOL-603 Çakışma planı sayfası kötü biçimlendirilmiş
Mevcut bir planla çakışan bir plan satın alındığında gösterilen sayfa artık kullanıcı için güzel bir şekilde biçimlendiriliyor.
DEVSOL-642 Müşteri düzeyindeki yapılandırmaları güvenlik ayarlarından şablon ayarlarını taşıma
DEVSOL-709 SmartDocs: Boş değerle istek gönderildikten sonra URL şablonu parametresi düzenlenemiyor
Yöntem dokümanlarındaki şablon parametresi silindikten sonra SmartDocs'tan istek gönderildiğinde şablon parametrelerinin düzenlenememesine neden olan sorun düzeltildi.
DEVSOL-1013 Geliştirici portalı kullanıcılarının e-posta adreslerini düzenlenebilir hale getirme
Profil düzenleme sayfasındaki e-posta adresi alanı artık devre dışı bırakılmayacak ve geliştiriciler e-posta adreslerini değiştirebilecek.
DEVSOL-1273 "DevConnect Mint" modül listesinde iki kez gösteriliyor
Modüller bölümünde "Dev Connect Mint" iki kez gösteriliyordu. Bu sorun artık düzeltildi.
DEVSOL-1313 Hem Swagger hem de WADL için JSON/YAML dosyası veya URL içe aktarma desteği
WADL dosyaları artık URL üzerinden içe aktarılabilir ve Swagger dosyaları yüklenebilir.
DEVSOL-1339 SmartDocs yönetici menüsü konumlarını değiştirme
SmartDocs artık içerik menüsünde, SmartDocs ayarları ise ayarlar yönetici menüsünde yer alıyor.
DEVSOL-1340 GA'ya geçişte Beta'yı kaldırma
SmartDocs artık içerik menüsünde, SmartDocs ayarları ise ayarlar yönetici menüsünde yer alıyor.
DEVSOL-1390 PHP SDK Edge kitaplığı, __toString() işlevinin çağrılmasıyla ilgili sorunu düzeltmek için güncellendi
PHP SDK Edge kitaplığı, __toString() işlevinin DeveloperRatePlan nesnesinde çağrılmasıyla ilgili sorunu düzeltmek için güncellendi. Bu işlem şu hataya neden oluyordu: {quote} Fatal error: Call to a member function format() on a non-object in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php on line 221 {quote} Bu hata yalnızca toString() yöntemini çağıran özel kodlu para kazanma müşterilerini etkiler.
DEVSOL-1398 Kullanıcıdan istemde bulunmadan yükleme sırasında içe aktarılan SmartDocs Petstore modeli
SmartDocs, artık site kurulumu sırasında hava durumu modeli yerine petstore swagger örneğini (http://petstore.swagger.io/v2/swagger.json) içe aktararak SmartDocs kullanımına dair daha kapsamlı bir örnek sunuyor.
DEVSOL-1407 Çok sayıda geliştirici olduğunda Cron başarısız oluyor
Drupal cron çalıştırılırken çok sayıda geliştirici zaman aşımı sorununa neden oldu. Bir kuruluşta 200'den fazla kullanıcı olduğunda artık toplu işlem kullanılır.
DEVSOL-1470 "API'ler" menü bağlantısı ve ilgili görünümü oluşturma
Geliştirici Portalı SmartDocs artık varsayılan olarak, yayınlanmış yöntemlere sahip tüm modelleri bağlayan "API'ler" adlı ana menüde SmartDocs ile oluşturulmuş belgelere bağlantı içerir.

Bilinen sorunlar

Bu sürümde aşağıdaki bilinen sorunlar vardır:

Sorun Kimliği Açıklama
DEVSOL-1558
Petstore Example SmartDocs yöntem sayfaları yeni bir yüklemede doğru şekilde oluşturulmuyor
SmartDocs'taki örnek Petstore yöntemi sayfaları, yeni bir yüklemede doğru şekilde oluşturulmuyor. Bu sorunu düzeltmek için:
  1. Drupal menüsünde İçerik > SmartDocs'u seçin.
  2. "Petstore Example" modelini seçin.
  3. Güncelleme Seçenekleri bölümünde Düğümleri oluştur ve yayınla'yı seçin.
  4. Tüm düğümleri seçmek için Tümünü seç / Tümünün seçimini kaldır onay kutusunu tıklayın.
  5. Güncelle'yi tıklayın.

Düğümler artık düzgün şekilde oluşturulmalıdır.