Exemple : Définir et récupérer des images d’entité

Cet exemple montre comment définir et récupérer les données pour les images d’entité. Vous pouvez télécharger l’exemple ici.

Note

Cet exemple s’applique à Dynamics 365 Customer Engagement (on-premises) et Dataverse.

Comment exécuter cet exemple

Pour obtenir une copie locale de tous les exemples et les générer, procédez comme suit :

1. Télécharger ou cloner le référentiel Exemples pour en avoir une copie locale.
2. (Facultatif) Modifiez le fichier dataverse/App.config pour définir une chaîne de connexion qui spécifie l’instance ou l’organisation à laquelle vous souhaitez vous connecter.
3. Ouvrez l’exemple de solution dans Visual Studio et appuyez sur F5 pour exécuter l’exemple. Après avoir spécifié une chaîne de connexion dans le fichier dataverse/App.config, tout exemple que vous exécutez utilise ces informations de connexion.

Si vous ne spécifiez pas de chaîne de connexion dans le fichier dataverse/App.config, une boîte de dialogue s’ouvre chaque fois que vous exécutez l’exemple et vous devez entrer des informations sur l’instance ou l’organisation à laquelle vous souhaitez vous connecter et sur les informations d’identification que vous souhaitez utiliser. Cette boîte de dialogue met en cache les connexions précédentes afin que vous puissiez choisir une connexion déjà utilisée.

En quoi consiste cet exemple

Cet exemple montre comment définir et récupérer les données pour les images d’entité.

Utiliser cet exemple

Afin de simuler le scénario décrit dans En quoi consiste cet exemple, l’exemple procède comme suit :

Configurer

Vérifie la version actuelle de l’organisation.

Démontrer

1. Utilisez la méthode CreateImageAttributeDemoEntity pour créer une entité personnalisée avec le nom de schéma sample_ImageAttributeDemo et un attribut principal avec le nom de schéma sample_Name.

2. Créer un attribut d’image avec le nom de schéma EntityImage. Tous les attributs d’image utilisent ce nom.

3. Récupérez et mettez à jour le formulaire principal pour l’entité sample_ImageAttributeDemo pour définir l’attribut showImage sur true afin que l’image soit affichée dans le formulaire.

4. Publier l’entité sample_ImageAttributeDemo.

5. Crée cinq nouveaux enregistrements pour l’entité sample_ImageAttributeDemo à l’aide de cinq images de tailles différentes situées dans le dossier Images, comme illustré ici. Après la création de chaque enregistrement, vous avez la possibilité de visualiser l’enregistrement dans l’application de navigateur Web à l’aide de la méthode ShowEntityFormInBrowser afin de pouvoir voir comment les images source sont redimensionnées pour s’adapter à l’espace disponible dans le formulaire.

6. Récupère les enregistrements avec l’attribut entityimage et enregistre les fichiers redimensionnés. Après avoir exécuté l’exemple, les fichiers sont enregistrés dans le dossier \bin\Debug.

7. Récupère les enregistrements avec l’attribut entityimage_url et affiche les valeurs de l’URL relative que vous pouvez inclure dans votre application pour accéder aux images. Cette requête doit être plus réactive, car la quantité de données transférées est inférieure.

Nettoyer

Affichez une option pour supprimer les enregistrements dans Installation. La suppression est facultative si vous souhaitez vérifier les entités et les données créées par l’exemple. Vous pouvez supprimer manuellement l’enregistrement pour obtenir le même résultat.