Valeurs par défaut des métadonnées basées sur l’emplacement
Dernière modification : jeudi 15 avril 2010
S’applique à : SharePoint Server 2010
Dans cet article
Présentation des valeurs par défaut des métadonnées basées sur l’emplacement
Conditions et précédence
Inscription de récepteurs d’événements pour appliquer des métadonnées par défaut
Configuration des valeurs par défaut des métadonnées pour les emplacements
Programmabilité des valeurs par défaut des métadonnées basées sur l’emplacement
Cette rubrique présente les valeurs par défaut des métadonnées basées sur l’emplacement, leurs options de configuration, les règles de précédence qui régissent leur application et la façon dont elles utilisent des récepteurs d’événements pour appliquer des métadonnées par défaut.
Présentation des valeurs par défaut des métadonnées basées sur l’emplacement
Les valeurs par défaut des métadonnées basées sur l’emplacement gèrent les valeurs par défaut des champs de métadonnées basés sur l’emplacement et les appliquent de sorte qu’elles soient disponibles lorsque l’utilisateur modifie un document. Lorsqu’un utilisateur interagit avec un site Microsoft SharePoint Server 2010, SharePoint Server applique les valeurs par défaut ; ainsi, celles-ci apparaissent la première fois que l’utilisateur consulte un formulaire de modification de document. Les applications Microsoft Office 2010 telles que Microsoft Word 2010 obtiennent les valeurs par défaut pour un emplacement lorsque le document est enregistré. Au moment de l’enregistrement du document, l’application cliente obtient les informations de type de contenu pour l’emplacement où l’élément de contenu est enregistré, et le serveur applique les valeurs par défaut et génère le schéma de propriété dans le document Office 2010.
Conditions et précédence
Les valeurs par défaut des métadonnées basées sur l’emplacement respectent des règles conditionnelles pour déterminer à quel moment les valeurs par défaut sont appliquées à un document. Cette section répertorie en premier lieu les conditions, puis passe en revue les règles de précédence qui sont utilisées pour les appliquer.
Les valeurs par défaut sont appliquées :
lorsque vous téléchargez un fichier unique ;
lorsque vous ajoutez des fichiers en bloc à l’aide du Mode Explorateur ou du contrôle ActiveX Télécharger plusieurs documents ;
lorsque vous créez une page de publication ;
lorsque vous créez un document par défaut dans un jeu de documents ;
lorsqu’un flux de travail crée un document ;
lorsque vous enregistrez directement à partir d’applications clientes Office 2010 ou d’un espace de travail SharePoint ;
une fois la conversion du document terminée.
SharePoint Server 2010 applique les valeurs par défaut des métadonnées basées sur l’emplacement par défaut en établissant tout d’abord un jeu de règles de précédence générales afin de déterminer les valeurs par défaut des métadonnées qui sont appliquées et dans quel ordre. Par exemple, des règles de précédence spécifiques sont utilisées pour appliquer des valeurs par défaut au serveur, inscrire des récepteurs d’événements, déterminer la séquence des événements qui sont déclenchés lorsqu’un document est téléchargé sur le serveur, etc.
La façon dont SharePoint Server 2010 applique les valeurs par défaut des métadonnées basées sur l’emplacement aux éléments et le moment auquel il les applique dépendent de la manière dont la fonctionnalité définit la précédence. En premier lieu, lors du téléchargement d’un document vers un dossier dans une bibliothèque de documents, les valeurs par défaut des métadonnées basées sur l’emplacement sont obtenues à partir de différents emplacements, notamment :
Le document en cours de téléchargement, qui peut contenir une valeur de colonne, une colonne intégrée telle que « Titre » ou un document qui a été précédemment stocké avec un schéma appliqué (avec la même colonne). Il s’agit des deux cas où le document en cours de téléchargement peut contenir une valeur de colonne.
La définition du champ dans la liste, qui peut spécifier une valeur par défaut.
L’emplacement auquel le document est téléchargé dans la bibliothèque de documents, qui peut spécifier une valeur de colonne par défaut.
Des règles de précédence sont utilisées pour déterminer la valeur qui est appliquée à une colonne :
Si le document téléchargé contient une valeur pour le champ égale à la valeur par défaut de la liste pour la définition du champ, SharePoint Server 2010 remplace la valeur actuelle du champ par une valeur par défaut basée sur l’emplacement si une telle valeur existe selon les règles de précédence.
Si le document téléchargé contient une valeur qui diffère de la valeur par défaut de la liste, SharePoint Server 2010 conserve cette valeur, même si une valeur par défaut basée sur l’emplacement existe pour celle-ci.
Si un champ n’existe pas, le serveur utilise la valeur par défaut qui est définie dans la définition du champ.
Inscription de récepteurs d’événements pour appliquer des métadonnées par défaut
La première fois que vous configurez une valeur par défaut de métadonnées basées sur l’emplacement pour n’importe quel emplacement dans une bibliothèque de documents, SharePoint Server 2010 inscrit un nouveau récepteur d’événements post-événement ItemAdded synchrone sur cette bibliothèque de documents. Une fois l’événement inscrit, le serveur l’applique aux valeurs par défaut par emplacement. Une séquence d’événements affecte la façon dont les valeurs par défaut des métadonnées basées sur l’emplacement sont promues hors des documents vers la colonne appropriée dans une liste SharePoint Server 2010, les valeurs par défaut qui sont spécifiées pour un emplacement et si les valeurs de propriétés doivent être mises à jour ou corrigées.
L’utilisateur télécharge un document vers un emplacement. À l’heure actuelle, les métadonnées sont promues hors du document.
Le nouveau récepteur d’événements ItemAdded s’exécute. Il vérifie les valeurs par défaut des métadonnées basées sur l’emplacement qui sont spécifiées pour l’emplacement et met à jour la valeur de propriétés si une valeur par défaut est spécifiée et que la valeur actuelle est équivalente à la valeur par défaut pour le type de contenu spécifié.
L’utilisateur consulte le formulaire de modification standard pour l’élément, et les valeurs par défaut correctes pour l’emplacement y figurent déjà.
Si vous supprimez la dernière valeur par défaut par emplacement dans la bibliothèque de documents, le serveur annule l’inscription du récepteur d’événements.
Une fois que le document est téléchargé vers le serveur, l’événement ItemAdded est déclenché, et les valeurs des métadonnées du document pour toutes les colonnes sont promues vers la colonne appropriée dans la liste. SharePoint Server 2010 affiche le formulaire de modification pour le document et le serveur modifie les valeurs de métadonnées réelles à l’aide des règles de précédence générales.
Configuration des valeurs par défaut des métadonnées pour les emplacements
Vous pouvez configurer les valeurs par défaut des métadonnées basées sur l’emplacement dans les colonnes qui prennent en charge la définition de valeurs par défaut dans une hiérarchie de dossiers. Si des valeurs de métadonnées sont configurées dans un dossier parent, ses sous-dossiers héritent alors des valeurs des métadonnées du parent, sauf si une valeur de métadonnées différente a été explicitement spécifiée dans un sous-dossier. Selon que les dossiers ou les métadonnées sont manipulés par le biais de l’interface utilisateur ou de l’API, les valeurs des métadonnées par défaut des dossiers et des sous-dossiers peuvent être affectées.
En supposant qu’aucune valeur par défaut n’est configurée pour un dossier ou un sous-dossier, et que la liste comprend uniquement une colonne (une colonne texte nommée « TheOnlyColumn » avec une chaîne vide comme valeur par défaut), une série de trois actions modifie les valeurs des métadonnées par défaut des dossiers et des sous-dossiers selon l’héritage. Par exemple, prenons une structure où :
Un dossier nommé DocLib est le parent.
Les dossiers nommés Alpha et Beta sont des sous-dossiers du dossier DocLib.
Les dossiers AlphaOne et AlphaTwo sont des sous-dossiers d’Alpha.
BetaOne est un sous-dossier de Beta.
Première action : accès au dossier Beta et définition d’une valeur par défaut
Un utilisateur accède au dossier Beta et attribue la valeur par défaut « Z » à TheOnlyColumn.
Tableau 1. Effet de la définition de valeurs de métadonnées sur des dossiers : première action
Si vous ajoutez un élément dans ce dossier... |
La valeur par défaut de TheOnlyColumn est... |
|---|---|
DocLib (racine) |
Vierge |
Alpha |
Vierge |
AlphaOne |
Vierge |
AlphaTwo |
Vierge |
Beta |
Z |
BetaOne |
Z |
La modification affecte les dossiers Beta et BetaOne : la modification de la valeur de métadonnées de Beta affecte BetaOne, car BetaOne est un sous-dossier de Beta, et donc il hérite la valeur de métadonnées de son parent.
Deuxième action : accès au dossier Alpha et définition d’une valeur par défaut
Un deuxième utilisateur accède au dossier Alpha et définit la valeur par défaut « Y ».
Tableau 2. Effet de la définition de valeurs de métadonnées sur des dossiers : deuxième action
Si vous ajoutez un élément dans ce dossier... |
La valeur par défaut de TheOnlyColumn est... |
DocLib (racine) |
Vierge |
Alpha |
Y |
AlphaOne |
Y |
AlphaTwo |
Y |
Beta |
Z |
BetaOne |
Z |
La modification affecte le dossier Alpha et ses sous-dossiers. Les dossiers Beta ne sont pas affectés.
Troisième action : accès au dossier AlphaOne et définition d’une valeur par défaut
Pour terminer, un autre utilisateur accède au dossier AlphaOne et définit la valeur par défaut « X ».
Tableau 3. Effet de la définition de valeurs de métadonnées sur des dossiers : troisième action
Si vous ajoutez un élément dans ce dossier... |
La valeur par défaut de TheOnlyColumn est... |
|---|---|
DocLib (racine) |
Vierge |
Alpha |
Y |
AlphaOne |
X |
AlphaTwo |
Y |
Beta |
Z |
BetaOne |
Z |
La valeur du dossier AlphaTwo est toujours « Y ». La modification apportée au dossier AlphaOne n’affecte pas AlphaTwo, car AlphaTwo n’est pas un enfant du dossier AlphaOne.
Programmabilité des valeurs par défaut des métadonnées basées sur l’emplacement
Le modèle objet pour les valeurs par défaut des métadonnées basées sur l’emplacement se trouve principalement dans le type MetadataDefaults. Il comprend des méthodes que vous pouvez utiliser pour appliquer les valeurs par défaut des métadonnées basées sur l’emplacement, obtenir, définir et supprimer des métadonnées par défaut dans les objets String et SPFolder, et obtenir des valeurs par défaut de champs. La documentation de référence gérée pour MetadataDefaults contient des extraits de code qui illustrent cette fonctionnalité.
Voir aussi
Concepts
Modèle de programmation de gestion des documents