Beispiel grundlegender Web-API-Operationen (C#)

  • Artikel

Dieses .NET 6.0-Beispiel veranschaulicht, wie allgemeine Datenvorgänge mit der Dataverse-Web-API ausgeführt werden.

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

Hinweis

Dieses Beispiel implementiert die Dataverse-Vorgänge sowie die Konsolenausgabe, die unter Beispiel grundlegender Web-API-Operationen aufgeführt sind, und nutzt herkömmliche C#-Konstrukte, die in Web-API-Beispiele (C#) aufgeführt sind.

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 PowerApps-Beispiele-Repository oder laden Sie es herunter.

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

  3. Die Datei BasicOperations.sln mit Visual Studio 2022 öffnen

  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: Grundlegendes Erstellen und Aktualisieren von Vorgängen

Vorgänge:

  • Erstellen Sie einen Kontaktdatensatz.
  • Aktualisieren Sie die Kontaktdatensatz.
  • 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.

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 die Zordnung aufheben

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 auf false und Sie werden aufgefordert, zu entscheiden, ob Sie die Datensätze löschen möchten.

Siehe auch

Dataverse-Web-API verwenden
WebAPIService-Klassenbibliothek (C#)
Erstellen einer Tabellenzeile über die Web-API
Aktualisieren und Löschen von Tabellenzeilen über die Web-API
Abrufen einer Tabellenzeile mit der Web-API
Web API Beispiele
Beispiel grundlegender Web-API-Operationen
Web API-Abfragedatenbeispiel (C#)
Beispiel bedingter Web-API-Operationen (C#)
Web-API-Funktionen- und Aktionen-Beispiel (C#)
Beispiel für Web-API-Tabellenschemavorgänge (C#)
Web-API WebApiService-Beispiel für parallele Operationen (C#)
Beispiel für parallele Web-API-Vorgänge mit TPL Dataflow-Komponenten (C#)

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