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.
bilgi

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

Sorularınız için 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 sunulma tarihine geçiyor. 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.
  • Düzeltme 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 sunulma tarihi sürümündeki 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 sunulma tarihine yükseltmek için

  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. Özel şablonları, CSS ve JS öğelerinin v6 sürümünü kullanacak şekilde güncelleyin ve authSchemes ile apiSchema gibi yeni nesne adlarını yansıtacak değişiklikler yapın. SmartDocs şablonlarını güncelleme hakkında bilgi 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ılabilir olmalıdır
Tarih biçimi artık Avrupa ve ABD tarih biçimleri için para kazanma ayarları bölümünde 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ığı, DeveloperRatePlan nesnesinde __toString() işlevinin ç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 etkileyen bir hatadır.
DEVSOL-1398 Kullanıcıdan istemde bulunulmadan yükleme sırasında SmartDocs Petstore modeli içe aktarılıyor
SmartDocs'un kullanımına dair daha kapsamlı bir örnek sunmak için artık site kurulumu sırasında hava durumu modeli yerine petstore swagger örneği (http://petstore.swagger.io/v2/swagger.json) içe aktarılıyor.
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'ta oluşturulan belgelere yönelik bir bağlantıyla birlikte gelir.

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.