Procedura dettagliata: registrare un plug-in utilizzando lo strumento per la registrazione dei plug-in

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

La procedura dettagliata illustra come registrare un plug-in utilizzando lo strumento Plug-in Registration fornito nell'SDK. Il plug-in da registrare è il FollowupPlugin dall'argomento Esempio: creare un plug-in di base.

Il plug-in deve essere registrato nell'entità account, messaggio CreateRequest, in un post-evento e nella sandbox. Il plug-in può essere registrato in qualsiasi distribuzione di Aggiornamento di Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015 in cui il proprio account utente dispone del ruolo addetto alla personalizzazione del sistema o amministratore di sistema.

I prerequisiti seguenti devono essere completati prima di iniziare questa procedura dettagliata:

• Ottenere lo strumento PluginRegistration.exe che si trova nella cartella Tools\PluginRegistration dell'SDK.Scarica il pacchetto SDK di Microsoft Dynamics CRM.

• Ottenere un account utente di sistema in un server Microsoft Dynamics 365.

• L'account utente deve disporre del ruolo Amministratore di sistema o Addetto alla personalizzazione del sistema. Vedere Come usare la sicurezza basata sui ruoli per controllare l'accesso alle entità in Microsoft Dynamics CRM 2015.

Connessione al server Microsoft Dynamics CRM

1. Eseguire lo strumento Plug-in Registration.

2. Selezionare CREA NUOVA CONNESSIONE.

3. Nella finestra di dialogo Accedi, selezionare il pulsante di opzione del tipo di distribuzione che corrisponde al server di Microsoft Dynamics 365 in cui si desidera registrare il plug-in. Il pulsante di opzione Locale include una distribuzione IFD, il pulsante Online è relativo al provider Windows Live di Microsoft Dynamics CRM Online e il pulsante Office 365 è relativo al provider Microsoft Online Services di Microsoft Dynamics CRM Online.

   Finestra di accesso per una distribuzione online

   Finestra di accesso per una distribuzione locale

4. Se si seleziona Visualizza sempre l'elenco delle organizzazioni disponibili, verrà presentato un elenco di organizzazioni a cui appartiene l'utente dopo avere selezionato Accedi. Ciò consente di scegliere l'organizzazione in cui si desidera registrare il plug-in. In caso contrario, viene utilizzata l'organizzazione predefinita.

5. Immettere le informazioni indicate sul server e l'account di accesso, quindi selezionare Accedi.

Verrà visualizzato un elenco compresso dei plug-in registrati o degli assembly delle attività flusso di lavoro personalizzate e degli endpoint servizio. I feed attività e assembly di Microsoft.Crm.ObjectModel sono necessari per consentire il corretto funzionamento di Microsoft Dynamics 365, quindi lo strumento non consente di alterarli. Selezionando un elemento nei risultati di elenco nelle schede Proprietà e Dettagli visualizzando informazioni sulla tale elemento dell'elenco.

La finestra principale dell'applicazione

Registrare un assembly di plug-in

1. Selezionare una scheda dell'organizzazione per renderla attiva.

2. Nella barra degli strumenti della scheda, selezionare Registra, quindi su Registra nuovo assembly.

3. Nella finestra di dialogo Registra nuovo assembly, selezionare il pulsante ellissi […] a destra del campo Passaggio 1.

4. Nella finestra di dialogo Apri, passare alla posizione dell'assembly compilato SamplePlugin.dll. La posizione predefinita è SDK\SampleCode\CS\Plug-ins\bin\Debug. Selezionare l'assembly, quindi scegliere Apri.

5. Nella sezione Passaggio 2, espandere l'assembly SamplePlugins per visualizzare tutti i plug-in presenti nell'assembly. Selezionare (controllare) solo il plug-in Microsoft.Crm.Sdk.Samples.FollowupPlugin.

6. Nella sezione Passaggio 3, selezionare l'opzione Sandbox.

7. Nella sezione Passaggio 4, selezionare l'opzione Database.

   

   Interazione per registrare un assembly

8. Scegliere Registra plug-in selezionati. È possibile chiudere tutte le finestre di dialogo aperte.

   

   Un plug-in registrato visualizzato nella visualizzazione albero

   Suggerimento

   Viene visualizzato un errore nell'area Registro e il registro contiene il messaggio seguente?

   <Message>Action failed for assembly 'SamplePlugins, Version=0.0.0.0, Culture=neutral, PublicKeyToken=829f574d80e89132': Deployment/Scalegroup does not allow running external code.</Message>

   In questo caso, è necessario abilitare il codice personalizzato nel server e riprovare. Per ulteriori informazioni, vedere Abilitare o disabilitare l'esecuzione del codice personalizzato.

L'assembly SamplePlugins.dll e il plug-in FollowupPlugin sono ora registrati e distribuiti al server. Se è stato utilizzato lo strumento per registrare un assembly di attività flusso di lavoro personalizzato, non si applica la sezione successiva, relativa alla registrazione di un passaggio.

Registrare un passaggio del plug-in per un evento

1. Nella visualizzazione ad albero Plug-in registrati e Attività personalizzate del flusso di lavoro, espandere il nodo (Assembly) SamplePlugins e selezionare un plug-in registrato.

2. Passare al menu Registra nella barra degli strumenti, quindi selezionare Registra nuovo passaggio.

   Nota

   I plug-in sono registrati per essere eseguiti quando un evento viene elaborato nella pipeline di esecuzione. Ogni evento ha un nome e un numero di fase per indicare la sua posizione nella pipeline prima o dopo l'operazione principale di piattaforma. 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.

3. Completare la finestra di dialogo Registra nuovo passaggio come illustrato nella figura seguente.

   

   Interazione per registrare un nuovo passaggio

4. Selezionare Registra nuovo passaggio.

5. Espandere il nodo e i sottonodi (Assembly) SamplePlugins per visualizzare i nodi del passaggio e il plug-in creati. È quindi possibile chiudere lo strumento, ma può essere opportuno tenerlo aperto fino a quando non si verifica il plug-in e si annulla la registrazione dell'assembly.

   Nota

   Per annullare la registrazione di un passaggio, plug-in o assembly, selezionare il relativo nodo nell'albero e quindi selezionare Annulla la registrazione nella barra degli strumenti. Per modificare la registrazione di un passaggio o un assembly, fare doppio clic sull'assembly o sul nodo del passaggio nella visualizzazione albero. In alternativa, è possibile selezionare il nodo e scegliere Aggiorna nella barra degli strumenti.

Il plug-in è ora registrato per essere eseguito nella sandbox, per un evento di creazione account e in seguito all'esecuzione dell'operazione principale. Il plug-in è stato registrato per essere eseguito in modalità asincrona, poiché per la creazione dell'impegno di tipo attività di completamento non è fondamentale il tempo. In seguito alla creazione di un account, il plug-in verrà eseguito la volta successiva che il servizio asincrono elabora la relativa coda.

Verificare il plug-in

Dopo avere registrato il plug-in è possibile verificare facoltativamente la relativa esecuzione utilizzando la procedura seguente.

1. Aprire l'applicazione Web di Microsoft Dynamics 365 per la stessa organizzazione in cui è stato registrato l'assembly del plug-in.

2. Passare all'area di lavoro, selezionare Account e quindi scegliere Nuovo.

3. Nella casella Nome account digitare un nome account, ad esempio Adventure Works Cycle, quindi scegliere Salva e chiudi.

4. Fare doppio clic sul nome del modulo nella griglia Account per aprire il modulo.

5. Selezionare Impegni per visualizzare un elenco di impegni relativi all'account. Dovrebbe essere visualizzato l'impegno chiamato “Send email to the new customer“ creata dal plug-in.

6. Se il plug-in è stato registrato per essere eseguito in modalità asincrona e non è stata selezionata l'opzione Eliminazione AsyncOperation se Statuscode = completata nel modulo Registra nuovo passaggio, sarà presente un nuovo processo di sistema chiamato “FollowupPlugin: Create of account”. Per visualizzare il relativo processo di sistema, selezionare Impostazioni, quindi fare clic su Processi di sistema. Fare doppio clic sul processo di sistema precedentemente indicato.

È ora possibile annullare la registrazione del passaggio, del plug-in e dell'assembly, se lo si desidera. Può inoltre essere opportuno eliminare il processo di sistema e l'account che è stato creato.

Vedere anche

Sviluppo dei plug-in
Procedura dettagliata: Configurare la sicurezza dell'assembly per un plug-in offline
Registrare e distribuire plug-in
Pipeline di esecuzione evento
Isolamento di plug-in, attendibilità e statistiche
Messaggi supportati ed entità per plug-in

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright