Creare un'attività flusso di lavoro personalizzata

  • Articolo

 

Data di pubblicazione: gennaio 2017

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

In questo argomento viene descritto come creare attività flusso di lavoro personalizzata e registrarla per l'utilizzo in Microsoft Dynamics 365 (online e locale). Per Microsoft Dynamics 365 (online), le attività flusso di lavoro personalizzate possono essere registrate solo per essere eseguite nella sandbox (attendibilità parziale) Per ulteriori informazioni sulla sandbox e sull'attendibilità parziale, vedere: Isolamento di plug-in, attendibilità e statistiche.

In questo argomento

Software e assembly necessari

Utilizzare la classe di base del flusso di lavoro di CodeActivity

Specificare il nome e nome del gruppo per un attività flusso di lavoro personalizzata

Software e assembly necessari

Per sviluppare gli impegni personalizzati di Windows Workflow Foundation 4 per Dynamics 365, devi utilizzare Microsoft .NET Framework 4.5.2. Gli assembly seguenti devono essere aggiunti come riferimenti nel progetto. Questi assembly sono disponibili nella cartella SDK\Bin di Microsoft Dynamics 365 SDK.Scarica il pacchetto SDK di Microsoft Dynamics CRM.

  • Microsoft.Xrm.Sdk.dll

  • Microsoft.Xrm.Sdk.Workflow.dll

Utilizzare la classe di base del flusso di lavoro di CodeActivity

Per creare un'attività flusso di lavoro personalizzata, creare una classe che eredita dalla classe di base del flusso di lavoro di CodeActivity. Questa classe è disponibile nello spazio dei nomi System.Activities. Gli impegni che ereditano dalla classe CodeActivity possono sostituire il metodo Execute per generare funzionalità personalizzate.

  1. Avviare Microsoft Visual Studio.

  2. Nel menu File, fare clic su Nuovo e quindi su Progetto.

  3. Nella finestra di dialogo Nuovo progetto, selezionare Flusso di lavoro in Visual C# nel riquadro Modelli installati, quindi selezionare Libreria attività.

  4. Specificare un nome e una posizione per la soluzione e quindi fare clic su OK.

  5. Passare al menu Progetto e quindi selezionare Proprietà. Nella scheda Applicazione, specificare .NET Framework 4.5.2 come framework di destinazione.

  6. Aggiungere riferimenti agli assembly Microsoft.Xrm.Sdk.dll e Microsoft.Xrm.Workflow.dll.

  7. Eliminare file di Activity1.xaml nel progetto.

  8. Aggiungere il file di una classe (.cs) al progetto. In Esplora soluzioni, fare clic con il pulsante destro del mouse sul progetto, selezionare Aggiungi, quindi fare clic su Classe. Nella casella di dialogo Aggiungi nuovo elemento digitare un nome per la nuova classe, quindi fare clic su Aggiungi.

  9. Aprire il file di classe e aggiungere quanto segue utilizzando le direttive:

    using System.Activities;using Microsoft.Xrm.Sdk;using Microsoft.Xrm.Sdk.Workflow;

  10. Fare in modo che la classe erediti dalla classe CodeActivity e assegnarle un modificatore di accesso pubblico come illustrato di seguito:

    public class SampleCustomActivity : CodeActivity

  11. Aggiungere funzionalità alla classe aggiungendo un metodo Execute:

    protected override void Execute(CodeActivityContext context){    //Activity code}

    Per ulteriori informazioni, vedere Aggiungere i metadati a un'attività del flusso di lavoro personalizzata.

  12. Specificare i parametri di input e di output. Per ulteriori informazioni, vedere Aggiungere i metadati a un'attività del flusso di lavoro personalizzata.

  13. Nelle proprietà del progetto, nella scheda Firma, selezionare Firma assembly e immettere un nome file chiave. Gli assembly (e i plug-in) delle attività flusso di lavoro personalizzati devono essere firmati.

  14. Compilare il progetto creare un assembly (.dll).

Per visualizzare un esempio di codice che illustra come creare attività flusso di lavoro personalizzata, vedere Esempio: creare un'attività flusso di lavoro personalizzata.

Importante

Per prestazioni ottimali, Microsoft Dynamics 365 archivia le istanze delle attività flusso di lavoro personalizzate. Il metodo Execute dell'attività flusso di lavoro personalizzata deve essere scritto in modo da risultare senza stato perché il costruttore non viene chiamato per ogni chiamata dell'attività flusso di lavoro personalizzata. Inoltre, più thread di sistema potrebbero eseguire l'attività flusso di lavoro personalizzata contemporaneamente. Tutte le informazioni sullo stato per chiamata vengono archiviate nel contesto, quindi non è consigliabile utilizzare variabili globali o variabili membro per passare i dati da una chiamata alla successiva.

Specificare il nome e nome del gruppo per un attività flusso di lavoro personalizzata

Quando si registra un assembly dell'attività flusso di lavoro, specificare il nome e il nome del gruppo. La proprietà del nome specifica il nome dell'attività flusso di lavoro. La proprietà del nome del gruppo specifica il nome del sottomenu aggiunto al menu principale nella finestra di progettazione del processo di Microsoft Dynamics 365. Queste proprietà collegano l'attività flusso di lavoro personalizzata con la finestra di progettazione di processo di Microsoft Dynamics 365, in modo che il nome di impegno personalizzato verrà visualizzato nell'interfaccia utente.

Per specificare il nome e il nome del gruppo di un'attività flusso di lavoro personalizzata, utilizzare gli attributi PluginType.WorkflowActivityGroupName e PluginType.Name quando si registra l'assembly dell'attività flusso di lavoro personalizzata. Per ulteriori informazioni sulla registrazione delle attività flusso di lavoro personalizzate, vedere Registrare e utilizzare un assembly delle attività flusso di lavoro personalizzate. Se gli attributi PluginType.Name e PluginType.WorkflowActivityGroupName sono impostati su null, l'impegno personalizzato viene nascosto dalla finestra di progettazione dei flussi di lavoro di Microsoft Dynamics 365 ed è accessibile solo dai flussi di lavoro XAML.

Se si utilizza lo strumento per la registrazione dei plug-in per registrare gli assembly dell'attività flusso di lavoro personalizzati, è possibile specificare i valori appropriati nelle caselle WorkflowActivityGroupName e Nome, nell'area Modifica. Per ulteriori informazioni su come utilizzare lo strumento di registrazione di del plug-in, Procedura dettagliata: registrare un plug-in utilizzando lo strumento per la registrazione dei plug-in

Specifica il nome e il nome del gruppo durante la registrazione

In seguito alla registrazione di questa attività flusso di lavoro personalizzata, è possibile utilizzarla dalla finestra di progettazione di processo di Microsoft Dynamics 365 per i flussi di lavoro o le interazioni. Per ulteriori informazioni, vedere Registrare e utilizzare un assembly delle attività flusso di lavoro personalizzate.

Vedere anche

Attività personalizzate del flusso di lavoro (assembly del flusso di lavoro)
Aggiungere i metadati a un'attività del flusso di lavoro personalizzata
Utilizzare il servizio Web IOrganization in un attività flusso di lavoro personalizzata
Esempio: creare un'attività flusso di lavoro personalizzata
Esempio: attività flusso di lavoro personalizzata che riconosce Azure
Classi di attività di base del flusso di lavoro di Windows Workflow Foundation 4

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright