Freigeben über

Beispiel grundlegender Web-API-Operationen (PowerShell)

In diesem PowerShell Version 7.4.0-Beispiel wird veranschaulicht, wie allgemeine Datenvorgänge mithilfe der Dataverse-Web-API und Visual Studio Code ausgeführt werden. Dieses Beispiel implementiert die Dataverse-Vorgänge und die Konsolenausgabe, die unter Beispiel grundlegender Web-API-Vorgänge beschrieben ist.

Dieses Beispiel auf Github ansehen

Dieses Beispiel verwendet die Dataverse-Web-API-PowerShell-Hilfsfunktionen, um die Authentifizierung zu verwalten und wiederverwendbare Funktionen zur Durchführung allgemeiner Vorgänge bereitzustellen. Auf diese Skripte wird mit Dot-Sourcing mit den folgenden Zeilen verwiesen:

. $PSScriptRoot\..\Core.ps1
. $PSScriptRoot\..\TableOperations.ps1
. $PSScriptRoot\..\CommonFunctions.ps1

Anmerkung

Dieses Beispiel sollte mit Windows, Linux und macOS funktionieren, wurde jedoch nur auf Windows getestet.

Anforderungen

Bevor Sie dieses Beispiel ausführen, sollten Sie die folgenden Artikel lesen, in denen die von diesen Beispielen verwendeten Konzepte und Muster erläutert werden:

Für diese Artikel gelten die gleichen Voraussetzungen.

Installieren Sie Folgendes oder überprüfen Sie, ob es vorhanden ist

Überprüfen der Installation

  1. Öffnen Sie Visual Studio Code.

  2. Wählen Sie im Menü Terminal die Option New Terminal (Neues Terminal) aus.

  3. Wählen Sie im navigationsbereich Visual Studio Code das Symbol für die PowerShell-Erweiterung aus.

  4. Kopieren Sie das folgende Skript, und fügen Sie es in das terminalfenster Visual Studio Code ein:

    Write-Host 'PowerShell Version:'$PSVersionTable.PSVersion.ToString()
Write-Host 'PowerShell Az version:'(Get-InstalledModule Az).Version

  5. Drücken Sie die EINGABETASTE. Die Ausgabe sollte wie folgt aussehen:

    PowerShell Version: 7.4.0
PowerShell Az version: 11.1.0

Wenn Sie solche Ergebnisse nicht sehen, installieren oder aktualisieren Sie die erforderlichen Systemanforderungen.

Darüber hinaus brauchen Sie

  • Ein gültiges Benutzerkonto für eine Dataverse-Umgebung
  • Die URL zur Dataverse-Umgebung, mit der Sie eine Verbindung herstellen möchten. Unter Entwicklerressourcen anzeigen erfahren Sie, wie Sie ihn finden. Sie sieht ungefähr so aus: https://yourorg.crm.dynamics.com/, wobei yourorg.crm anders ist.
  • Grundlegende Kenntnisse über die PowerShell-Skriptsprache

Wie man dieses Beispiel ausführt

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

  2. Öffnen sie die Datei BasicOperations.ps1 mit Visual Studio Code

  3. Bearbeiten Sie diese Zeile, damit sie die URL der Umgebung verwendet, mit der Sie eine Verbindung herstellen können:

    Connect 'https://yourorg.crm.dynamics.com/' # change this

  4. (Optional) Legen Sie die $deleteCreatedRecords-Variable auf $false fest, wenn Sie die in diesem Beispiel erstellten Datensätze nicht löschen möchten.

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

  6. Wenn Sie das Beispiel zum ersten Mal ausführen, wird ein Browserfenster geöffnet. Geben Sie im Browserfenster die Anmeldeinformationen ein bzw. wählen Sie diejenigen aus, die Sie zur Authentifizierung verwenden möchten.

Um eine Verbindung als anderer Benutzer herzustellen, führen Sie den Disconnect-AzAccount-Befehl aus, und versuchen Sie es erneut.

Code

Sie finden den Code für dieses Beispiel unter: PowerApps-Samples/dataverse/webapi/PS/BasicOperations/BasicOperations.ps1

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.

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: Datensätze zuordnen und trennen

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: Beispielaufzeichnungen 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
Schnellstart-Web-API mit PowerShell und Visual Studio Code
Verwenden Sie PowerShell und Visual Studio Code mit der Dataverse-Web-API
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

  • Last updated on