Atributos de imagen

Artículo
03/22/2023

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 imágenes, consulte Imágenes de entidad.

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 darle soporte.

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.

Atributo EntityImage_Timestamp

Nombre del tipo de atributo: 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.

Atributo EntityImage_URL

Nombre del tipo de atributo: StringType

Dirección URL absoluta para mostrar la imagen de la entidad en un cliente.

La dirección URL se compone de lo siguiente:

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

0: la URL de la organización
1: el nombre lógico de la entidad
2: el nombre lógico del atributo
3: el valor de EntityImageId.
4: El valor de EntityImage_Timestamp

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

EntityImageId

Nombre del tipo de atributo: UniqueIdentifierType

El identificador único de la imagen.

Recuperar datos de imagen

Cuando use RetrieveMultiple o Retrieve, EntityImage no se incluye cuando la propiedad ColumnSet. La propiedad AllColumnsse 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: configurar 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.