Ejemplo: establecer y recuperar imágenes de entidad

En este ejemplo se muestra cómo establecer y recuperar datos de las imágenes de entidad. Puede descargar el ejemplo desde aquí.

Nota

Este ejemplo se aplica tanto a Dynamics 365 Customer Engagement (on-premises) como a Dataverse.

Cómo ejecutar esta muestra

Para obtener una copia local de todas las muestras y compilarlas, siga estos pasos:

1. Descargar o clonar el informe de Muestras para que tenga una copia local.
2. (Opcional) Edite el archivo dataverse/App.config para definir una cadena de conexión que especifique la instancia o la organización a la que desea conectarse.
3. Abra la solución de ejemplo en Visual Studio y presione F5 para ejecutar la muestra. Una vez que especifique una cadena de conexión en dataverse/App.config, cualquier muestra que ejecute utilizará esa información de conexión.

Si no especifica una cadena de conexión en el archivo dataverse/App.config, se abre un diálogo cada vez que ejecute la muestra y tendrá que introducir información acerca de a qué instancia u org desea conectarse y qué credenciales desea usar. Este diálogo guardará en caché conexiones anteriores para que pueda elegir una conexión usada previamente.

Qué hace este ejemplo

En este ejemplo se muestra cómo establecer y recuperar datos de las imágenes de entidad.

Cómo funciona este ejemplo

Para simular el escenario descrito en Qué hace este ejemplo, el ejemplo hará lo siguiente:

Programa de instalación

Comprueba la versión actual de la organización.

Demostración

1. Utiliza el método CreateImageAttributeDemoEntity para crear una entidad personalizada con el nombre de esquema sample_ImageAttributeDemo y un atributo principal con el nombre de esquema sample_Name.

2. Crear un atributo de imagen con el nombre de esquema EntityImage. Todos los atributos de imagen usan este nombre.

3. Recupera y actualiza el formulario principal para la entidad sample_ImageAttributeDemo para establecer el atributo showImage a true de forma que la imagen se muestre en el formulario.

4. Publicar la entidad sample_ImageAttributeDemo.

5. Crea cinco nuevos registros para la entidad sample_ImageAttributeDemo utilizando cinco imágenes de diferentes tamaños ubicadas en la carpeta Imágenes como se muestra aquí. Después de crear cada registro, tiene la oportunidad de ver el registro en la aplicación del navegador web utilizando el método ShowEntityFormInBrowser para que pueda ver cómo se redimensionan las imágenes de origen para ajustarse al espacio disponible en el formulario.

6. Recupera los registros con el atributo entityimage y guarda los archivos redimensionados. Después de ejecutar el ejemplo puede encontrar los archivos guardados en la carpeta \bin\Debug.

7. Recupera los registros con el atributo entityimage_url y muestra los valores de la dirección URL relativa que puede incluir en la aplicación para tener acceso a las imágenes. Esta consulta debe ser más dinámica porque la cantidad de datos transmitidos es inferior.

Limpiar

Muestra una opción para eliminar los registros creados en Configuración. La eliminación es opcional en caso de que desee examinar las entidades y los datos creados por el ejemplo. Puede eliminar manualmente los registros para obtener el mismo resultado.