Attributs d’image

Article
03/22/2023

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

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.

Note

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, consultez : SdkClientVersion.

Attribut EntityImage_Timestamp.

Nom du type d’attribut : 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.

Attribut EntityImage_URL

Nom du type d’attribut : 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

Nom du type d’attribut : UniqueIdentifierType

Identificateur unique de l’image.

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

Lorsque vous utilisez RetrieveMultiple ou Retrieve l’EntityImage n’est pas incluse dans le ColumnSet. La propriété 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.