Bildattribute

Artikel
12/13/2024

Entitätsdatensätze, die Bilddaten enthalten, bieten eine einzigartige Umgebung in der Anwendung. Als Entwickler müssen wissen, wie Sie mit Bilddaten arbeiten.

Nur bestimmte Systementitäten und benutzerdefinierte Entitäten unterstützen Bilder. Informationen dazu, welche Systementitäten Bilder unterstützen, finden Sie unter Entitätsbilder.

Unterstützen von Attributen

Für Entitäten, die Bildattribute untersützen, ist das SchemaName des Entitätsbildattributs immer EntityImage. Wenn ein Bildattribut einer Entität hinzugefügt wird, werden zur Unterstützung einige zusätzliche Attribute erstellt.

Notiz

Clients, die nicht die aktuellen .NET-Assemblys verwenden, müssen SdkClientVersion mit dem Wert „6.0.0.0“ (oder höher) enthalten, um ImageAttributeMetadata-Attribute zu erhalten. Weitere Informationen: SdkClientVersion.

EntityImage_Timestamp-Attribut

Name des Attributtyps: BigIntType

Der Wert zeigt an, wenn das Bild zuletzt aktualisiert wurde, und wird verwendet, um sicherzustellen, dass die aktuelle Version des Bilds heruntergeladen und auf dem Client zwischengespeichert wird.

EntityImage_URL-Attribut

Name des Attributtyps: StringType

Eine absolute URL, um das Entitätsbild in einem Client anzuzeigen.

Die URL setzt sich wie folgt zusammen:

{0}/image/download.aspx?entity={1}&attribute={2}&id={3}&timestamp={4}

0 : Die URL der Organisation
1 : Der logische Entitätsname
2 : Der logische Attributname
3 : Der EntityImageId-Wert
4 : Der EntityImage_Timestamp-Wert

Beispiel:
https://myorg.crm.dynamics.com/image/download.aspx?attribute=entityimage&entity=contact&id={ECB6D3DF-4A04-E311-AFE0-00155D9C3020}&timestamp=635120312218444444

EntityImageId

Name des Attributtyps: UniqueIdentifierType

Der eindeutige Bezeichner des Bilds

Abrufen von Bilddaten

Wenn Sie RetrieveMultiple oder Retrieve verwenden, wird die EntityImage nicht berücksichtigt, wenn die ColumnSet. AllColumns Eigeschaft ist auf wahr festgelegt. Aufgrund von möglichen Größe der Daten in diesem Attribut müssen Sie es explizit anfordern, wenn es zurückgegeben werden soll.

Die Binärdaten, die das Bild darstellen, werden nicht mithilfe der veralteten ExecuteFetchRequest-Klasse zurückgegeben. Sie sollten stattdessen RetrieveMultipleRequest verwenden.

Weitere Informationen: Beispiel: Bilder einer Entität festlegen und abrufen.

Hochladen von Bilddaten

Um Bilder zu aktualisieren, legen Sie den Wert von EntityImage auf ein byte[] fest, das die Inhalte der Datei enthält. Alle Bilder werden in einem 144x144-Pixelquadrat angezeigt. Die Bilder werden zugeschnitten und die Größe wird geändert, um die Größe der Daten zu verringern, bevor sie gespeichert werden.

Bilder, bei denen mindestens eine Seite größer ist als 144 Pixel, werden zentriert auf 144x144 zugeschnitten.
Bilder, bei denen beide Seiten kleiner sind als 144 Pixel, werden quadratisch auf ihre kleinste Seite zugeschnitten.

Die folgende Tabelle enthält zwei Beispiele.