Élément Association (WorkflowConfig)

  • Article

S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

Contient les informations nécessaires à un éditeur de flux de travail déclaratif sans code basé sur des règles, 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**

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

**TaskListID**

**Texte**requis. 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**

**Text**facultatif. 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
É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 pour le flux de travail :

  • La valeur de l’attribut StartManually est stockée dans la propriété AllowManual .

  • La valeur de l’attribut StartOnCreate est stockée dans la propriété AutoStartCreate .

  • La valeur de l’attribut StartOnChange est stockée dans la propriété AutoStartChange .

  • La valeur de l’attribut HistoryListID est stockée dans la propriété HistoryListId .

  • La valeur de l’attribut TaskListID est stockée dans la propriété TaskListId .

Les applications créées pour fonctionner comme un éditeur de flux de travail déclaratif sans code basé sur des règles peuvent utiliser la méthode AssociateWorkflowMarkup(String, String) du service web web web websvcWebPartPages pour créer un modèle de flux de travail et l’associer à une liste SharePoint spécifiant un fichier de balisage de flux de travail, un fichier de configuration de flux de travail et éventuellement un fichier de balisage 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 suivant montre un élément Association pour une configuration de workflow. Les attributs de l’élément spécifient la liste SharePoint à laquelle le flux de travail est associé, la liste de tâches utilisée par le flux de travail, que le flux de travail peut être démarré manuellement et que le flux de travail 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