Ajouter des métadonnées à une activité de workflow personnalisée

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

L’assembly contenant la définition d’activité de workflow personnalisée est annoté à l’aide des attributs .NET pour fournir les métadonnées que Microsoft Dynamics 365 utilise au moment de l’exécution pour lier votre code au moteur de workflow. Pour plus d’informations sur les attributs .NET, consultez Extension des métadonnées à l’aide d’attributs.

Avant de commencer à ajouter des métadonnées à votre définition d’activité de workflow personnalisée, assurez-vous de connaître les types et les attributs Microsoft Dynamics 365 pris en charge pour les activités de workflow personnalisées.Pour plus d'informations : voir Classes, attributs et types de processus

Contenu de la rubrique

Ajouter des paramètres d’entrée

Ajouter des paramètres de sortie

Ajouter des attributs d’entrée et de sortie pour le même paramètre

Attributs supplémentaires

Ajouter la méthode Execute

Ajouter des paramètres d’entrée

Lorsque vous spécifiez le paramètre d’entrée dans votre classe de workflow, vous pouvez également définir une valeur par défaut pour le paramètre. L’exemple suivant illustre la définition d’un paramètre d’entrée.

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

Ce paramètre d’entrée est annoté à l’aide de l’attribut .NETInput. La classe InputAttribute dérive de la classe ParameterAttribute, qui accepte un paramètre (ParameterAttribute.Name) pour spécifier le nom de l’attribut d’entrée. Ce nom apparaît dans l’Assistant Formulaire de processus de l’application Web. Cela vous permet de mapper un attribut comme paramètre d’entrée du processus.

En outre, vous pouvez rendre ce paramètre d’entrée obligatoire.Pour plus d'informations :RequiredArgumentAttribute

Ajouter des paramètres de sortie

Les paramètres de sortie sont ajoutés de la même manière que les paramètres d’entrée. L’exemple suivante illustre la définition d’un paramètre de sortie.

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

Ce paramètre de sortie est annoté à l’aide de l’attribut .NETOutput. La classe OutputAttribute dérive de la classe ParameterAttribute, qui accepte un paramètre (ParameterAttribute.Name) pour spécifier le nom de l’attribut de sortie. Ce nom apparaît dans l’Assistant Formulaire de processus de l’application Web. Cela vous permet de mapper un attribut comme sortie.

Ajouter des attributs d’entrée et de sortie pour le même paramètre

Vous pouvez utiliser les attributs d’entrée et de sortie pour le même paramètre. Dans l’exemple de code suivant, IntParameter représente le paramètre d’entrée et de sortie.

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

Attributs supplémentaires

Certains types, tels que EntityReference et OptionSetValue, nécessitent des attributs supplémentaires, en plus des attributs Input, Output et Default. Les attributs supplémentaires sont : ReferenceTarget et AttributeTarget. L’exemple suivante illustre la définition d’un paramètre du type EntityReference.

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

Pour obtenir la liste des types et attributs pris en charge, consultez Classes, attributs et types de processus.

Ajouter la méthode Execute

Votre activité de workflow personnalisée doit disposer d’une méthode Execute, comme illustré dans l’exemple suivant.

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

Voir aussi

Activités de workflow personnalisées (assemblys de workflow)
Activités de workflow personnalisées (assemblys de workflow)
Créer une activité de workflow personnalisée
Utiliser le service Web IOrganization dans une activité de workflow personnalisée
Exemple : créer une activité de workflow personnalisée
Classes, attributs et types de processus

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright