Bagikan melalui

Panduan entitas virtual menggunakan penyedia Data OData v4

  • Artikel

Bayangkan jika Anda ingin mengakses, membuat, memperbarui, dan menghapus beberapa informasi pribadi tentang kontak dari sumber data dalam aplikasi bisnis kustom Anda. Karena sumber data yang digunakan untuk panduan ini memiliki layanan web v4 OData, Anda dapat menggunakan penyedia Data v4 OData yang disertakan dengan versi Dynamics 365 Customer Engagement Anda. Informasi selengkapnya: Panduan tabel virtual menggunakan penyedia Data OData v4

Topik ini berlaku untuk Dynamics 365 Customer Engagement (on-premises). Untuk versi Power Apps dari topik ini, lihat: Panduan tabel virtual

Tentang langkah-langkah entitas virtual ini

Bayangkan Anda ingin mengakses informasi tiket dari sumber data eksternal dalam aplikasi bisnis kustom Anda atau area Layanan Customer Engagement. Dalam Langkah-langkah sederhana ini, Anda akan memodelkan entitas virtual dengan bidang yang dipetakan ke skema eksternal yang mengambil data tiket saat runtime dari layanan web OData.

Rincian sumber data

Karena sumber data yang digunakan untuk panduan ini memiliki layanan web v4 OData, kami dapat menggunakan penyedia Data v4 OData yang disertakan dengan lingkungan Anda.

URL layanan web: https://contosowebservice.azurewebsites.net/odata/

Penting

url Layanan web yang digunakan untuk panduan ini bukan layanan web yang berfungsi.

Untuk langkah-langkah ini, satu entitas virtual yang berisi tiga bidang berikut diperlukan.

Nama bidang Eksternal Jenis data eksternal Jenis Data Entitas Virtual Tujuan
TicketID Edm.Guid Kunci Primer Kunci primer untuk entitas
Jabatan Edm.String Teks Satu Baris Judul tiket.
Tingkat Keparahan Edm.Int32 Bilangan Bulat Nilai angka 0-4 yang menunjukkan keparahan tiket

Metadata OData entitas tiket sumber data eksternal seperti yang dilihat dari web browser.

Medadata entitas tiket.

Buat Sumber Data

Buat sumber data untuk penyedia data v4 OData yang menggunakan layanan web sampel OASIS Open Data Protocol (OData).

Buka Sumber Data Entitas Virtual Administrasi>Pengaturan>.

Pilih BARU, pilih Penyedia Data OData v4, lalu pilihOK.

Masukkan atau pilih informasi berikut.

  • Nama: Contoso Sample sumber data
  • URL:https://contosowebservice.azurewebsites.net/odata
  • Waktu habis: 30
  • Jumlah Inline Pengembalian: True

Biarkan bidang lainnya apa adanya, dan pilih SIMPAN &; TUTUP.

Tip

Saat menggunakan layanan web Anda sendiri, pastikan URL valid dengan merekatkannya ke browser web Anda.

Buat Entitas virtual

Buka Pengaturan>Penyesuaian>Sesuaikan Sistem.

Di panel navigasi kiri, pilih Entitas , lalu pilihBaru dari panel utama.

Pada entitas: Formulir baru , pilih opsi entitas virtual, dan kemudian masukkan informasi berikut:

  • Sumber Data: Sumber Data sampel aswono
  • Nama Tampilan Tiket
  • Nama Jamak: Tiket
  • Nama: tiket_baru
  • Nama Eksternal: Tiket
  • Nama Koleksi Eksternal: Tiket
  • Pilih untuk mengaktifkan opsi Komunikasi &; Kolaborasi berikut ini:
    • Catatan (mencakup lampiran)
    • Aktivitas

Di samping Area yang menampilkan entitas ini, pilih Layanan , lalu pilihSimpan (tetapi jangan tutup formulir entitas).

Definisi Entitas tiket.

Buat bidang untuk entitas virtual

Di panel navigasi kiri halaman Entitas: Tiket , pilih Bidang. Sebagai bagian dari panduan ini, Anda akan mengedit dua bidang yang ada dan menambahkan bidang ketiga.

Penting

Nama eksternal peka besar huruf. Lihat metadata layanan web untuk memastikan bahwa Anda menggunakan nama yang benar.

Nilai Nullable salah menunjukkan bahwa atribut diperlukan. Perhatikan bahwa bidang utama primer selalu diperlukan sistem.

Buka bidang new_ticketid , dan ubah atribut berikut dengan nilai yang ditunjukkan di sini:

Nama Eksternal: TicketID

Bidang TicketID.

Pilih Simpan dan Tutup.

Buka bidang new_name , dan ubah atribut berikut agar nilai ditunjukkan di sini:

  • Nama Tampilan Judul
  • Nama Eksternal: Judul

Bidang judul.

Pilih Simpan dan Tutup.

Pilih Baru, dan padahalaman Bidang: Baru untuk Tiket masukkan informasi berikut:

  • Nama Tampilan: Keparahan
  • Nama: keparahan_baru
  • Nama Eksternal: Keparahan
  • Persyaratan Bidang: diperlukan untuk bisnis
  • Jenis Data: Bilangan Bulat
  • Nilai Minimum: 0
  • Nilai Maksimum: 4

Bidang keparahan.

Pilih Simpan dan Tutup.

Tambahkan bidang ke formulir Utama

Pada jendela entitas Tiket, pilih Formulir.

Buka formulir utama, seret dan lepas bidang Tingkat Keparahan dari panel kanan ke formulir di bagian Umum di bawah bidang Judul .

Bidang keparahan ditambahkan ke formulir utama.

Pada jendela entitas Tiket, pilih Simpan dan Tutup.

Mengkonfigurasi tampilan default

Di panel kiri Penjelajah Solusi, di bawah entitas Tiket, pilih Tampilan.

Buka tampilan Semua Tiket .

Di panel Tugas Umum, pilih Tambahkan Kolom.

Tambah Kolom untuk Tampilan.

Pilih Tingkat Keparahan, lalu pilih OK.

Pada jendela Lihat: Semua Tiket pilih Simpan dan Tutup.

Pada jendela Penjelajah Solusi, pilih Terbitkan Semua Penyesuaian.

Publikasikan semua penyesuaian.

Setelah semua penyesuaian diterbitkan, tutup jendela explorer solusi.

Lihat entitas virtual dalam praktik dengan Dynamics 365 Customer Engagement (on-premises)

>Buka Tiket Ekstensi Layanan>.

Area Tiket.

Tampilan Semua Tiket ditampilkan. Perhatikan bahwa Anda mungkin perlu menyegarkan browser Anda untuk melihat entitas dari area Layanan .

Tampilan Semua Tiket.

Buka catatan Tiket untuk melihat formulir yang menyertakan bidang Judul dan Tingkat Keparahan untuk catatan tertentu.

Rekaman tiket.

Lihat juga

Konfigurasi, persyaratan, dan praktik terbaik Penyedia Data OData v4

Membuat dan mengedit entitas virtual yang berisi data dari sumber data eksternal