Condition-Element (WorkflowInfo)

Artikel
04/08/2023

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013

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

Wenn ein Workflow durch ein Ereignis ausgelöst wird, das einem SharePoint-Listen- oder Dokumentbibliothekselement in Microsoft SharePoint Foundation 2010 entspricht, muss häufig ausgewertet werden, welche Workflowaktion ausgeführt werden soll oder ob eine Aktion erforderlich ist. Mit einem Condition-Element kann der Workflow diese Auswertung mit den Werten und Argumenten ausführen, die vom Workflow-Editor bereitgestellt werden.

Jedes Condition-Element entspricht auch einer booleschen Methode innerhalb 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 Microsoft .NET-Assembly, in der der Condition-Code implementiert ist, sowie die Parameter, die zum Ausführen des Funktionsaufrufs erforderlich sind. Außerdem sind Informationen dazu enthalten, wie die Condition-Anweisung dem Workflow-Editor angezeigt werden soll.

Definition

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

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Attribut	Beschreibung
Appliesto	Erforderlich text. Gibt an, dass die bedingte Anweisung, die ausgewertet wird, 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 Dokumentbibliothekstypen verfügbar ist. doclib gibt an, dass eine Bedingungsanweisung nur dann für den Workflow-Editor sichtbar ist, wenn der Workflow einer Dokumentbibliothek zugeordnet ist. Wenn der Workflow einem anderen Listentyp zugeordnet ist, wird die Bedingungsanweisung für den Workflow-Editor ausgeblendet. list gibt an, dass eine Bedingungsanweisung nur dann für den Workflow-Editor sichtbar ist, 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 im Workflow-Editor ausgeblendet wird.
Versammlung	Erforderlich text. 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	Erforderlich text. Enthält den vollqualifizierten Klassennamen, in dem der Condition-Elementcode implementiert ist. Werttyp: String. Vollqualifizierter Klassenname, in dem der benutzerdefinierte Condition-Elementcode implementiert ist. Beispiel: XML: ClassName=>Microsoft.SharePoint.WorkflowActions.Helper>
Functionname	Erforderlich text. Name der Boolean-Methode in der Klasse, die den Condition-Code implementiert. Werttyp: String. Stellt den Methodennamen in der Klasse dar, in der der Condition-Elementcode implementiert ist. Beispielmethode: "Bool myCondition(WorkflowContext context, string ListGUIDorName, int ItemWorkflowAttachedTo)" XML: FunctionName=>myCondition>
ItemKeyType	Optional text. Der implementierungsspezifische Bezeichner für den Standardobjekttyp.
Namen	Erforderlich text. Gibt einen lokalisierten Bedingungsnamen an.
Typ	Optional text. Gibt an, ob das Condition-Element Custom oder Advanced ist. Bei den folgenden Werten wird die Groß-/Kleinschreibung nicht beachtet: Benutzerdefiniert Wird verwendet, um einen Wert aus dem aktuellen SharePoint-Listen- oder Dokumentbibliothekselement mit einem vom Workflow-Designer angegebenen Wert zu vergleichen. Erweitert Wird verwendet, um anzugeben, dass eine Bedingung verwendet werden kann, um zwei Werte eines beliebigen Typs (z. B. Text, ganze Zahlen und Datumsangaben) zu vergleichen.
UsesCurrentItem	Optional Boolean. Gibt an, dass das zurzeit ausgewählte Element dem Workflow zugeordnet ist. Werttyp: Boolean. Bei Festlegung auf true wird der Workflow an das SharePoint-Listenelement oder Dokumentbibliothekselement gebunden, das die Workflowinstanz gestartet hat. Bei Verwendung eines deklarativen, codefreien Workflow-Editors gibt dieser Wert immer true zurück und kann nicht geändert werden.

Untergeordnete Elemente

RuleDesigner

Parameter

Übergeordnete Elemente

Bedingungen:

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>

Attribut	Beschreibung
Appliesto	Erforderlich text. Gibt an, dass die bedingte Anweisung, die ausgewertet wird, 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 Dokumentbibliothekstypen verfügbar ist. doclib gibt an, dass eine Bedingungsanweisung nur dann für den Workflow-Editor sichtbar ist, wenn der Workflow einer Dokumentbibliothek zugeordnet ist. Wenn der Workflow einem anderen Listentyp zugeordnet ist, wird die Bedingungsanweisung für den Workflow-Editor ausgeblendet. list gibt an, dass eine Bedingungsanweisung nur dann für den Workflow-Editor sichtbar ist, 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 im Workflow-Editor ausgeblendet wird.
Versammlung	Erforderlich text. 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	Erforderlich text. Enthält den vollqualifizierten Klassennamen, in dem der Condition-Elementcode implementiert ist. Werttyp: String. Vollqualifizierter Klassenname, in dem der benutzerdefinierte Condition-Elementcode implementiert ist. Beispiel: XML: ClassName=>Microsoft.SharePoint.WorkflowActions.Helper>
Functionname	Erforderlich text. Name der Boolean-Methode in der Klasse, die den Condition-Code implementiert. Werttyp: String. Stellt den Methodennamen in der Klasse dar, in der der Condition-Elementcode implementiert ist. Beispielmethode: "Bool myCondition(WorkflowContext context, string ListGUIDorName, int ItemWorkflowAttachedTo)" XML: FunctionName=>myCondition>
ItemKeyType	Optional text. Der implementierungsspezifische Bezeichner für den Standardobjekttyp.
Namen	Erforderlich text. Gibt einen lokalisierten Bedingungsnamen an.
Typ	Optional text. Gibt an, ob das Condition-Element Custom oder Advanced ist. Bei den folgenden Werten wird die Groß-/Kleinschreibung nicht beachtet: Benutzerdefiniert Wird verwendet, um einen Wert aus dem aktuellen SharePoint-Listen- oder Dokumentbibliothekselement mit einem vom Workflow-Designer angegebenen Wert zu vergleichen. Erweitert Wird verwendet, um anzugeben, dass eine Bedingung verwendet werden kann, um zwei Werte eines beliebigen Typs (z. B. Text, ganze Zahlen und Datumsangaben) zu vergleichen.
UsesCurrentItem	Optional Boolean. Gibt an, dass das zurzeit ausgewählte Element dem Workflow zugeordnet ist. Werttyp: Boolean. Bei Festlegung auf true wird der Workflow an das SharePoint-Listenelement oder Dokumentbibliothekselement gebunden, das die Workflowinstanz gestartet hat. Bei Verwendung eines deklarativen, codefreien Workflow-Editors gibt dieser Wert immer true zurück und kann nicht geändert werden.

Freigeben über