Portallar Web API'sine genel bakış
Not
12 Ekim 2022 tarihi itibarıyla Power Apps portalları, Power Pages olarak adlandırılmıştır. Daha fazla bilgi: Microsoft Power Pages genel kullanıma sunuldu (blog)
Yakında Power Apps portalları belgelerini taşıyıp Power Pages belgeleri ile birleştireceğiz.
Portallar Web API'si, Power Apps portalları sayfalarında daha zengin bir kullanıcı deneyimi sağlar. 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önetimi 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.
Not
Portallar Web API'sini Power Pages'te de kullanabilirsiniz. Daha fazla bilgi: Power Pages nedir
Önemli
- Bu özelliğin çalışması için portal sürümünüzün 9.3.3.x veya sonraki bir sürüm 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. Diğer Power Apps Portal siteleriyle tümleştirmek için Portal Web API'sini kullanmak da desteklenmemektedir.
- 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 portalları 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 portalları 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.
Not
Web API işlemleri büyük ve küçük harf duyarlıdır.
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
Not
Portallar Web API'si kullanılarak eylemlerin ve işlevlerin çağrılması desteklenmez.
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.
Not
Bu ayarlar için mantıksal ad tablosunu kullanın (örneğin firma).
| Site ayarı adı | Tanım |
|---|---|
| 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 |
| Webapi/<table name>/disableodatafilter | OData filtresini etkinleştirir veya devre dışı bırakır. Varsayılan: False Geçerli değerler: True, False Daha fazla bilgi için bkz. bilinen sorunlar. Site ayarı portal sürümü 9.4.10.74 veya daha sonraki portal sürümlerinde kullanılabilir. |
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 | true |
| 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'sı kullanırken bir tablodaki her sütun için ayrıcalık tanımlamak üzere sütun izinlerini yapılandırabilirsiniz.
Portallar Web API'si 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.
EntitySetName kullanma
Kodunuzda portallar Web API'sini kullanan Dataverse tablolarına başvurulduğunda, EntitySetName değerini kullanmanız gerekir. Örneğin, firma tablosuna erişmek için kod sözdizimi firmalar öğesinin EntitySetName değerini (/_api/accounts()) kullanır.
Not
Site ayarları için tablo mantıksal adını kullanın (örneğin firma).
Belirli tabloların EntitySetName öğesini aşağıdaki adımları izleyerek belirleyebilirsiniz:
https://make.powerapps.com adresine gidin
Yan panelden Dataverse sekmesini seçin ve tabloyu seçin.
... (Komutlar seçeneği) simgesini seçin ve ardından tablonun EntitySetName öğesini panonuza kopyalamak için Gelişmiş, Araçlar ve Ayarlanmış adı kopyala seçeneğine gidin.
Genel Veri Koruma Yönetmeliği (GDPR)
Tüm istek üst bilgilerinde, 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
Bilinen sorunlar
Kullanıcılar üst kapsamı tanımlanmış birden çok düzeyde 1-çok veya çok-çok tablo izinleri için bir GET Web API isteği çağrılırsa bir CDS hatası alır.
Bu sorunu gidermek için, önerilen çözüm OData sorgusunda FetchXML kullanmaktır.
Alternatif olarak, Webapi/<table name>/disableodatafilter site ayarını True olarak ayarlayın.
Önemli
Webapi/<table name>/disableodatafilter site ayarını True olarak değiştirmek Web API GET çağrıları için daha düşük performansa neden olabilir.
Site ayarı portal sürümü 9.4.10.74 veya daha sonraki portal sürümlerinde kullanılabilir.
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
Not
Belge dili tercihlerinizi bizimle paylaşabilir misiniz? Kısa bir ankete katılın. (lütfen bu anketin İngilizce olduğunu unutmayın)
Anket yaklaşık yedi dakika sürecektir. Kişisel veri toplanmaz (gizlilik bildirimi).