Action-Element (WorkflowInfo)
Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013
Enthält die Informationen, die für die Workflow-Engine zum Verarbeiten einer Workflowaktivität benötigt werden, die in Microsoft SharePoint Foundation 2010 als Aktion bezeichnet wird. Ein Workflowaktionselement stellt eine Workflowaktivität dar, z. B. das Senden von E-Mail-Benachrichtigungen, das Aktualisieren von SharePoint Foundation 2010-Listenelementen, das Erstellen und Zuweisen von Aufgaben und viele andere Aktivitäten.
Standardmäßig bietet SharePoint Foundation 2010 23 integrierte Workflowaktionen. Diese werden im WSS definiert. ACTIONS-Datei.
Definition
<Actions>
<Action>
<Parameters>
</Parameters>
<RuleDesigner>
</RuleDesigner>
<DataSources>
</DataSources>
<Modifications>
<Modification>
</Modification>
</Modifications>
<ActionVariables>
</ActionVariables>
<ActionBody>
</ActionBody>
<ActionConditions>
</ActionConditions>
</Action>
</Actions>
Elemente und Attribute
In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.
Attribute
Attribut |
Beschreibung |
---|---|
**Namen** |
Erforderlich **text**. Stellt die Beschreibung der Workflowaktion dar, die dem Workflow- Editor angezeigt wird. |
**Classname** |
Erforderlich **text**. Vollqualifizierter Name der Klasse, die die Workflowaktion implementiert; Beispiel: **Microsoft.SharePoint.WorkflowActions.EmailActivity**. |
**Versammlung** |
Erforderlich **text**. Der Microsoft .NET-Assemblyname, der Anweisungen zum Implementieren des **Action**-Elements enthält. Der Text sollte PublicKeyToken, Version und Culture enthalten. |
**Functionname** |
Optional **text**. Gibt bei Sandkastenlösungen den Namen einer aufzurufenden Funktion an. |
**Kategorie** |
Optional **text**. Stellt eine Kategorie für die Workflowaktion bereit. Dieser **Text** wird verwendet, um die Liste der verfügbaren Aktionen zu filtern. |
**CreatesTask** |
Optional **Boolean**. Bei Festlegung auf **true** wird im Workflow ein Aufgabenlistenelement erstellt. Wenn sie leer gelassen wird, ist die Annahme **false**, und es werden keine Aufgabenlistenelemente erstellt. |
**CreatesInList** |
Optional **text**. Wenn ein Wert für dieses Attribut festgelegt ist, erstellt der Workflow ein Element in einer Liste. Werte müssen einem Parameternamen zugeordnet werden, der die **ID** der Liste oder Dokumentbibliothek enthält. |
**Appliesto** |
Erforderlich **text**. Gibt an, ob diese Workflowaktion für Listen, Dokumentbibliotheken oder beides verfügbar sein soll. Gültige Werte sind **list**, **doclib** und **all**. |
**Iserror** |
Optional **Boolean**. Wenn dieser Wert auf **true** festgelegt ist, werden Instanzen dieses **Action**-Elements von der Clientanwendung als Fehler angesehen. |
**ListModeration** |
Optional **Boolean**. Bei Festlegung auf **true** gilt dieses **Action**-Element für eine Liste oder Dokumentbibliothek, für die die Inhaltsgenehmigung aktiviert ist. Wenn sie leer gelassen wird, lautet die Annahme **false**. |
**UsesCurrentItem** |
Optional **Boolean**. Bei Festlegung auf **true** gibt an, dass das aktuelle Element verwendet oder geändert werden soll. Wenn auf **false** festgelegt oder leer gelassen wird, verwendet dieses **Action**-Element nur das angegebene SharePoint-Listen- oder Dokumentbibliothekselement. |
**CreatedTaskFormType** |
Optional **text**. Gibt den Typ einer erstellten Aufgabe an: **DataCollectTask** zum Erstellen einer Aufgabe, die Daten von einem Benutzer sammelt; **GroupAssignedTask** zum Erstellen einer Aufgabe, die Daten von einem oder mehreren Benutzern sammelt; **TodoItemTask** zum Erstellen einer Aufgabe, die keine Daten von Benutzern sammelt, sondern nur für einen Benutzer vorhanden ist, um zu überprüfen, ob er etwas getan hat; oder **TaskProcess**, um eine Aufgabe zu erstellen, die über ein Formular verfügt, das die Ad-hoc-Zusammenarbeit ermöglicht und möglicherweise Daten von einem oder mehreren Benutzern sammelt. |
**__Solutionid** |
Optional **text**. Gibt eine GUID an, die die Clientanwendung in die implementierungsspezifische Aktion schreibt. Der Server verwendet die GUID, um die Assembly zur Laufzeit des Workflows zu finden. |
**SandboxedFunction** |
Optional **Boolean**. Bei Festlegung auf **true** fügt die Clientanwendung eine implementierungsspezifische Aktion ein, wenn diese Aktion ausgewählt ist. Die Aktion sollte so konfiguriert werden, dass eine Funktion aufgerufen wird, die durch die Konjunktion von **AssemblyName**, **ClassName** und **FunctionName** definiert wird. Wenn festgelegt, müssen **AssemblyName**, **ClassName**, **FunctionName** und **__SolutionId** ebenfalls festgelegt werden. |
Untergeordnete Elemente
Übergeordnete Elemente
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie ein Action-Element so erstellt wird, dass 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>