Beispiel: Dateivorgänge im Zusammenhang mit Anhängen und Anmerkungen unter Verwendung der Dataverse-Web-API

In diesem .NET 6.0-Beispiel wird veranschaulicht, wie Vorgänge mithilfe von Dateidaten mit activitymimeattachment und annotation Entitätstypen mithilfe der Dataverse-Web-API ausgeführt werden.

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

Anforderungen

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

So führen Sie das Beispiel aus

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

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

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

   • ActivityMimeAttachmentOperations: Demonstriert die Verwendung von Anhängen.
   • AnnotationOperations: Demonstriert die Verwendung von Anmerkungen.

   Hinweis: Das Projekt WebAPIService ist enthalten, sodass jedes der anderen Projekte vom gemeinsamen Hilfscode abhängen kann, der vom Dienst bereitgestellt wird. Die Beispiele verwenden mehrere Klassen im WebAPIService/Messages-Ordner.

   Klicken Sie in Solution Explorer mit der rechten Maustaste auf das Projekt, das Sie ausführen möchten, und wählen Sie Set als Startprojekt aus.

3. Bearbeiten Sie in einem der Projekte 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. Informationen dazu finden Sie unter Entwicklerressourcen anzeigen.
   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.

4. Speichern Sie die Datei appsettings.json.

   Hinweis: Beide Projekte verweisen auf dieselbe appsettings.json-Datei, sodass Sie dies nur einmal tun müssen, um beide Projekte auszuführen.

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

Veranschaulichung

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

• README-Beispiel für Web-API-Anlagenoperationen (ActivityMimeAttachment)
• README für Vorgangsbeispiel für Web-API-Anmerkungen (Anmerkung)

Hilfsklasse

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 FileInfoMicrosoft.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 WebAPIServiceServiceservice den maxuploadfilesize-Wert des Integers aus der Tabelle organization zurück.

SetMaxUploadFileSize (Maximale Upload-Dateigröße festlegen)

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

Siehe auch

Dateidaten mit Anhangs- und Notizdatensätzen nutzen
Sample: Dateivorgänge mit Anlagen und Notizen mithilfe des Dataverse SDK für .NET