CCSP Blog

• Ouvrir Workflow1.cs en mode design. Un événement nommé onWorkflowActivated est créé par défaut.
• Ajouter une activité createTask, suivie d'une boucle whileActivity, puis d'une activité completeTask. Dans la whileActivity, ajouter un événement onTaskChanged. Le résultat devrait ressembler à la copie d'écran ci-dessous.

Le premier élément onWorkflowActivated est indispensable. Il est appelé lorsqu'une nouvelle instance de workflow est créée et permet par exemple de récupérer des paramètres d'initiation. L'activité createTask permet, comme son nom l'indique, de créer une nouvelle tâche associée au workflow. Ensuite, une boucle whileActivity est exécutée tant que la tâche précédemment créée n'a pas été accomplie par l'utilisateur auquel elle a été affectée. Finalement, l'activité completeTask permet de modifier le statut de la tâche à "completed".

On constate qu'il y a un avertissement sur chaque activité du schéma. Il va donc falloir paramétrer certaines parties afin que ce template de workflow soit exploitable.

Définir la propriété "CorrelationToken"

Tout d'abord, il faut définir le paramètre CorrelationToken pour les activités createTask, onTaskChanged et completeTask. Ce paramètres est important car il permet de définir à quelle instance de workflow est attachée une tâche. Dans notre exemple, il permet de lancer l'événement onTaskChanged lorsque la tâche définie par l'activité createTask a été modifiée.

Définir l'identifiant (Guid) de la tâche

Un autre élément important concerne la génération d'une identifiant unique (Guid) pour la tâche qui va être créée. Cet identifiant doit être généré automatiquement par le système.

• Répéter l'étape précédente pour l'événement onTaskChanged et completeTask.

Définir la propriété TaskProperties

TaskProperties sert à définir les propriétés (titre, description, utilisateur, etc.) de la tâche créée avec l'activité createTask. Il faut créer un objet dans la classe Workflow1 de type Microsoft.SharePoint.Workflow.SPWorkflowTaskProperties. Les propriétés de cet objet seront initialisées lors de l'activité createTask, juste avant que la tâche soit réellement créée.

• Basculer en mode d'affichage du code source. Visual Studio a automatiquement déclaré un nouvel attribut:
  • public static DependencyProperty taskPropertiesProperty = DependencyProperty.Register("taskProperties", typeof(Microsoft.SharePoint.Workflow.SPWorkflowTaskProperties), typeof(TestWorkflow3.Workflow1));
  •         [DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Visible)]
            [BrowsableAttribute(true)]
            [CategoryAttribute("Misc")]
            public SPWorkflowTaskProperties taskProperties
            {
                get
                {
                    return ((Microsoft.SharePoint.Workflow.SPWorkflowTaskProperties)(base.GetValue(TestWorkflow3.Workflow1.taskPropertiesProperty)));
                }
                set
                {
                    base.SetValue(TestWorkflow3.Workflow1.taskPropertiesProperty, value);
                }
            }
• L'attribut taskProperties a été défini mais pas initialisé. On peut effectuer cette opération dans le handler MethodInvoking de l'activité createTask, au même endroit que la génération du Guid de la tâche. Cette méthode s'exécute juste avant que la tâche soit réellement créée. Elle constitue donc l'endroit idéal pour initialiser des données. Ajouter les lignes suivantes:
  •             this.taskProperties = new SPWorkflowTaskProperties();
                this.taskProperties.Title = "Un titre de tâche";
                this.taskProperties.Description = "La nouvelle tâche que j'ai créée";
                this.taskProperties.AssignedTo = "SERVEUR-CLG\\cleglaun";

Définir le suivi de la tâche

Notre tâche est maintenant créée et assignée à un utilisateur. Le but est de détecter le moment où un utilisateur accomplit la tâche, puis de récupérer les données associées. Dans cet exemple, on ne vérifie pas que la tâche soit accomplie par l'utilisateur auquel elle a été assignée.

Il est important de noter que le workflow se met en attente lorsqu'il atteint l'événement onTaskChanged. Dans notre exemple, on aimerait que le workflow reste à l'état "In Progress" tant que le pourcentage complété de la tâche n'est pas égal à 100%.

L'événement onTaskChanged a l'avantage de posséder une propriété fournissant les informations de la tâche saisies par l'utilisateur. On va donc utiliser cette propriété, nommée AfterProperties, pour enregistrer la valeur du champs qui nous intéresse, nommé PercentComplete. Elle est également de type Microsoft.SharePoint.Workflow.SPWorkflowTaskProperties.

• Toujours en mode design, double-cliquer sur l'événement onTaskChanged. Une méthode pour le handler Invoked est créée. Cette méthode se nomme onTaskChanged_Invoked.
• On veut stocker l'état de la tâche (renseigné par l'utilisateur) dans l'attribut percentComplete. Ajouter la ligne suivante dans la méthode onTaskChanged_Invoked créée à l'étape précédente.
  • this.percentComplete = this.taskAfterModifProperties.PercentComplete;

Il ne reste plus qu'à configurer la boucle while afin qu'elle s'exécute uniquement lorsque le pourcentage complété de la tâche est inférieur à 100%. Il est possible de définir une condition d'exécution pour une whileActivity.

Tester le workflow

Si Visual Studio est exécuté sur une machine possédant MOSS 2007, on peut utiliser les fonctionnalités de débuggage. Il suffit de cliquer sur "Start debugging" (la flèche verte). Une fenêtre Internet Explorer affiche automatiquement une vue contenant la liste pour tester le workflow. Il faut avoir préalablement défini les paramètres de débuggage. Pour y parvenir, faire un click droite sur la racine du projet et cliquer sur le menu "Sharepoint Debug Settings..."

Après avoir testé le workflow, il est possible d'appuyer sur le bouton Stop dans VS. A ce moment, le workflow est automatiquement désinstallé et la fenêtre Internet Explorer fermée.

Déployer le workflow

Un autre article de ce blog traitera plus en détail les aspects liés au déploiement d'une feature.