Promotion et rétrogradation de propriétés de document
Dernière modification : lundi 1 novembre 2010
S’applique à : SharePoint Foundation 2010
La promotion de propriété désigne le processus d’extraction de valeurs des propriétés d’un document et d’écriture de ces valeurs dans les colonnes correspondantes de la liste ou de la bibliothèque de documents qui héberge le document. La rétrogradation de propriété correspond au processus exactement inverse. Les valeurs sont lues dans les colonnes de liste et écrites dans les propriétés de document.
Microsoft SharePoint Foundation peut fonctionner avec un analyseur de document pour automatiser le processus de promotion et de rétrogradation de propriétés. Lorsque les valeurs des propriétés de document changent, les modifications peuvent être automatiquement écrites dans la liste. Lorsque les valeurs de colonnes ou de champs dans un élément de liste changent, les modifications peuvent être automatiquement écrites dans le document associé à l’élément de liste. Par conséquent, le document et son élément de liste associé demeurent synchronisés.
SharePoint Foundation déclenche la promotion ou la rétrogradation de propriété lorsque les événements suivants se produisent :
Un fichier est téléchargé vers une bibliothèque de documents.
Les champs d’un élément de liste associé à un fichier sont modifiés.
La propriété Properties d’un objet SPFile est mise à jour par programme.
Un fichier est téléchargé la première fois après la modification du schéma de liste.
Dans chaque cas, SharePoint Foundation détermine si un analyseur est associé au type de fichier. Si c’est le cas, SharePoint Foundation appelle l’analyseur en lui passant le document et un objet conteneur de propriétés. L’analyseur remplit ensuite le conteneur de propriétés de valeurs à promouvoir vers la liste, ou extrait du conteneur de propriétés les valeurs à rétrograder vers le document.
SharePoint Foundation promeut ou rétrograde uniquement les propriétés correspondant aux colonnes de liste qui s’appliquent au document. Les colonnes qui s’appliquent à un document sont spécifiées par les éléments suivants :
Le type de contenu du document, si un type de contenu lui a été affecté.
Les colonnes de la bibliothèque de documents, si le document n’a pas de type de contenu.
Pour plus d’informations sur les types de contenu, voir Types de contenu.
SharePoint Foundation stocke également l’ensemble de la collection de propriétés du document dans une table de hachage, laquelle est accessible par programme par le biais de la propriété Properties d’un objet SPFile. Vous ne pouvez pas accéder à la table de hachage des propriétés d’un document par une interface utilisateur.
Pour plus d’informations sur la façon dont l’analyseur XML intégré promeut et rétrograde les propriétés de document pour les fichiers XML, voir Promotion et rétrogradation des propriétés de document XML.
Promotion
SharePoint Foundation crée une instance de la IParserPropertyBag, interface et remplit l’objet avec toutes les propriétés de document spécifiées dans la liste. Il appelle ensuite l’analyseur de document correspondant au type de fichier et appelle la méthode Parse de l’analyseur, en transmettant le document et le conteneur de propriétés en guise d’arguments. Une fois les résultats de la méthode retournés, SharePoint Foundation accède au conteneur de propriétés, établit une correspondance entre les propriétés de document et les colonnes de liste, puis inscrit ces valeurs dans la liste.
La figure ci-dessous illustre le processus de promotion d’un document. Dans celui-ci, l’analyseur extrait les propriétés de document du document et les écrit dans le conteneur de propriétés. Sur les quatre propriétés du document, trois sont incluses dans le type de contenu du document. SharePoint Foundation établit ensuite une correspondance entre les propriétés dans le conteneur de propriétés et les colonnes (champs) de la bibliothèque de documents, puis promeut ces propriétés vers la bibliothèque de documents ; autrement dit, il écrit leurs valeurs de propriété dans les colonnes appropriées. Le type de contenu du document n’incluant pas la colonne État, SharePoint Foundation ne promeut pas cette quatrième propriété du document, même si la bibliothèque de documents comprend une colonne correspondante. SharePoint Foundation écrit aussi les propriétés du document dans la propriété Properties de l’objet SPFile qui représente le document dans la bibliothèque de documents.
.gif "Promotion de propriétés à l’aide d’un analyseur personnalisé")
Rétrogradation
SharePoint Foundation crée une instance de la IParserPropertyBag, interface et remplit l’objet avec les propriétés de document spécifiées dans la liste. Il appelle ensuite l’analyseur de document correspondant au type de fichier et appelle la méthode Demote de l’analyseur, en transmettant le document et le conteneur de propriétés en guise d’arguments. La méthode Demote accède au conteneur de propriétés, établit une correspondance entre les colonnes de liste et les propriétés de document et écrit les valeurs appropriées dans le document.
La figure suivante illustre le processus de rétrogradation de propriétés d’un document. Pour mettre à jour deux propriétés du document, SharePoint Foundation appelle l’analyseur, en lui passant le document à mettre à jour et un objet conteneur de propriétés qui reprend les deux propriétés du document. L’analyseur lit les valeurs des propriétés dans le conteneur de propriétés et met à jour les propriétés dans le document. Lorsque l’analyseur a terminé la mise à jour du document, il définit un indicateur, transmis dans un paramètre de sortie, indiquant qu’il a modifié le document. SharePoint Foundation enregistre ensuite le document mis à jour dans la bibliothèque de documents.
.gif "Rétrogradation de propriétés à l’aide d’un analyseur personnalisé")