En écrivant le billet sur le classement des propriétés des profils utilisateurs, je me suis rendu compte qu'il serait intéressant d'avoir une commande pour accomplir cette tâche, car l'utilisation des flèches dans la console d'administration n'est vraiment pas pratique.
Et justement, pour que cette fonctionnalité soit disponible aux administrateurs directement, je me suis dit qu'il serait intéressant de l'avoir dans l'outil stsadm.
Pour ceux qui ne sont pas familier avec cet outil, sachez que c'est un utilitaire en ligne de commande fourni dans SharePoint, qui permet d'effectuer des tâches administratives d'une plateforme WSS 3.0 ou MOSS 2007. La syntaxe pour exécuter une commande est comme suit:
Après l'option -o, on précise l'opération que l'on veut exécuter. Il est possible, via cet outil, de sauvegarder/restaurer des collections de sites, de créer des sites etc ... Vous trouverez la liste de toutes les opérations disponibles en exécutant dans une console DOS la commande
stsadm -help
ou en vous reportant à l'aide MSDN.
L'idée ici n'est pas de vous donner un cours sur stsadm, internet fourmille de documentation à ce sujet, mais de vous présenter l'extension SetProfilePropertyPosition, qui est en fait l'encapsulation du code que j'avais présenté, dans une opération stsadm. En effet, une des forces de cet outil est la possibilité d'ajouter nos propres opérations.
Je vous invite à suivre le webcast de la session que j'ai co-animé avec Gaëtan Bouveret durant les TechDays 2008 intitulé "Comment étendre sa plateforme SharePoint 2007" avec notamment en première partie tout ce qu'il faut savoir et faire pour pouvoir ajouter une extension stsadm.
L'extension SetProfilePropertyPosition va permettre de réordonner facilement les propriétés des profils utilisateurs, en offrant une plus grande marge de manœuvre que l'interface du fournisseur de services.
Ci-dessous, on peut voir les options disponibles pour cette opération:
On précise le Shared Service Provider (fournisseur de services) avec lequel on veut interagir (sspname), la propriété que l'on veut déplacer (property), et la façon dont on veut la déplacer (move) qui peut prendre les valeurs suivantes :
- top : mettre la propriété en première position de la liste,
- bottom : mettre la propriété en dernière position de la liste,
- up : monter la propriété (d'une place par défaut),
- down : descendre la propriété (d'une place par défaut),
- x : on donne une position directement (entier positif).
Pour les options up & down, on peut préciser l'écart (variation). Par défaut, cet écart est de 1. Par exemple, pour monter de 2 lignes, on exécutera la commande suivante :
Voilà, j'espère que ce petit outil vous aidera, autant qu'il m'a aidé. Je précise qu'il est distribué "as is", donc testez le bien avant de le passer sur un environnement de production.
Vous pouvez télécharger le package wsp sur CodePlex.
N'hésitez pas à m'apporter vos commentaires.
- Julien