Enregistrez et déployez le plug-in personnalisé pour utiliser votre fournisseur de données geospatiales préféré
Avant de pouvoir utiliser un plug-in, une inscription et un déploiement serveur sont nécessaires.
Générer votre projet de plug-in résultera en un assembly de plug-ins (.dll). Cet article fournit des informations sur la façon dont vous pouvez enregistrer et déployer l’assembly de plug-ins permettant aux deux actions géospatiales d’utiliser votre fournisseur de données géospatiales préféré. Pour plus d’informations sur l’écriture d’un plug-in, voir Créer un plug-in personnalisé pour utiliser votre fournisseur de données geospatiales préféré
Considérations sur l’ordre d’exécution lors de l’inscription de votre plug-in personnalisé
Lorsque vous enregistrez plusieurs plug-ins pour les mêmes entité et message, la séquence d’exécution des plug-ins est définie par l’Ordre d’exécution des plug-ins individuels. Celui avec une valeur d’ordre d’exécutions inférieure s’exécute d’abord, suivi de celui-ci ayant une valeur d’ordre d’exécution plus élevée.
La valeur de l’ordre d’exécution du plug-in par défaut dans Field Service et Project Service qui utilise Bing Maps pour le géocode et les actions de la matrice des distances est définie sur 1. Vous pouvez définir l’ordre d’exécution de votre plug-in personnalisé à exécuter avant (moins de 1) ou après (plus de 1) le plug-in par défaut.
Le tableau suivant décrit comment vous pouvez souhaiter que votre plug-in personnalisé soit traité en fonction de l’ordre d’exécution spécifiée pendant l’inscription du plug-in et les conditions de paramètre.
| Hiérarchie | Description |
|---|---|
| Principal | Si vous souhaitez traiter votre plug-in personnalisé en tant principal et le plug-in Bing par défaut comme secondaire, définissez l’ordre d’exécution de votre plug-in sur 0. Il en résultera que votre plug-in sera exécuté avant le plug-in Bing. Le plug-in Bing examinera les valeurs « latitude » et « longitude » que votre plug-in personnalisé renvoie, et passera uniquement au géocode avec Bing si les deux valeurs renvoyées sont égales à 0. Ce doit être le moyen privilégié si votre plug-in personnalisé doit fournir la majorité de vos besoins en géocodage. |
| Secondaire | Si vous souhaitez traiter votre plug-in personnalisé comme secondaire au plug-in Bing en fournissant le service de géocodage uniquement lorsque Bing échoue au géocode, définissez l’ordre d’exécution de votre plug-in sur 2. Vous devez également écrire votre code de plug-in personnalisé de sorte qu’il examine d’abord les valeurs « latitude » et « longitude » que le plug-in Bing renvoie, et continue uniquement si les deux valeurs renvoyées sont égales à 0. Ce doit être le moyen d’exécution privilégié si Bing doit fournir la majorité de vos besoins en géocodage. |
| Remplacer complètement | Si vous souhaitez toujours que votre plug-in personnalisé soit la source du géocodage et remplace entièrement le géocodage Bing, même si votre plug-in personnalisé échoue au géocode, vous devez toujours renvoyer quelque chose autre que 0,0 pour les valeurs « latitude » et « longitude ». Vous souhaitez peut-être décider quelles conditions d’exception lèvent une exception .NET et lesquelles ne retournent simplement aucun résultat. Pour ne pas retourner de résultat et ne pas autoriser à n’importe quel plug-in suivant de retourner un résultat, votre plug-in personnalisé doit retourner quelque chose comme 0.0001, 0.0001. |
Inscrivez et déployez votre plug-in personnalisé
Vous pouvez inscrire et déployer des plug-ins à l’aide de l’outil Plug-in Registration ou par programmation en écrivant le code d’inscription à l’aide de certaines classes SDK. Plus d’informations : Inscrire et déployer des plug-ins.
Pour cette section, nous utiliserons l’outil Plug-in Registration, qui fournit une interface utilisateur graphique pour facilement enregistrer et déployer des plug-ins. En outre, cette section contient des informations basées sur l’hypothèse que vous travaillez sur site avec l’exemple de plug-in personnalisé et que vous avez créé l’exemple de projet pour générer l’assembly CustomPlugin-FS-Geospatial.dll. Si vous aurez développé votre propre plug-in personnalisé, le nom de l’assembly et les plug-ins diffèreront, mais les instructions générales pour inscrire le plug-in resteront les mêmes.
Pourboire
Pour des informations détaillées sur l’utilisation de l’outil Plug-in Registration en général, voir Procédure pas-à-pas : inscrire un plug-in à l’aide de l’outil Plug-in Registration (Inscription de plug-in).
Obtenez l’outil Plug-in Registration. Pour obtenir l’outil Plug-in Registration, voir Télécharger les outils à partir de NuGet.
Accédez au dossier
[Your folder]\Tools\PluginRegistration, puis double-cliquez sur le fichier PluginRegistration.exe pour exécuter l’outil.Cliquez sur CRÉER UNE NOUVELLE CONNEXION.
Dans la boîte de dialogue Se connecter, spécifiez les informations d’identification pour vous connecter à votre instance de Dynamics 365, puis cliquez sur Se connecter.
Si vous avez accès à plusieurs organisations dans l’instance de Dynamics 365, une liste des organisations à choisir pour vous connecter s’affiche. Sinon, votre organisation par défaut est utilisée.
Vous devriez voir une liste réduite d’assemblys de plug-in ou d’activité de workflow personnalisée inscrits. Sélectionnez Inscrire>Inscrire un nouvel assembly.
Dans la boîte de dialogue Inscrire un nouvel assembly :
Sous la section Étape 1, cliquez sur le bouton des points de suspension […] pour sélectionner l’assembly CustomPlugin-FS-Geospatial.dll.
Sous la section Étape 2, sélectionnez les plug-ins.
Sous la section Étape 3, sélectionnez l’option Bac à sable (sandbox).
Sous la section Étape 4, sélectionnez l’option Base de données.
Sélectionnez Inscrire les plug-ins sélectionnés.
L’assembly CustomPlugin-FS-Geospatial.dll et les deux plug-ins pour msdyn_GeocodeAddress et msdyn_RetrieveDistanceMatrix sont désormais inscrits et déployés sur le serveur.
L’étape suivante consiste à inscrire une étape pour chaque action. Une étape fait référence à l’entité de l’étape de traitement du message SDK qui sert à configurer quand et comment un plug-in doit être exécuté.
Dans la vue d’arborescence Plug-ins et activités de workflow personnalisées enregistrés, développez le nœud (Assembly) CustomPlugin-FS-Geospatial, puis sélectionnez un plug-in enregistré, disons Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix.
Cliquez avec le bouton droit sur Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix, et sélectionnez Inscrire la nouvelle étape.
Dans la boîte de dialogue Inscrire la nouvelle étape, spécifiez ce qui suit :
- Message : msdyn_RetrieveDistanceMatrix
- Ordre d’exécution: Au besoin. Voir Considérations sur l’ordre d’exécution lors de l’inscription de votre plug-in personnalisé précédemment dans cet article.
- Phase d’exécution dans le pipeline d’événement : PostOperation
- Mode d’exécution : Synchrone
- Laissez les autres champs avec leurs valeurs par défaut. Cliquez sur Inscrire une nouvelle étape.
Ensuite, cliquez avec le bouton droit sur le plug-in Microsoft.Crm.Sdk.Samples.msdyn_GeocodeAddress, et sélectionnez Inscrire la nouvelle étape.
Dans la boîte de dialogue Inscrire la nouvelle étape, spécifiez ce qui suit :
- Message : msdyn_GeocodeAddress
- Ordre d’exécution: Au besoin. Voir Considérations sur l’ordre d’exécution lors de l’inscription de votre plug-in personnalisé précédemment dans cette rubrique.
- Phase d’exécution dans le pipeline d’événement : PostOperation
- Mode d’exécution : Synchrone
- Laissez les autres champs avec leurs valeurs par défaut. Cliquez sur Inscrire une nouvelle étape.
Vous avez terminé d’inscrire les étapes pour appeler votre plug-in personnalisé pour les deux actions géospatiales.
Si vous affichez l’une des actions géospatiales d’Universal Resource Scheduling dans l’outil Plug-in Registration, vous verrez le plug-in par défaut et votre plug-in personnalisé inscrits pour l’action. Par exemple, consultez les plug-ins pour l’action mdyn_GeocodeAddress.
