Formulaires d'association et d'initialisation de flux de travail (Office SharePoint Server 2007)

Article
02/01/2010

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 (Windows SharePoint Services) dans le Kit de développement (SDK) de Windows SharePoint Services 3.0.

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 Office SharePoint Server 2007 ; la page inclut un composant WebPart InfoPath Forms Services pour héberger le formulaire d'association de flux de travail de Microsoft Office InfoPath 2007 :
```
AssociationURL ="_layouts/CstWrkflIP.aspx"
```
Notes

Office SharePoint Server 2007 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 Schéma de définition de flux de Travail dans le Kit de développement (SDK) de Windows SharePoint Services 3.0.

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é, Office SharePoint Server 2007 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, Office SharePoint Server 2007 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 Office InfoPath 2007, le développeur définit cette valeur à _layouts/CstWrkflIP.aspx. Office SharePoint Server 2007 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 Office InfoPath 2007 approprié à héberger. En outre, ce composant WebPart passe toutes les données stockées dans l'élément AssocationData au formulaire Office InfoPath 2007.

Lorsque l'administrateur soumet des modifications apportées au formulaire, CstWrkflIP.aspx repasse les données à Office SharePoint Server 2007 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 Office InfoPath 2007, 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 Office SharePoint Server 2007 ; la page inclut un composant WebPart Office InfoPath Forms Services pour héberger le formulaire d'initiation de flux de travail Office InfoPath 2007 :
```
InstantiationURL="_layouts/IniWrkflIP.aspx"
```
Notes

Office SharePoint Server 2007 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". 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 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 Office InfoPath 2007 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é, Office SharePoint Server 2007 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 Office InfoPath 2007, le développeur définit cette valeur à "_layouts/IniWrkflIP.aspx". Office SharePoint Server 2007 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 Office InfoPath 2007 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 à Office InfoPath 2007. 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 Windows SharePoint Services, dans le cadre de l'appel à la méthode StartWorkflow.

Le gestionnaire de flux de travail d'Office SharePoint Server 2007 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

Autres ressources

Flux de travail dans Office SharePoint Server 2007
Formulaires InfoPath pour flux de travail
Formulaires de modification de flux de travail (Office SharePoint Server 2007)
Fiches tâche de flux de travail (Office SharePoint Server 2007)
Workflow Definition Schema for InfoPath Forms
Procédure : concevoir un formulaire InfoPath pour un flux de travail dans Office SharePoint Server 2007
Procédure : accéder aux données des formulaires d'initiation et d'association dans un flux de travail
Procédure : créer un formulaire de flux de travail pour utiliser des données d'association et d'initiation

Partager via