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.
- Localize SharePoint Add-ins (article MSDN)
- Localize the add-in web, host web, and remote components of an add-in (MSDN Code Sample)
Liens connexes
- Localize SharePoint Add-ins (article MSDN)
- Localize the add-in web, host web, and remote components of an add-in (Office Dev GitHub sample)
- Articles de référence sur la page https://aka.ms/OfficeDevPnPGuidance
- Références dans MSDN sur la page https://aka.ms/OfficeDevPnPMSDN
- Vidéos sur la page https://aka.ms/OfficeDevPnPVideos
Exemples PnP
- Classe VariationsExtensions.cs (exemple PnP O365)
- Exemples et contenu dans Microsoft 365 et pratiques PnP (Patterns and Practices)
S’applique à
- Office 365 multi-locataire (MT).
- Office 365 dédiés (D)
- SharePoint 2013 en local