Pages de l'Administration centrale
Dernière modification : mercredi 9 décembre 2009
S’applique à : SharePoint Foundation 2010
Dans cet article
Page maître d'administration
Pages d'administration et ressources de localisation
Code-behind
Barre de navigation
Liens Opérations et Gestion des applications
Le site Web Administration centrale SharePoint Foundation utilise un répertoire virtuel nommé /_admin semblable au répertoire virtuel /_layouts des sites de contenu. Le répertoire virtuel d’administration est mappé physiquement au répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\\Template\Admin, dans lequel vous pouvez placer des pages d’administration personnalisées. Les pages qui se trouvent dans ce répertoire sont associées à la base de données de configuration, et non pas à la base de données de contenu.
Page maître d'administration
Pour garantir la cohérence de l'ensemble des pages d'administration, SharePoint Foundation fournit une page maître (admin.master) qui définit la mise en page. Pour plus d'informations sur les pages maîtres dans SharePoint Foundation, voir Pages maîtres.
La liste suivante décrit des espaces réservés clés définis dans le fichier de page maître SharePoint Foundation :
PlaceHolderPageTitle : titre affiché dans la barre supérieure du navigateur.
PlaceHolderPageTitleInTitleArea : titre affiché en gros caractères noirs sur la page restituée.
PlaceHolderAdditionalPageHead : autres éléments à placer dans la balise <HEAD> de la page, qui fournit un emplacement idéal pour le script côté client sur la page.
PlaceHolderPageDescription : description de la page.
PlaceHolderMain : emplacement de la majeure partie du contenu de page dérivé.
Les pages d'administration et de paramètres de site utilisent un ensemble de contrôles utilisateur et de contrôles serveur pour garantir la cohérence de l'ensemble des différents types de pages. Par exemple, les pages de paramètres recourent aux contrôles utilisateur InputFormSection et InputFormControl, tandis que les pages de style de grille ou de liste peuvent utiliser les contrôles serveur ToolBar et ToolBarButton pour implémenter une barre d'outils.
Pages d'administration et ressources de localisation
Les pages ASPX d'administration sont globales et reposent sur l'infrastructure de localisation intégrée à ASP.NET.
L'exemple suivant montre comment spécifier l'ID de ressource pour le titre d'un contrôle de liste déroulante :
<asp:DropDownList id="MyExample" runat="server"
Title="<%$Resources:YourResxFile, example_title%>" />
Les ressources des pages Web se trouvent dans un fichier .resx que vous pouvez placer dans le répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Config\AdminResources. Lorsque vous approvisionnez une application Web, les ressources définies dans ce fichier sont copiées dans le répertoire des services IIS approprié. Si vous apportez une modification au fichier .resx une fois que le site Administration centrale a été approvisionné, vous pouvez exécuter l’opération de ligne de commande stsadm.exe –o copyappbincontent pour redéployer les fichiers de ressources révisés.
Code-behind
Afin que le code soit séparé du contenu, les pages Web ASP.NET sont généralement divisées en classes code-behind et en pages .aspx. Les classes code-behind sont compilées dans un assembly privé pour l’application Web d’administration. Si vous placez l’assembly dans le répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\\Config\AdminBin, il est copié dans le site Web IIS d’administration pendant l’approvisionnement. Si vous recompilez le projet une fois le site Web Administration centrale créé, vous pouvez redéployer l’assembly en exécutant l’opération de ligne de commande stsadm.exe –o copyappbincontent.
Barre de navigation
La barre de navigation située en haut d’une page d’administration est construite à l’aide d’un fichier XML qui contient la hiérarchie de la page. Vous devez placer les fichiers sitemap dans le répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Template\Admin avec vos pages .aspx personnalisées et les nommer selon le modèle admin.sitemap.*.xml. L’exemple de fichier sitemap suivant montre comment créer la barre de navigation pour une nouvelle page de paramètres liée à partir de la page Opérations :
<siteMap>
<siteMapNode url="/_admin/YourPage.aspx"
parentUrl="/_admin/applications.aspx"
title="$Resources:YourResource,YourPage_StringId" />
<siteMapNode url="/_admin/YourSubPage.aspx"
title="$Resources: YourResource,YourSubPage_StringId" />
</siteMap>
Comme les pages .aspx, un fichier de barre de navigation utilise l'infrastructure ASP.NET pour la localisation.
Liens Opérations et Gestion des applications
Les pages Opérations et Gestion des applications permettent d'étendre les liens par le biais de l'infrastructure des composants fonctionnels SharePoint Foundation. Pour plus d'informations sur l'ajout de liens à l'aide des composants fonctionnels, voir Procédure : modifier l’interface utilisateur à l’aide d’actions personnalisées.
Pour rechercher les propriétés Location et GroupId appropriées pour un nouveau lien, parcourez les définitions de liens existantes. Les liens par défaut des pages Opérations et Gestion des applications se trouvent dans les fichiers Operations.xml et Applications.xml de %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\\TEMPLATE\FEATURES\AdminLinks.
Les fichiers de composants fonctionnels implémentent l'infrastructure SharePoint Foundation pour localiser les fichiers XML. La spécification des ressources est semblable à la syntaxe d'ASP.NET, à l'exception d'un point-virgule de fin (;). Placez les fichiers .resx qui définissent ces chaînes dans \12\Template\Resources.