Atributos de imagen
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Los registros de entidad que incluyen datos de imagen proporcionan una experiencia única dentro de la aplicación. Como programador, usted necesita comprender cómo trabaja con datos de imagen.
Sólo determinadas entidades del sistema y las entidades personalizadas admiten imágenes. Para obtener información acerca de qué entidades del sistema admiten las imágenes, consulte Imágenes de entidad.
En este tema
Atributos compatibles
Recuperar datos de imagen
Carga de datos de imagen
Atributos compatibles
Para las entidades que admitan atributos de imagen, el atributo SchemaName de la entidad de imagen siempre es EntityImage. Cuando se agrega un atributo de imagen a una entidad se crean algunos atributos adicionales para el mismo como se muestra en la siguiente tabla.
Nombre de esquema |
Nombre del tipo de atributo |
Descripción |
|---|---|---|
EntityImage_Timestamp |
BigIntType |
El valor representa el momento en que la imagen se actualizó por última vez y se usa para asegurarse de que la versión más reciente de la imagen se descarga y se almacena en caché en el cliente. |
EntityImage_URL |
StringType |
Dirección URL absoluta para mostrar la imagen de la entidad en un cliente. La dirección URL se compone de lo siguiente:
Por ejemplo: |
EntityImageId |
UniqueIdentifierType |
El identificador único de la imagen. |
Nota
Los clientes que no usan los ensamblados actuales de .NET deben incluir SdkClientVersion con un valor de ‘6.0.0.0’ o posterior para recibir los atributos de ImageAttributeMetadata.Más información:SdkClientVersion.
Recuperar datos de imagen
Cuando use RetrieveMultiple o Retrieve, EntityImage no se incluye cuando la propiedad ColumnSet.AllColumns se establece en true. Debido al tamaño que pueden alcanzar los datos de este atributo, para devolver este atributo debe solicitarlo explícitamente.
Los datos binarios que representan la imagen no se devuelven con la clase obsoleta ExecuteFetchRequest. Debe usar RetrieveMultipleRequest en su lugar.
Más información:Ejemplo: establecer y recuperar imágenes de entidad.
Carga de datos de imagen
Para actualizar las imágenes, establezca el valor de EntityImage en un byte[] que contenga el contenido del archivo. Todas las imágenes se muestran en un cuadrado de 144x144 píxeles. Las imágenes se recortarán y se redimensionarán para reducir el tamaño de los datos antes de guardarlos.
Las imágenes que tengan al menos un lado de más de 144 píeles se recortan en el centro a 144x144.
Las imágenes que tengan ambos lados con menos de 144 píxeles se recortarán con forma de cuadrado cuyo lado coincide con la dimensión más pequeña.
En la siguiente tabla se muestran dos ejemplos.
Antes |
Después de |
|---|---|
.jpeg "Imagen antes de cambio de tamaño")
300x428 |
.jpeg "imagen después de cambiar el tamaño")
144x144 |
.jpeg "Segunda ejemplo de cambio de tamaño de imagen")
91x130 |
.jpeg "segundo ejemplo de cambio de tamaño")
91x91 |
Más información:Ejemplo: establecer y recuperar imágenes de entidad.
Ver también
Introducción a entidades en Microsoft Dynamics 365
Introducción a los atributos de entidad de Microsoft Dynamics 365
Ejemplo: establecer y recuperar imágenes de entidad
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright