Localisation d'une solution

Windows SharePoint Services 3

Les solutions et les packages de composants WebPart acceptent tous deux des modules de prise en charge linguistique. Un module de prise en charge linguistique est une collection de ressources qui permet d'ajouter la prise en charge linguistique à une solution principale existante.

Windows SharePoint Services traite les modules de prise en charge linguistique de la même façon que toute autre solution ; toutefois, leur déclaration en tant que tels est liée à la façon dont un administrateur les soumet au magasin de solutions. Lorsqu'il spécifie le paramètre de langue sur la ligne de commande (ou par le biais du modèle objet), l'administrateur déclare de manière explicite qu'une solution est un module de prise en charge linguistique.

Les points à prendre en compte pour utiliser les modules de prise en charge linguistique sont présentés ci-après :

  • Une solution principale peut contenir plusieurs jeux de langue ou n'en contenir aucun. Elle peut ne contenir aucune ressource spécifique à la langue (et par conséquent être inopérante sans un module de prise en charge linguistique) ou, au contraire, être multilingue et contenir des ressources pour plusieurs langues (dans laquelle aucun module de prise en charge linguistique supplémentaire n'est requis ou dans laquelle les modules de prise en charge linguistique contiennent une prise en charge linguistique supplémentaire).

  • Un module de prise en charge linguistique peut être lié à une langue seulement.

  • Un module de prise en charge linguistique peut être lié à une solution principale seulement.

  • Un module de prise en charge linguistique ne peut pas être ajouté au magasin de solutions excepté si la solution principale qu'il modifie réside également dans le magasin de solutions.

  • Un module de prise en charge linguistique ne peut pas être déployé excepté si la solution principale à laquelle il est associé est déployée.

  • Une solution ne peut pas être retirée sauf si tous les modules de prise en charge linguistique qui lui sont associés sont retirés en premier.

Remarque Remarque :

Ces restrictions ne s'appliquent pas aux modules de prise en charge linguistique des packages de composants WebPart. Pour des raisons de compatibilité descendante, un module de prise en charge linguistique d'un package de composants WebPart peut être ajouté au magasin et être déployé, même si la solution principale n'est pas déployée.

Création d'un module de prise en charge linguistique

Une solution ne contient pas de ressources localisables ; par conséquent, une solution n'est pas en soi liée à une langue. Les ressources localisables qui lient une solution à une langue particulière sont les suivantes :

  • fichiers de ressources spécifiques à la fonctionnalité,

  • ressources satellites et assemblys satellites de packages de composants WebPart,

  • fichiers de modèles Web spécifiques à la langue (webtemp*.xml),

  • fichiers _layout spécifiques à la langue.

Comme avec n'importe quelle autre solution, un module de prise en charge linguistique contient un fichier manifest.xml à sa racine. Il doit porter le même ID de solution que la solution indépendante de la culture.

Remarque Remarque :

Pour plus d'informations sur le fichier manifest.xml, voir Création d'une solution.

Pour ajouter des ressources à une solution, définissez une section dans le fichier manifeste du module de prise en charge linguistique à l'intérieur de la balise <Resources>. Lorsque cette balise est présente dans un fichier manifeste, un fichier sentinelle de culture est écrit automatiquement.

Les fichiers de ressources de fonctionnalités locaux sont situés dans le chemin d'accès <featuredir>\Resources\resources.<culture>.resx. L'exemple suivant montre des fichiers de ressources situés dans <featuredir>/Resources/resources.1033.resx.

<Resources>
  <Resource Location="\Resources\Resource.en-us.resx">
  </Resource>
</Resources>

Si le fichier de ressources local n'existe pas, le fichier de ressources de base partagé qui est situé dans le chemin d'accès 12\Resources\core.en-us.resx est utilisé.

Les ressources applicatives sont placées dans le répertoire Resources du répertoire virtuel de l'application Web et sont conçues pour être utilisées dans les fonctionnalités et définitions de site, comme illustré dans l'exemple suivant.

<ApplicationResources>
  <ApplicationResource Location="wss.fr-fr.resx">
  </ApplicationResource>
</ApplicationResources >

En outre, les modules de prise en charge linguistique peuvent contenir une ou plusieurs balises < TemplateFiles > pour le déploiement des ressources Web, comme des fichiers .gif ou des fichiers statiques .htm.

Localisation de modules de prise en charge linguistique de composants WebPart

Le plus souvent, les modules de prise en charge linguistique des packages de composants WebPart sont gérés de la même manière que les modules de prise en charge linguistique pour n'importe quelle solution. Il existe cependant des différences dans la façon dont Solution Framework gère ces modules à partir de l'utilitaire stsadm. Certaines de ces différences sont décrites plus haut dans cette rubrique mais en voici deux autres très importantes :

  • Lorsque vous utilisez stsadm pour ajouter des modules de prise en charge linguistique de composants WebPart, le nom du fichier du module de prise en charge linguistique doit être identique à celui du fichier de solutions principales. Par exemple, si un développeur crée un package de composants WebPart nommé Weather.wpp contenant les assemblys principaux et la définition du composant WebPart Weather et que vous voulez ajouter un module de prise en charge linguistique contenant les fichiers de ressources pour le français, le module de prise en charge linguistique doit également être nommé Weather.wpp. Au moment du déploiement, l'administrateur ajoute le fichier .cab à l'aide du paramètre –lcid 1036.

  • Lorsque vous utilisez le modèle objet, le module de prise en charge linguistique peut porter n'importe quel nom de fichier ; il n'est pas nécessaire qu'il soit identique à celui du fichier de solution principale.

Voir aussi

Autres ressources

Création d'une solution

Afficher: