Prozessklassen, Attribute und Typen

  • Artikel

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Dieses Thema enthält Informationen zu den Prozessklassen und Typen, die in Microsoft Dynamics 365, auftreten, und die Sie verwenden können, um mit den benutzerdefinierten Aktivitäten zu arbeiten.

In diesem Thema

Prozessklassen

Attribute und Microsoft Dynamics 365-Typen

InputAttribute und OutputAttribute

DefaultAttribute

ReferenceTargetAttribute

AttributeTargetAttribute

RequiredArgumentAttribute

Prozessklassen

Die in Prozessklassen sind im Microsoft.Xrm.Sdk.Workflow-Namespace verfügbar (Microsoft.Xrm.Sdk.Workflow.dll). Sie können diese Klassen verwenden, um benutzerdefinierte Aktivitäten in Windows Workflow Foundation zu erstellen und anschließend die Aktivitäten im Bereich Prozesse in Microsoft Dynamics 365 oder in den XAML-Workflows zu verwenden. Detaillierte Informationen zu den Prozessklassen finden Sie unter Microsoft.Xrm.Sdk.Workflow.

Attribute und Microsoft Dynamics 365-Typen

Die Microsoft Dynamics 365-Typen befinden sich im Microsoft.Xrm.Sdk-Namespace (Microsoft.Xrm.Sdk.dll). Verwenden Sie die Klassen InputAttribute und OutputAttribute, um zu Eingabe- und Ausgabeeigenschaften zu kommentieren.

Die folgenden Typen werden für benutzerdefinierte Workflowaktivitäten unterstützt:

Abgesehen von den Attributen Input, Output und Default, erfordern einige der unterstützten Microsoft Dynamics 365-Attribute in den benutzerdefinierten Workflowaktivitäten, dass Sie zusätzliche Attribute wie ReferenceTarget und AttributeTarget angeben. Diese werden im folgenden Abschnitt beschrieben.

InputAttribute und OutputAttribute

Das folgende Beispiel zeigt, wie die Eingabe- und Ausgabeattribute einem Money-Parameter hinzugefügt werden, der in einer benutzerdefinierten Workflowaktivität verwendet wird. Darüber hinaus wird dargestellt, wie Sie einen Standardwert für die angezeigten Eigenschaft festlegen.

[Input("Money input")]
[Output("Money output")]
[Default("232.3")]
public InOutArgument<Money> MoneyParameter { get; set; }

DefaultAttribute

Sie können die Klasse DefaultAttributeverwenden, um einen Standardwert für einen Eingabeparameter anzugeben. Die folgenden Beispiele veranschaulichen, wie der Standardwert für jeden Typ mithilfe des Default-Attributs angegeben wird.

Bool

[Input("Bool input")]
[Output("Bool output")]
[Default("True")]
public InOutArgument<bool> Bool { get; set; }

DateTime

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

Dezimalzahl

[Input("Decimal input")]
[Output("Decimal output")]
[Default("23.45")]
public InOutArgument<decimal> Decimal { get; set; }

Doppelt

[Input("Double input")]
[Output("Double output")]
[Default("252.2")]
public InOutArgument<double> Double { get; set; }

EntityReference

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

Int

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

Zahlung

[Input("Money input")]
[Output("Money output")]
[Default("232.3")]
public InOutArgument<Money> Money { get; set; }

OptionSetValue

[Input("OptionSetValue input")]
[Output("OptionSetValue output")]
[AttributeTarget("account", "industrycode")]
[Default("3")]
public InOutArgument<OptionSetValue> OptionSetValue { get; set; }

Zeichenfolge

[Input("String input")]
[Output("String output")]
[Default("string default")]
public InOutArgument<string> String { get; set; }

ReferenceTargetAttribute

Der Attributtyp EntityReference erfordert, dass Sie den Entitätstyp, auf den verwiesen wird, mithilfe der ReferenceTargetAttribute-Klasse angeben. Das folgende Beispiel zeigt, wie die Eingabe- und Ausgabeattribute einem AccountReference-Parameter in einer benutzerdefinierten Workflowaktivität unter Verwendung des ReferenceTarget-Attributs hinzugefügt wird.

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

AttributeTargetAttribute

Der Attributtyp OptionSetValue erfordert, dass Sie die Entität und das Attribut, auf die verwiesen wird, mithilfe der AttributeTargetAttribute-Klasse angeben. Das folgende Beispiel zeigt, wie die Eingabe- und Ausgabeattribute einem OptionSetValue-Parameter in einer benutzerdefinierten Workflowaktivität unter Verwendung des AttributeTarget-Attributs hinzugefügt wird.

[Input("OptionSetValue input")]
[Output("OptionSetValue output")]
[AttributeTarget("account", "industrycode")]
[Default("3")]
public InOutArgument<OptionSetValue> OptionSetValue { get; set; }

RequiredArgumentAttribute

Sie können die Klasse System.Activities.RequiredArgumentAttributeverwenden, um anzugeben, dass ein Eingabeparameter erforderlich ist.

[RequiredArgument]
[Input("Update Next Birthdate for")]
[ReferenceTarget("contact")]
public InArgument<EntityReference> Contact { get; set; }

Siehe auch

Benutzerdefinierte Workflowaktivitäten (Workflowassemblys)
Einer benutzerdefinierten Workflowaktivität Metadaten hinzufügen
Beispiel: Eine benutzerdefinierte Workflowaktivität erstellen

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright