Freigeben über


Ü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

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.

Sicherheit bei Web API für Portale

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:

  1. Zu https://make.powerapps.com wechseln

  2. Wählen Sie die Dataverse-Registerkarte im Seitenbereich und die Tabelle aus.

  3. Wählen Sie die ... (Befehlsoption) und dann Erweitert, Tools und Satzname kopieren aus, um den EntitySetName der Tabelle in die Zwischenablage zu kopieren.

    So finden Sie den EntitySetName einer Dataverse-Tabelle.

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.

Office 365-Überwachungsprotokoll

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).