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

Artikel
03/08/2023

Dieses .NET-6.0-Beispiel zeigt, wie Vorgänge unter Verwendung von Dateidaten mit den Tabellen Anlage (ActivityMimeAttachment) und Notiz (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

Klonen Sie das PowerApps-Beispiele-Repository oder laden Sie es herunter.
Ö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.
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.
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"
  }
}

Tipp: 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 IOrganizationService service den maxuploadfilesize-Wert des Integers aus der organization-Tabelle zurück.

SetMaxUploadFileSize

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

Siehe auch

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

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

Freigeben über