Partager via


Condition, élément (WorkflowActions)

Dernière modification : vendredi 25 février 2011

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents

Représente une instruction Condition, qui fait partie d’une phrase de règle pouvant être affichée dans un éditeur de flux de travail déclaratif, sans code et basé sur des règles, tel que Microsoft SharePoint Designer 2010.

Lorsqu’un flux de travail est déclenché par un événement qui correspond à un élément de bibliothèque de documents ou de liste SharePoint dans Microsoft SharePoint Foundation 2010, il est souvent impératif de déterminer l’action de flux de travail à appliquer ou d’évaluer la nécessité d’une action. Un élément Condition permet au flux de travail d’effectuer cette évaluation à partir des valeurs et des arguments fournis à celui-ci par l’éditeur de flux de travail.

Chaque élément Condition correspond à une méthode Boolean dans une bibliothèque de flux de travail SharePoint Foundation 2010 spécifiée. Ces méthodes permettent d’évaluer les valeurs passées par leurs paramètres et de retourner la valeur true ou false.

Un élément Condition contient des informations sur l'assembly .NET dans lequel le code Condition est implémenté, ainsi que les paramètres nécessaires à l'appel des fonctions. Il contient également des informations sur la façon dont l'instruction Condition doit être affichée à l'éditeur de flux de travail.

<WorkflowInfo>
      <Conditions>
            <Condition>
               <RuleDesigner>…</RuleDesigner>
               <Paramaters>…</Parameters>
            </Condition>
            <Default>…</Default>
      </Conditions>
      <Action>…</Actions>
</WorkflowInfo>

Attributs

Attribut

Description

AppliesTo

Argument text obligatoire. Spécifie que l'instruction conditionnelle évaluée est appliquée à une bibliothèque de documents ou à une liste SharePoint. En modifiant la valeur, vous pouvez afficher ou masquer une instruction conditionnelle spécifique dans l'éditeur de flux de travail, en fonction du type de liste SharePoint auquel le flux de travail est associé.

Les valeurs suivantes ne respectent pas la casse :

  • all   Indique qu'une instruction conditionnelle est disponible pour tous les types de bibliothèques de documents et de listes.

  • doclib   Indique qu'une instruction conditionnelle n'est visible par l'éditeur de flux de travail que lorsque le flux est associé à une bibliothèque de documents. Si le flux est associé à un autre type de liste, l'instruction conditionnelle est masquée à l'éditeur de flux de travail.

  • list   Indique qu'une instruction conditionnelle n'est visible par l'éditeur de flux de travail que lorsque le flux est associé à une liste SharePoint. Si le flux est associé à un type autre qu'un type de liste, l'instruction conditionnelle est masquée à l'éditeur de flux de travail.

  • none   Indique qu'une instruction conditionnelle est masquée à l'éditeur de flux de travail.

Assembly

Argument text obligatoire. Spécifie l'assembly .NET qui contient le code d'implémentation de l'élément Condition.

Type de valeur : String.

Spécifie l'assembly .NET qui contient le code de flux de travail. Le format doit être le suivant :

Nom de l'assembly, Version, Culture, Jeton de clé publique

Exemple :

Assembly="Microsoft.SharePoint.WorkflowActions,

Version=12.0.0.0,

Culture=neutre,

Jeton de clé publique= 71e9bce111e9429c"

ClassName

Argument text obligatoire. Contient le nom de classe complet dans lequel le code de l'élément Condition est implémenté.

Type de valeur : String.

Nom complet de la classe dans laquelle le code de l'élément Condition personnalisé est implémenté.

Exemple :

XML :

ClassName=”Microsoft.SharePoint.WorkflowActions.Helper"

FunctionName

Argument text obligatoire. Nom de la méthode Boolean dans la classe qui implémente le code Condition.

Type de valeur : String.

Représente le nom de méthode dans la classe où le code de l'élément Condition est implémenté.

Example method :

Bool myCondition(WorkflowContext context, string ListGUIDorName, int ItemWorkflowAttachedTo)

XML :

FunctionName="myCondition"

Type

Argument text facultatif. Indique si l'élément Condition est Custom ou Advanced.

Les valeurs suivantes ne respectent pas la casse :

  • Custom   Permet de comparer une valeur trouvée dans l'élément de bibliothèque de documents ou de liste SharePoint actuel à une valeur spécifiée par le concepteur de flux de travail.

  • Advanced   Permet d'indiquer qu'un élément Condition peut être utilisé pour comparer deux valeurs de n'importe quel type (par exemple, texte, entiers et dates).

UsesCurrentItem

Argument Boolean facultatif. Indique que l'élément actuellement sélectionné est associé au flux de travail.

Type de valeur : Boolean

Si la valeur est true, le flux de travail est lié à l'élément de liste SharePoint ou à l'élément de bibliothèque de documents qui a démarré l'instance de flux de travail. Lorsque vous utilisez un éditeur de flux de travail déclaratif sans code, cette valeur retourne toujours true et ne peut pas être modifiée.

Éléments enfants

RuleDesigner

Parameters

Éléments parents

Conditions

Exemple

L'exemple suivant montre comment exposer un élément Condition à l'éditeur sans code au cours du processus de conception de flux de travail.

<WorkflowInfo Language="en-us">
   <Conditions And="and" Or="or" Not="not" When="If" Else="ElseIf">
      <Condition 
              AppliesTo="list" 
              Assembly="MyWorkflowProject.Workflow1,
                        PublicKeyToken=71e9bce111e9429c,
                        Version=1.0.0.0,
                        Culture=neutral" 
              ClassName="MyWorkflowProject.Workflow1.MyClass"
              FunctionName="IsOrderComplete" 
              Name="Check if item in %1 is a complete order"
              Type="Custom"
              UsesCurrentItem="True">
          <RuleDesigner>...</RuleDesigner>
      </Condition>
   </Conditions>
</WorkflowInfo>

Voir aussi

Concepts

Vue d'ensemble du schéma d'actions de flux de travail

Création d'éditeurs de flux de travail déclaratifs et sans code

Autres ressources

Conditions, élément