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 Geliştirici Hizmetleri Portalı'nın yeni bir bulut sürümünü kullanıma sunduk.

Sorularınız varsa Apigee Müşteri Desteği sayfasını ziyaret edin.

Tüm Apigee Edge sürüm notlarının listesi için Apigee Sürüm Notları başlıklı makaleyi inceleyin.

Yeni özellikler

SmartDocs'un genel kullanıma sunulması

SmartDocs, beta sürümden çıkıp genel kullanıma sunuluyor. Güncellemeler ve yeni özellikler arasında şunlar yer alır:

  • Dosya veya URL ile içe aktarma dahil olmak üzere Swagger 2.0 desteği, özel olarak adlandırılmış güvenlik nesneleri için destek dahil.
  • SmartDocs oluşturan şablonlarda görsel tasarım iyileştirmeleri.
  • Geliştirici Portalı'ndaki kullanılabilirlik ve iş akışı iyileştirmeleri. Bu iyileştirmelere Drupal'daki İçerik > SmartDocs menüsünden erişebilirsiniz.
  • "Ö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.
  • Şablon düzeyinde istemci kimlik doğrulamasının yapılandırılması. Yeni düzeltmeler artık önceden yapılandırılmış SmartDocs istemci kimlik bilgilerini sıfırlamaz.

Diğer özellik açıklamaları için bu blog yayınını inceleyin.

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

SmartDocs yükseltme süreci

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

Geliştirici portalınızda yayınlanmış olan tüm SmartDocs sayfaları çalışmaya devam edecek ancak mevcut veya yeni sayfalarda yapılan değişiklikleri düzenlemeden ya da yayınlamadan önce güncelleme sürecini uygulamanız gerekir.

SmartDocs'u geliştirici portalınızda oluşturabilir ve yayınlayabilirsiniz ancak SmartDocs'un Apigee'nin Edge API Yönetim Hizmetleri'ndeki 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 var olma şekline benzer).

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

  1. 15.05.27 sürümünü Pantheon'daki geliştirme veya test ortamlarınızda güncelleyip test edin.
  2. Kullandığınız mevcut API modelini değiştirmek için 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ü aracılığıyla yönetiyorsanız SmartDocs JSON olarak dışa aktarın ve dosya eki kullanarak yeni modelinize aktarın.
  3. Modelinizin düzeltmesinin 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ında (İçerik > SmartDocs) önceden yapılandırılmış kimlik doğrulamayı kontrol edin.
  5. Özel şablonları CSS ve JS öğelerinin 6. sürümünü kullanacak şekilde 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 düzeltmenizi 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
Para kazanma bölümündeki tarih biçimi, Avrupa ve ABD tarih biçimleri için para kazanma ayarlarında artık yapılandırılabilir.
DEVSOL-603 Çakışan Plan sayfası kötü biçimlendirilmiş
Mevcut bir planla çakşan bir plan satın alınırken 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ına taşıma
DEVSOL-709 SmartDocs: Boş değerle istek gönderildikten sonra URL şablonu parametresi düzenlenemiyor
Yöntem dokümanında şablon parametresi silindikten sonra SmartDocs'tan istek gönderildikten sonra şablon parametrelerinin düzenlenemez hale gelmesi sorunu düzeltildi.
DEVSOL-1013 Geliştirici Portalı kullanıcı 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üller 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 JSON/YAML dosyası veya URL içe aktarma özelliği hem Swagger hem de WADL için desteklenir
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ünün altında, SmartDocs ayarları ise ayarlar yönetici menüsünün altında yer alıyor.
DEVSOL-1340 GA'ya geçerken Beta sürümünü kaldırma
SmartDocs artık içerik menüsünün altında, SmartDocs ayarları ise ayarlar yönetici menüsünün altında yer alıyor.
DEVSOL-1390 PHP SDK Edge kitaplığı, __toString() çağrısı sorununu düzeltmek için güncellendi
PHP SDK Edge kitaplığı, DeveloperRatePlan nesnesinde __toString() çağrısı sorununu düzeltmek için güncellendi. Bu sorun şu hatayı oluşturur: {quote} Önemli hata: /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php dosyasının 221. satırında, nesne olmayan bir öğede format() üye işlevi çağrısı {quote} Bu, yalnızca toString() yöntemini çağıran özel kod içeren para kazanma müşterilerini etkileyen bir hatadır.
DEVSOL-1398 SmartDocs Petstore Model, kullanıcıdan istem alınmadan yükleme sırasında içe aktarıldı
SmartDocs artık site yükleme sırasında hava durumu modeli yerine petstore swagger örneğini (http://petstore.swagger.io/v2/swagger.json) içe aktararak SmartDocs'un kullanımına dair daha kapsamlı bir örnek sunar.
DEVSOL-1407 Çok sayıda geliştirici olduğunda Cron başarısız oluyor
Drupal cron'u çalıştırırken çok sayıda geliştirici zaman aşımı sorununa neden oldu. Bir kuruluşta 200'den fazla kullanıcı varsa artık toplu işlem kullanılıyor.
DEVSOL-1470 "API'ler" menüsü bağlantısı ve ilgili görünümü oluşturma
Geliştirici Portalı SmartDocs'ta artık varsayılan olarak, "API'ler" adlı ana menüde, yayınlanan yöntemleri olan tüm modellere bağlantı veren SmartDocs oluşturulmuş dokümanlarının bağlantısı yer alır.

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'daki ö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şturulacaktır.