Condition-Element (WorkflowActions)

Artikel
09/24/2014

Letzte Änderung: Freitag, 25. Februar 2011

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente

Stellt eine Condition-Anweisung dar, die Teil eines Regelsatzes ist, der in einem deklarativen, regelbasierten, codefreien Workflow-Editor wie beispielsweise Microsoft SharePoint Designer 2010 angezeigt werden kann.

Wenn ein Workflow von einem Ereignis ausgelöst wird, das einem SharePoint-Listenelement oder -Dokumentbibliothekselement in Microsoft SharePoint Foundation 2010 entspricht, muss oft bewertet werden, welche Workflowaktion ausgeführt werden soll bzw. ob eine Aktion erforderlich ist. Mit einem Condition-Element kann diese Bewertung vom Workflow mit den vom Workflow-Editor bereitgestellten Werten und Argumenten ausgeführt werden.

Jedes Condition-Element entspricht auch einer Boolean-Methode in einer angegebenen SharePoint Foundation 2010-Workflowbibliothek. Diese Methoden werden verwendet, um von den Parametern übergebene Werte zu bewerten und true oder false zurückzugeben.

Ein Condition-Element enthält Informationen zur .NET-Assembly, in der der Condition-Code implementiert ist, sowie die für den Funktionsaufruf erforderlichen Parameter. Außerdem sind Informationen dazu enthalten, wie die Condition-Anweisung dem Workflow-Editor angezeigt werden soll.

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

Attribute

Attribut	Beschreibung
AppliesTo	Erforderlicher text-Wert. Gibt an, dass die zu bewertende Bedingungsanweisung auf eine SharePoint-Liste oder -Dokumentbibliothek angewendet wird. Durch Ändern des Werts können Sie abhängig vom SharePoint-Listentyp, dem der Workflow zugeordnet ist, eine bestimmte Bedingungsanweisung im Workflow-Editor anzeigen oder ausblenden. Bei den folgenden Werten wird die Groß-/Kleinschreibung nicht beachtet: all Gibt an, dass eine Bedingungsanweisung für alle Listen- und Dokumentbibliothektypen verfügbar ist. doclibGibt an, dass eine Bedingungsanweisung nur dann für den Workflow-Editor angezeigt wird, wenn der Workflow einer Dokumentbibliothek zugeordnet ist. Wenn der Workflow einem anderen Listentyp zugeordnet ist, wird die Bedingungsanweisung für den Workflow-Editor ausgeblendet. listGibt an, dass eine Bedingungsanweisung nur dann für den Workflow-Editor angezeigt wird, wenn der Workflow einer SharePoint-Liste zugeordnet ist. Wenn der Workflow einem anderen Typ als einem Listentyp zugeordnet ist, wird die Bedingungsanweisung für den Workflow-Editor ausgeblendet. none Gibt an, dass eine Bedingungsanweisung für den Workflow-Editor ausgeblendet wird.
Assembly	Erforderlicher text-Wert. Gibt die .NET-Assembly an, die den Implementierungscode für das Condition-Element enthält. Werttyp: String. Gibt die .NET-Assembly an, die den Workflowcode enthält. Das Format sollte wie folgt aussehen: Assemblyname, Version, Kultur, öffentliches Schlüsseltoken Beispiel: Assembly="Microsoft.SharePoint.WorkflowActions, Version=12.0.0.0, Culture=neutral, PublicKeyToken= 71e9bce111e9429c"
ClassName	Erforderlicher text-Wert. Enthält den vollqualifizierten Namen der Klasse, in der der Condition-Elementcode implementiert wird. Werttyp: String. Vollqualifizierter Name der Klasse, in der der benutzerdefinierte Condition-Elementcode implementiert wird. Beispiel: XML: ClassName=”Microsoft.SharePoint.WorkflowActions.Helper"
FunctionName	Erforderlicher text-Wert. Name der Boolean-Methode in der Klasse, von der der Condition-Code implementiert wird. Werttyp: String. Stellt den Methodennamen in der Klasse dar, in der der Condition-Elementcode implementiert wird. Example method: Bool myCondition(WorkflowContext context, string ListGUIDorName, int ItemWorkflowAttachedTo) XML: FunctionName="myCondition"
Type	Optionaler text-Wert. Gibt an, ob das Condition-Element Custom oder Advanced ist. Bei den folgenden Werten wird die Groß-/Kleinschreibung nicht beachtet: CustomWird verwendet, um einen im aktuellen SharePoint-Listenelement oder -Dokumentbibliothekselement gefundenen Wert mit einem durch den Workflow-Designer angegebenen Wert zu vergleichen. Advanced Wird verwendet, um anzugeben, dass eine Condition verwendet werden kann, um zwei Werte eines beliebigen Typs (beispielsweise Text, ganze Zahlen und Datumswerte) zu vergleichen.
UsesCurrentItem	Optionaler Boolean-Wert. Gibt an, dass das zurzeit ausgewählte Element dem Workflow zugeordnet ist. Werttyp: Boolean. Wenn der Wert auf true festgelegt ist, wird der Workflow an das SharePoint-Listenelement oder -Dokumentbibliothekselement gebunden, von dem die Workflowinstanz gestartet wurde. Bei Verwendung eines deklarativen, codefreien Workflow-Editors gibt dieser Wert immer true zurück und kann nicht geändert werden.

Untergeordnete Elemente

RuleDesigner

Parameters

Übergeordnete Elemente

Conditions

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie ein Condition-Element während des Workflowentwurfsprozesses für den codefreien Editor verfügbar machen.

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

Siehe auch

Konzepte

Übersicht über das Workflowaktivitätsschema

Erstellen deklarativer Workflow-Editoren ohne Code

Weitere Ressourcen

Conditions-Element

Freigeben über