Partager via

Attributs d’image

  • Article

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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.

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.

Avant

Après
Image avant redimensionnement

300 x 428
image après redimensionnement

144 x 144
Deuxième exemple de redimensionnement d'image

91 x 130
deuxième exemple de redimensionnement

91 x 91

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

Voir aussi

Présentation des entités dans Microsoft Dynamics 365
Présentation des attributs d'entité dans Microsoft Dynamics 365
Exemple : Définir et récupérer des images d’entité

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright