Beispiel grundlegender Web-API-Operationen (C#)

In diesem .NET 6.0-Beispiel wird veranschaulicht, wie allgemeine Datenvorgänge mithilfe der Dataverse-Web-API ausgeführt werden.

In diesem Beispiel wird der allgemeine Helfercode in der WebAPIService-Klassenbibliothek (C#) verwendet.

Anforderungen

Diese Anforderungen müssen zum Erstellen und Ausführen dieses Beispiels erfüllt sein:

• Microsoft Visual Studio 2022.
• Zugriff auf Dataverse mit Rechten, um Datenvorgänge auszuführen.

Wie man dieses Beispiel ausführt

1. Klonen Sie das Repository Power Apps-Samples, oder laden Sie es herunter.

2. Suchen Sie den Ordner /dataverse/webapi/C#-NETx/BasicOperations/.

3. Öffnen der Datei BasicOperations.sln mit Visual Studio 2022

4. Bearbeiten Sie die appsettings.json-Datei, um die folgenden Eigenschaftswerte festzulegen:

   Eigenschaften	Anweisungen
   Url	Die Url für Ihre Umgebung. Ersetzen Sie den https://yourorg.api.crm.dynamics.com-Wert des Platzhalters durch den Wert für Ihre Umgebung. Gehen Sie zu Entwicklerressourcen anzeigen, um die URL für Ihre Umgebung zu finden.
   UserPrincipalName	Ersetzen Sie den you@yourorg.onmicrosoft.com-Wert des Platzhalters durch den UPN-Wert, den Sie für den Zugriff auf die Umgebung verwenden.
   Password	Ersetzen Sie den yourPassword-Wert des Platzhalters durch das von Ihnen verwendete Kennwort.

5. Die Datei appsettings.json speichern

6. Drücken Sie F5, um das Beispiel auszuführen.

Code

Der Code für dieses Beispiel ist hier: PowerApps-Beispiele/dataverse/webapi/C#-NETx/BasicOperations/Program.cs

Veranschaulichung

Dieses Beispiel umfasst fünf Regionen:

Abschnitt 1: Grundlegende Erstellungs- und Aktualisierungsvorgänge

Vorgänge:

• Erstellen Sie einen Kontaktdatensatz.
• Aktualisieren Sie die Kontaktkarte.
• Rufen Sie den Kontaktdatensatz ab.
• Aktualisieren Sie eine einzelne Eigenschaft des Kontaktdatensatzes.
• Rufen Sie eine einzelne Eigenschaft des Kontaktdatensatzes ab.

Abschnitt 2: Ein mit einem anderen Datensatz verknüpften Datensatz erstellen

Vorgänge: Verknüpfen Sie einen neuen Datensatz mit einem vorhandenen.

Abschnitt 3: Verknüpfte Entitäten erstellen

Vorgänge: Erstellen Sie die folgenden Einträge in einem Vorgang: ein Konto, seinen zugeordneten primären Kontakt und offene Aufgaben für diesen Kontakt. Diese Entitätstypen haben die folgenden Beziehungen:

Accounts
    |---[Primary] Contact (N-to-1)
        |---Tasks (1-to-N)

Abschnitt 4: Entitäten zuordnen und entkoppeln

Vorgänge:

• Fügen Sie der contact_customer_accounts-Sammlung des Kontos einen Kontakt hinzu.
• Entfernen Sie einen Kontakt aus der contact_customer_accounts-Sammlung des Kontos.
• Ordnen Sie einem Benutzer ein Sicherheitsrolle zu, indem Sie die systemuserroles_association-Sammlung verwenden.
• Entfernen Sie eine Sicherheitsrolle für einen Benutzer, indem Sie die systemuserroles_association-Sammlung verwenden.

Abschnitt 5: Beispielentitäten löschen

Vorgänge: Ein Verweis auf jeden in diesem Beispiel erstellten Datensatz wurde einer Liste hinzugefügt, während sie erstellt wurde. Dieser Abschnitt durchläuft diese Liste und löscht jeden Datensatz.

Bereinigung

Standardmäßig löscht dieses Beispiel alle darin erstellten Datensätze. Wenn Sie die erstellten Datensätze nach Abschluss des Beispiels anzeigen möchten, ändern Sie die deleteCreatedRecords-Variable in false. Sie werden dann aufgefordert, zu entscheiden, ob Sie die Datensätze löschen möchten.

Siehe auch

Verwenden der Dataverse-Web-API
WebAPIService-Klassenbibliothek (C#)
Erstellen einer Tabellenzeile mithilfe der Web-API
Tabellenzeilen über die Web-API aktualisieren und löschen
Abrufen einer Tabellenzeile mit der Web-API
Web-API-Beispiele
Beispiel grundlegender Web-API-Operationen
Beispiel fürWeb API-Abfragedaten (C#)
Beispiel bedingter Web-API-Vorgänge (C#)
Beispiel für Internet-API-Funktionen- und Aktionen (C#)
Beispiel für Web-API-Tabellen-Schemaoperationen (C#)
Web-API WebApiService-Beispiel für parallele Operationen (C#)
Beispiel für parallele Web-API-Vorgänge mit TPL Dataflow-Komponenten (C#)