Formulaires de modification de flux de travail (Microsoft SharePoint Server 2010)
Dernière modification : mercredi 7 avril 2010
S’applique à : SharePoint Server 2010
Vous pouvez permettre aux utilisateurs de modifier votre flux de travail à des endroits spécifiques pendant qu'il s'exécute sur un élément. Les options que vous présentez aux utilisateurs de cette manière sont appelées modifications. Vous pouvez ensuite créer des formulaires de modification qui permettent aux utilisateurs de spécifier les paramètres de la modification.
Vous pouvez également créer des formulaires de modification de flux de travail Microsoft InfoPath 2010. Toutefois, par défaut, ces formulaires de modification fonctionnent uniquement en tant que formulaires côté serveur. Ils ne sont pas affichés dans les applications clientes Microsoft Office 2010, même s’ils ont été conçus en tant que formulaires symétriques dans InfoPath 2010.
Pour plus d'informations sur les concepts des formulaires de modification de flux de travail, voir Formulaires de modification des flux de travail (SharePoint Foundation) dans le Kit de développement (SDK) de Windows SharePoint Services 3.0.
Spécification de formulaires de modification
Chaque formulaire de modification InfoPath 2010 que vous utilisez dans votre flux de travail doit avoir son propre GUID. SharePoint Server 2010 utilise ce GUID pour faire correspondre la modification sélectionnée par l'utilisateur avec le formulaire approprié.
La spécification d'un formulaire de modification requiert la définition des données suivantes :
Définissez la propriété ModificationId de l'activité EnableWorkflowModification avec le GUID que vous avez généré pour votre modification.
Dans la définition du modèle de flux de travail, définissez l'attribut ModificationURL de l'élément Workflow avec la valeur suivante :
ModificationUrl="_layouts/WFMod.aspx"Il s'agit d'une page .aspx fournie avec SharePoint Server 2010 ; la page inclut un composant WebPart InfoPath Forms Services pour héberger le formulaire de modification de flux de travail de InfoPath 2010 :
Ajoutez deux éléments à l'élément Metadata dans la définition XML du modèle de flux de travail. Le premier élément est Modification_GUID_FormURN, élément (Workflow), où guid est le GUID que vous avez généré pour votre formulaire de modification ; affectez l'URN du formulaire de modification à cet élément. Par exemple :
<Modification_GUID_FormURN> urn:schemas-microsoft-com:office:infopath:workflow:ReviewRouting-Modify </Modification_GUID_FormURN>Le deuxième élément est Modification_Guid_Name, où GUID est le GUID que vous avez généré pour votre formulaire de modification ; affectez le nom que vous souhaitez donner à votre modification à cet élément. SharePoint Server 2010 affiche ce nom en tant que texte du lien pour le lien de la modification sur la page d'état du flux de travail. Par exemple :
<Modification_GUID_Name>Add a New Reviewer</Modification_GUID_Name>
Pour plus d’informations sur le schéma de définition de flux de travail, voir Définitions de flux de travail dans le Kit de développement logiciel (SDK) de Microsoft SharePoint 2010 Software Development Kit (SDK).
Traitement de formulaire de modification
Lorsque l'utilisateur clique sur un lien de modification de flux de travail, SharePoint Server 2010 examine l'attribut ModificationURL de l'élément Workflow pour déterminer le formulaire à charger. Pour les formulaires Office InfoPath 2007, le développeur a défini cette valeur à "_layouts/WFMod.aspx". SharePoint Server 2010 charge cette page. La page examine l'élément Modification_GUID_FormURN, élément (Workflow) approprié, sur la base du GUID de la modification qui lui a été passé par SharePoint Server 2010. La page charge le formulaire de modification de flux de travail InfoPath spécifié. La page passe également au formulaire les données de contexte de la propriété ContextData de l'activité EnableWorkflowModification en tant que source de données principale du formulaire.
Important
La propriété ContextData de l'activité EnableWorkflowModification doit contenir du code XML conforme au schéma XML du formulaire de modification. Ceci est vrai même si vous ne passez pas de données de contexte au formulaire. Dans ce cas, vous devez toujours spécifier du code XML conforme au schéma XML du formulaire de modification, même si le code XML ne contient pas de données. Dans le cas contraire, la page WFMod.aspx ne peut pas passer la chaîne XML attendue au formulaire de modification lors du chargement, ce qui provoque l'échec du chargement du formulaire de modification.
Lorsque l'utilisateur soumet le formulaire de modification, la page WFMod.aspx appelle la méthode ModifyWorkflow, en passant l'ID de l'instance de flux de travail et les informations de contexte mises à jour.
SharePoint Server 2010 déclenche un événement OnWorkflowModified lorsque la méthode ModifyWorkflow est appelée. Pour gérer cet événement et traiter la modification, ajoutez une activité d’événement OnWorkflowModified au flux de travail. La propriété ContextData de cet événement contient le code XML soumis par le formulaire de modification.
Voir aussi
Concepts
Flux de travail dans SharePoint Server 2010
Formulaires InfoPath pour flux de travail
Formulaires d'association et d'initialisation de flux de travail (Microsoft SharePoint Server 2010)
Formulaires de tâches de flux de travail (Microsoft SharePoint Server 2010)