4.15.07.00 - Catatan Rilis Portal Layanan Developer Apigee

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

Pada Selasa, 8 September 2015, kami merilis versi triwulanan Apigee Edge Developer Services Portal untuk Private Cloud.

Nama produk sebelumnya "Apigee Edge On-premises Developer Services Portal" atau "OPDK" kini menjadi "Apigee Edge Developer Services Portal for Private Cloud".

Jika ada pertanyaan, hubungi Dukungan Apigee Edge.

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

Persyaratan Apigee Edge untuk portal

Jika Anda menghubungkan rilis portal ini ke penginstalan Edge untuk Private Cloud, Anda harus menghubungkannya ke versi 4.15.07.00 atau yang lebih baru untuk memastikan semua fitur SmartDocs didukung. Lihat 4.15.07.00 - Apigee Edge untuk catatan rilis Private Cloud untuk mengetahui informasi selengkapnya.

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 berdasarkan file atau URL, termasuk dukungan untuk objek keamanan bernama kustom.
  • Peningkatan desain visual dalam template yang menghasilkan SmartDocs.
  • Peningkatan alur kerja dan kegunaan di Portal Developer, yang tersedia melalui menu Konten > SmartDocs di Drupal.
  • Autentikasi yang sebelumnya dikenal sebagai "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 mengetahui deskripsi fitur selengkapnya, lihat blog post 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 di portal developer.

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

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

Untuk mengupgrade dari SmartDocs versi beta ke ketersediaan umum

  1. Update dan uji rilis 15.05.27 di lingkungan dev atau test di Pantheon.
  2. Buat model baru untuk mengganti 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 SmartDocs JSON 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. Update template kustom apa pun untuk menggunakan aset CSS dan JS versi 6, dan lakukan 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 produksi ke rilis 15.05.27.

Jika Anda adalah pelanggan perusahaan Edge dan memiliki pertanyaan atau masalah terkait proses upgrade proses, 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 di bagian setelan monetisasi untuk format tanggal Eropa dan AS.
DEVSOL-584 Parameter jalur tidak diingat saat pertama kali digunakan
Parameter jalur saat melakukan panggilan tidak selalu diingat.
DEVSOL-603 Halaman Konflik Paket diformat dengan buruk
Saat membeli paket yang tumpang-tindih dengan paket yang ada, halaman yang ditampilkan kini diformat dengan baik untuk pengguna.
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-723 Menampilkan pesan yang mudah dipahami pengguna saat SmartDocs gagal diimpor
DEVSOL-1013 Membuat alamat email pengguna Portal Developer dapat diedit
Kolom alamat email di halaman profil tidak akan dinonaktifkan lagi dan developer dapat mengubah alamat email mereka.
DEVSOL-1244 Tidak mengaktifkan modul Indikator Lingkungan untuk rilis OPDK
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 menu konten, dan setelan smartdocs berada di menu admin setelan.
DEVSOL-1340 Menghapus Beta saat beralih ke GA
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:

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

Ini adalah bug yang hanya memengaruhi pelanggan Monetisasi dengan kode kustom yang memanggil metode toString().

DEVSOL-1398 Model SmartDocs Petstore 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, untuk memiliki contoh penggunaan SmartDocs yang lebih lengkap.
DEVSOL-1407 Cron gagal jika ada banyak developer
Saat menjalankan cron Drupal, sejumlah besar developer akan menyebabkan masalah waktu tunggu. Jika organisasi memiliki lebih dari 200 pengguna, proses batch kini digunakan.
DEVSOL-1410 Error Koneksi tidak terlihat saat menginstal Portal Developer
Menambahkan pesan error yang lebih baik ke penginstal saat koneksi pengelolaan Edge tidak berfungsi untuk meminimalkan masalah pemecahan masalah.
DEVSOL-1422 Menghapus formulir Konfigurasi SMTP dari profil Apigee
Proses penginstalan tidak lagi menanyakan apakah Anda ingin mengonfigurasi SMTP. Sebagai gantinya, hal ini dapat dilakukan setelah penginstalan selesai dengan mengikuti praktik Drupal standar untuk mengaktifkan modul SMTP dan mengonfigurasinya dengan benar.
DEVSOL-1427

Menambahkan hook ke modul Aplikasi Developer Devconnect untuk memungkinkan perubahan data data analisis
Modul devconnect_developer_apps kini menyediakan tiga hook baru:

# hook_devconnect_developer_apps_analytics_chart_data_alter()

# hook_devconnect_developer_app_analytics_datapoints_params_alter()

# hook_devconnect_developer_app_analytics_datapoints_alter()

Hal ini memungkinkan modul kustom mengubah diagram analisis aplikasi developer.

DEVSOL-1464 Error fatal saat menyimpan setelan Autentikasi untuk model
Saat Skema keamanan dihapus, kini akan muncul kotak centang untuk memilih apakah skema autentikasi Template terkait juga perlu dihapus.
DEVSOL-1470 Membuat link Menu "API" dan tampilan yang sesuai
SmartDocs Portal Developer kini dilengkapi secara default dengan link ke dokumentasi yang dirender SmartDocs di menu utama bernama "API", yang ditautkan ke model apa pun dengan metode yang dipublikasikan.
DEVSOL-1486 Panggilan SmartDocs dapat melakukan autentikasi dengan kunci yang telah ditentukan
Mengaktifkan autentikasi dengan kunci API yang telah disediakan dan yang disediakan pengguna.
DEVSOL-1499 Kode HTML tidak diuraikan dalam deskripsi parameter SmartDocs
Kode HTML kini diuraikan dalam deskripsi parameter SmartDocs.
DEVSOL-1507 Tidak dapat menambahkan beberapa parameter ke API dengan Tambahkan Metode
Anda kini dapat menambahkan beberapa parameter ke SmartDocs API saat mengedit metode.
DEVSOL-1509 Tidak melihat cara mengedit kolom "contoh" untuk SmartDocs API
Anda kini dapat menetapkan "Jenis MIME isi", "Dokumentasi isi", dan "Contoh isi" saat mengedit halaman SmartDocs.
DEVSOL-1534 Jenis konten tidak diisi dalam output SmartDocs
Jenis konten kini diisi di halaman metode SmartDocs.
DEVSOL-1554 Perbandingan tanggal tidak valid di Monetisasi
Di tab paket yang dibeli untuk portal developer yang mengaktifkan monetisasi, tombol "Batalkan" tidak pernah ditampilkan untuk paket dengan tanggal mulai di masa mendatang,
DEVSOL-1556 Modul Drupal versi lama dikirimkan
Modul media_youtube dan fitur telah diupdate ke versi terbaru.
DEVSOL-1558 Halaman metode SmartDocs tidak dirender untuk contoh PetStore
Pada penginstalan baru, metode SmartDocs PetStore contoh kini dirender dengan benar.
DEVSOL-1562 Membuat tampilan untuk setiap model SmartDocs
Saat membuat model baru, tampilan baru akan dibuat secara default untuk model tersebut.
DEVSOL-1565 Mengedit metode SmartDocs akan menghasilkan error Fatal
Memperbaiki masalah yang terkadang menyebabkan error saat mengedit metode SmartDocs.
DEVSOL-1567 "Tambahkan model" ditampilkan di menu admin teratas
Memperbaiki masalah item menu "Tambahkan model" yang ditampilkan di menu admin teratas.
DEVSOL-1576 Tampilan Dokumentasi API menampilkan nama model, bukan nama tampilan
Halaman Dokumentasi API yang ditampilkan saat mengklik "API" di menu menampilkan nama internal model, bukan nama tampilan. Jika Anda mengupdate ke rilis ini dan Anda telah mengubah tampilan ini, Anda harus mengembalikan tampilan untuk melihat perubahan ini dengan mengikuti langkah-langkah berikut: # Login sebagai administrator # Buka Struktur > Tampilan # Klik dropdown di samping "Edit" di "Model SmartDocs" untuk melihat semua operasi. # Jika Anda melihat "kembalikan", berarti Anda telah menimpa kode dengan perubahan Anda sendiri. Klik "kembalikan" untuk mengembalikan tampilan ke status default. Perhatikan bahwa tindakan ini akan menghapus perubahan yang telah Anda buat pada tampilan ini.
DEVSOL-1578 Merender model Cuaca dan Petstore di penginstalan situs
Model SmartDocs Petstore dan Cuaca diimpor di situs baru.
DEVSOL-1584 Paket tidak dapat dibeli
Memperbaiki masalah formulir pembelian paket monetisasi yang tidak dapat dikirimkan untuk rilis cloud 15.05.27.00 dan 15.06.08.00 jika Anda menggunakan tema Responsif Apigee atau subtema tema Responsif Apigee.
DEVSOL-1597 Tidak dapat mengubah setelan waktu tunggu developer
Bug yang menyebabkan setelan waktu tunggu koneksi Edge tidak diterapkan dengan benar telah diperbaiki.
DEVSOL-1620

Upgrade modul saya, indikator lingkungan, dan fitur
Update keamanan yang cukup penting untuk modul saya dan update modul untuk indikator lingkungan dan fitur. Info selengkapnya:

https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator

https://www.drupal.org/project/features

DEVSOL-1648 Pastikan arg_separator.output adalah '&' untuk mencegah kerusakan reCAPTCHA
Masalah terkait platform yang menyebabkan penggunaan Google reCAPTCHA rusak telah diperbaiki.
DEVSOL-1651 Tema Dasar Apigee gagal jika modul smartdocs tidak diaktifkan
Tema apigee_base tidak lagi bergantung pada modul SmartDocs yang diaktifkan.
DEVSOL-1654

Meningkatkan versi admin_views untuk mendapatkan perbaikan keamanan penting
Modul kontribusi berikut telah diupdate:

  • Tampilan Administratif
  • Migrasi
  • Pengalihan
  • Redis
  • Operasi Massal Tampilan