Implementieren einer Web-API-Komponente

Die Web-API-Komponente ist für die Durchführung von Erstellungs-, Abruf-, Aktualisierungs- und Löschaktionen vorgesehen. Die Komponente stellt vier Schaltflächen zur Verfügung, die angeklickt werden können, um verschiedene Web-API-Aktionen aufzurufen. Das Ergebnis des Web-API-Aufrufs wird in ein HTML-Div-Element am unteren Ende der Code-Komponente injiziert.

Verfügbar für

Modellgesteuerte Apps

Code

Sie können die komplette Beispielkomponente hier herunterladen.

Standardmäßig ist die Komponente in dem Beispiel so konfiguriert, dass sie die Aktionen zum Erstellen, Abrufen und Aktualisieren der Entität Account ausführt und die Namens- und Umsatzfelder in den Web-API-Beispielen festlegt.

Um die Standardkonfiguration zu einer beliebigen Entität oder einen Feld zu ändern, aktualisieren Sie die Konfigurationswerte wie dargestellt.

 private static _entityName:string = "account";  
 private static _requiredAttributeName: string = "name";  
 private static _requiredAttributeValue: string = "Web API code component (Sample)";  
 private static _currencyAttributeName: string = "revenue";  

Die createRecord-Methode rendert drei Schaltflächen, mit denen Sie einen Firmendatensatz erstellen können, bei dem das Umsatzfeld auf verschiedene Werte (100, 200, 300) festgelegt werden kann.

Wenn Sie auf eine der Erstellen-Schaltflächen klicken, prüft der Ereignisbehandler onClick der Schaltfläche den Wert der angeklickten Schaltfläche und verwendet die Web-API-Aktion, um einen Kontodatensatz zu erstellen, bei dem das Umsatzfeld auf den Wert der Schaltfläche festgelegt ist. Der Namensfeld des Firmendatensatzes wird auf Web API code component (Sample) festgelegt und ein zufälliges int-Element wird dem Ende der Zeichenfolge angehängt. Die Rückruf-Methode aus dem Web-API-Aufruf injiziert das Ergebnis des Web-API-Aufrufs (Erfolg oder Misserfolg) in die Ergebnis-div des benutzerdefinierten Steuerelements.

Die deleteRecord-Methode rendert eine Schaltfläche, mit der bei Aufurf ein Suchdialog geöffnet wird. Mit dem Suchdialog können Sie den Firmendatensatz auswählen, den Sie löschen möchten. Sobald ein Firmendatensatz aus dem Suchdialog ausgewählt wurde, wird er an deleteRecord übergeben, damit der Datensatz aus der Datenbank gelöscht wird. Die Rückruf-Methode aus dem Web-API-Aufruf injiziert das Ergebnis des Web-API-Aufrufs (Erfolg oder Misserfolg) in die Ergebnis-div des benutzerdefinierten Steuerelements.

Die Methode FetchXML retrieveMultiple rendert eine Schaltfläche in der Codekomponente. Bei onClick auf diese Schaltfläche wird FetchXML generiert und an die retrieveMultiple-Funktion übergeben, um den Durchschnittswert des Umsatzfelds für alle Firmendatensätze zu berechnen. Die Rückruf-Methode aus dem Web-API-Aufruf injiziert das Ergebnis des Web-API-Aufrufs (Erfolg oder Misserfolg) in die Ergebnis-div des benutzerdefinierten Steuerelements.

Die OData retrieveMultiple-Methode stellt eine Schaltfläche in der Codekomponente dar. onClick dieser Schaltfläche wird eine OData-Zeichenkette erzeugt und an die Funktion retrieveMultiple übergeben, um alle Kontendatensätze mit einem Namensfeld abzurufen, das wie die „Codekomponenten-Web-API (Beispiel)“ aussieht, was für alle Kontendatensätze gilt, die von diesem Codekomponentenbeispiel erstellt wurden.

Nach erfolgreichem Abruf der Datensätze hat die Codekomponente die Logik, um zu zählen, wie viele Kontensätze das Erlösfeld auf 100, 200 oder 300 gesetzt haben, und diese Zählung in einen OData-Statuscontainer div auf der Codekomponente anzuzeigen. Die Rückruf-Methode aus dem Web-API-Aufruf injiziert das Ergebnis des Web-API-Aufrufs (Erfolg oder Misserfolg) in die Ergebnis-div des benutzerdefinierten Steuerelements.

Verwandte Themen

Beispielkomponenten herunterladen
Beispielkomponenten verwenden
Power Apps component framework-API-Referenz
Power Apps component framework-Manifestschemareferenz

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