Metagegevens toevoegen aan een aangepaste werkstroomactiviteit

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

De assembly die de aangepaste definitie van de werkstroomactiviteit bevat, wordt geannoteerd met de .NET-kenmerken om de metagegevens te leveren die Microsoft Dynamics 365 tijdens uitvoeringstijd gebruikt om uw code aan de werkstroomengine te koppelen. Zie Metagegevens uitbreiden met kenmerken voor meer informatie over .NET-kenmerken.

Voordat u met het toevoegen van metagegevens aan uw aangepaste definitie van werkstroomkactiviteit start, moet u op de hoogte zijn van de Microsoft Dynamics 365-typen en -kenmerken die worden ondersteund voor aangepaste werkstroomactiviteiten.Meer informatie: zie Procesklassen, -kenmerken en -typen

In dit onderwerp

Invoerparameters toevoegen

Uitvoerparameters toevoegen

Invoer- en uitvoerkenmerken toevoegen voor dezelfde parameter

Aanvullende kenmerken

De methode Execute toevoegen

Invoerparameters toevoegen

Tijdens het opgeven van de invoerparameter in uw werkstroomklasse kunt u ook een standaardwaarde voor de parameter opgeven. Het volgende voorbeeld toont de definitie van een invoerparameter.

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

Deze invoerparameter wordt geannoteerd met het .NET-kenmerk Input. De klasse InputAttribute wordt afgeleid van de klasse ParameterAttribute, die een parameter (ParameterAttribute.Name) gebruikt om de naam van het invoerkenmerk op te geven. Deze naam wordt weergegeven in de procesformulierassistent in de webtoepassing. Hiermee kunt u een kenmerk als invoerparameter aan het proces toewijzen.

U kunt de invoerparameter bovendien verplicht maken.Meer informatie:RequiredArgumentAttribute

Uitvoerparameters toevoegen

Uitvoerparameters worden toegevoegd op dezelfde manier als invoerparameters. Het volgende voorbeeld toont de definitie van een uitvoerparameter.

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

Deze uitvoerparameter wordt geannoteerd met het .NET-kenmerk Output. De klasse OutputAttribute wordt afgeleid van de klasse ParameterAttribute, die een parameter (ParameterAttribute.Name) gebruikt om de naam van het uitvoerkenmerk op te geven. Deze naam wordt weergegeven in de procesformulierassistent in de webtoepassing. Zo kunt u een kenmerk als uitvoer toewijzen.

Invoer- en uitvoerkenmerken toevoegen voor dezelfde parameter

U kunt de invoer- en uitvoerkenmerken gebruiken voor dezelfde parameter. In het volgende codevoorbeeld is IntParameter de invoer- en de uitvoerparameter.

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

Aanvullende kenmerken

Sommige typen, zoals EntityReference en OptionSetValue, vereisen aanvullende kenmerken, afgezien van de kenmerken Input, Output en Default. De aanvullende kenmerken zijn: ReferenceTarget en AttributeTarget. Het volgende voorbeeld toont de definitie van een parameter van het type EntityReference.

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

Voor een lijst met ondersteunde typen en berichten raadpleegt u Procesklassen, -kenmerken en -typen.

De methode Execute toevoegen

Uw aangepaste werkstroomactiviteit moet een Execute-methode hebben, zoals aangegeven in het volgende voorbeeld.

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

Zie ook

Aangepaste workflowactiviteiten (workflowassemblies)
Aangepaste workflowactiviteiten (workflowassemblies)
Een aangepaste werkstroomactiviteit maken
De IOrganization-webservice gebruiken in een aangepaste werkstroomactiviteit
Voorbeeld: Een aangepaste werkstroomactiviteit maken
Procesklassen, -kenmerken en -typen

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht