Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Per poter utilizzare un plug-in, è necessario registrarlo e distribuirlo sul server.
La generazione del progetto di plug-in risulta in un assembly del plug-in (.dll). In questo articolo vengono fornite informazioni su come registrare e distribuire l'assembly di un plug-in per due azioni geospaziali allo scopo di utilizzare il provider di dati geospaziali preferito. Per informazioni sulla scrittura di un plug-in, vedi Creazione di un plug-in personalizzato per utilizzare il provider di dati geospaziali preferito
Considerazioni sull'ordine di esecuzione durante la registrazione del plug-in personalizzato
Quando registri più plug-in per la stessa entità e lo stesso messaggio, la sequenza di esecuzione dei plug-in viene definita dall'ordine di esecuzione di singoli plug-in. Quello con il valore di ordine di esecuzione più basso viene eseguito per primo seguito da quello con il valore di ordine di esecuzione più alto.
Il valore di ordine di esecuzione del plug-in predefinito in Field Service e Project Service che utilizza Bing Maps per le azioni di matrice di distanza e di codifica geografica è 1. Puoi impostare l'ordine di esecuzione del plug-in personalizzato affinché venga eseguito prima (inferiore a 1) o dopo (superiore a 1) il plug-in predefinito.
La tabella seguente descrive come deve essere considerato il plug-in personalizzato a seconda dell'ordine di esecuzione specificato.
| Hierarchy | Description |
|---|---|
| Primario | Se vuoi considerare il plug-in personalizzato come primario e il plug-in Bing predefinito come secondario, imposta l'ordine di esecuzione del tuo plug-in su 0. Così facendo il tuo plug-in viene eseguito prima del plug-in Bing. Il plug-in Bing esaminerà i valori di "latitudine" e "longitudine" restituiti dal tuo plug-in e procede alla codifica geografica con Bing solo se entrambi i valori restituiti sono 0. Questo sarebbe il modo preferito se il tuo plug-in personalizzato deve fornire la maggior parte della codifica geografica necessaria. |
| Secondario | Se vuoi che il tuo plug-in personalizzato sia considerato come secondario al plug-in Bing fornendo il servizio di codifica geografica solo quando Bing non funziona, imposta l'ordine di esecuzione del tuo plug-in su 2. In tal caso, scriveresti il codice del tuo plug-in di modo che esamini i valori di "latitudine" e "longitudine" restituiti dal plug-in Bing e proceda alla codifica geografica solo se entrambi i valori restituiti sono 0. Questo sarebbe il modo di esecuzione preferito se Bing dovesse fornire la maggior parte della codifica geografica necessaria. |
| Escludi completamente | Se vuoi che il tuo plug-in personalizzato sia sempre l'origine della codifica geografica e che escluda completamente Bing anche quando non funziona, è necessario che i valori di "longitudine" e "latitudine" restituiti del tuo plug-in siano diversi da 0,0. Se lo desideri, puoi stabilire quali condizioni generano un'eccezione .NET e quali non restituiscono un risultato. Per non restituire un risultato e non consentire a qualsiasi plug-in di restituire un risultato, il tuo plug-in deve restituire valori come 0.0001, 0.0001. |
Registrare e distribuire il plug-in personalizzato
Registrare e distribuire plug-in usando lo strumento di registrazione plug-in o scrivendo codice di registrazione con classi SDK specifiche.
Puoi registrare e distribuire plug-in utilizzando lo strumento per la registrazione di plug-in oppure in modo programmatico scrivendo codice di registrazione mediante determinate classi SDK. Per altre informazioni, vedere Registrare e distribuire plug-in.
I passaggi seguenti illustrano lo strumento Di registrazione plug-in, che fornisce un'interfaccia utente grafica per registrare e distribuire facilmente i plug-in. Si presuppone che si stia lavorando con il plug-in personalizzato di esempio e si disponga del progetto di esempio per generare l'assembly CustomPlugin-FS-Geospatial.dll . Se hai sviluppato un plug-in personalizzato, i nomi di assembly e plug-in sono diversi, ma segui le stesse istruzioni per la registrazione del plug-in.
Suggerimento
Per ulteriori informazioni, vedere Guida pratica: Registrazione di un plug-in usando lo strumento di registrazione del plug-in
Ottieni lo strumento per la registrazione di plug-in. Per altre informazioni, vedere Scaricare gli strumenti da NuGet.
Accedi alla cartella
[Your folder]\Tools\PluginRegistratione fai doppio clic sul file PluginRegistration.exe per eseguire lo strumento.Seleziona CREA NUOVA CONNESSIONE.
Nella finestra di dialogo Accedi, specifica le credenziali per la connessione all'istanza di Dynamics 365 e seleziona Accedi.
Se si ha accesso a più organizzazioni nell'istanza di Dynamics 365, viene visualizzato un elenco di organizzazioni da selezionare. In caso contrario, lo strumento usa l'organizzazione predefinita.
Viene visualizzato un elenco compresso dei plug-in registrati o degli assembly delle attività flusso di lavoro personalizzate. Seleziona Registra>Registra nuovo assembly.
Immettere le informazioni seguenti:
- Passaggio 1: seleziona i puntini (...) e quindi CustomPlugin-FS-Geospatial.dll
- Passaggio 2: selezionare entrambi i plug-in.
- Passaggio 3: Selezionare Sandbox.
- Passaggio 4: Selezionare Database.
Seleziona Registra plug-in selezionati.
L'assembly CustomPlugin-FS-Geospatial.dll e i due plug-in per il msdyn_GeocodeAddress e msdyn_RetrieveDistanceMatrix vengono ora registrati e distribuiti nel server.
Registrare un passaggio per ogni azione. Un passaggio si riferisce all'entità di passaggio di elaborazione del messaggi SDK utilizzata per configurare quando e come il plug-in deve essere eseguito.
Nella visualizzazione ad albero di Plug-in registrati e attività di flusso di lavoro personalizzate, espandi il nodo CustomPlugin-FS-Geospatial (Assembly) e seleziona un plug-in registrato come Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix.
Fai clic con il pulsante destro del mouse su Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix e seleziona Registra nuovo passaggio.
Immettere le informazioni seguenti:
- Messaggio: msdyn_RetrieveDistanceMatrix
- Ordine esecuzione: come necessario. Per altre informazioni, vedere Considerazioni sull'ordine di esecuzione durante la registrazione del plug-in personalizzato.
- Fase di esecuzione della pipeline eventi: PostOperation
- Modalità esecuzione: sincrona
Lasciare il resto dei campi con i valori predefiniti e selezionare Registra nuovo passaggio.
Fare clic con il pulsante destro del mouse sul plug-in Microsoft.Crm.Sdk.Samples.msdyn_GeocodeAddress e scegliere Registra nuovo passaggio.
Immettere le informazioni seguenti:
- Messaggio: msdyn_GeocodeAddress
- Ordine esecuzione: come necessario. Per altre informazioni, vedere Considerazioni sull'ordine di esecuzione durante la registrazione del plug-in personalizzato.
- Fase di esecuzione della pipeline eventi: PostOperation
- Modalità esecuzione: sincrona
Lasciare il resto dei campi con i valori predefiniti e selezionare Registra nuovo passaggio.
I passaggi per chiamare il plug-in personalizzato per entrambe le azioni geospaziali vengono registrati.
Se viene visualizzata una qualsiasi delle azioni geospaziali di Pianificazione risorse universale nello strumento per la registrazione di plug-in, il plug-in predefinito e il tuo risulteranno entrambi registrati per l'azione. Ad esempio, vedi il plug-in per l'azione mdyn_GeocodeAddress.
