15.05.27.00 - Catatan Rilis Portal Layanan Developer Apigee

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

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

Jika ada pertanyaan, buka Dukungan Pelanggan Apigee.

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

Fitur baru

Ketersediaan umum SmartDocs

SmartDocs lulus dari versi beta ke ketersediaan umum. Pembaruan dan fitur baru meliputi:

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

Untuk deskripsi fitur selengkapnya, lihat postingan blog ini.

Untuk dokumentasi SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.

Proses upgrade SmartDocs

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

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

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

Untuk mengupgrade dari SmartDocs versi beta ke versi yang tersedia secara 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 mengelola 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 (Konten > SmartDocs) dengan mengklik Setelan di kolom Operasi.
  5. Perbarui template kustom apa pun untuk menggunakan aset CSS dan JS v6, dan buat perubahan untuk mencerminkan nama objek baru, seperti authSchemes dan apiSchema. Untuk informasi tentang cara memperbarui template SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.
  6. Render ulang dan publikasikan revisi model Anda.
  7. Setelah memvalidasi dokumentasi baru, update portal produksi Anda ke rilis 15.05.27.

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

Bug yang diperbaiki

Bug berikut diperbaiki dalam rilis ini.

ID Masalah Deskripsi
DEVSOL-487 Format hari di Monetisasi harus dapat dikonfigurasi oleh admin
Format tanggal kini dapat dikonfigurasi di Monetisasi pada 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 kini 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 menyebabkan parameter template tidak dapat diedit setelah mengirim permintaan dari SmartDocs setelah menghapus parameter template dalam dokumentasi metode.
DEVSOL-1013 Membuat alamat email pengguna Dev Portal 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 Modul
Di bagian Modul, "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 kini dapat diimpor melalui URL dan file Swagger dapat diupload.
DEVSOL-1339 Mengubah lokasi menu Admin SmartDocs
SmartDocs kini berada di bagian menu konten, dan setelan smartdocs berada di bagian menu admin setelan.
DEVSOL-1340 Menghapus Beta saat membuka GA
SmartDocs kini berada di bagian menu konten, dan setelan smartdocs berada di bagian 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 __toString() pada objek DeveloperRatePlan yang menyebabkan error ini: {quote} Error fatal: Panggilan ke fungsi anggota format() pada non-objek di /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php pada baris 221 {quote} Ini adalah bug yang hanya memengaruhi pelanggan Monetisasi dengan kode kustom yang memanggil metode toString().
DEVSOL-1398 Model Petstore SmartDocs diimpor saat penginstalan tanpa meminta pengguna
SmartDocs kini mengimpor contoh swagger petstore selama penginstalan situs (http://petstore.swagger.io/v2/swagger.json), bukan model cuaca, agar 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. Jika organisasi memiliki lebih dari 200 pengguna, proses batch kini digunakan.
DEVSOL-1470 Membuat link Menu "API" dan tampilan yang sesuai
SmartDocs Portal Dev kini dilengkapi dengan link ke dokumentasi SmartDocs yang dirender di menu utama bernama "API", yang tertaut 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 pada penginstalan baru. Untuk menyelesaikan masalah ini:
  1. Pilih Konten > SmartDocs di menu Drupal.
  2. Pilih model "Contoh Petstore".
  3. Pilih Render and publish nodes di bagian Update Opsi.
  4. Klik kotak centang Pilih / Batalkan pilihan semua untuk memilih semua node.
  5. Klik Perbarui.

Node seharusnya dirender dengan benar sekarang.