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

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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 Microsoft Dynamics 365 (online e locale) 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 utilizzare la sicurezza basata sui ruoli per controllare l'accesso alle entità in Microsoft Dynamics 365.

Connessione al server Microsoft Dynamics 365

1. Eseguire lo strumento Plug-in Registration.

2. Fai clic su 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 365 (online) e il pulsante Office 365 è relativo al provider Microsoft Online Services di Microsoft Dynamics 365 (online).

   Finestra di accesso per una distribuzione online

   Finestra di accesso per una distribuzione locale

4. Se selezioni Visualizza sempre l'elenco delle organizzazioni disponibili compare un elenco di organizzazioni a cui appartieni dopo avere fatto clic su Accedi. Ciò consente di scegliere l'organizzazione in cui si desidera registrare il plug-in. In caso contrario, viene utilizzata l'organizzazione predefinita.

5. Immetti le informazioni indicate sul server e l'account di accesso, quindi fai clic su 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 fai clic su Registra, quindi su Registra nuovo assembly.

3. Nella finestra di dialogo Registra nuovo assembly, fare clic sul 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. Seleziona l'assembly, quindi fai clic su 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. Fai clic su 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. Passa al menu Registra nella barra degli strumenti quindi fai clic su 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. Fai clic su 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, seleziona il relativo nodo nell'albero e quindi fai clic su 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, puoi selezionare il nodo e fai clic su 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 fare clic su Nuovo.

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

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

5. Fare clic su 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, fare clic su 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

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright