Attributs d’image

Article
07/06/2017

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Les enregistrements d'entités qui contiennent des données d'image fournissent une expérience unique dans l'application. En tant que développeur, vous devez savoir comment vous utilisez des données d'image.

Seules certaines entités système et entités personnalisées prennent en charge les images. Pour plus d'informations sur les entités système prenant en charge les images, voir Images d'entité.

Contenu de la rubrique

Prise en charge des attributs

Récupération des données d'image

Chargement des données d'image

Prise en charge des attributs

Pour les entités prenant en charge les attributs d'image, le SchemaName de l'attribut d'image de l'entité est toujours EntityImage. Lorsqu’un attribut d’image est ajouté à une entité, certains attributs supplémentaires sont créés pour le prendre en charge comme illustré dans le tableau suivant.

Nom du schéma	Nom du type d’attribut	Description
EntityImage_Timestamp	BigIntType	La valeur représente la date à laquelle l’image a été mise à jour pour la dernière fois et permet de garantir que la dernière version de l’image est téléchargée et mise en cache sur le client.
EntityImage_URL	StringType	Une URL absolue pour afficher l’image d’entité d’un client. L’URL est composée de cette façon : `{0}/image/download.aspx?entity={1}&attribute={2}&id={3}&timestamp={4}` 0 : URL de l’organisation 1 : Nom logique de l’entité 2 : Nom logique de l’attribut 3 : Valeur EntityImageId 4 : Valeur EntityImage_Timestamp Par exemple : https://myorg.crm.dynamics.com/image/download.aspx?attribute=entityimage&entity=contact&id={ECB6D3DF-4A04-E311-AFE0-00155D9C3020}&timestamp=635120312218444444
EntityImageId	UniqueIdentifierType	Identificateur unique de l’image.

Nom du schéma

Nom du type d’attribut

Description

EntityImage_Timestamp

BigIntType

La valeur représente la date à laquelle l’image a été mise à jour pour la dernière fois et permet de garantir que la dernière version de l’image est téléchargée et mise en cache sur le client.

EntityImage_URL

StringType

Une URL absolue pour afficher l’image d’entité d’un client.

L’URL est composée de cette façon :

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

0 : URL de l’organisation
1 : Nom logique de l’entité
2 : Nom logique de l’attribut
3 : Valeur EntityImageId
4 : Valeur EntityImage_Timestamp

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

EntityImageId

UniqueIdentifierType

Identificateur unique de l’image.

Notes

Les clients qui n’utilisent pas les assemblys .NET actuels doivent inclure SdkClientVersion avec la valeur « 6.0.0.0 » ou valeur supérieure afin de recevoir les attributs ImageAttributeMetadata.Pour plus d'informations :SdkClientVersion.

Récupération des données d'image

Lorsque vous utilisez RetrieveMultiple ou Retrieve, EntityImage n’est pas inclus lorsque la propriété ColumnSet.AllColumns est définie sur true. En raison de la taille potentielle des données de l’attribut, pour le retourner vous devez explicitement le demander.

Les données binaires représentant l’image ne sont pas renvoyées à l’aide de la classe obsolète ExecuteFetchRequest. Vous devez utiliser à la place RetrieveMultipleRequest.

Pour plus d'informations :Exemple : Définir et récupérer des images d’entité.

Chargement des données d'image

Pour mettre à jour les images, définissez la valeur de l’EntityImage sur un byte[] contenant le contenu du fichier. Toutes les images sont affichées dans un carré de 144 x 144. Les images seront rognées et redimensionnées pour réduire la taille des données avant d’être enregistrées.

Les images possédant au moins un côté supérieur à 144 pixels sont rognées au centre sur 144 x 144.
Les images avec les deux côtés inférieurs à 144 sont rognées à angle droit sur leur plus petit côté.

Le tableau suivant présente deux exemples.