Élément Condition (WorkflowInfo)

Article
04/08/2023

S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

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

Lorsqu’un flux de travail est déclenché par un événement qui correspond à une liste SharePoint ou à un élément de bibliothèque de documents dans Microsoft SharePoint Foundation 2010, il est souvent nécessaire d’évaluer l’action de flux de travail à entreprendre ou si une action est requise. Un élément Condition permet au flux de travail d’effectuer cette évaluation avec les valeurs et arguments qui lui sont fournis par l’éditeur de workflow.

Chaque élément Condition correspond également à une méthode booléenne à l’intérieur d’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 Microsoft .NET dans lequel le code Condition est implémenté, ainsi que sur les paramètres requis pour effectuer l’appel de fonction. Il contient également des informations sur la façon dont l'instruction Condition doit être affichée à l'éditeur de flux de travail.

Définition

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

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut	Description
AppliesTo	textrequis. Spécifie que l’instruction conditionnelle en cours d’évaluation est appliquée à une liste ou une bibliothèque de documents 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 spécifie qu’une instruction de condition est disponible pour tous les types de liste et de bibliothèque de documents. doclib spécifie qu’une instruction de condition est visible par l’éditeur de workflow uniquement lorsque le flux de travail 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 spécifie qu’une instruction de condition est visible par l’éditeur de flux de travail uniquement lorsque le flux de travail 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 spécifie qu’une instruction de condition est masquée dans l’éditeur de workflow.
Assemblée	textrequis. 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, PublicKeyToken= 71e9bce111e9429c>
Classname	textrequis. Contient le nom de classe complet dans lequel le code d’élément Condition est implémenté. Type de valeur : String. Nom de classe complet dans lequel le code d’élément Condition personnalisé est implémenté. Exemple : XML: ClassName=>Microsoft.SharePoint.WorkflowActions.Helper>
Functionname	textrequis. Nom de la méthode Boolean dans la classe qui implémente le code Condition. Type de valeur : String. Représente le nom de la méthode dans la classe dans laquelle le code d’élément Condition est implémenté. Exemple de méthode : 'Bool myCondition(WorkflowContext context, string ListGUIDorName, int ItemWorkflowAttachedTo)' XML: FunctionName=>> myCondition
ItemKeyType	textfacultatif. Identificateur spécifique à l’implémentation pour le type d’objet par défaut.
Nom	textrequis. Spécifie un nom de condition localisé.
Type	textfacultatif. Spécifie si l’élément Condition est Personnalisé ou Avancé. Les valeurs suivantes ne respectent pas la casse : Personnalisé Utilisé pour comparer une valeur trouvée dans la liste SharePoint ou l’élément de bibliothèque de documents actuel à une valeur spécifiée par le concepteur de flux de travail. Avancé Utilisé pour indiquer qu’une Condition peut être utilisée pour comparer deux valeurs de n’importe quel type (par exemple, texte, entiers et dates).
UsesCurrentItem	Facultatif Boolean. Indique que l'élément actuellement sélectionné est associé au flux de travail. Type de valeur : Boolean. S’il est défini sur 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. Lors de l’utilisation d’un éditeur de flux de travail déclaratif et sans code, cette valeur retourne toujours true et ne peut pas être modifiée.

Éléments enfants

RuleDesigner

Paramètres

É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>

Attribut	Description
AppliesTo	textrequis. Spécifie que l’instruction conditionnelle en cours d’évaluation est appliquée à une liste ou une bibliothèque de documents 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 spécifie qu’une instruction de condition est disponible pour tous les types de liste et de bibliothèque de documents. doclib spécifie qu’une instruction de condition est visible par l’éditeur de workflow uniquement lorsque le flux de travail 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 spécifie qu’une instruction de condition est visible par l’éditeur de flux de travail uniquement lorsque le flux de travail 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 spécifie qu’une instruction de condition est masquée dans l’éditeur de workflow.
Assemblée	textrequis. 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, PublicKeyToken= 71e9bce111e9429c>
Classname	textrequis. Contient le nom de classe complet dans lequel le code d’élément Condition est implémenté. Type de valeur : String. Nom de classe complet dans lequel le code d’élément Condition personnalisé est implémenté. Exemple : XML: ClassName=>Microsoft.SharePoint.WorkflowActions.Helper>
Functionname	textrequis. Nom de la méthode Boolean dans la classe qui implémente le code Condition. Type de valeur : String. Représente le nom de la méthode dans la classe dans laquelle le code d’élément Condition est implémenté. Exemple de méthode : 'Bool myCondition(WorkflowContext context, string ListGUIDorName, int ItemWorkflowAttachedTo)' XML: FunctionName=>> myCondition
ItemKeyType	textfacultatif. Identificateur spécifique à l’implémentation pour le type d’objet par défaut.
Nom	textrequis. Spécifie un nom de condition localisé.
Type	textfacultatif. Spécifie si l’élément Condition est Personnalisé ou Avancé. Les valeurs suivantes ne respectent pas la casse : Personnalisé Utilisé pour comparer une valeur trouvée dans la liste SharePoint ou l’élément de bibliothèque de documents actuel à une valeur spécifiée par le concepteur de flux de travail. Avancé Utilisé pour indiquer qu’une Condition peut être utilisée pour comparer deux valeurs de n’importe quel type (par exemple, texte, entiers et dates).
UsesCurrentItem	Facultatif Boolean. Indique que l'élément actuellement sélectionné est associé au flux de travail. Type de valeur : Boolean. S’il est défini sur 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. Lors de l’utilisation d’un éditeur de flux de travail déclaratif et sans code, cette valeur retourne toujours true et ne peut pas être modifiée.

Partager via