Localisation dans le modèle SharePoint de l’entreprise

L’approche que vous prenez pour implémenter la localisation pour les add-ins est différente dans le nouveau modèle de SharePoint par rapport au code de confiance totale. Dans un scénario classique de code de confiance totale /solution de batterie de serveurs, la localisation de composants personnalisés tels que des composants Web, des contrôles utilisateur et des contrôles Web a été implémentée avec une combinaison de fichiers de ressources, de code géré .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 SharePoint Solutions.

Dans un SharePoint de modèle de SharePoint, vous utilisez JavaScript ou les fonctionnalités de localisation associées à la technologie web avec qui vous créez vos applications pour implémenter la localisation. En fonction de la ressource localisée, vous pouvez également utiliser des fichiers de ressources classiques, par exemple lorsque vous avez besoin de localiser des éléments déployés sur le site web de add-in à l’aide d’éléments d’infrastructure de fonctionnalité dans la définition de l’application.

Conseils généraux

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

  • Vous devez installer les packs de langue 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 SharePoint est également une approche que vous pouvez utiliser pour trouver du contenu dans les composants de l’éditeur de script.

Scénarios de localisation

Il existe deux scénarios distincts dans lequel vous devrez peut-être implémenter la localisation d’un add-in.

  • SharePoint hébergés par un groupe
  • Add-ins hébergés par un fournisseur

Composants ou composants de site web de recherche de contenu

Dans ce scénario, la localisation est appliquée au add-in via JavaScript.

  • SharePoint hébergés par des serveurs SharePoint n’ont pas accès aux fichiers de ressources basés sur le serveur, mais vous avez accès aux fichiers * .resx de l’élément de fonctionnalité.
  • L’approche de la SharePoint d’un Office et d’un Office est très similaire, car elles utilisent toutes deux JavaScript.

Quand est-elle adaptée ?

Lorsque vous créez un add-in hébergé par SharePoint, l’utilisation de JavaScript est la meilleure adaptée, 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 add-in hébergé par SharePoint. Vous pouvez également tirer parti de cette approche si votre application hébergée par un fournisseur contient également un site web de add-in 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 add-in, ainsi que les attributs associés aux éléments HTML dans le add-in.

La section Localize SharePoint Add-ins montre également comment utiliser JavaScript pour localiser des ressources dans le site web de l’application.

Composants distants

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

  • Lorsque ASP.NET est utilisé pour implémenter le add-in, 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 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 qui est utilisée 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é ni de complexité supplémentaire.

Prise en main

Les articles suivants décrivent comment localiser des add-ins 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