Konfigurasi, keperluan dan amalan terbaik Pembekal Data v4 OData

Topik ini menerangkan cara untuk mengkonfigurasi Pembekal Data v4 OData serta keperluan dan amalan terbaik yang disyorkan untuk menggunakan pembekal data v4 OData untuk bersambung dengan perkhidmatan web v4 OData.

Amalan terbaik pembekal data v4 OData

  • Microsoft Dataverse memerlukan semua jadual mempunyai atribut ID, ID ini dikenali sebagai pengecam unit dan nilai mesti guid. Anda hanya boleh memetakan lajur ID pada lajur luaran dengan jenis data Edm.Guid. Anda tidak boleh memetakan jenis data Edm.Int32 pada lajur jenis data Pengecam Unik dalam Dataverse.
  • Jadual OData dengan sifat nullable mesti ditetapkan untuk disepadankan dengan lajur yang dipetakan dalam jadual maya. Contohnya, sifat jadual OData dengan Nullable=Salah mesti mempunyai lajur dipetakan dalam Dataverse Keperluan Medan set atribut pada Keperluan Perniagaan.
  • Untuk mendapatkan semua berbilang pertanyaan, seperti apabila anda memuatkan data ke dalam grid, mengawal saiz set data yang dikembalikan daripada sumber data luaran menggunakan memilih dan menapis parameter penapis.
  • Jika belum didayakan, pentadbir sistem perlu mendayakan penjejakan pasang masuk. Sebaik sahaja didayakan, semua ralat daripada titik akhir OData direkodkan dalam log jejak pasang masuk. Maklumat lanjut: Panduan Pentadbir: Kotak dialog Tetapan Sistem - tab Penyesuaian
  • Anda tidak boleh menggunakan Pembekal Data v4 OData untuk menyambung ke persekitaran lain.

Pemetaan jenis data

Jadual berikut menyenaraikan pemetaan jenis data Model Data jadual OData (EDM) dengan jenis data Dataverse.

Jenis Data OData Jenis Data Dataverse
Edm.Boolean Dua Pilihan
Edm.DateTime Tarikh dan Masa
Edm.DateTimeOffset Tarikh dan Masa
Edm.Decimal Nombor Perpuluhan atau Mata Wang
Edm.Double Nombor Titik Terapung
Edm.Guid Pengecam Unik
Edm.Int32 Nombor Bulat
Edm.Int64 Nombor Bulat
Edm.String Baris Teks Tunggal atau Berbilang Baris Teks

Jenis data EDM OData yang tidak disokong untuk pemetaan dengan jadual maya

  • Edm.Binary
  • Edm.Time
  • Edm.Float
  • Edm.Single
  • Edm.Int16
  • Edm.Byte
  • Edm.SByte

Tambah sumber data menggunakan Pembekal Data v4 OData

Prosedur ini menunjukkan anda cara menggunakan Pembekal Data OData permulaan untuk digunakan sebagai sumber data jadual maya.

  1. Pergi ke Tetapan > Pentadbiran > Sumber Data Entiti Maya.

  2. Pada bar alat tindakan, klik Baharu.

  3. Pada kotak dialog Pilih Pembekal Data, pilih daripada sumber data berikut dan kemudian, klik OK.

    • Pembekal Data v4 OData. Dataverse Mengandungi pembekal data v4 OData yang boleh digunakan untuk bersambung dengan sumber data yang menyokong standard terbuka v4 OData.
    • Pembekal data tersuai. Jika anda telah mengimport pasang masuk pembekal data, ia akan kelihatan di sini. Maklumat lanjut: Dokumentasi Pembangun: Mari Bermula dengan jadual maya
  4. Pada halaman sifat Sumber Data Baharu, lengkapkan lajur berikut dan kemudian simpan baris.

    • Nama. Taipkan nama yang menghuraikan sumber data.
    • Uri. Jika anda menggunakan Pembekal Data OData, masukkan uri untuk perkhidmatan web OData. Contohnya, jika anda menggunakan pembekal OData untuk bersambung kepada perkhidmatan web yang dihoskan di Azure, URI boleh kelihatan serupa seperti https://contosodataservice.azurewebsites.net/odata/.
    • Masa tamat dalam saat. Masukkan bilangan saat untuk menunggu respons daripada perkhidmatan web sebelum tamat masa permintaan data. Contohnya, masukkan 30 untuk menunggu maksimum tiga puluh saat sebelum tamat masa berlaku.
    • Mod penghalaman. Pilih sama ada mahu menggunakan penghalaman bahagian klien atau bahagian pelayan untuk mengawal cara hasil pertanyaan dihalamankan. Nilai lalai ialah penghalaman bahagian klien. Dengan penghalaman bahagian pelayan, pelayan mengawal cara hasil dihalamankan menggunakan parameter $skiptoken, yang ditambah pada rentetan pertanyaan. Maklumat lanjut: Langkau Pilihan Pertanyaan Sistem Token ($skiptoken)
      • Kembalikan kiraan sebaris. Mengembalikan jumlah bilangan baris dalam set hasil. Tetapan ini digunakan untuk mendayakan kefungsian halaman seterusnya apabila anda mengembalikan data kepada grid. Gunakan nilai palsu jika titik akhir OData anda tidak menyokong parameter $inlinecount OData. Nilai lalai ialah palsu.
    • Parameter Permintaan. Anda juga boleh menambah pengepala tersuai atau parameter rentetan pertanyaan yang digunakan untuk bersambung kepada perkhidmatan web OData seperti parameter pengesahan untuk perkhidmatan luaran. Klik Rentetan Pertanyaan untuk menogol antara pengepala dan parameter serta nilai rentetan pertanyaan. Sehingga 10 pengepala atau rentetan pertanyaan boleh ditambah.

      Baris sumber data jadual maya.

Lihat juga

Cipta dan edit jadual maya yang mengandungi data daripada sumber data luaran

Nota

Adakah anda boleh memberitahu kami tentang keutamaan bahasa dokumentasi anda? Jawab tinjauan pendek. (harap maklum bahawa tinjauan ini dalam bahasa Inggeris)

Tinjauan akan mengambil masa lebih kurang tujuh minit. Tiada data peribadi akan dikumpulkan (pernyataan privasi).