Association-Element (WorkflowConfig)
Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Enthält die Informationen, die für einen deklarativen regelbasierten, codefreien Workflow-Editor wie Microsoft SharePoint Designer 2010 erforderlich sind, um der angegebenen SharePoint-Liste in SharePoint Foundation eine Workflowvorlage zuzuordnen.
Definition
<Association
ListID="Text"
TaskListID="Text"
HistoryListID="Text"
StartManually="true" | "false"
StartOnCreate="true" | "false"
StartOnChange="true" | "false"
>
</Association>
Elemente und Attribute
In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.
Attribute
Attribut |
Beschreibung |
---|---|
**ListID** |
Erforderlich **Text**. Gibt die GUID der Liste an, der der Workflow zugeordnet werden soll. |
**TaskListID** |
Erforderlich **Text**. Gibt die GUID der Aufgabenliste an, die der Workflow für Workflowaufgaben verwenden soll, falls vorhanden. |
**HistoryListID** |
Optional **Text**. Gibt die GUID der Verlaufsliste an, die der Workflow zum Protokollieren von Ereignissen zum Workflowverlauf verwenden soll, falls vorhanden. Falls nichts angegeben ist, protokolliert der Workflow die Ereignisse zum Workflowverlauf in der Standardverlaufsliste. |
**StartManually** |
Optional **Boolean**. Wenn diese Einstellung auf true festgelegt ist, kann der Workflow von Benutzern manuell gestartet werden. Wenn dieses Attribut nicht vorhanden ist, behandelt SharePoint Foundation den Workflow so, als wäre dieses Attribut auf false festgelegt. |
**StartOnCreate** |
Optional **Boolean**. Wenn dieser Wert auf TRUE festgelegt ist, startet SharePoint Foundation den Workflow automatisch, wenn ein neues Element in der Liste erstellt wird, der der Workflow zugeordnet ist. Wenn dieses Attribut nicht vorhanden ist, behandelt SharePoint Foundation den Workflow so, als wäre dieses Attribut auf false festgelegt. |
**StartOnChange** |
Optional **Boolean**. Wenn diese Einstellung auf true festgelegt ist, startet SharePoint Foundation den Workflow automatisch, wenn ein Element in der Liste geändert wird, der der Workflow zugeordnet ist. Wenn dieses Attribut nicht vorhanden ist, behandelt SharePoint Foundation den Workflow so, als wäre dieses Attribut auf false festgelegt. |
Untergeordnete Elemente
Keine |
Übergeordnete Elemente
Element |
---|
WorkflowConfig-Element |
Hinweise
Nachdem der Workflow einer bestimmten SharePoint-Liste zugeordnet wurde, werden die Werte der folgenden Attribute im SPWorkflowAssociation-Objekt für den Workflow gespeichert:
Der StartManually-Attributwert wird in der AllowManual-Eigenschaft gespeichert.
Der StartOnCreate-Attributwert wird in der AutoStartCreate-Eigenschaft gespeichert.
Der StartOnChange-Attributwert wird in der AutoStartChange-Eigenschaft gespeichert.
Der HistoryListID-Attributwert wird in der HistoryListId-Eigenschaft gespeichert.
Der TaskListID-Attributwert wird in der TaskListId-Eigenschaft gespeichert.
Anwendungen, die als deklarativer regelbasierter, codefreier Workflow-Editor erstellt wurden, können die AssociateWorkflowMarkup(String, String) -Methode des websvcWebPartPages-Webdiensts verwenden, um eine Workflowvorlage zu erstellen und sie einer SharePoint-Liste zuzuordnen, die eine Workflowmarkupdatei, eine Workflowkonfigurationsdatei und optional eine Markupdatei für Workflowregeln angibt.
Weitere Informationen zum Erstellen einer Anwendung, die als deklarativer regelbasierter Workflow-Editor ohne Code verwendet werden kann, finden Sie unter Creating Declarative, No-Code Workflow Editors.
Beispiel
Im folgenden Beispiel wird ein Association-Element für eine Workflowkonfiguration gezeigt. Die Elementattribute geben die SharePoint-Liste an, der der Workflow zugeordnet ist, die vom Workflow verwendete Aufgabenliste, dass der Workflow manuell gestartet werden kann und dass der Workflow automatisch gestartet wird, wenn ein neues Element in der Liste erstellt wird.
<Association
ListID="{B8C6FEEA-8066-462E-958D-1B4E90FE1C34}"
TaskListID="{C64BA541-9D5B-42F3-A989-96F56FD51155}"
StartManually="true"
StartOnCreate="true"
>