Aggiungere i metadati a un'attività del flusso di lavoro personalizzata

Data di pubblicazione: gennaio 2017

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

L'assembly che contiene la definizione dell'attività del flusso di lavoro personalizzato è annotato con gli attributi .NET per fornire i metadati utilizzati da Microsoft Dynamics 365 al momento del runtime per collegare il codice al motore del flusso di lavoro. Per ulteriori informazioni sugli attributi .NET vedere Estensione metadati con gli attributi.

Prima di iniziare ad aggiungere i metadati alla definizione dell'attività del flusso di lavoro personalizzata, assicurati di conoscere i tipi e gli attributi di Microsoft Dynamics 365 supportati per le attività del flusso di lavoro personalizzate.Ulteriori informazioni: vedere Classi, attributi e tipi di processo

In questo argomento

Aggiungere i parametri di input

Aggiungere parametri di output

Aggiungere gli attributi di Input e Output per lo stesso parametro

Attributi aggiuntivi

Aggiungere il metodo di esecuzione

Aggiungere i parametri di input

Per specificare il parametro di input nella classe del flusso di lavoro, è inoltre possibile specificare un valore predefinito per il parametro. Nel seguente esempio viene illustrata la definizione di un parametro di input.

[Input("DateTime input")]
[Default("2004-07-09T02:54:00Z")]
public InArgument<DateTime> Date { get; set; }

Il parametro di input viene annotato con l'attributo Input di .NET. La classe InputAttribute deriva dalla classe ParameterAttribute, che prendere un parametro (ParameterAttribute.Name) per specificare il nome dell'attributo di input. Il nome verrà visualizzato nelle Informazioni e selezione rapida dell'applicazione Web. Consente di eseguire il mapping di un attributo come parametro di input al processo.

Inoltre, è possibile rendere necessario il parametro di input.Ulteriori informazioni:RequiredArgumentAttribute

Aggiungere parametri di output

I parametri di output sono aggiunti analogamente come parametri di input. Nel seguente esempio viene illustrata la definizione di un parametro di output.

[Output("Money output only")]
[Default("23.3")]
public OutArgument<Money> MoneyOutput { get; set; }

Il parametro di output viene annotato con l'attributo Output di .NET. La classe OutputAttribute deriva dalla classe ParameterAttribute, che prendere un parametro (ParameterAttribute.Name) per specificare il nome dell'attributo di output. Il nome verrà visualizzato nelle Informazioni e selezione rapida dell'applicazione Web. Ciò consente di eseguire il mapping di un attributo come output.

Aggiungere gli attributi di Input e Output per lo stesso parametro

È possibile utilizzare gli attributi di input e di output per lo stesso parametro. Nel seguente esempio di codice, IntParameter è il parametro di input nonché il parametro di output.

[Input("Int input")]
[Output("Int output")]
[Default("2322")]
public InOutArgument<int> IntParameter { get; set; }

Attributi aggiuntivi

Alcuni tipi, come EntityReference e OptionSetValue, richiedono altri attributi oltre agli attributi Input, Output e Default. Ulteriori attributi sono: ReferenceTarget e AttributeTarget. Nel seguente esempio viene illustrata la definizione di un parametro del tipo EntityReference.

[Input("EntityReference input")]
[Output("EntityReference output")]
[ReferenceTarget("account")]
[Default("3B036E3E-94F9-DE11-B508-00155DBA2902", "account")]
public InOutArgument<EntityReference> AccountReference { get; set; }

Per l'elenco dei tipi e degli attributi supportati vedere Classi, attributi e tipi di processo.

Aggiungere il metodo di esecuzione

L'attività flusso di lavoro personalizzata deve avere un metodo Execute, come illustrato nell'esempio seguente.

protected override void Execute(CodeActivityContext context)
{
   if (AccountReference.Get(context).Id != new Guid("3B036E3E-94F9-DE11-B508-00155DBA2902"))   
      throw new InvalidPluginExecutionException("Unexpected default value");
}

Vedere anche

Attività personalizzate del flusso di lavoro (assembly del flusso di lavoro)
Attività personalizzate del flusso di lavoro (assembly del flusso di lavoro)
Creare un'attività flusso di lavoro personalizzata
Utilizzare il servizio Web IOrganization in un attività flusso di lavoro personalizzata
Esempio: creare un'attività flusso di lavoro personalizzata
Classi, attributi e tipi di processo

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright