Bildattribute

Artikel
03/04/2017

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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.

In diesem Thema

Unterstützen von Attributen

Abrufen von Bilddaten

Hochladen von Bilddaten

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, wie in der folgenden Tabelle veranschaulicht.

Schemaname	Name des Attributtyps	Beschreibung
EntityImage_Timestamp	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	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 Zum Beispiel: https://myorg.crm.dynamics.com/image/download.aspx?attribute=entityimage&entity=contact&id={ECB6D3DF-4A04-E311-AFE0-00155D9C3020}&timestamp=635120312218444444
EntityImageId	UniqueIdentifierType	Der eindeutige Bezeichner des Bilds

Schemaname

Name des Attributtyps

Beschreibung

EntityImage_Timestamp

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

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

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

EntityImageId

UniqueIdentifierType

Der eindeutige Bezeichner des Bilds

Hinweis

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.

Abrufen von Bilddaten

Wenn Sie RetrieveMultiple oder Retrieve verwenden, ist EntityImage nicht enthalten, wenn die ColumnSet.AllColumns-Eigenschaft auf „true“ festgelegt ist. 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: Festlegen und Abrufen von Entitätsbildern.

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.