Élément Association (WorkflowConfig)

S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | SharePoint Server 2013

Contient les informations nécessaires à un éditeur de flux de travail sans code basé sur des règles déclaratives, tel que Microsoft SharePoint Designer 2010, pour associer un modèle de flux de travail à la liste SharePoint spécifiée dans SharePoint Foundation.

Définition

<Association
  ListID="Text"
  TaskListID="Text"
  HistoryListID="Text"
  StartManually="true" | "false"
  StartOnCreate="true" | "false"
  StartOnChange="true" | "false"
>
</Association>

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut

Description

**ListID**

Obligatoire **Text**. Spécifie le GUID de la liste à laquelle le workflow doit être associé.

**TaskListID**

Obligatoire **Text**. Spécifie le GUID de la liste des tâches que le flux de travail doit utiliser pour les tâches du flux de travail, le cas échéant.

**HistoryListID**

Facultatif **Text**. Spécifie le GUID de l'historique que le flux de travail doit utiliser pour l'enregistrement des événements de l'historique de flux de travail, le cas échéant.

Si le GUID n'est pas spécifié, le flux de travail enregistre les événements de l'historique de flux de travail dans un historique par défaut.

**StartManually**

Facultatif **Boolean**. Si défini sur True, le flux de travail peut être démarré manuellement par les utilisateurs.

Si cet attribut n’est pas présent, SharePoint Foundation traite le flux de travail comme si cet attribut avait la valeur false.

**StartOnCreate**

Facultatif **Boolean**. Si la valeur est true, SharePoint Foundation démarre automatiquement le flux de travail lorsqu’un nouvel élément est créé dans la liste à laquelle le flux de travail est associé.

Si cet attribut n’est pas présent, SharePoint Foundation traite le flux de travail comme si cet attribut avait la valeur false.

**StartOnChange**

Facultatif **Boolean**. Si la valeur est true, SharePoint Foundation démarre automatiquement le flux de travail lorsqu’un élément est modifié dans la liste à laquelle le flux de travail est associé.

Si cet attribut n’est pas présent, SharePoint Foundation traite le flux de travail comme si cet attribut avait la valeur false.

Éléments enfants

Aucun

Éléments parents

Élément WorkflowConfig

Remarques

Une fois que le flux de travail a été associé à une liste SharePoint spécifique, les valeurs des attributs suivants sont stockées dans l’objet SPWorkflowAssociation du flux de travail :

Les applications créées pour fonctionner en tant qu’éditeur de flux de travail sans code et basé sur des règles déclaratives peuvent utiliser la méthode AssociateWorkflowMarkup(String, String) du service web websvcWebPartPages pour créer un modèle de flux de travail et l’associer à une liste SharePoint spécifiant un fichier de marques de code de flux de travail, un fichier de configuration de flux de travail et éventuellement un fichier de marques de code de règles de flux de travail.

Pour plus d'informations sur la création d'une application qui peut agir en tant qu'éditeur de flux de travail sans code basé sur des règles déclaratives, voir Creating Declarative, No-Code Workflow Editors.

Exemple

L'exemple de code suivant montre un élément Association pour une configuration de flux de travail. Les attributs d'élément spécifient la liste SharePoint à laquelle le flux de travail est associé et la liste des tâches qu'utilise le flux de travail. Ils spécifient si le flux de travail peut être démarré manuellement et s'il démarre automatiquement lorsqu'un nouvel élément est créé dans la liste.

    <Association
        ListID="{B8C6FEEA-8066-462E-958D-1B4E90FE1C34}"
        TaskListID="{C64BA541-9D5B-42F3-A989-96F56FD51155}"
        StartManually="true"
        StartOnCreate="true"
    >

Voir aussi