Partager via


Débogage de solutions de flux de travail SharePoint

Mise à jour : novembre 2007

S'applique à

Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés.

Type de projet

  • Flux de travail SharePoint

Version de Microsoft Office

  • SharePoint Server 2007

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Vous pouvez déboguer un modèle de flux de travail SharePoint en utilisant le débogueur Visual Studio. Lorsque vous lancez le débogage, Visual Studio ouvre un site SharePoint et ajoute le modèle de flux de travail à une bibliothèque ou une liste. Vous pouvez démarrer ensuite une instance du modèle de flux de travail et utiliser des outils de débogage standard pour déboguer votre code.

Remarque :

Si vous ajoutez des références à d'autres assemblys, vérifiez que ces assemblys sont installés dans le Global Assembly Cache. Sinon, la solution de flux de travail échouera. Pour plus d'informations sur l'installation des assemblys, consultez Comment : installer un assembly dans le Global Assembly Cache.

Spécification des paramètres de configuration Debug

Vous pouvez spécifier des paramètres de configuration Debug dans l'Assistant Nouveau flux de travail Office SharePoint lorsque vous créez un projet Flux de travail séquentiel SharePoint 2007 ou Flux de travail de l'ordinateur d'état SharePoint 2007. Pour plus d'informations, consultez Comment : créer un projet de flux de travail SharePoint.

Vous pouvez modifier ces paramètres dans la fenêtre Propriétés ou en redémarrant l'Assistant Nouveau flux de travail Office SharePoint. Pour plus d'informations, consultez Comment : modifier les paramètres de configuration Debug d'un projet de flux de travail SharePoint.

Le tableau suivant affiche les paramètres de débogage inclus dans l'Assistant.

Paramètre

Description

Nom complet

Identifie le modèle de flux de travail sur le site Web SharePoint Server. Ce nom apparaît dans une liste de modèles de flux de travail qui sont disponibles pour une bibliothèque ou une liste.

Site cible

Spécifie l'URL du site Web SharePoint que vous souhaitez utiliser pour exécuter ce flux de travail. Pour développer et déboguer ce flux de travail, ce site doit être placé sur l'ordinateur local.

Liste cible

Spécifie la bibliothèque ou la liste que vous utiliserez pour initialiser le flux de travail. Les activités du workflow s'appliquent aux éléments de cette bibliothèque ou de cette liste.

Liste des tâches

Spécifie la liste des tâches que vous souhaitez utiliser. La liste des tâches affiche les tâches de flux de travail qui sont disponibles pour chaque participant du flux de travail.

Historique

Spécifie la liste qui affiche tous les événements qui se produisent lors de l'exécution du flux de travail. Si un historique n'existe pas sur le site Web SharePoint local, le processus du déploiement du flux de travail Visual Studio Tools pour Office en crée un.

Association auto.

Indique si le modèle de flux de travail doit automatiquement être associé à la bibliothèque ou la liste que vous spécifiez dans l'Assistant Nouveau flux de travail Office SharePoint.

Si vous sélectionnez cette option, le processus du déploiement du flux de travail Visual Studio Tools pour Office associe le modèle de flux de travail à la bibliothèque ou la liste spécifiée.

Si vous désactivez cette option, vous devez associer manuellement le modèle de flux de travail à la bibliothèque ou la liste en utilisant la page d'administration Ajouter un flux de travail du site Web SharePoint.

Autoriser le démarrage manuel

Indique si vous pouvez démarrer manuellement le flux de travail à partir d'un document de la bibliothèque ou d'un élément de la liste. Pour plus d'informations, consultez Démarrage manuel d'un flux de travail sur un élément de document (en anglais).

Démarrer à la création de l'élément

Indique si un flux de travail doit être démarré lorsqu'un nouvel élément est créé dans la bibliothèque ou la liste.

Démarrer à la modification de l'élément

Indique si le flux de travail doit être démarré lorsqu'un élément est mis à jour dans la bibliothèque ou la liste.

Fonctionnalités SharePoint

Une fonctionnalité est une unité portable et modulaire de fonctionnalités qui simplifient la modification de sites via des définitions de site. Une fonctionnalité est un package d'éléments Windows SharePoint Services qui peuvent être activés pour une portée spécifique et qui permettent à des utilisateurs de réaliser une tâche ou un objectif particulier. Le processus de déploiement du flux de travail déploie des modèles de flux de travail comme des fonctionnalités.

Lorsque vous démarrez le débogueur, le processus de déploiement du flux de travail crée un dossier dans le répertoire de fonctionnalités sous %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES.

Le dossier de la solution dans le répertoire de fonctionnalités contient un fichier de définition de fonctionnalité et un fichier de définition de flux de travail. Le fichier de définition de fonctionnalité (feature.xml) décrit les fichiers dans la fonctionnalité de flux de travail.Le fichier de définition de flux de travail (workflow.xml) décrit le modèle de flux de travail. Vous pouvez trouver ces fichiers dans l'Explorateur de solutions. Pour plus d'informations sur ces fichiers, consultez Modèles de projet de flux de travail SharePoint.

Processus de déploiement du débogueur

Lorsque vous démarrez le débogueur Visual Studio, le processus de déploiement du flux de travail Visual Studio Tools pour Office effectue les tâches suivantes :

  • Déploie les fichiers de définition des fonctionnalités et du flux de travail vers SharePoint Server.

  • Installe l'assembly de flux de travail dans le Global Assembly Cache (GAC).

  • Redémarre les services Internet (IIS) et SharePoint Server.

  • Active la fonctionnalité dans SharePoint Server 2007.

  • Associe le flux de travail à la bibliothèque ou la liste SharePoint que vous avez sélectionnée dans l'Assistant Nouveau flux de travail Office SharePoint.

  • Joint le débogueur Visual Studio au processus Windows SharePoint Services (w3wp.exe).

  • Affiche la page de bibliothèque ou de liste appropriée.

    Remarque :

    Si vous avez choisi de ne pas associer automatiquement le modèle de flux de travail à la bibliothèque ou la liste, vous devez d'abord associer manuellement le modèle de flux de travail à la bibliothèque ou la liste en utilisant la page d'administration Ajouter un flux de travail dans SharePoint.

Visual Studio Tools pour Office affiche un message d'état dans la fenêtre Sortie de Visual Studio à l'issue de chaque tâche. Si une tâche ne peut pas être effectuée, Visual Studio Tools pour Office affiche un message d'erreur dans la fenêtre Liste d'erreurs de Visual Studio. Pour plus d'informations sur la résolution des erreurs, consultez Dépannage des solutions de flux de travail SharePoint.

Démarrage du flux de travail

Le processus de déploiement ne démarre pas le flux de travail. Vous devez démarrer le flux de travail à partir du site Web SharePoint. Vous pouvez également démarrer le flux de travail en utilisant une application cliente telle que Microsoft Office Word 2007 ou en utilisant du code distinct côté serveur. Utilisez l'une des approches que vous avez spécifiées dans l'Assistant Nouveau flux de travail SharePoint.

Par exemple, si vous avez spécifié que le flux de travail peut être démarré manuellement, démarrez directement le flux de travail à partir de l'élément de la bibliothèque ou de la liste. Pour plus d'informations sur le démarrage manuel d'un flux de travail, consultez Démarrage manuel d'un flux de travail sur un élément de document (en anglais).

Voir aussi

Tâches

Comment : inclure des fichiers d'assistance lors du débogage d'une solution SharePoint

Flux de travail séquentiel SharePoint, exemple

Procédure pas à pas : création et débogage d'une solution de flux de travail SharePoint

Concepts

Solutions de flux de travail SharePoint

Dépannage des solutions de flux de travail SharePoint

Autres ressources

Déploiement de flux de travail à l'aide de fonctionnalités