Développer des workflows avec formulaires Infopath embarqués

Ouvrez Infopath et créer un nouveau formulaire. Nommez-le SimpleAssociation.xsn. Ensuite, la première chose à faire est de rendre notre formulaire compatible avec Forms Services. En effet, Forms Services est le service qui sera sollicité par MOSS lors de l'association du workflow à une liste lorsqu'il invoquera notre formulaire. Une bonne pratique consiste à spécifier cette exigence de compatibilité dès la création du formulaire car pas mal de contrôles sont incompatibles avec Forms Services et Infopath les enlève lorsqu'il détecte que vous souhaitez construire un formulaire Forms Services. L'intérêt est donc d'éviter de construire entièrement le formulaire et de se rendre compte en fin de conception que la moitié des contrôles que vous avez utilisé sont en fait incompatibles et inutilisables pour votre workflow :).

Pour rendre le formulaire compatible, cliquez sur Design Checker

Ensuite cliquez sur Change compatibility settings

Cochez la case comme illustré.

Cliquez ensuite sur Security and Trust et spécifiez le mode Full Trust

Le mode Full Trust est requis pour exécuter les formulaires Infopath au sein des workflows.

Veillez à présent à construire votre formulaire afin d'obtenir ceci:

L'interface utilisateur

La source de données

veillez à nommer votre source de données SimpleAssociationData comme illustré sur l'image.

Le bouton Valider permet de soumettre les données d'association et est lié à une connexion permettant l'envoi de données vers le processus appelant. Le bouton Annuler quant à lui exécute une action consistant à fermer le formulaire sans envoyer les données vers l'hôte. Voici comment créer la connexion liée au bouton Valider

Dans la partie Data Sources, cliquez sur Manage Data Connections et ensuite sur Add, vous obtenez le formulaire suivant:

Choisissez Create a new connection to Submit data et ensuite cliquez sur Next pour obtenir l'écran suivant

Choisissez l'option illustrée par l'image, ensuite cliquez sur Next et appelez la connexion Soumettre

Il est à présent temps d'associer notre bouton Valider à la connexion Soumettre. Double-cliquez sur le bouton Valider pour obtenir cet écran

Cliquez ensuite sur Rules et ensuite sur Add, vous obtenez l'écran suivant

Nommez la règle ValiderEtFermer et ensuite cliquez sur Add Action

Remplissez l'écran comme illustré ci-dessus. Ensuite, cliquez à nouveau sur Add Action et choisissez l'action Close this form..., vous devez obtenir au final, ceci

Le bouton Valider est à présent opérationnel. Pour le bouton Annuler procédez comme pour le bouton Valider mais n'ajoutez que l'action Close the form...

Le formulaire est prêt. Il ne reste plus qu'à le publier

Les étapes de publication du formulaire sont assez simples. Il s'agit de le publier vers un répertoire ou une ressource réseau. Le formulaire ainsi publié sera référencé par notre workflow et chargé dans Sharepoint lors de l'installation de la feature liée au workflow.

Avant la publication, enregistrez votre formulaire quelque part sur votre disque dur. Je vous conseille de l'enregistrer en dehors de votre projet Visual Studio lié à votre workflow ou alors dans un répertoire bien distinct pour éviter toute confusion ultérieure.

Cliquez sur Publish form template

Choisissez ensuite, To a network location et spécifiez le chemin du répertoire cible

Idéalement, placez la version publiée du formulaire dans le répertoire FeatureFiles de votre projet Visual Studio. Dans mon cas, c'est le répertoire C:\Documents and Settings\Administrator\My Documents\Visual Studio 2005\Projects\SimpleAssociation\DeploymentFiles\FeatureFiles

Si vous avez un chemin dans la zone de texte, retirez-le et cliquez sur Next. Enfin, pour terminer, cliquez sur Publish puis sur Close

Le formulaire est à présent publié et prêt à l'emploi.

Maintenant que vous avez créé et publié le formulaire, il reste deux choses à faire :

• Récupérer l'URN du formulaire
• Enregistrer le formulaire en mode source et générer la classe .cs qui nous permettra de collecter les données d'association entrées par l'utilisateur

IV-A-3-a. Récupération de l'URN▲

Ouvrez le menu File => Properties

et récupérez l'URN

On utilisera l'URN dans la section suivante. En attendant, faites un copier/coller dans le bloc note

IV-A-3-b. Enregistrer les sources et utilisation de XSD▲

Cliquez sur File=>Save as source files...

choisissez un répertoire cible et cliquez sur Ok. Fermez Infopath.

Dans le répertoire où vous avez enregistré les sources, vous devez retrouver ces fichiers

Le seul qui nous intéresse vraiment est myschema.xsd qui contient le schéma de notre datasource principal. C'est à partir de ce fichier que nous allons créer la classe csharp correspondante. Ouvrez une commande DOS (visual studio tools) et positionnez-vous dans le répertoire où vous avez enregistré les sources. Exécutez ensuite cette commande

 

Sélectionnez

					    xsd myschema.xsd /c

Cette commande vous créerez le fichier myschema.cs

Pour terminer, ajoutez ce fichier à votre solution Visual Studio et donnez-lui un nom approprié, comme par exemple DonneesAssociation

La dernière étape consiste à associer le formulaire au workflow. Pour ce faire, vous devez éditer les fichiers feature.xml et workflow.xml.

IV-A-4-a. feature.xml▲

<Feature  Id="2A4B0389-5ED3-423e-9CB0-E347342B21F4"
	Title="Simple Association"
	Description="Ce workflow utilise un formulaire d'association"
	Version="12.0.0.0"
	Scope="Site"
	ReceiverAssembly="Microsoft.Office.Workflow.Feature, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"
	ReceiverClass="Microsoft.Office.Workflow.Feature.WorkflowFeatureReceiver"
	xmlns="http://schemas.microsoft.com/sharepoint/">
	<ElementManifests>
		<ElementManifest Location="workflow.xml" />
		<ElementFile Location="SimpleAssociation.xsn"/>
	</ElementManifests>
	<Properties>
		<Property Key="GloballyAvailable" Value="true" />		
		<Property Key="RegisterForms" Value="*.xsn" />
	</Properties>
</Feature>

IV-A-4-b. workflow.xml▲

<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
 <Workflow
	 Name="Simple Association"
	 Description="Ce workflow utilise un formulaire d'association"
	 Id="FBAD33C1-D237-455f-875E-F68A92314288"
	 CodeBesideClass="SimpleAssociation.Workflow1" 
	 CodeBesideAssembly="SimpleAssociation, Version=1.0.0.0, Culture=neutral, PublicKeyToken=34c70c0a7a1ac3ee"
	 TaskListContentTypeId="0x01080100C9C9515DE4E24001905074F980F93160"		 
	 AssociationUrl="_layouts/CstWrkflIP.aspx"
	 StatusUrl="_layouts/WrkStat.aspx">

	<Categories/>
	<!-- Tags to specify InfoPath forms for the workflow; delete tags for forms that you do not have -->
	<MetaData>
		<Association_FormURN>VOTRE URN</Association_FormURN>
	</MetaData>
 </Workflow>
</Elements>

urn:schemas-microsoft-com:office:infopath:SimpleAssociation:-myXSD-2008-03-03T12-51-23

Maintenant que nous avons procédé à toutes les étapes de création et d'association de notre formulaire d'association au workflow, voici comment récupérer les données du formulaire. Grâce à la classe générée par XSD et nommée DonneesAssociation dans notre exemple, nous pouvons sur l'activation du workflow récupérer les données comme suit

XmlSerializer serializer = new XmlSerializer(typeof(SimpleAssociationData));
XmlTextReader reader = new XmlTextReader(new System.IO.StringReader
                (workflowProperties.AssociationData));
SimpleAssociationData Assoc = (SimpleAssociationData)serializer.Deserialize(reader);            
if (Assoc.TexteAssociation != null && Assoc.TexteAssociation != "")
   workflowProperties.Item["Title"] = Assoc.TexteAssociation;
else
   workflowProperties.Item["Title"] = "Aucune donnée spécifiée";
workflowProperties.Item.Update();

Ce code initialise un serialiseur XML et un reader pour desérialiser le XML contenu dans les données d'association et en faire une instance valide de classe de type SimpleAssociationData qui est le nom de la classe du fichier DonneesAssociation.cs qui a été créé à l'aide de l'outil XSD

Ensuite pour que notre workflow effectue quand même une action, on met à jour le champ Titre de l'élément de liste sur lequel le workflow a été exécuté.

Les quelques captures d'écran ci-dessous montrent les étapes d'exécution de notre workflow.

Lors de l'ajout de notre workflow à une bibliothèque, notre formulaire d'association apparaît

Démarrage du workflow

Résultat après exécution

Le champ Title contient bien la valeur test que l'on a encodée dans notre formulaire d'association.

Toutes les étapes de création du formulaire d'initiation avec Infopath sont identiques à celles requises pour créer un formulaire d'association. Ceci est d'ailleurs tellement vrai que les projets SimpleAssociation et SimpleInitiation disponibles en téléchargement utilisent le même formulaire. Les seules différences se situent au niveau de notre workflow Visual Studio pour associer le formulaire d'initiation au workflow et pour récupérer les données.

Voici le détail pour gérer ces différences

IV-A-7-a. workflow.xml▲

<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
	<Workflow
		 Name="Simple Initiation"
		 Description="Simple Initiation"
		 Id="ADCC8485-F36C-404b-93E2-D6D0629ABC19"
		 CodeBesideClass="SimpleInitiation.Workflow1" 
		 CodeBesideAssembly="SimpleInitiation, Version=1.0.0.0, Culture=neutral, PublicKeyToken=1e28b168300722b5"
		 TaskListContentTypeId="0x01080100C9C9515DE4E24001905074F980F93160"		 
		 InstantiationUrl="_layouts/IniWrkflIP.aspx"
		 StatusUrl="_layouts/WrkStat.aspx">

		<Categories/>
		<!-- Tags to specify InfoPath forms for the workflow; delete tags for forms that you do not have -->
		<MetaData>			
			<Instantiation_FormURN>VOTRE URN/Instantiation_FormURN>			
		</MetaData>
	</Workflow>
</Elements>

IV-A-7-b. Récupération des données d'association dans le workflow▲

XmlSerializer serializer = new XmlSerializer(typeof(SimpleAssociationData));
XmlTextReader reader = new XmlTextReader(new System.IO.StringReader
         (workflowProperties.InitiationData));
SimpleAssociationData Init = (SimpleAssociationData)serializer.Deserialize(reader);
if (Init.TexteAssociation != null && Init.TexteAssociation != "")
    workflowProperties.Item["Title"] = Init.TexteAssociation;
else
    workflowProperties.Item["Title"] = "Aucune donnée spécifiée";
workflowProperties.Item.Update();

Le workflow, également disponible en téléchargement le plus basique possible pour créer une tâche correspond à ceci

soit

• L'activité SurActivation obligatoire
• L'activité CreeTache qui crée la tâche Sharepoint
• Une boucle (WhileAcitivy) qui vérifie si la tâche est complète ou non et qui encapsule l'activité QuandTacheChange
• L'activité CompleterTache qui termine la tâche
• L'activité de logging qui affiche le commentaire inséré dans la tâche dans l'historique du workflow

Je ne vais pas expliquer en détail le workflow et le code de celui-ci, vous pourrez l'examiner en téléchargeant le projet. Il faut simplement retenir que pour accéder aux données de notre tâche, nous passons cette fois par la collection ExtendedProperties proposée par le type SPWorkflowTaskProperties.

Dans cet exemple simpliste, les données de la tâche sont accédées comme suit

bool Statut = Convert.ToBoolean(QuandTacheChange_ApresModif.ExtendedProperties["Approuve"].ToString());
TacheCommentaire = QuandTacheChange_ApresModif.ExtendedProperties["Commentaire"].ToString();
if (Statut)
  TacheApprouvee = true;
else
  TacheApprouvee = false;

Comme vous pouvez le voir, c'est assez simple et ne nécessite aucune désérialization préalable.

Vous l'avez compris, chaque formulaire a son propre noeud metadata. Pour un formulaire de tâche, il s'agit du noeud Task0_FormURN. Vous noterez la présence du "0". En réalité, vous pouvez avoir plusieurs formulaires de tâche dans un même workflow, dans ce cas, il vous suffira d'utiliser le noeud Task1_FormURN, Task2_FormURN etc...

Voici donc à quoi ressemble le code complet de workflow.xml

<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
 <Workflow
	 Name="SimpleTache"
	 Description="Ce workflow assigne une tâche"
	 Id="4E7191A0-8E91-4b4b-8BFB-45A86BB4A554"
	 CodeBesideClass="SimpleTache.Workflow1" 
	 CodeBesideAssembly="SimpleTache, Version=1.0.0.0, Culture=neutral, PublicKeyToken=67b46027114cd162"
	 TaskListContentTypeId="0x01080100C9C9515DE4E24001905074F980F93160"		 
	 StatusUrl="_layouts/WrkStat.aspx">

	<Categories/>
	<!-- Tags to specify InfoPath forms for the workflow; delete tags for forms that you do not have -->
	<MetaData>
		<Task0_FormURN>urn:schemas-microsoft-com:office:infopath:SimpleTache:-myXSD-2008-03-02T13-45-52</Task0_FormURN>
	</MetaData>
 </Workflow>
</Elements>

Lorsque vous avez associé le workflow à une bibliothèque et lorsque vous l'avez exécuté sur un élément de liste, celui-ci reste en statut In Progress jusqu'à ce que la tâche soit approuvée

Il crée la tâche suivante:

qui redirige la personne à qui elle est assignée sur notre formulaire

Ce qui a pour effet de terminer notre workflow

Note: une fois de plus, cet exemple consiste à démontrer l'association d'un formulaire de tâche à un workflow. Ce n'est en aucun cas utilisable dans un environnement réel car :

• La tâche est assignée "en dur" à un utilisateur
• Aucun contrôle n'est fait en cas de suppression de tâche
• Aucune action n'est réalisée lorsque la tâche est refusée
• Bref, c'est du basique de chez basique :)