Action-Element (WorkflowActions)

Artikel
09/24/2014

Letzte Änderung: Montag, 28. Februar 2011

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente

Enthält die vom Workflowmodul benötigten Informationen zum Verarbeiten einer Workflowaktivität, die in Microsoft SharePoint Foundation 2010 als Aktion bezeichnet wird. Das Workflowelement Action stellt eine Workflowaktivität, z. B. das Senden von E-Mail-Benachrichtigungen, Aktualisieren von SharePoint Foundation 2010-Listenelementen, Erstellen und Zuweisen von Aufgaben, sowie zahlreiche andere Aktivitäten dar.

SharePoint Foundation 2010 bietet standardmäßig 23 vordefinierte Workflowaktionen, die in der Datei WSS.ACTIONS definiert sind.

<Actions>
    <Action>
    </Action>
</Actions>

Attribute

Attribut	Beschreibung
Name	Erforderlicher text-Wert. Stellt die Beschreibung der Workflowaktion dar, die dem Workflow- Editor angezeigt wird.
ClassName	Erforderlicher text-Wert. Der vollqualifizierte Name der Klasse, die die Workflowaktion implementiert. Beispiel: Microsoft.SharePoint.WorkflowActions.EmailActivity.
Assembly	Erforderlicher text-Wert. Der Name der .NET-Assembly, die Anweisungen zum Implementieren des Action-Elements enthält. Der Text muss die Elemente PublicKeyToken, Version und Culture enthalten.
Category	Optionaler text-Wert. Stellt eine Kategorie für die Workflowaktion bereit. Dieser text-Wert dient zum Filtern der Liste verfügbarer Aktionen.
CreatesTask	Optionaler Boolean-Wert. Bei Festlegung auf true wird ein Aufgabenlistenelement im Workflow erstellt. Falls leer gelassen, wird false vorausgesetzt, sodass keine Aufgabenlistenelemente erstellt werden.
CreatesInList	Optionaler text-Wert. Wenn ein Wert für dieses Attribut festgelegt ist, erstellt der Workflow ein Element in einer Liste. Werte müssen einem Parameternamen zugeordnet sein, der die ID der Liste oder Dokumentbibliothek enthält.
AppliesTo	Erforderlicher text-Wert. Gibt an, ob diese Workflowaktion für Listen, Dokumentbibliotheken oder beides verfügbar sein soll. Gültige Werte sind list, doclib und all.
ListModeration	Optionaler Boolean-Wert. Bei Festlegung auf true gilt dieses Action-Element für eine Liste oder Dokumentbibliothek, für welche die Inhaltsgenehmigung aktiviert ist. Falls leer, wird false angenommen.
UsesCurrentItem	Optionaler Boolean-Wert. Gibt bei Festlegung auf true an, dass das aktuelle Element verwendet oder geändert werden muss. Falls auf false festgelegt oder leer gelassen, verwendet dieses Action-Element nur das angegebene SharePoint-Listen- oder Dokumentbibliothekselement.

Untergeordnete Elemente

RuleDesigner

Parameters

Übergeordnete Elemente

Actions

Beispiel

Das folgende Codebeispiel veranschaulicht das Erstellen eines Action-Elements, damit es im Workflow-Editor angezeigt wird. Beachten Sie, dass diese XML-Datei zur Verbesserung der Lesbarkeit geändert wurde.

<WorkflowInfo>
  <Conditions>…</Conditions>
  <Actions Sequential="then" Parallel="and">
    <Action Name="Update my custom SharePoint list"
            ClassName="CustomActivities.OrderListFunctions"
            Assembly="CustomActivities,      
                      PublicKeyToken=b03f5f7f11d50a3a, 
                      Version=1.0.0.0, 
                      Culture=neutral"
            Category="My Custom Actions"
            CreatesTask="true"
            CreatesInList="UpdateList"
            AppliesTo="all"
            ListModeration="false"
            UsesCurrentItem="true">
      <RuleDesigner Sentence="Update %1">
        <FieldBind Field="UpdateList"
                   Function="UpdateOrderList"
                   DesignerType="ChooseListItem"
                   ID="1"
                   Text="My Custom List">
        </FieldBind>
      </RuleDesigner>
      <Parameters>
        <Parameter Type="System.String, mscorlib"
                   Direction="In"
                   Name="UpdateList"
        </Parameters>
    </Action>
  </Actions>
</WorkflowInfo>