Portallar Web API'sına genel bakış
Portallar Web API'si Power Apps portal sayfaları içinde daha zengin bir kullanıcı deneyimi oluşturmayı etkinleştirir. Portal sayfalarınızdaki tüm Microsoft Dataverse tabloları genelinde oluşturmak, okumak, güncelleştirmek ve silmek için Portal Web API'sini kullanabilirsiniz. Örneğin, Portal Yönetim uygulaması yerine Portal Web API'sini kullanarak bir ürün için yeni hesap oluşturabilir, ilgili kişiyi güncelleştirebilir veya tablo izinlerini değiştirebilirsiniz.
Önemli
- Bu özelliğin çalışması için portal sürümünüzün 9.3.3.x veya üstü olması gerekir.
- Portallar Web API'si portal sayfaları içinde daha zengin bir kullanıcı deneyimi oluşturmayı amaçlar. Üçüncü taraf hizmetler veya uygulama tümleştirmesi için uygun değildir.
- Portal Web API'si işlemleri hesaplar, ilgili kişiler veya özel tablolar gibi verilerle ilgili tablolarla sınırlıdır. Tablo meta verileri veya Portal yapılandırma tablosu verilerini yapılandırma (Örneğin, adx_contentsnippet, adx_entityform veya adx_entitylist gibi portal tablolarını yapılandırmak) Portal Web API'sinde desteklenmez. Tam liste için bu konunun ilerleyen bölümlerindeki desteklenmeyen yapılandırma tablolarına gidin.
- Portallar Web API, sunucu tarafı önbellekten yararlanır, bu nedenle ardıl Web API çağrıları ilk çağrılardan daha hızlıdır. Portal sunucusu tarafı önbelleğinin temizlenmesinin geçici performans düşüşüne neden olduğunu unutmayın.
- Portal Web API işlemleri için bir Power Apps portal lisansı gerekir. Örneğin, anonim kullanıcıların yaptığı Web API çağrıları sayfa görüntüleme kapasitesine doğru sayılır. Kimliği doğrulanmış kullanıcılar (iç veya dış) tarafından yapılan Web API çağrıları sayfa görünümlerine dahil edilmez, ancak uygun lisanslar gerektirir. Daha fazla bilgi: Power Apps Portal lisansları SSS
Web API işlemleri
Portallar Web API'si, Dataverse API'sini kullanarak gerçekleştirebileceğiniz Dataverse işlemleri için bir dizi yetenek alt kümesi sunar. Öğrenme eğrisini azaltmak için API biçimini mümkün olduğunca benzer tuttuk.
Portallarda kullanılabilen Web API işlemleri
- Bir tablodaki kayıtları okuma
- Tabloda kayıt oluşturma
- Tablodaki kayıtları güncelleştirme ve silme
- Tabloları ilişkilendirme ve ilişkiyi kaldırma
Web API'si için site ayarları
Portalınızın Portallar Web API'sini etkinleştirmek için site ayarını etkinleştirmeniz gerekir. Ayrıca Portal Web API'siyle değiştirilebilen veya değiştirilemeyen tablo alanlarını belirleyen alan düzeyinde Web API'sini de yapılandırabilirsiniz.
| Site Ayarı Adı | Veri Akışı Açıklaması |
|---|---|
| Webapi/<table name>/etkin | <table name> için Web API'sini etkinleştirir veya devre dışı bırakır. Varsayılan: False Geçerli Değerler: True,False |
| Webapi/<table name>/alanlar | Web API'si ile değiştirilebilen özniteliklerin virgülle ayrılmış listesini tanımlar. Olası değerler: - Tüm öznitelikler: * - Belirli öznitelikler: attr1,attr2,attr3 Not: Değer bir yıldız (*) veya alan adlarının virgülle ayrılmış bir listesi olmalıdır. Önemli: Bu, zorunlu bir site ayarıdır. Bu ayar eksikse, "Bu varlık için alan tanımlanmadı" hatasını görürsünüz. |
| Webapi/error/innererror | InnerError'ı etkinleştirir veya devre dışı bırakır. Varsayılan: False Geçerli Değerler: True,False |
Not
Değişikliklerin etkin olabilmesi için site ayarlarının etkin olarak ayarlanması gerekir .
Örneğin, kimliği doğrulanmış kullanıcıların bu varlık üzerinde oluşturma, güncelleştirme ve silme işlemleri gerçekleştirmesine izin verilen Servis Talebi tablosunun Web API'sini kullanıma açmak için site ayarları aşağıdaki tabloda gösterilir.
| Site Ayarı Adı | Site Ayarı Değeri |
|---|---|
| Webapi/incident/enabled | doğru |
| Webapi/incident/fields | attr1,attr2,attr3 |
Portallar Web API'si ile güvenlik
Tablo izinlerini kullanarak portaldaki ayrı kayıtlar için kayıt tabanlı güvenlik yapılandırabilirsiniz. Portal Web API tablo (varlık) kayıtlarına erişir ve ilgili web rolleri aracılığıyla kullanıcılara verilen tablo izinlerini izler.
Portal Web API istekleri için kimlik doğrulama
Kimlik doğrulama ve yetkilendirme uygulama oturumu tarafından yönetildiğinden, kimlik doğrulaması kodu eklemeniz gerekmez. Tüm Web API çağrıları, Siteler Arası İstek Sahteciliği (CSRF) belirtecini içermelidir.
Genel Veri Koruma Yönetmeliği (GDPR)
Tüm istek üst bilgilerindeki, denetleme amacıyla iletilen bir ilgili kişi kimliği vardır. Anonim kullanıcı için bu null olarak geçilir.
Denetim günlüğü etkinse, Kullanıcı Office 365 denetim günlüğündeki tüm denetim olaylarını görebilir.
Daha fazla bilgi:
Etkinlik günlüğünü etkinleştirme ve kullanma
Denetim günlüğü kayıtlarını verme, yapılandırma ve görüntüleme
Desteklenmeyen yapılandırma tabloları
Portal Web API'si aşağıdaki yapılandırma tabloları için kullanılamaz:
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
Sonraki adım
Portal Web API kullanarak verileri sorgulama
Ayrıca bkz.
HTTP isteklerini oluşturma ve hataları işleme Web API kullanarak portalları yazma, güncelleştirme ve silme işlemleri Öğretici: Portal Web API'sini kullanma