15.05.27.00 - Catatan Rilis Portal Layanan Developer Apigee

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X.
info

Pada hari Selasa, 2 Juni 2015, kami merilis versi cloud baru dari Portal Layanan Developer Apigee.

Jika ada pertanyaan, buka Dukungan Pelanggan Apigee.

Untuk mengetahui daftar semua catatan rilis Apigee Edge, lihat Catatan Rilis Apigee.

Fitur baru

Ketersediaan umum SmartDocs

SmartDocs dirilis dari versi beta ke ketersediaan umum. Update dan fitur baru meliputi:

  • Dukungan untuk Swagger 2.0, termasuk impor menurut file atau URL, termasuk dukungan untuk objek keamanan bernama khusus.
  • Peningkatan desain visual dalam template yang membuat SmartDocs.
  • Peningkatan kegunaan dan alur kerja di Portal Developer, tersedia melalui menu Content > SmartDocs di Drupal.
  • Apa yang sebelumnya dikenal sebagai autentikasi "Token Kustom" kini disebut "Kunci API".
  • Objek "keamanan" autentikasi yang ditentukan di tingkat revisi.
  • Konfigurasi autentikasi klien di level template. Revisi baru tidak lagi mereset kredensial klien SmartDocs yang telah dikonfigurasi sebelumnya.

Untuk deskripsi fitur lainnya, lihat postingan blog ini.

Untuk dokumentasi SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.

Proses upgrade SmartDocs

Jika Anda telah menggunakan SmartDocs selama periode beta, fitur dan kemampuan baru dalam versi ketersediaan umum mengharuskan Anda mengupgrade SmartDocs dalam portal developer.

Setiap halaman SmartDocs yang telah dipublikasikan di portal developer Anda akan tetap berfungsi, tetapi Anda harus mengikuti proses pembaruan sebelum mengedit atau memublikasikan perubahan apa pun ke halaman yang sudah ada atau baru.

Perlu diingat bahwa meskipun Anda dapat merender dan memublikasikan SmartDocs di dalam portal developer, SmartDocs dibuat dari model API yang berada dalam Layanan Pengelolaan Edge API Apigee. Perubahan apa pun yang Anda buat pada model API di Edge akan sama di semua lingkungan Pantheon (serupa dengan cara developer berada di seluruh lingkungan Pantheon).

Untuk mengupgrade dari SmartDocs beta ke ketersediaan umum

  1. Update dan uji rilis 15.05.27 di lingkungan dev atau test di Pantheon.
  2. Buat model baru untuk menggantikan model API yang ada yang telah Anda gunakan.
    • Jika Anda telah mengimpor dokumen Swagger atau WADL, impor lagi ke revisi baru.
    • Jika Anda telah mempertahankan model API melalui modul SmartDocs, ekspor sebagai JSON SmartDocs dan impor ke model baru menggunakan lampiran file.
  3. Tetapkan properti keamanan revisi model Anda. Di halaman Konten > SmartDocs > model, pilih Setelan Keamanan.
  4. Periksa autentikasi yang telah dikonfigurasi sebelumnya di halaman setelan model (Content > SmartDocs) dengan mengklik Settings di kolom Operations.
  5. Update template kustom apa pun agar menggunakan aset CSS dan JS v6, lalu buat perubahan untuk mencerminkan nama objek baru, seperti authSchemes dan apiSchema. Untuk mengetahui informasi tentang cara mengupdate template SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.
  6. Render ulang dan publikasikan revisi model Anda.
  7. Setelah memvalidasi dokumentasi baru, update portal production Anda ke rilis 15.05.27.

Jika Anda adalah pelanggan Edge Enterprise dan memiliki pertanyaan atau masalah tentang proses upgrade, kirim email ke marsh@apigee.com dan cnovak@apigee.com. Atau, gunakan Komunitas Apigee untuk mendapatkan respons terbaik.

Bug telah diperbaiki

Bug berikut telah diperbaiki dalam rilis ini.

ID Masalah Deskripsi
DEVSOL-487 Format hari dalam Monetisasi harus dapat dikonfigurasi oleh admin
Format tanggal kini dapat dikonfigurasi di Monetisasi di bagian setelan monetisasi untuk format tanggal Eropa dan Amerika Serikat.
DEVSOL-603 Halaman Rencana Konflik tidak diformat dengan baik
Saat membeli paket yang tumpang-tindih dengan paket yang ada, halaman yang ditampilkan sekarang diformat dengan baik untuk pengguna.
DEVSOL-642 Memindahkan konfigurasi tingkat klien dari setelan keamanan ke setelan template
DEVSOL-709 SmartDocs: Parameter template URL tidak dapat diedit setelah mengirim permintaan dengan nilai kosong
Memperbaiki masalah yang membuat parameter template tidak dapat diedit setelah mengirim permintaan dari SmartDocs setelah menghapus parameter template dalam dokumentasi metode.
DEVSOL-1013 Membuat alamat email pengguna Portal Dev dapat diedit
Kolom alamat email di halaman edit profil tidak akan dinonaktifkan lagi dan developer dapat mengubah alamat email mereka.
DEVSOL-1273 "DevConnect Mint" muncul dua kali dalam daftar Module
Di bagian Modules, "Dev Connect Mint" ditampilkan dua kali. Hal ini sekarang telah diperbaiki.
DEVSOL-1313 Mendukung Impor File JSON/YAML atau URL untuk Swagger dan WADL
File WADL sekarang dapat diimpor melalui URL dan file Swagger dapat diupload.
DEVSOL-1339 Mengubah lokasi menu Admin SmartDocs
SmartDocs kini berada di menu konten, dan setelan smartdocs berada di menu admin setelan.
DEVSOL-1340 Hapus Beta saat masuk ke GA
SmartDocs kini berada di menu konten, dan setelan smartdocs berada di menu admin setelan.
DEVSOL-1390 Library PHP SDK Edge telah diupdate untuk memperbaiki masalah pemanggilan __toString()
Library PHP SDK Edge telah diupdate untuk memperbaiki masalah pemanggilan baris __toString() pada objek DeveloperRatePlan yang menghasilkan error ini: {tanda kutip} Error fatal: Panggil ke anggota fungsi format() pada non-objek di metode /Applications/MAMP/htdocs/ordnance/docelibraries()
DEVSOL-1398 SmartDocs Petstore Model yang diimpor saat penginstalan tanpa permintaan pengguna
SmartDocs kini mengimpor contoh swagger petstore selama penginstalan di situs (http://petstore.swagger.io/v2/swagger.json), bukan model cuaca, untuk memiliki contoh penggunaan SmartDocs yang lebih lengkap.
DEVSOL-1407 Cron gagal saat ada banyak developer
Saat menjalankan cron Drupal, sejumlah besar developer menyebabkan masalah waktu tunggu habis. Jika sebuah organisasi memiliki lebih dari 200 pengguna, kini proses batch digunakan.
DEVSOL-1470 Buat link Menu "API" dan tampilan yang sesuai
SmartDocs Portal Dev kini hadir secara default dengan link ke dokumentasi yang dirender SmartDocs di menu utama bernama "API", yang menautkan ke model apa pun dengan metode yang dipublikasikan.

Masalah Umum

Rilis ini berisi masalah umum berikut:

ID Masalah Deskripsi
DEVSOL-1558
Halaman metode SmartDocs Contoh Petstore tidak dirender dengan benar pada penginstalan baru
Contoh halaman metode Petstore di SmartDocs tidak dirender dengan benar saat penginstalan baru. Untuk menyelesaikan masalah ini:
  1. Pilih Konten > SmartDocs di menu Drupal.
  2. Pilih model "Contoh Petstore".
  3. Pilih Render and publish node di bagian Update Options.
  4. Klik kotak centang Select / Unselect all untuk memilih semua node.
  5. Klik Perbarui.

Node seharusnya dirender dengan benar sekarang.