Del via

Føj metadata til en brugerdefineret arbejdsprocesaktivitet

  • Artikel

 

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

Den assembly, der indeholder definitionen af den brugerdefinerede arbejdsprocesaktivitet, angives ved hjælp af .NET-attributter med henblik på levering af de metadata, som Microsoft Dynamics 365 bruger på kørselstidspunktet til at knytte din kode til arbejdsprocesprogrammet. Du kan finde flere oplysninger om .NET-attributter, under Udvide metadata ved hjælp af attributter.

Før du begynder at føje metadata til definitionen af din brugerdefinerede arbejdsprocesaktivitet, skal du sætte dig ind i de Microsoft Dynamics 365-typer og -attributter, der understøttes for brugerdefinerede arbejdsprocesaktiviteter.Flere oplysninger: se Procesklasser, attributter og typer

Dette emne indeholder

Tilføje inputparametre

Tilføje outputparametre

Tilføje input- og outputattributter for den samme parameter

Yderligere attributter

Tilføje metoden Execute

Tilføje inputparametre

Når du angiver inputparameteren i din arbejdsprocesklasse, kan du også angive en standardværdi for parameteren. I følgende eksempel vises definitionen af en inputparameter.

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

Denne inputparameter angives med .NET-attributten Input. Klassen InputAttribute er afledt af klassen ParameterAttribute, som kræver en parameter (ParameterAttribute.Name) til angivelse af navnet på inputattributten. Dette navn vises i procesformularassistenten i webprogrammet. Her kan du tilknytte en attribut som inputparameter til processen.

Du kan desuden gøre inputparameteren påkrævet.Flere oplysninger:RequiredArgumentAttribute

Tilføje outputparametre

Outputparametre tilføjes på samme måde som inputparametrene. I følgende eksempel vises definitionen af en outputparameter.

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

Denne outputparameter angives med .NET-attributten Output. Klassen OutputAttribute er afledt af klassen ParameterAttribute, som kræver en parameter (ParameterAttribute.Name) til angivelse af navnet på outputattributten. Dette navn vises i procesformularassistenten i webprogrammet. Her kan du tilknytte en attribut som output.

Tilføje input- og outputattributter for den samme parameter

Du kan bruge input- og outputattributter for den samme parameter. I følgende kodeeksempel er IntParameter både input- og outputparameter.

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

Yderligere attributter

Nogle typer som f.eks. EntityReference og OptionSetValue, kræver yderligere attributter ud over attributterne Input, Output og Default. De ekstra attributter er: ReferenceTarget og AttributeTarget. I følgende eksempel vises definitionen af en parameter af typen EntityReference.

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

Hvis du vil have vist en liste over understøttede typer og attributter, skal du se under Procesklasser, attributter og typer.

Tilføje metoden Execute

Din brugerdefinerede arbejdsprocesaktivitet skal have en Execute-metode, som vist i følgende eksempel.

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

Se også

Brugerdefinerede arbejdsprocesaktiviteter (arbejdsprocesassemblies)
Brugerdefinerede arbejdsprocesaktiviteter (arbejdsprocesassemblies)
Oprette en brugerdefineret arbejdsprocesaktivitet
Brug IOrganization-webtjenesten i en brugerdefineret arbejdsprocesaktivitet
Eksempel: Opret en brugerdefineret arbejdsprocesaktivitet
Procesklasser, attributter og typer

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret