Siklus hidup item

Alur yang direkomendasikan untuk pembuatan item di UI Fabric adalah

  1. Minta pengguna untuk nama item.
  2. Buat item "kosong".
  3. Edit dan simpan item baru.

Representasi skema dari bagian pertama manajemen siklus hidup item di Microsoft Fabric.

Proses ini dapat dibagi menjadi fase berikut:

  1. Membuat item kosong
  2. Muat item
  3. Mengedit item

Representasi skema dari bagian kedua dari manajemen siklus hidup item di Microsoft Fabric.

Saat pengguna memilih tombol untuk membuat item dari jenis apa pun, kode Fabric FE (Portal) perlu memuat editor item yang sesuai. Fabric FE melakukan panggilan API ke Fabric BE untuk mengambil informasi yang diperlukan, termasuk URL sumber, detail aplikasi ID Microsoft Entra, dan URL BE beban kerja, semuanya sesuai dengan konteks saat ini. Setelah informasi ini tersedia, item dibuat. Biasanya item memuat sumber daya statisnya seperti HTML, JavaScript, CSS, dan gambar dari CDN. Sebaiknya gunakan penyebaran CDN multi-wilayah dan untuk mengonfigurasi resolusi nama sehingga URL sumber akan diselesaikan ke server CDN yang secara fisik paling dekat dengan lokasi browser saat ini.

Catatan

Biasanya editor item perlu melakukan panggilan ke beban kerja BE, mungkin selama fase pengeditan. Ini memerlukan penyelesaian URL BE beban kerja berdasarkan konteks saat ini. Saat ini, kode dapat menggunakan URL BE yang dikodekan secara permanen.

Membuat item kosong

Ini adalah praktik umum di Fabric untuk memungkinkan pembuatan item tanpa input pengguna, kecuali nama item. Tidak diharapkan bahwa item tersebut melakukan sesuatu yang bermakna (oleh karena itu "kosong"), tetapi muncul di ruang kerja dan dapat berpartisipasi dalam alur dan operasi dasar. Selain itu, dalam beberapa kasus mereka bahkan dapat berfungsi, berdasarkan default yang wajar yang ditetapkan oleh beban kerja.

Alur ini dimulai dengan meminta pengguna untuk memberikan nama untuk item baru. Memiliki nama, iframe melakukan panggilan ke HOST JS API untuk memulai alur pembuatan item, melewati objek JSON opsional sebagai "payload pembuatan," dan host kemudian akan melakukan panggilan ke Fabric BE. Autentikasi ditangani oleh host. Fabric BE menyelesaikan URL BE beban kerja berdasarkan konteks, dan memanggil CreateItem API beban kerja, meneruskan "payload pembuatan" yang dikirim oleh iframe. BE beban kerja diharapkan untuk menyimpan metadata item baru, mungkin mengalokasikan beberapa sumber daya (meskipun langkah ini dapat ditangguhkan ke titik selanjutnya), dan melakukan pekerjaan lain yang relevan. Ketika pembuatan item selesai dari perspektif BE beban kerja, perlu memberi tahu Fabric BE pada perubahan metadata item. Proses yang sama perlu terjadi pada pembaruan metadata item apa pun, sehingga token subjek perlu ditukar dengan audiens Fabric BE.

Catatan

API untuk memberi tahu pembaruan metadata item saat ini tidak tersedia.

Muat item

Untuk mengedit item, iframe perlu memuat metadatanya. Proses ini sama untuk memuat item "kosong" dan "diinisialisasi". Iframe melakukan panggilan ke HOST JS API, yang memanggil Fabric BE, yang pada gilirannya memanggil API beban kerja GetItemPayload. BE beban kerja dapat mengembalikan objek JSON, yang kemudian diteruskan kembali ke iframe. Autentikasi ditangani oleh host.

Mengedit item

Setelah metadata item dimuat, sesi pengeditan dapat dimulai. Baik di awal atau selama sesi ini, iframe mungkin perlu melakukan panggilan ke BE beban kerja (misalnya untuk mengambil konfigurasi, mengisi kontrol UI, melakukan validasi, dan banyak lagi). Untuk tujuan ini, perlu meminta token dari API JS host.

Konten terkait

  • Last updated on