Partager via

Localisation dans le modèle de complément SharePoint

  • Article

L’approche que vous utilisez pour implémenter la localisation des compléments est différente dans le nouveau modèle de complément SharePoint et dans le code de confiance totale. Dans un scénario standard de code de confiance totale (FTC) /solution de batterie de serveurs, la localisation des composants personnalisés tels que les composants WebPart, les contrôles utilisateur et les contrôles Web a été implémentée avec une combinaison de fichiers de ressources, de code managé .Net, de propriétés et de code déclaratif. Tous les artefacts ont été empaquetés dans des fonctionnalités déployées via des solutions SharePoint.

Dans un scénario de modèle de complément SharePoint, vous utilisez JavaScript ou les fonctionnalités de localisation associées à la technologie web avec laquelle vous créez vos compléments pour implémenter la localisation. Selon la ressource localisée, vous pouvez également utiliser des fichiers de ressources classiques, par exemple lorsque vous devez localiser des éléments déployés sur le site web de complément à l’aide d’éléments d’infrastructure de fonctionnalités dans la définition du complément.

Conseils généraux

En règle générale, nous aimerions fournir les instructions générales suivantes pour l’implémentation de la localisation.

  • Vous devez installer les modules linguistiques appropriés dans vos environnements SharePoint locaux et Office 365 pour permettre aux utilisateurs de créer des sites web dans une langue et une culture spécifiques.
  • L’utilisation de JavaScript pour implémenter la localisation dans les compléments SharePoint est également une approche que vous pouvez utiliser pour localiser du contenu dans les composants de complément de l’éditeur de script.

Scénarios de localisation

Il existe deux scénarios distincts dans lesquels vous devrez peut-être implémenter la localisation d’un complément.

  • Compléments hébergés par SharePoint
  • Compléments hébergés par un fournisseur

Composants ou ressources web de complément

Dans ce scénario, la localisation est appliquée au complément via JavaScript.

  • Les compléments hébergés par SharePoint n’ont pas accès aux fichiers de ressources basés sur le serveur dans les serveurs SharePoint, mais vous avez accès aux fichiers *.resx de l’élément de fonctionnalité.
  • L’approche de localisation d’un complément hébergé par SharePoint et d’un complément Office est très similaire, car ils utilisent tous deux JavaScript.

Quand est-elle adaptée ?

Lorsque vous créez un complément hébergé par SharePoint, l’utilisation de JavaScript est la meilleure solution, car vous pouvez implémenter la localisation avec JavaScript et déployer tous les fichiers JavaScript nécessaires pour prendre en charge la localisation avec le complément hébergé par SharePoint. Vous pouvez également tirer parti de cette approche si votre complément hébergé par le fournisseur contient également un site web de complément spécifique.

Prise en main

Le scénario 2 dans Core.JavaScriptCustomization (exemple PnP O365)) montre comment utiliser JavaScript pour localiser le texte dans un complément, ainsi que les attributs associés aux éléments HTML dans le complément.

Le complément Localiser SharePoint montre également comment utiliser JavaScript pour localiser des ressources dans le site web de complément.

Composants distants

Dans ce scénario, la localisation est appliquée au complément via les technologies de localisation associées à la technologie web hébergeant le complément.

  • Lorsque ASP.NET est utilisé pour implémenter le complément, les fichiers de ressources et les fichiers JavaScript sont utilisés pour le localiser.
  • Lorsqu’une autre technologie telle que PHP, Python ou Ruby est utilisée pour implémenter le complément, les fonctionnalités de localisation associées à ces plateformes sont utilisées.

Quand est-elle adaptée ?

Lorsque vous créez un complément hébergé par un fournisseur, l’utilisation de la technologie de localisation fournie avec la plateforme d’hébergement web est la meilleure solution, car vous créez le complément d’une manière qui n’introduit pas de code personnalisé ou de complexité supplémentaire.

Mise en route

Les articles suivants expliquent comment localiser des compléments hébergés par un fournisseur avec des fichiers de ressources et JavaScript.

Exemples PnP

S’applique à

  • Office 365 multi-locataire (MT).
  • Office 365 dédiés (D)
  • SharePoint 2013 en local