Saran dan Komentar

Menggunakan konektor kustom dengan kontrol garis waktu

  • Artikel
  • 2 menit untuk membaca

Fitur konektor kustom menyediakan cara bagi pengembang untuk memunculkan informasi seperti Dataverse baris tabel, sumber data eksternal, dan sebagainya, sebagai entri catatan dalam komponen TimelineWallControl. Hal ini memungkinkan untuk satu set yang lebih luas dari skenario di samping yang ada out-of-box catatan, posting, dan kegiatan.

Untuk informasi tentang mengonfigurasi dan menggunakan garis waktu, lihat topik berikut:

Catatan yang dikonfigurasi dalam konektor kustom adalah sumber daya web JavaScript yang sesuai dengan antarmuka IRecordSource. Nama sumber daya web, bersama dengan konstruktor (nama termasuk namespace), dan jalur sumber daya web JSON opsional, dapat ditambahkan sebagai konfigurasi parameter UClientRecordSourcesJSON dalam FormXML.

<UClientRecordSourcesJSON>
  {"recordSources": [{
    "name": "new_SecondaryRecordSource", 
    "constructor": "SampleNamespace.SecondaryRecordSource"}]
  }
</UClientRecordSourcesJSON>

TimelineWallControl diharapkan untuk memuat sumber daya web JavaScript dan kemudian membuat instance IRecordSource dari konstruktor yang dikonfigurasi.

IRecordSource kemudian diinsialisasi (init), dengan permintaan halaman catatan (getRecordsData), permintaan untuk detail filter (getFilterDetails), dan permintaan untuk representasi UX dari satu rekaman (getRecordUX).

Respons dari meminta rekaman dipertahankan untuk meminimalkan jumlah permintaan rekaman yang terjadi dalam skenario multi-sesi.

Dukungan filter

Dukungan filter konektor kustom mencakup kemampuan berikut.

  • Menambahkan jenis filter baru ke grup filter yang sudah ada
  • Menambahkan grup filter baru
  • Memperbarui jumlah tipe filter yang ada
  • Filter pada kunci pencarian

Konektor kustom harus menggunakan informasi UserSettings Timezone dari konteks yang diteruskan di init() agar konsisten dengan rendering garis waktu.

Scope

Fitur konektor kustom didukung dalam formulir tabel sesi tunggal dan multi-sesi di Antarmuka Terpadu aplikasi model klien.

Di luar cakupan

Fungsi berikut tidak tersedia untuk fitur konektor kustom:

  • Skenario offline dan offline-by-default
  • Dasbor
  • Lokasi di mana TimelineWallControl tidak tersedia (seperti aplikasi konvergen, aplikasi kanvas, portal, halaman kustom, dan sebagainya)

Pembatasan yang diketahui

Sumber daya web yang dikonfigurasi tidak secara resmi dinyatakan sebagai dependensi ke formulir. Ini berarti bahwa mengekspor formulir tidak akan secara otomatis mengekspor sumber daya web dan mereka perlu ditambahkan ke ekspor itu secara manual. Selain itu, mudah untuk secara tidak sengaja menghapus sumber daya web ini.

Mengembangkan sumber rekaman

Saat mengembangkan sumber rekaman, pastikan untuk mengikuti praktik-praktik berikut:

  • Pastikan Anda mengambil data dengan aman. Model keamanan Antarmuka Terpadu menganggap sumber daya web JS dan JSON tidak dipercaya, dan dengan demikian, sumber daya tersebut tidak boleh berisi token atau rahasia di dalamnya, karena mereka akan disimpan dalam teks biasa.
  • Jika data berada di dalam Dataverse, gunakan objek konteks dari perilaku init untuk membuat permintaan menjadi Dataverse. Panggilan ke dalam Dataverse dari konteks memiliki permintaan proxy melalui iframe yang aman. Ini adalah cara out-of-box sumber rekaman dalam TimelineWallControl mengambil data.
  • Jika data berada di luar Dataverse, gunakan mekanisme yang ada dari platform untuk mengambil data eksternal.
  • Uji perubahan secara lokal dengan menggunakan Fiddler: Tingkatkan kelincahan pengembangan dan debugging sumber daya web JavaScript dengan menggunakan Fiddler AutoResponder. Informasi lebih lanjut: Pengembangan sumber daya web skrip menggunakan Fiddler AutoResponder.
  • Mengurangi risiko serangan XSS: Risiko serangan XSS terjadi saat menambahkan / mengikat HTML ke DOM. Gunakan teks biasa bila memungkinkan untuk mengurangi risiko ini. Jika HTML diperlukan, Anda harus membersihkan konten ini sebelum menambahkannya ke catatan.
  • Ikuti praktik terbaik umum untuk skrip klien. Informasi selengkapnya: Skrip klien di aplikasi berdasarkan model
  • Pastikan praktik desain inklusif, termasuk penggunaan alat pengujian otomatis seperti Accessibility Insights.

Sampel solusi

Anda dapat memulai dengan sampel solusi konektor kustom yang memiliki sumber daya web "SecondaryRecordSource", yang dikonfigurasi untuk formulir "Akun untuk Pengalaman Interaktif" dan "Akun untuk Pengalaman Multisesi".

Lihat juga

Gunakan timeline
Konfigurasikan Timeline

Catatan

Apa bahasa dokumentasi yang Anda inginkan? Lakukan survei singkat. (perlu diketahui bahwa survei ini dalam bahasa Inggris)

Survei akan berlangsung kurang lebih selama tujuh menit. Tidak ada data pribadi yang dikumpulkan (pernyataan privasi).