Création d'éditeurs de flux de travail déclaratifs et sans code
Dernière modification : lundi 28 février 2011
S’applique à : SharePoint Foundation 2010
Le service Web websvcWebPartPages de Microsoft SharePoint Foundation contient des méthodes qui activent un éditeur de flux de travail déclaratif, sans code, à base de règles, tel que Microsoft SharePoint Designer 2010, permettant de créer des modèles de flux de travail et de les associer à des listes SharePoint spécifiques.
Ces méthodes sont les suivantes :
FetchLegalWorkflowActions(), méthode
Utilisez cette méthode pour obtenir une liste spécifique à la langue des actions de flux de travail valides installées pour SharePoint Foundation. Cela permet à une application créée d'agir comme un éditeur de flux de travail déclaratif pour afficher les actions dans son interface utilisateur.
La liste renvoyée est une liste fusionnée qui contient le contenu de tous les fichiers .actions installés sur le serveur, avec les actions de flux de travail principales incluses dans SharePoint Foundation affichées par défaut en premier.
Pour plus d'informations sur les actions de flux de travail, voir Vue d’ensemble des flux de travail dans SharePoint Designer.
ValidateWorkflowMarkupAndCreateSupportObjects(String, String, String, String), méthode
Utilisez cette méthode pour valider le marquage d'un flux de travail déclaratif et éventuellement pour créer les objets apparentés nécessaires à l'exécution de ce flux de travail. Cela implique les actions suivantes :
la création de la liste des tâches du flux de travail, si aucune n’est spécifiée dans les données de configuration du flux de travail ou si la liste des tâches spécifiée n’existe pas ;
la définition de tous les types de contenu des tâches du flux de travail dans le formulaire de modification spécifié.
La méthode utilise les paramètres suivants :
XML qui représente un fichier de marquage de flux de travail au format XOML.
XML qui représente un marquage des règles de flux de travail au format RULES.
Pour plus d’informations sur les formats de flux de travail XOML et RULES, voir Windows Workflow Foundation.
XML qui représente un fichier de configuration de flux de travail complet conforme au schéma de configuration de flux de travail.
Pour plus d'informations sur le schéma de configuration de flux de travail, voir Vue d'ensemble du schéma de configuration de flux de travail.
Valeur d’indicateur qui spécifie s’il faut simplement valider le balisage de flux de travail ou valider le balisage de flux de travail et créer aussi les objets associés.
AssociateWorkflowMarkup(String, String), méthode
Utilisez cette méthode pour créer un modèle de flux de travail et associer ce modèle de flux de travail à la liste SharePoint spécifiée.
Cette méthode utilise les paramètres suivants :
Chemin d'accès au fichier de configuration de flux de travail à utiliser pour ce flux de travail.
Version du fichier de configuration de flux de travail à utiliser.
Le fichier de configuration de flux de travail contient les informations nécessaires pour créer un modèle de flux de travail dans SharePoint Foundation à partir des fichiers de marquage et de règles de flux de travail spécifiés et pour l'associer à une liste SharePoint spécifique. Les informations incluses dans le fichier de configuration de flux de travail sont les suivantes :
Les fichiers de marquage et de règles de flux de travail à utiliser, y compris la version appropriée de ces fichiers.
La liste SharePoint à laquelle le flux de travail doit être associé.
La liste des tâches et l'historique du flux de travail à utiliser.
Conditions sous lesquelles le flux de travail démarre.
Emplacement du formulaire d'initiation de flux de travail, champs de données et valeurs par défaut.
Le fichier de configuration de flux de travail doit être conforme au schéma de configuration de flux de travail. Pour plus d'informations, voir Vue d'ensemble du schéma de configuration de flux de travail.
Lorsque le modèle de flux de travail déclaratif est créé et associé à la liste spécifiée, les objets SPWorkflowTemplate et SPWorkflowAssociation sont créés pour représenter respectivement le modèle de flux de travail et l'association. Pour les flux de travail déclaratifs, la propriété IsDeclarative de chaque objet a la valeur True.
SharePoint Foundation comprend un compilateur juste-à-temps pour compiler l'assembly de flux de travail au premier démarrage du flux de travail sur un élément. SharePoint Foundation conserve le flux de travail compilé en mémoire jusqu'à l'appel suivant, un peu comme les serveurs mettent en cache les pages ASPX compilées pour accélérer les performances d'exécution la prochaine fois que la page est appelée.
Chaque fois qu'un flux de travail est démarré sur un élément, SharePoint Foundation détermine si ce flux de travail a été déployé en tant qu'assembly ou que marquage déclaratif. S'il existe un assembly de flux de travail, SharePoint Foundation l'appelle pour créer l'instance de flux de travail. Si le flux de travail a été déployé en tant que marquage déclaratif, SharePoint Foundation détermine ensuite s'il existe déjà un assembly de flux de travail compilé à partir de ce marquage en mémoire. Si tel est le cas, SharePoint Foundation appelle le flux de travail compilé en mémoire pour créer l'instance de flux de travail. Dans le cas contraire, SharePoint Foundation utilise son compilateur juste-à-temps pour compiler le marquage de flux de travail dans un flux de travail en mémoire, qu'il appelle ensuite pour créer l'instance de flux de travail.
Pour un site donné, les flux de travail déclaratifs doivent être stockés dans une bibliothèque de documents au niveau du site, appelée Flux de travail. Les fichiers des flux de travail déclaratifs doivent être stockés dans un dossier distinct, dans la bibliothèque de documents Flux de travail. Cela inclut le fichier de balisage de flux de travail (.xoml), le fichier des règles et le fichier de configuration de flux de travail. Il est vivement recommandé de stocker tous les formulaires de flux de travail dans le dossier de flux de travail.
Voir aussi
Concepts
Développement de flux de travail pour SharePoint Foundation
Vue d'ensemble du schéma de configuration de flux de travail