Freigeben über

Beispiel: Dateivorgänge mit Anlagen und Notizen unter Verwendung des Dataverse SDK für .NET

  • Artikel

Dieses .NET-6.0-Beispiel zeigt, wie Vorgänge unter Verwendung von Dateidaten mit den Tabellen Anlage (ActivityMimeAttachment) und Anmerkung (Anmerkungen) mit Dataverse SDK für .NET ausgeführt werden.

In diesem Beispiel wird die Microsoft.PowerPlatform.Dataverse.Client.ServiceClient-Klasse verwendet.

Anforderungen

  • Microsoft Visual Studio 2022
  • Greifen Sie mit Systemadministrator- oder Systemanpasserberechtigungen auf Dataverse zu.

Wie das Beispiel ausgeführt wird

  1. Klonen Sie das PowerApps-Beispiele-Repository oder laden Sie es herunter.

  2. Öffnen Sie die PowerApps-Samples\dataverse\orgsvc\C#-NETCore\AttachmentAndAnnotationOperations\AttachmentAndAnnotationOperations.sln-Datei mit Visual Studio 2022.

    Diese Lösung enthält zwei Projekte mit Beispielen:

    • ActivityMimeAttachmentOperations: Demonstriert die Verwendung von Anlagen.
    • AnnotationOperations: Demonstriert die Verwendung von Anmerkungen.

    Machen Sie im Lösungsexplorer einen Rechtsklick auf das Projekt, das Sie ausführen möchten, und wählen Sie Als Startprojekt festlegen aus.

  3. Bearbeiten Sie in beiden Projekten die appsettings.json-Datei. Legen Sie Parameter Url und Username für die Verbindungszeichenfolge fest, die für Ihre Testumgebung geeignet sind.

    Die Umgebungs-URL befindet sich im Power Platform Admin Center. Sie sieht wie folgt aus: https://<environment-name>.crm.dynamics.com.

  4. Erstellen Sie die Lösung, und führen Sie dann das gewünschte Projekt aus.

Wenn das Beispiel ausgeführt wird, werden Sie im Standardbrowser aufgefordert, ein Umgebungsbenutzerkonto auszuwählen und ein Kennwort einzugeben. Um diesen Vorgang nicht bei jeder Ausführung eines Beispiels wiederholen zu müssen, fügen Sie einen Kennwortparameter in die Verbindungszeichenfolge in die appsettings.json-Datei ein. Zum Beispiel:

{
"ConnectionStrings": {
    "default": "AuthType=OAuth;Url=https://myorg.crm.dynamics.com;Username=someone@myorg.onmicrosoft.com;Password=mypassword;RedirectUri=http://localhost;AppId=51f81489-12ee-4a9e-aaae-a2591f45987d;LoginPrompt=Auto"
  }
}

Lesen Sie die folgenden wichtigen Informationen zur Verwendung einer Verbindungszeichenfolge im Anwendungscode.

Wichtig

Microsoft empfiehlt, den sichersten verfügbaren Authentifizierungsflow zu verwenden. Der in diesem Artikel beschriebene Authentifizierungsablauf erfordert ein sehr hohes Maß an Vertrauen in die Anwendung und birgt Risiken, die in anderen Flows nicht vorhanden sind. Sie sollten diesen Flow nur verwenden, wenn andere, sicherere Flows, z. B. verwaltete Identitäten, nicht funktionsfähig sind.

Trinkgeld

Sie können eine Benutzerumgebungsvariable namens DATAVERSE_APPSETTINGS auf den Dateipfad der „appsettings.json“-Datei festlegen, die auf Ihrem Computer gespeichert ist. Die Beispiele verwenden diese appsettings-Datei, wenn die Umgebungsvariable vorhanden und nicht Null ist. Achten Sie darauf, sich abzumelden und wieder anzumelden, nachdem Sie die Variable definiert haben, damit sie wirksam wird. Um eine Umgebungsvariable festzulegen, navigieren Sie zu Einstellungen > System > Info, wählen Sie Erweiterte Systemeinstellungen und dann Umgebungsvariablen aus.

Veranschaulichung

Dieses Beispiel ist eine Lösung mit zwei Projekten. Weitere Informationen zu den einzelnen Projekten finden Sie in den jeweiligen README-Dateien.

Hilfsprogrammklasse

Beide Projekte verwenden eine gemeinsam genutzte Utility-Klasse zum Ausführen allgemeiner Vorgänge. Diese Klasse enthält drei statische Methoden:

GetMimeType

Diese Funktion verwendet ausgehend vom Parameter FileInfo Microsoft.AspNetCore.StaticFiles.FileExtensionContentTypeProvider, um zu versuchen, den MIME-Typ der Datei abzurufen. Kann dieser nicht festgestellt werden, wird application/octet-stream zurückgegeben

GetMaxUploadFileSize

Diese Funktion gibt unter Verwendung des Parameters IOrganizationServiceservice den maxuploadfilesize-Wert des Integers aus der Tabelle organization zurück.

SetMaxUploadFileSize

Diese Funktion legt mithilfe des Parameters IOrganizationServiceservice den maxuploadfilesize-Wert des Integers aus der Tabelle organization auf den Wert des Integers des maxUploadFileSizeInBytes-Parameters fest.

Siehe auch

Dateidaten mit Anlagen- und Notizdatensätzen verwenden
Beispiel: Dateivorgänge für Anlagen und Anmerkungen mit Dataverse Web-API