Extension de formulaires
Dernière modification : lundi 8 février 2010
S’applique à : SharePoint Foundation 2010
Dans cet article
Création et enregistrement d'un contrôle de lancement
Promotion et rétrogradation de propriétés
Gestion des liens
Fusionner les formulaires
Cette rubrique présente des méthodes permettant d’étendre le type de contenu Formulaire dans Microsoft SharePoint Foundation.
Les développeurs tiers peuvent créer une DLL qui fournit un contrôle de lancement pour ouvrir les fichiers XML d’un type de contenu Formulaire dans un éditeur XML compatible avec SharePoint Foundation. Le type de contenu Formulaire est une extension du type de contenu Document et est conçu pour les fichiers XML.
Le type de contenu Formulaire fournit les fonctionnalités suivantes pour utiliser des fichiers XML :
Promotion et rétrogradation de propriétés Promeut les données stockées dans le fichier XML en tant que colonnes de la bibliothèque SharePoint Foundation, et permet l’écriture dans le document à l’aide de ces propriétés.
Gestion des liens Conserve les liens dans les fichiers XML associés au modèle de formulaire.
Fusionner les formulaires Envoie plusieurs fichiers XML à une application cliente à fusionner.
Création et enregistrement d'un contrôle de lancement
Les développeurs tiers peuvent créer une DLL qui fournit le contrôle de lancement permettant d'ouvrir des documents XML dans un éditeur XML. Le contrôle doit fournir la même interface pour la création, la modification et la fusion des fichiers XML, ainsi que pour la personnalisation des modèles, comme indiqué pour le contrôle OpenXMLDocuments, contrôle. Le contrôle doit avoir un ProgID, tel que SharePoint.OpenXMLDocuments et être installé et enregistré sur l'ordinateur client.
Le fichier Présentation des fichiers DocIcon.xml pour un déploiement SharePoint Foundation peut être personnalisé afin que le ProgID (par exemple, Word.Document) et l’extension du nom de fichier d’un type de document spécifique correspondent au ProgID du contrôle de lancement et à une icône représentant les documents dans la bibliothèque de formulaires.
Promotion et rétrogradation de propriétés
SharePoint Foundation fournit à la fois la promotion et la rétrogradation de propriétés pour les formulaires XML.
SharePoint Foundation inclut un analyseur de document XML intégré que vous pouvez utiliser pour promouvoir et rétrograder les propriétés incluses dans vos documents XML. Étant donné que les formulaires sont des documents XML, SharePoint Foundation appelle automatiquement l'analyseur XML intégré chaque fois que la promotion ou la rétrogradation de propriétés de document est requise.
Notes
La promotion de propriétés fait référence à l'extraction de valeurs d'un formulaire, et à l'écriture de ces valeurs dans les colonnes appropriées de la bibliothèque dans laquelle le formulaire est enregistré. La rétrogradation de propriétés fait référence à la récupération de valeurs de colonnes de la bibliothèque dans laquelle le formulaire est enregistré et à l'écriture de ces valeurs dans le document.
Pour plus d'informations, voir Promotion et rétrogradation des propriétés de document XML.
Gestion des liens
La gestion des liens vous permet de conserver les formulaires assignés sur un type de contenu Formulaire donné synchronisés avec le modèle de type de contenu Formulaire. Les mécanismes de gestion des liens sont les suivants :
Gestion automatique des liens Après avoir synchronisé un formulaire avec le modèle, si un site, un sous-site ou une bibliothèque est renommé, le lien est synchronisé automatiquement avec l'URL du modèle de type de contenu Formulaire.
Notes
La gestion des liens n'a pas lieu immédiatement. Un indicateur est défini et elle se produit lorsque le fichier est demandé pour le téléchargement.
Recréer un lien manuellement Si le formulaire n'est pas synchronisé initialement avec l'URL du modèle de type de contenu Formulaire, sélectionnez Recréer un lien entre ces documents et cette bibliothèque sur la page Personnaliser pour recréer le lien manuellement. Il est utilisé pour les documents téléchargés ou pour les formulaires copiés d'un serveur vers un autre.
Les deux mécanismes nécessitent que la colonne TemplateUrl dans le type de contenu Formulaire indique l'emplacement dans le formulaire XML où le modèle de formulaire est spécifié. Cela permet à SharePoint Foundation de rétrograder l'emplacement de modèle approprié dans les documents XML assignés à ce type de contenu.
Si ces informations sont stockées dans une instruction de traitement du formulaire XML, utilisez les attributs PITarget et PIAttribute de la définition de la colonne TemplateUrl pour spécifier son emplacement, tel qu’illustré dans l’exemple suivant.
<FieldRef
ID="{4B1BF6C6-4F39-45ac-ACD5-16FE7A214E5E}"
Name="TemplateUrl"
PITarget="PI_Element"
PIAttribute="PI_Attribute"/>
En outre, vous pouvez spécifier un emplacement principal dans une instruction de traitement dans lequel SharePoint Foundation doit rechercher avant de rechercher dans l’emplacement spécifié par les attributs PITarget et PIAttribute. Pour ce faire, ajoutez une autre paire d’attributs : PrimaryPITarget et PrimaryPIAttribute. Si ces attributs sont présents, SharePoint Foundation recherche l’URL du modèle dans l’emplacement qu’ils spécifient en premier. S’il existe une valeur à cet emplacement, l’analyseur l’utilise et ignore les attributs PITarget et PIAttribute, tel qu’illustré dans l’exemple suivant :
<FieldRef
ID="{4B1BF6C6-4F39-45ac-ACD5-16FE7A214E5E}"
Name="TemplateUrl"
PrimaryPITarget="primaryPI_Element"
PrimaryPIAttribute="primaryPI_Attribute"
PITarget="PI_Element"
PIAttribute="PI_Attribute"/>
Si ces informations sont stockées dans le contenu XML du formulaire, utilisez l'attribut Node dans la définition de la colonne TemplateUrl pour spécifier son emplacement, tel qu'illustré dans l'exemple suivant.
<FieldRef
ID="{4B1BF6C6-4F39-45ac-ACD5-16FE7A214E5E}"
Name="TemplateUrl"
Node="XPath"/>
Pour plus d’informations sur la manière dont SharePoint Foundation utilise ces attributs pour promouvoir et rétrograder des propriétés de documents telles que l’URL de modèle, voir Utilisation de types de contenu pour spécifier des propriétés de document XML.
Fusionner les formulaires
La fusion de formulaires fournit au type de contenu Formulaire un mécanisme d'affichage combiné de formulaires qui possèdent le même schéma.
Pour activer la fusion pour un type de contenu, ce type de contenu doit contenir la colonne Fusionner le site, avec le nom interne de « combinaison ». Par défaut, le type de contenu Formulaire comprend la colonne Fusionner le site avec le nom interne approprié. La colonne Fusionner permet aux utilisateurs de sélectionner les formulaires qu'ils souhaitent fusionner.