Tester et distribuer un connecteur personnalisé
Important
Tout ou partie de cette fonctionnalité est accessible dans le cadre d’une version préliminaire. Le contenu et la fonctionnalité sont susceptibles d’être modifiés.
Cet article fournit des informations sur la manière de tester et de distribuer votre connecteur d’importation de données personnalisé dans Microsoft Sustainability Manager.
Tester l’interface utilisateur du connecteur
En suivant ces étapes, vous pouvez voir à quoi ressemble l’interface utilisateur de votre connecteur.
Exportez la solution Power Platform que vous avez créée précédemment en suivant les étapes dans la rubrique Exporter des solutions. Assurez-vous que le numéro de version de la solution que vous exportez est supérieur à la version actuelle. Vous réimporterez la solution après avoir ajouté le fichier XML que vous avez créé précédemment.
Extrayez les fichiers ZIP que vous avez exportés et créez un dossier nommé Actifs.
Enregistrez le fichier msdyn_dataconnectors.xml (et le fichier msdyn_dataflowtemplates.xml pour un connecteur de modèle Power Query) dans le dossier Actifs.
Pour un connecteur Power Automate, la structure de vos dossiers devrait maintenant ressembler à :
Pour un connecteur de modèle Power Query, la structure de vos dossiers devrait ressembler à :
Sélectionnez tous les fichiers et compressez-les dans un fichier ZIP. Lorsque vous ouvrez votre fichier ZIP récemment créé, la structure des dossiers de niveau supérieur doit contenir ces éléments :
- Dossier Actifs
- [Types de contenu] fichier
- fichier customizations.xml
- fichier solution.xml
- Fichier ZIP de la solution de modèles (pour les connecteurs de modèle Power Query)
Réimportez le fichier ZIP dans le même environnement Power Platform à partir duquel vous l’avez exporté en suivant les étapes de la rubrique Importer des solutions.
Une fois l’importation terminée, un connecteur apparaît dans cet environnement. Dans Sustainability Manager, dans la zone Données du volet de navigation de gauche, sélectionnez Importations. Sélectionnez Nouveau, puis sélectionnez CONNECTEURS DU FOURNISSEUR DE DONNÉES. Votre vignette de connecteur s’affiche sur la page suivante. Sélectionnez votre vignette de connecteur, puis cliquez sur Suivant.
Pour un connecteur Power Automate, l’interface utilisateur du formulaire d’informations d’identification que vous avez conçu apparaît. Vous pouvez vous assurer qu’il semble correct et déboguer le formulaire via cette page.
Pour un connecteur de modèle Power Query, l’expérience d’importation du modèle Power Query apparaît.
Si vous souhaitez apporter des modifications, suivez les étapes pour exporter la solution, mettez à jour le fichier msdyn_dataconnectors.xml, puis réimportez-le. Assurez-vous que la version que vous exportez est supérieure à la version actuelle.
Vous pouvez remplir le formulaire avec des exemples de valeurs et l’enregistrer. Pour vérifier comment ces valeurs sont stockées, dans Power Apps, sélectionnez Tables. Sélectionnez Tout et recherchez msdyn_providercredential. Les données de la table s’affichent. Si c’est la première fois que vous créez la connexion, il ne devrait y avoir qu’un seul enregistrement d’informations d’identification. Vérifiez la colonne Informations d’identification pour voir comment les valeurs que vous avez fournies dans le formulaire sont stockées.
Tester pour la gestion des erreurs
Pour les connecteurs Power Automate, il est important de gérer les erreurs dans votre flux de connexion. Si, pour une raison quelconque, une étape du flux échoue, l’état de l’importation de données reste bloqué sur Planifié.
Pour tester cet événement, ajoutez vos actions dans le flux dans un bloc try/catch. Dans le bloc catch, échouez la connexion et l’actualisation de la connexion.
Si la connexion échoue, vos utilisateurs devraient pouvoir vous contacter en utilisant le lien d’assistance que vous avez inclus dans le JSON pour l’interface utilisateur de votre connecteur. Ce JSON apparaît dans Étape 2 : Créer un enregistrement de connecteur.
Pour échouer la connexion et l’actualisation de la connexion, utilisez l’action Mettre à jour une ligne Dataverse pour les deux enregistrements Actualisation de la connexion et Connexion.
Pour l’enregistrement Actualisation de la connexion, réglez le champ Actualiser le statut sur Échec :
Pour l’enregistrement Actualisation de la connexion, réglez le champ Statut sur Erreur :
Pour plus d’informations, consultez Utiliser un flux sur mettre à jour une ligne.
Pour plus d’informations sur la gestion des erreurs, accédez à Meilleures pratiques pour la gestion des erreurs dans les flux Power Automate.
Tester votre connecteur
Après avoir créé votre connecteur, vous pouvez l’exporter au format solution gérée en suivant les étapes de la rubrique Exporter des solutions.
Importez votre solution exportée dans d’autres environnements sur lesquels Sustainability Manager est installé et testez votre solution pour vous assurer qu’elle fonctionne comme prévu.
Distribuer votre connecteur
Une fois vos tests terminés, vous pouvez soit distribuer votre solution en privé directement à vos utilisateurs, soit la distribuer publiquement via Microsoft AppSource. Pour plus d’informations sur la distribution via AppSource, accédez à Publier votre application sur AppSource.
Informations associées
- Présentation de l’importation de données
- Importer des données avec les connecteurs fournisseur de données