Übersicht über Web-API für Portale
Die Web-API des Portals ermöglicht eine reichhaltigere Benutzererfahrung in Power Pages-Websites. Sie können die Web-API verwenden, um Vorgänge zum Erstellen, Lesen, Aktualisieren und Löschen aller Microsoft Dataverse-Tabellen von Ihren Webseiten aus durchzuführen. Sie können beispielsweise ein neues Konto erstellen oder einen Kontakt aktualisieren, ohne ein Formular oder ein mehrstufiges Formular mithilfe des Web-API des Portals zu verwenden.
Wichtig
- Ihre Power Pages-Websiteversion muss 9.3.3.x oder höher sein, damit dieses Feature 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. Die Verwendung der Web-API des Portals zur Integration mit anderen Power Pages Sites 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 weiter unten in diesem Artikel unter Unterstützte Konfigurationstabellen.
- Die Portale-Web-API profitiert vom Server-seitigen Zwischenspeichern, so dass nachfolgende Aufrufe der Web-API schneller sind als die ersten Aufrufe. Das Löschen des serverseitigen Caches des Portals führt zu einer vorübergehenden Leistungsverschlechterung.
- Für Portale-Web-API-Vorgänge ist eine Power Pages-Lizenz erforderlich. Beispielsweise werden Web-API-Aufrufe von anonymen Benutzern auf die Kapazität des anonymen Benutzers angerechnet. Web-API-Aufrufe von authentifizierten (intern oder extern) Benutzenden werden nicht als Seitenaufrufe gezählt, erfordern jedoch Kapazitätslizenzen für authentifizierte Benutzende. Weitere Informationen: Häufig gestellte Fragen zur Power Pages
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 abzuflachen.
Anmerkung
Bei Web-API-Operationen wird zwischen Groß- und Kleinschreibung unterschieden.
In Power Pages 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
Anmerkung
Der Aufruf von Aktionen und Funktionen über die Portale-Web-API 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.
Anmerkung
Verwenden Sie die Tabelle logischer Name für diese Einstellungen (z. B. Konto).
| Website-Einstellungsname | Beschreibung |
|---|---|
| Webapi/<Tabellenname>/enabled | Aktiviert oder deaktiviert die Web-API für <Tabellenname>. Standard: False Gültige Werte: True, False |
| Webapi/<Tabellenname>/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: Bei dieser Einstellung handelt es sich um 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/<Tabellenname>/disableodatafilter | Aktiviert oder deaktiviert den OData-Filter. Standard: False Gültige Werte: True, False. weitere Informationen finden Sie unter Bekannte Probleme. Die Website-Einstellung ist in der Portalversion 9.4.10.74 oder später verfügbar. |
Anmerkung
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 angeben, da die Anwendungssitzung die Authentifizierung und Autorisierung verwaltet. Alle Web-API-Aufrufe müssen ein CSRF-Token (webiteübergreifende Anforderungsfälschung) enthalten.
Verwenden von EntitySetName
Wenn Sie mit der Web-API des Portals in Ihrem Code auf Dataverse-Tabellen verweisen, müssen Sie EntitySetName verwenden, z. B. um auf die Kontotabelle zuzugreifen. Die Codesyntax verwendet den EntitySetName von Konten; /_api/accounts().
Anmerkung
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.
Datenschutzgesetze und -vorschriften
Allen Anforderungskopfzeilen haben zum Zweck der Überwachung eine Kontakt-ID. Für einen anonymen Benutzenden wird dieser Wert 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
Benutzende erhalten einen CDS-Fehler, wenn sie eine GET-Web-API-Anforderung für Tabellen aufrufen, die über mehrere Ebenen von 1:n- oder n:n-Tabellenberechtigungen verfügen, wenn die Bereiche Übergeordnet, **Kontakt oder Konto der Abfrage weitere Bedingungen hinzufügen.
Um dieses Problem zu beheben, empfehlen wir die Verwendung von FetchXML in der OData-Abfrage.
Legen Sie alternativ die Website-Einstellung Webapi/<table name>/disableodatafilter auf True fest.
Wichtig
Wenn Sie die Websiteeinstellung Webapi/<Tabellenname>/disableodatafilter auf True ändern, kann sich die Leistung für GET-Web-API-Aufrufe verlangsamen.
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