Bagikan melalui

Konfigurasi dan praktik terbaik penyedia Data OData v4

  • Artikel

Topik ini berlaku untuk Dynamics 365 Customer Engagement (on-premises). Untuk versi Power Apps dari topik ini, lihat: Konfigurasi Penyedia data OData v4

Topik ini menjelaskan cara mengkonfigurasi penyedia Data v4 OData serta kebutuhan dan praktik terbaik disarankan untuk menggunakan penyedia data v4 OData untuk terhubung dengan layanan web OData v4.

Praktik terbaik Penyedia Data v4 OData

  • Instans Anda mengharuskan semua entitas memiliki atribut ID. ID ini dikenal sebagai pengidentifikasi unik dan nilai harus guid. Anda hanya dapat memetakan bidang ID ke bidang eksternal dengan jenis data EDM.Guid. Anda tidak dapat memetakan tipe data EDM.Int32 ke bidang jenis data uniqueidentifer.

  • entitas OData dengan properti nullable harus diatur untuk menyesuaikan bidang dipetakan di entitas virtual. Misalnya, properti entitas OData dengan Nullable=False harus memiliki bidang yang dipetakan dengan atribut Persyaratan Bidang yang diatur ke Diperlukan Bisnis.

  • Untuk Ambil beberapa kueri, seperti saat Anda memuat data di kisi, kontrol ukuran himpunan data yang dihasilkan dari sumber data eksternal dengan menggunakan parameter kueri pilih dan filter.

  • Jika belum diaktifkan, administrator sistem harus mengaktifkan pelacakan plug-in. Setelah diaktifkan, semua kesalahan dari titik akhir OData diambil dalam log jejak plugin. Informasi selengkapnya: Kotak dialog Pengaturan Sistem - tab Kustomisasi

Pemetaan Jenis data.

Tabel berikut berisi pemetaan jenis data Model Data entitas OData (EDM) dengan jenis data yang sesuai.

Jenis Data OData Jenis Data
Edm.Boolean Dua Pilihan
Edm.DateTime Tanggal dan Waktu
Edm.DateTimeOffset Tanggal dan Waktu
Edm.Decimal Bilangan desimal atau Mata uang
Edm.Double Angka Floating Point
Edm.Guid Pengidentifikasi Unik
Edm.Int32 Bilangan Bulat
Edm.Int64 Bilangan Bulat
Edm.String Satu baris teks atau beberapa baris teks

Jenis data OData EDM yang tidak didukung untuk pemetaan dengan entitas virtual

  • Edm.Binary

  • Edm.Time

  • Edm.Float

  • Edm.Single

  • Edm.Int16

  • Edm.Byte

  • Edm.SByte

Menambahkan sumber data yang menggunakan penyedia Data v4 OData

Prosedur ini menunjukkan cara menggunakan penyedia data dari OData siap digunakan sebagai sumber data entitas virtual.

  1. Buka Pengaturan>Administrasi>Sumber Data Entitas Virtual.

  2. Pada toolbar tindakan, pilih Baru.

  3. Pada kotak dialog Pilih penyedia data, pilih dari sumber data berikut, lalu pilih OK.

    • penyedia data OData v4. Lingkungan Anda mencakup penyedia Odata v4 data yang dapat digunakan untuk tersambung ke sumber data yang mendukung OData v4 standar terbuka.

    • penyedia data kustom. Jika Anda telah mengimpor plug-in penyedia data, penyedia data akan muncul di sini. Informasi selengkapnya: Mulai menggunakan entitas virtual

  4. Pada halaman properti sumber Data baru, lengkapi bidang berikut, dan kemudian menyimpan rekaman.

    • Nama. Masukkan nama yang mendeskripsikan sumber data.

    • Uri. Jika Anda menggunakan penyedia data OData, masukkan uri untuk layanan web OData. Misalnya, jika Anda menggunakan penyedia OData untuk menyambungkan ke layanan web yang dihosting di Azure, URI dapat terlihat mirip dengan https://contosodataservice.azurewebsites.net/odata/

    • Batas waktu dalam hitungan detik. Masukkan jumlah detik menunggu respons dari layanan web sebelum waktu habis permintaan data. Misalnya, masukkan 30 untuk menunggu maksimum tiga puluh detik sebelum waktu habis terjadi.

    • Mode penomoran halaman. Pilih apakah akan menggunakan halaman sisi klien atau sisi server untuk mengontrol cara pengaturan halaman hasil kueri. Nilai default adalah halaman sisi klien. Dengan halaman sisi server, server mengontrol cara pengaturan halaman hasil menggunakan parameter $skiptoken, yang akan ditambahkan ke string kueri. Informasi lebih lanjut: Lewati Opsi Kueri Sistem Token ($skiptoken)

      • Kembalikan jumlah sebaris. Menghasilkan rekaman angka total dalam rangkaian hasil. Pengaturan ini digunakan untuk mengaktifkan fungsi halaman berikutnya saat Anda mengembalikan data ke kisi. Gunakan nilai salah jika titik akhir OData Anda tidak mendukung parameter OData $inclinecount. Nilai default adalah false.

    • Parameter Permintaan. Atau, Anda dapat menambahkan header kustom atau parameter string kueri yang digunakan untuk tersambung ke layanan web OData, seperti parameter otentikasi ke layanan eksternal. Pilih String Kueri untuk beralih antara parameter dan nilai header dan string kueri. Hingga 10 tajuk atau string kueri dapat ditambahkan.

    Rekaman sumber daya entitas virtual.

Baca juga

Membuat dan mengedit entitas virtual yang berisi data dari sumber data eksternal
Blog TechNet: Berinteraksi dengan data dari sistem eksternal menggunakan entitas virtual baru