Cette documentation est archivée et n’est pas conservée.

Extension de formulaires

Windows SharePoint Services 3

Cette rubrique présente des méthodes permettant d'étendre le type de contenu Formulaire dans Windows SharePoint Services 3.0.

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 Windows SharePoint Services.

Le type de contenu Formulaire est une extension du type de contenu Document et est conçu pour des fichiers XML. Dans Windows SharePoint Services 2.0, les fonctionnalités spéciales proposées par des formulaires ont été liées au modèle de bibliothèque de formulaires. Dans Windows SharePoint Services 3.0, ces fonctionnalités spéciales sont encapsulées dans le type de contenu Formulaire, et les types de contenu dérivent de celui-ci. Cela libère les utilisateurs de la restriction précédente d'avoir à stocker leurs formulaires dans une bibliothèque distincte de celle des documents, et de pouvoir stocker un seul type de formulaire dans chacune des bibliothèques de formulaires. À présent, non seulement vous pouvez stocker plusieurs types de formulaires dans une seule bibliothèque, mais vous pouvez aussi stocker des formulaires et des documents dans la même bibliothèque.

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 dans la bibliothèque SharePoint, 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 DocIcon.xml pour un déploiement de Windows SharePoint Services 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 corresponde 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

Windows SharePoint Services 3.0 fournit à la fois la promotion et la rétrogradation des propriétés pour les formulaires XML.

Windows SharePoint Services 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, Windows SharePoint Services appelle automatiquement l'analyseur XML intégré chaque fois que la promotion ou la rétrogradation de propriétés de document est requise.

Remarque Remarque :

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.

    Remarque Remarque :

    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 à Windows SharePoint Services 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 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" 
  PITarget="PI_Element" 
  PIAttribute="PI_Attribute"/> 

En outre, vous pouvez spécifier un emplacement principal dans une instruction de traitement dans lequel Windows SharePoint Services 3.0 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, Windows SharePoint Services 3.0 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 :

 [xml]
<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 Windows SharePoint Services 3.0 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.

Voir aussi

Afficher: