Gambaran keseluruhan API Web portal
Nota
Berkuat kuasa pada 12 Oktober 2022, portal Power Apps ialah Power Pages. Maklumat lanjut: Microsoft Power Pages kini tersedia secara umum (blog)
Kami akan memindahkan dan menggabungkan dokumentasi portal Power Apps dengan dokumentasi Power Pages tidak lama lagi.
Portal API Web membolehkan pengalaman pengguna lebih banyak dalam Power Apps halaman Portal. Anda boleh menggunakan API Web untuk melaksanakan mencipta, membaca, mengemas kini dan memadam operasi merentas semua jadual Microsoft Dataverse dari halaman portal anda. Sebagai contoh, anda boleh mencipta akaun baharu, kemas kini kenalan atau mengubah keizinan jadual untuk produk dengan menggunakan API Web portal bukannya aplikasi Pengurusan Portal.
Nota
Anda juga boleh menggunakan API Web portal dalam Power Pages. Maklumat lanjut: Apakah Power Pages
Penting
- Versi portal anda mesti 9.3.3.x atau kemudian untuk ciri ini berfungsi.
- Portal API Web dibina untuk mencipta pengalaman pengguna lebih banyak dalam halaman portal. Ia tidak dioptimumkan untuk perkhidmatan pihak ketiga atau integrasi aplikasi. Menggunakan API Web portal untuk mengintegrasikan dengan tapak portal Power Apps lain juga tidak disokong.
- Operasi Portal API Web adalah terhad kepada jadual yang berkaitan dengan data—contohnya, akaun, kenalan atau jadual tersuai anda. Mengkonfigurasi data jadual metadata atau jadual konfigurasi portal—misalnya, mengkonfigurasi jadual portal seperti adx_contentsnippet, adx_entityform, atau adx_entitylist—tidak disokong dengan portal API Web. Untuk senarai lengkap, pergi ke jadual konfigurasi yang tidak disokong kemudian dalam topik ini.
- API Web portal manfaat dari cache bahagian pelayan, jadi panggilan berikutnya kepada API Web lebih cepat daripada panggilan awal. Ambil perhatian bahawa pengosongan cache bahagian pelayan portal menyebabkan penurunan prestasi sementara.
- Operasi API Web portal memerlukan Power Apps lesen portal. Contohnya, panggilan API Web yang dibuat oleh pengguna tanpa nama dikira dalam kapasiti pandangan halaman. Panggilan API Web yang dibuat oleh pengguna yang disahkan (dalaman atau luaran) tidak dikira dalam pandangan halaman tetapi memerlukan lesen yang berkaitan. Maklumat lanjut: Soalan Lazim pelesenan portal Power Apps
Operasi API Web
API Web portal menawarkan subset keupayaan untuk Dataverse operasi yang boleh anda lakukan dengan menggunakan API Dataverse. Kami telah menyimpan format API yang sama yang mungkin untuk mengurangkan lengkung pembelajaran.
Nota
Operasi API web adalah sensitif huruf.
Operasi API Web tersedia di portal
- Baca rekod daripada jadual
- Cipta rekod dalam jadual
- Kemas kini dan padamkan rekod dalam jadual
- Mengaitkan dan menyahkaitkan jadual
Tetapan tapak untuk API Web
Anda mesti mendayakan tetapan tapak untuk mendayakan API Web portal untuk portal anda. Anda juga boleh mengkonfigurasi API Web paras medan yang menentukan medan jadual yang boleh atau tidak boleh diubah suai dengan API Web portal.
Nota
Gunakan nama logik jadual untuk tetapan ini (sebagai contoh akaun).
| Nama tetapan tapak | Description |
|---|---|
| Webapi/<table name>/didayakan | Mendayakan atau menyahdayakan API Web untuk <table name>. Lalai: False Nilai yang sah: True, False |
| Webapi/<table name>/medan | Mentakrifkan senarai atribut dipisahkan koma yang boleh diubah suai dengan API Web. Nilai yang mungkin: - Semua atribut: * - Atribut khusus: attr1,attr2,attr3 Nota: Nilai tersebut mesti sama ada Asterisk (*) atau senarai nama medan dipisahkan koma. Penting: Ini ialah tetapan tapak mandatori. Apabila tetapan ini hilang, anda akan melihat ralat "Tiada medan yang ditakrifkan untuk entiti ini." |
| Webapi/ralat/ralatdalaman | Mendayakan atau menyahdayakan RalatDalaman. Lalai: False Nilai yang sah: True, False |
| Webapi/<table name>/disableodatafilter | Mendayakan atau menyahdayakan penapis OData. Lalai: False Nilai sah: True, False Lihat isu diketahui untuk mendapatkan maklumat lanjut. Tetapan tapak tersedia dalam versi portal 9.4.10.74 atau lebih baharu. |
Nota
Tetapan tapak mesti ditetapkan kepada Aktif untuk perubahan berkuat kuasa.
Sebagai contoh, untuk mendedahkan API Web untuk jadual Kes di mana pengguna yang disahkan dibenarkan untuk melaksanakan mencipta, mengemas kini dan memadam operasi pada entiti ini, tetapan tapak ditunjukkan dalam jadual berikut.
| Nama tetapan tapak | Nilai tetapan tapak |
|---|---|
| Webapi/kejadian/didayakan | benar |
| Webapi/kejadian/medan | attr1, attr2, attr3 |
Keselamatan dengan API Web portal
Anda boleh mengkonfigurasi keselamatan berdasarkan rekod kepada rekod individu dalam portal dengan menggunakan jadual keizinan. API Web portal mengakses jadual (entiti) rekod mengikut keizinan jadual yang diberikan kepada pengguna melalui yang berkaitan peranan web.
Anda boleh mengkonfigurasi keizinan lajur untuk mentakrifkan lagi kelayakan pada lajur individu dalam jadual ketika menggunakan API Web portal.
Mengesahkan permintaan API Web portal
Anda tidak perlu memasukkan kod pengesahan, kerana pengesahan dan pengesahan diuruskan oleh sesi aplikasi. Semua panggilan API Web mesti mengandungi token Pemalsuan Permintaan Merentasi Tapak (CSRF).
Menggunakan EntitySetName
Apabila merujuk kepada jadual Dataverse menggunakan API Web portal dalam kod anda, anda perlu menggunakan EntitySetName, sebagai contoh, untuk mengakses jadual akaun, sintaks kod akan menggunakan EntitySetName akaun;/_api/accounts().
Nota
Gunakan nama logik jadual untuk tetapan tapak (sebagai contoh, akaun).
Anda boleh menentukan EntitySetName jadual khusus dengan mengikut langkah berikut:
Pergi ke https://make.powerapps.com
Pilih tab Dataverse daripada panel tepi dan pilih jadual.
Pilih ... (Pilihan perintah) dan kemudian pilih Lanjutan, Alat, dan Salin nama set untuk menyalin EntitySetName jadual kepada papan klip anda.
Peraturan Perlindungan Data Umum (GDPR)
Semua pengepala permintaan akan mempunyai ID kenalan yang diluluskan untuk tujuan pengauditan. Untuk pengguna tanpa nama, ini akan diluluskan sebagai null.
Jika log audit didayakan, pengguna boleh melihat semua peristiwa audit dalam Office 365 log audit.
Maklumat lanjut:
Mendayakan dan menggunakan pengelogan aktiviti
Eksport, konfigurasi dan rekod log audit pandangan
Jadual konfigurasi tidak disokong
API Web Portal tidak boleh digunakan untuk jadual konfigurasi berikut:
adx_contentaccesslevel
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_entitypermission_webrole
adx_externalidentity
adx_pagealert
adx_pagenotification
adx_pagetag
adx_pagetag_webpage
adx_pagetemplate
adx_portallanguage
adx_publishingstate
adx_publishingstatetransitionrule
adx_publishingstatetransitionrule_webrole
adx_redirect
adx_setting
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_urlhistory
adx_webfile
adx_webfilelog
adx_webform
adx_webformmetadata
adx_webformsession
adx_webformstep
adx_weblink
adx_weblinkset
adx_webnotificationentity
adx_webnotificationurl
adx_webpage
adx_webpage_tag
adx_webpageaccesscontrolrule
adx_webpageaccesscontrolrule_webrole
adx_webpagehistory
adx_webpagelog
adx_webrole_systemuser
adx_website
adx_website_list
adx_website_sponsor
adx_websiteaccess
adx_websiteaccess_webrole
adx_websitebinding
adx_websitelanguage
adx_webtemplate
Isu yang diketahui
Pengguna akan mendapat ralat CDS jika mereka menggunakan permintaan API Web GET untuk jadual yang mempunyai berbilang peringkat 1 kepada banyak atau banyak kepada banyak keizinan jadual dengan skop induk ditakrifkan.
Untuk menyelesaikan isu ini, penyelesaian yang disyorkan ialah menggunakan FetchXML dalam pertanyaan OData.
Sebagai aternatif, tetapkan tetapan tapak Webapi/<table name> /disableodatafilterkepada True.
Penting
Mengubah tetapan tapak Webapi/<table name>/disableodatafilter kepada True mungkin menyebabkan prestasi yang lebih perlahan untuk panggilan GET API Web.
Tetapan tapak tersedia dalam versi portal 9.4.10.74 atau lebih baharu.
Langkah seterusnya
Pertanyaan data menggunakan API Web portal
Lihat juga
Tulis permintaan HTTP dan kendalikan ralat
Portal menulis, mengemas kini dan memadam operasi menggunakan API Web
Tutorial: Gunakan API Web portal
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).