Procédure : créer un formulaire de flux de travail pour utiliser des données d'association et d'initiation

Lorsque Microsoft Office SharePoint Server 2007 affiche un formulaire Microsoft Office InfoPath 2007 personnalisé pour une association ou une initiation de flux de travail, il transmet aussi toutes les données d'association ou d'initiation au format XML. Pour qu'un contrôle de formulaire affiche un élément de ce code XML, il doit avoir une liaison de données avec cet élément XML. Office SharePoint Server 2007 effectue automatiquement cette liaison de données pour les formulaires d'association et d'initiation de flux de travail, comme l'explique cette rubrique.

Liaison de contrôles de formulaire à des données d'association

Lorsqu'Office SharePoint Server 2007 affiche un formulaire InfoPath personnalisé pour une association de flux de travail, il appelle le contrôle Forms Server pour convertir le formulaire en une page Microsoft ASP.NET 2.0 et l'héberger. Pendant le chargement du formulaire, le contrôle Forms Server lui transmet toutes les données XML d'association prédéfinies au format XML. Le contrôle Forms Server lie automatiquement les éléments au contrôle de formulaire de même nom. Par exemple, il lierait automatiquement un contrôle de formulaire appelé Commentaires à l'élément de données Commentaires. Vous n'avez pas besoin de définir explicitement le schéma des données d'association comme source de données secondaire.

Pour utiliser des données d'association, donnez à votre contrôle de formulaire le même nom qu'à l'élément se trouvant dans le code XML des données d'association.

Vous pouvez spécifier des données d'association par défaut dans l'élément AssociationData du fichier de définition de flux de travail de votre solution de flux de travail. Pour plus d'informations, voir Schéma de définition de flux de Travail dans le Kit de développement (SDK) Windows SharePoint Services 3.0.

De la même manière, le contrôle Forms Servers retransmet les données de formulaire d'association à Windows SharePoint Services. Les données d'association de flux de travail sont stockées au format XML dans la propriété AssociationData de l'objet SPWorkflowAssociation approprié. Lorsqu'une instance de flux de travail démarre, ces données sont également passées dans le flux de travail via la propriété AssociationData de l'objet SPWorkflowActivationProperties.

Pour plus d'informations sur la manière dont les formulaires d'association sont spécifiés et traités, voir Formulaires d'association et d'initialisation de flux de travail (Office SharePoint Server 2007).

Pour lier des contrôles de formulaire à des données d'association

• Attribuez à votre contrôle de formulaire InfoPath le même nom que celui de l'élément du code XML des données d'association.

Liaison de contrôles de formulaire avec des données d'initiation

Lorsqu'Office SharePoint Server 2007 affiche un formulaire InfoPath personnalisé pour une initiation de flux de travail sur le serveur, il appelle le contrôle Forms Server pour convertir le formulaire en une page ASP.NET 2.0 et l'héberger. Pendant le chargement du formulaire, le contrôle Forms Server récupère les données d'initiation à partir de la propriété AssociationData de l'objet SPWorkflowAssociation approprié, puis il les transmet au formulaire d'initiation au format XML. Le contrôle Forms Server lie automatiquement les éléments au contrôle de formulaire de même nom. Par exemple, il lierait automatiquement un contrôle de formulaire appelé Commentaires à l'élément de données Commentaires. Vous n'avez pas besoin de définir explicitement le schéma des données d'initiation comme source de données secondaire.

Notes

Le contrôle Forms Server n'est appelé que si vous lancez le flux de travail à partir de l'interface de navigateur Web d'Office SharePoint Server 2007. Si vous le lancez à partir d'une application cliente de Microsoft Office System 2007, par exemple Microsoft Office Word, Microsoft Office PowerPoint ou Microsoft Office Excel, l'application peut héberger le formulaire d'initiation de flux de travail InfoPath sans le convertir en ASP.NET 2.0. Toutefois, dans chaque cas, l'opération de liaison de données est gérée de la même manière.

Pour utiliser des données d'initiation, donnez à votre contrôle de formulaire le même nom que celui de l'élément du code XML des données d'initiation.

De la même manière, le contrôle Forms Server gère lui-même le démarrage du flux de travail et la transmission des données du formulaire d'initiation à la nouvelle instance de flux de travail. Après le démarrage du flux de travail, les données d'initiation sont stockées dans la propriété InitiationData de l'objet SPWorkflowActivationProperties renvoyé par la propriété WorkflowProperties de l'activité OnWorkflowActivated.

Pour plus d'informations sur la manière dont les formulaires d'initiation sont spécifiés et traités, voir Formulaires d'association et d'initialisation de flux de travail (Office SharePoint Server 2007).

Pour lier des contrôles de formulaire à des données d'initiation

• Attribuez à votre contrôle de formulaire InfoPath le même nom que celui de l'élément du code XML des données d'initiation.

Voir aussi

Autres ressources

Formulaires InfoPath pour flux de travail
Formulaires d'association et d'initialisation 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