Formulaires d'association et d'initialisation de flux de travail (Microsoft SharePoint Server 2010)
Dernière modification : mardi 6 avril 2010
S’applique à : SharePoint Server 2010
Dans cet article
Spécification de formulaires d'association
Traitement de formulaire d'association
Spécification de formulaires d'initiation
Traitement du formulaire d'initiation
Avant le démarrage du flux de travail, vous pouvez afficher des formulaires d'association et d'initialisation aux utilisateurs, pour leur permettre de définir préalablement des paramètres et d'autres informations pour le flux de travail. Les formulaires d'association concernent le flux de travail qui s'applique à une liste, une bibliothèque ou un type de contenu spécifiques ; les formulaires d'initialisation concernent le flux de travail qui s'applique à un élément SharePoint spécifique.
Vous pouvez aussi inclure des données de pré-association dans la définition du modèle de flux de travail. Par exemple, vous pouvez choisir de pré-remplir les champs sur votre formulaire d’association avec des valeurs par défaut.
Pour plus d'informations sur les concepts des formulaires d'association et d'initialisation, voir Formulaires d’initiation et d’association de flux de travail (Sharepoint Foundation) dans le Kit de développement (SDK) de Windows SharePoint Foundation.
Spécification de formulaires d'association
Comme pour les formulaires de flux de travail, vous spécifiez le formulaire d'association d'un flux de travail dans le code XML de définition du modèle de flux de travail. Pour cela, vous modifiez deux éléments du code XML.
Définissez la valeur de l'attribut AssociationURL de l'élément Workflow à « _layouts/CstWrkflIP.aspx ». Il s'agit d'une page .aspx fournie avec Microsoft SharePoint Server 2010 ; la page inclut un composant WebPart InfoPath Forms Services pour héberger le formulaire d'association de flux de travail de Microsoft InfoPath 2010 :
AssociationURL ="_layouts/CstWrkflIP.aspx"Notes
SharePoint Server 2010 prend en charge les chemins d'accès absolus ou relatifs de serveur dans la définition du modèle de flux de travail. Vous devez exprimer toutes les URL de chemin d'accès des formulaires dans l'un de ces formats. Par exemple, un chemin d'accès absolu, tel que "http://site/library/page.aspx";, ou un chemin d'accès relatif de serveur, tel que "/layouts/page.aspx". Office SharePoint Server 2007 ne prend pas en charge la correction des liens dans les définitions de modèle de flux de travail.
Ajoutez un élément Association_FormURN à l'élément Metadata dans la définition du modèle de flux de travail. Utilisez cet élément pour spécifier l'URN du formulaire Office InfoPath 2007 que vous souhaitez utiliser pour l'association du flux de travail. Par exemple :
<Association_FormURN>urn:schemas-microsoft- com:office:infopath:workflow:ReviewRouting-Assoc </Association_FormURN>Si vous souhaitez fournir des données personnalisées au formulaire d'association, vous pouvez stocker ces informations dans l'élément AssocationData. Par exemple, vous pouvez utiliser cet élément pour stocker des valeurs par défaut que vous souhaitez passer au formulaire d'association lorsqu'il est affiché. L'élément AssocationData peut contenir tout code XML valide.
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 (SDK) de Windows SharePoint Foundation.
Traitement de formulaire d'association
Lorsqu'un administrateur sélectionne un flux de travail à associer à une liste, une bibliothèque ou un type de contenu donné, SharePoint Server 2010 affiche la page Ajouter un nouveau flux de travail ; l'administrateur peut y spécifier des paramètres communs à tous les flux de travail, tels que la définition du flux de travail, ses conditions de démarrage, et si le flux de travail s'exécute sur des éléments, sur des dossiers ou sur les deux.
Lorsque l'administrateur clique sur le bouton Suivant sur cette page, SharePoint Server 2010 examine l'attribut AssociationURL de l'élément Workflow dans la définition du modèle de flux de travail, pour déterminer la page .aspx appropriée à charger. Pour un formulaire InfoPath 2010, le développeur définit cette valeur à _layouts/CstWrkflIP.aspx. SharePoint Server 2010 charge cette page, qui contient un composant WebPart InfoPath Forms Services hébergeant le formulaire personnalisé. La page examine ensuite l'élément Association_FormURN du code XML de la définition du modèle de flux de travail pour déterminer le formulaire InfoPath 2010 approprié à héberger. En outre, ce composant WebPart passe toutes les données stockées dans l'élément AssocationData au formulaire InfoPath 2010.
Lorsque l'administrateur soumet des modifications apportées au formulaire, CstWrkflIP.aspx repasse les données à SharePoint Server 2010 sous la forme d'une chaîne XML. Les données sont stockées dans la propriété AssociationData de l'objet SPWorkflowAssociation qui représente cette association du flux de travail.
Spécification de formulaires d'initiation
Pour spécifier un formulaire d'initiation de flux de travail InfoPath 2010, vous devez modifier deux éléments dans la définition du modèle de flux de travail.
Définissez la valeur de l'attribut InstantiationURL de l'élément Workflow à "_layouts/IniWrkflIP.aspx". Il s'agit d'une page .aspx incluse dans SharePoint Server 2010 ; la page inclut un composant WebPart Office InfoPath Forms Services pour héberger le formulaire d'initiation de flux de travail InfoPath 2010 :
InstantiationURL="_layouts/IniWrkflIP.aspx"Notes
SharePoint Server 2010 prend en charge les chemins d'accès absolus ou relatifs de serveur dans la définition du modèle de flux de travail. Toutes les URL de chemin d'accès des formulaires doivent être exprimées dans l'un de ces formats. Par exemple, un chemin d'accès absolu, tel que "http://site/library/page.aspx", ou un chemin d'accès relatif de serveur, tel que "/layouts/page.aspx". SharePoint Server 2010 ne prend pas en charge la correction des liens dans les définitions de modèle de flux de travail.
Ajoutez un élément Instantiation_FormURN à l'élément Metadata dans la définition du modèle de flux de travail. Utilisez cet élément pour spécifier l'URN du formulaire InfoPath 2010 que vous souhaitez utiliser pour l'initiation du flux de travail. Par exemple :
<Instantiation_FormURN>urn:schemas-microsoft- com:office:infopath:workflow:ReviewRouting-Init:1033 </Instantiation_FormURN>
Traitement du formulaire d'initiation
Lorsqu'un utilisateur démarre un flux de travail sur un élément donné, SharePoint Server 2010 examine l'attribut InstantiationURL de l'élément Workflow du code XML de la définition du modèle de flux de travail pour déterminer la page .aspx appropriée à charger. Dans le cas d'un formulaire InfoPath 2010, le développeur définit cette valeur à "_layouts/IniWrkflIP.aspx". SharePoint Server 2010 charge cette page, qui contient un composant WebPart Office InfoPath Forms Services pour héberger le formulaire personnalisé. Cette page examine ensuite l'élément Instantiation_FormURN du code XML de la définition du modèle de flux de travail pour déterminer le formulaire InfoPath 2010 approprié à héberger. En outre, la page passe sous la forme d'une chaîne XML les données de l'association stockées dans la propriété AssociationData de l'association SPWorkflowAssociation appropriée à InfoPath 2010. Ces données servent de source de données principale pour le formulaire.
Lorsque l'utilisateur soumet des modifications apportées au formulaire, IniWrkflIP.aspx repasse les données au modèle objet de SharePoint Foundation, dans le cadre de l'appel à la méthode StartWorkflow.
Le gestionnaire de flux de travail d'SharePoint Server 2010 crée une instance du flux de travail sur l'élément SharePoint. Le gestionnaire de flux de travail passe les données collectées à l'aide du formulaire d'initiation à l'événement OnWorkflowActivated du flux de travail lui-même.
Voir aussi
Tâches
Procédure : concevoir des formulaires de flux de travail InfoPath
Concepts
Flux de travail dans SharePoint Server 2010
Formulaires InfoPath pour flux de travail
Formulaires de modification de flux de travail (Microsoft SharePoint Server 2010)
Formulaires de tâches de flux de travail (Microsoft SharePoint Server 2010)