Übersicht über Web-API für Portale
Hinweis
Ab 12. Oktober 2022 ist Power Apps-Portale Power Pages. Weitere Informationen: Microsoft Power Pages ist jetzt allgemein verfügbar (Blog)
Wir werden die in Kürze migrieren und die Dokumentation für Power Apps-Portale mit der Power Pages-Dokumentation zusammenführen.
Die Web-API des Portals ermöglicht eine reichhaltigere Benutzererfahrung in Power Apps Portalseiten. Sie können die Web-API verwenden, um Vorgänge zum Erstellen, Lesen, Aktualisieren und Löschen aller Microsoft Dataverse-Tabellen von Ihren Portalseiten aus durchzuführen. Sie können beispielsweise ein neues Konto erstellen, einen Kontakt aktualisieren oder die Tabellenberechtigungen für ein Produkt mithilfe der Web-API für Portale anstelle der Portalverwaltungs-App.
Hinweis
Sie können auch Portal Web-API in Power Pages verwenden. Weitere Informationen: Was ist Power Pages?
Wichtig
- Ihre Portalversion muss 9.3.3.x oder höher sein, damit diese Funktion funktioniert.
- Die Web-API für Portale ist zum Erstellen einer umfassenden Benutzerumgebung in Portalseiten konzipiert. Sie ist nicht für Dienste von Drittanbietern oder die Integration von Anwendungen optimiert. Verwenden der Web-API des Portals zur Integration mit anderen Power Apps-Portalseiten wird ebenfalls nicht unterstützt.
- Portalvorgänge mit der Web-API sind auf datenbezogene Tabellen beschränkt — zum Beispiel Konten, Kontakte oder Ihre benutzerdefinierten Tabellen. Konfigurieren von Tabellenmetadaten oder Portalkonfigurationstabellendaten — zum Beispiel, das Konfigurieren von Portaltabellen wie adx_contentsnippet, adx_entityform oder adx_entitylist — wird mit der Web-API für Portale nicht unterstützt. Eine vollständige Liste finden Sie unter Unterstützte Konfigurationstabellen weiter unten in diesem Thema.
- Die Portale-Web-API profitiert vom Server-seitigen Zwischenspeichern, so dass nachfolgende Aufrufe der Web-API schneller sind als die ersten Aufrufe. Beachten Sie, dass das Löschen des serverseitigen Caches des Portals zu einer vorübergehenden Leistungsverschlechterung führt.
- Für Portale-Web-API-Vorgänge ist eine Power Apps-Portal-Lizenz erforderlich. Beispielsweise werden Web-API-Aufrufe von anonymen Benutzern auf die Kapazität der Seitenaufrufe angerechnet. Web-API-Aufrufe von authentifizierten Benutzern (intern oder extern) werden nicht für Seitenaufrufe gezählt, erfordern jedoch entsprechende Lizenzen. Mehr Informationen: Power Apps Häufig gestellte Fragen zur Lizenzierung von Portalen
Web-API-Vorgänge
Die Web-API für Portale bietet einen Teil der Funktionen für Dataverse-Vorgänge, die Sie mit der Dataverse-API ausführen können. Wir haben das API-Format so ähnlich wie möglich gehalten, um die Lernkurve zu verringern.
Hinweis
Bei Web-API-Operationen wird zwischen Groß- und Kleinschreibung unterschieden.
In Portalen verfügbare Web-API-Vorgänge
- Datensätze aus einer Tabelle lesen
- Erstellen eines Datensatzes in einer Tabelle
- Datensätze in einer Tabelle aktualisieren und löschen
- Tabellen assoziieren und disassoziieren
Hinweis
Das Aufrufen von Aktionen und Funktionen mit Web-API von Portale wird nicht unterstützt.
Website-Einstellungen für die Web-API
Sie müssen die Website-Einstellung aktivieren, um die Web-API für Portale für Ihr Portal zu aktivieren. Sie können auch die Web-API auf Feldebene konfigurieren, die die Tabellenfelder festlegt, die mit der Portale-Web-API geändert werden können oder nicht.
Hinweis
Verwenden Sie die Tabelle logischer Name für diese Einstellungen (z. B. Konto).
| Website-Einstellungsname | Beschreibung des Dataflows |
|---|---|
| Webapi/<table name>/enabled | Aktiviert oder deaktiviert die Web-API für <table name>. Standard: False Gültige Werte: True, False |
| Webapi/<table name>/fields | Definiert die durch Kommas getrennte Liste von Attributen, die mit der Web-API geändert werden können. Mögliche Werte: - Alle Attribute: * - Spezifische Attribute: attr1,attr2,attr3 Hinweis: Der Wert muss entweder ein Sternchen sein (*) oder eine durch Kommas getrennte Liste von Feldnamen. Wichtig: Dies ist eine obligatorische Website-Einstellung. Wenn diese Einstellung fehlt, wird der Fehler „Für diese Entität sind keine Felder festgelegt“ angezeigt. |
| Webapi/error/innererror | Aktiviert oder deaktiviert InnerError. Standard: False Gültige Werte: True, False |
| Webapi/<table name>/disableodatafilter | Aktiviert oder deaktiviert den OData-Filter. Standard: False Gültige Werte: True, FalseWeitere Informationen finden Sie unter Bekannte Probleme. Die Website-Einstellung ist in der Portalversion 9.4.10.74 oder später verfügbar. |
Hinweis
Die Website-Einstellungen müssen auf Aktiv festgelegt sein, damit Änderungen wirksam werden.
Um beispielsweise die Web-API für die Anfragetabelle verfügbar zu machen, bei der authentifizierte Benutzer Erstellungs-, Aktualisierungs- und Löschvorgänge für diese Entität ausführen dürfen, werden die Website-Einstellungen in der folgenden Tabelle angezeigt.
| Website-Einstellungsname | Website-Einstellungswert |
|---|---|
| Webapi/incident/enabled | Wahr |
| Webapi/incident/fields | attr1, attr2, attr3 |
Sicherheit mit der Web-API für Portale
Sie können die datensatzbasierte Sicherheit für einzelne Datensätze in Portalen mithilfe von Tabellenberechtigungen konfigurieren. Die Portale-Web-API greift auf Tabellendatensätze (Entitäten) zu und folgt den Tabellenberechtigungen, die den Benutzern über die zugehörige Web-Rolle erteilt wurden.
Sie können Spaltenberechtigungen konfigurieren, um weitere Rechte für individuelle Spalten innerhalb einer Tabelle weiter zu definieren, während die Web-API des Portals verwendet wird.
Authentifizieren von Anforderungen an Web-API für Portale
Sie müssen keinen Authentifizierungscode einfügen, da die Authentifizierung und Autorisierung von der Anwendungssitzung verwaltet wird. Alle Web-API-Aufrufe müssen ein CSRF-Token (webiteübergreifende Anforderungsfälschung) enthalten.
Verwenden von EntitySetName
Bei Bezugnahme auf Dataverse Tabellen mit der Web-API des Portals in Ihrem Code, müssen Sie EntitySetName verwenden, um beispielsweise auf die Konto Tabelle zuzugreifen, verwendet Sie die Codesyntax den EntitySetName von Konten ; /_api/accounts().
Hinweis
Verwenden Sie die Tabelle Logischer Name für Websiteeinstellungen (zum Beispiel, Konto).
Sie können den EntitySetName bestimmter Tabellen bestimmen, indem Sie die folgenden Schritte ausführen:
Zu https://make.powerapps.com wechseln
Wählen Sie die Dataverse-Registerkarte im Seitenbereich und die Tabelle aus.
Wählen Sie die ... (Befehlsoption) und dann Erweitert, Tools und Satzname kopieren aus, um den EntitySetName der Tabelle in die Zwischenablage zu kopieren.
Datenschutz-Grundverordnung (DSGVO)
Alle Abfrage-Header enthalten eine Kontakt-ID, die zu Prüfzwecken übergeben wird. Für einen anonymen Benutzer wird dies als null übergeben.
Wenn die Überwachungsprotokollierung aktiviert ist, kann ein Benutzer alle Überwachungsereignisse im Office 365-Überwachungsprotokoll anzeigen.
Weitere Informationen:
Aktivieren und verwenden Sie die Aktivitätsprotokollierung
Exportieren, konfigurieren und betrachten Sie Datensätze des Audit-Protokolls
Nicht unterstützte Konfigurationstabellen
Die Portale-Web-API kann nicht für die folgenden Konfigurationstabellen verwendet werden:
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
Bekannte Probleme
Benutzer erhalten einen CDS-Fehler, wenn sie eine GET-Web-API-Anforderung für Tabellen mit mehreren Ebenen von 1:n oder n:n -Tabellenberechtigungen mit einem definierten übergeordnetem Geltungsbereich aufrufen.
Die empfohlene Lösung zur Behebung dieses Problems ist die Verwendung von FetchXML in der OData-Abfrage.
Legen Sie alternativ die Website-Einstellung Webapi/<table name>/disableodatafilter auf True fest.
Wichtig
Das Ändern der Website-Einstellung Webapi/<table name>/disableodatafilter auf True kann zu einer geringeren Leistung bei Web-API-GET-Aufrufen führen.
Die Website-Einstellung ist in der Portalversion 9.4.10.74 oder später verfügbar.
Nächster Schritt
Daten über die Portale-Web-API abfragen
Siehe auch
HTTP-Anforderungen erstellen und Fehlern behandeln
Portale Schreib-, Aktualisierungs- und Löschvorgänge über die Web-API
Tutorial: Portale-Web-API verwenden
Hinweis
Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)
Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).