Lokalisierung im SharePoint-Add-In-Modell

  • Artikel

Der Ansatz, den Sie verwenden, um die Lokalisierung für Add-Ins zu implementieren, unterscheidet sich im neuen SharePoint-Add-In-Modell von dem bei voll vertrauenswürdigem Code. In einem typischen FTC-Szenario (Full Trust Code) /Farm Solution wurde die Lokalisierung für benutzerdefinierte Komponenten wie Webparts, Benutzersteuerelemente und Websteuerelemente mit einer Kombination aus Ressourcendateien, verwaltetem .NET-Code, Eigenschaften und deklarativem Code implementiert. Alle Artefakte wurden in Features verpackt, die über SharePoint-Lösungen bereitgestellt wurden.

In einem SharePoint-Add-In-Modellszenario verwenden Sie JavaScript oder die Lokalisierungsfunktionen, die der Webtechnologie zugeordnet sind, mit der Sie Ihre Add-Ins erstellen, um die Lokalisierung zu implementieren. Abhängig von der lokalisierten Ressource können Sie auch klassische Ressourcendateien verwenden, z. B. wenn Sie Elemente lokalisieren müssen, die im Add-In-Web mithilfe von Featureframeworkelementen in der Add-In-Definition bereitgestellt werden.

Richtlinien auf hoher Ebene

Als Faustregel möchten wir die folgenden allgemeinen Richtlinien für die Implementierung der Lokalisierung bereitstellen.

  • Sie müssen die entsprechenden Sprachpakete in Ihren lokalen und Office 365 SharePoint-Umgebungen installieren, damit Benutzer Websites in einer bestimmten Sprache und Kultur erstellen können.
  • Die Verwendung von JavaScript zum Implementieren der Lokalisierung in SharePoint-Add-Ins ist auch ein Ansatz, den Sie verwenden können, um Inhalte in Skript-Editor-Add-In-Parts zu lokalisieren.

Lokalisierungsszenarien

Es gibt zwei verschiedene Szenarien, in denen Sie möglicherweise die Lokalisierung für ein Add-In implementieren müssen.

  • Von SharePoint gehostete Add-Ins
  • Vom Anbieter gehostete Add-Ins

Add-In-Webkomponenten oder -Ressourcen

In diesem Szenario wird die Lokalisierung über JavaScript auf das Add-In angewendet.

  • Von SharePoint gehostete Add-Ins haben keinen Zugriff auf serverbasierte Ressourcendateien auf den SharePoint-Servern, aber Sie haben Zugriff auf die * .resx-Dateien des Featureelements .
  • Der Ansatz zum Lokalisieren eines von SharePoint gehosteten Add-Ins und eines Office-Add-Ins ist sehr ähnlich, da beide JavaScript verwenden.

Wann ist die Option geeignet?

Wenn Sie ein von SharePoint gehostetes Add-In erstellen, ist die Verwendung von JavaScript am besten geeignet, da Sie die Lokalisierung mit JavaScript implementieren und alle JavaScript-Dateien bereitstellen können, die zur Unterstützung der Lokalisierung mit dem von SharePoint gehosteten Add-In erforderlich sind. Sie können diesen Ansatz auch nutzen, wenn Ihr vom Anbieter gehostetes Add-In auch ein bestimmtes Add-In-Web enthält.

Erste Schritte

Szenario 2 in der Core.JavaScriptCustomization (O365 PnP-Beispiel)) veranschaulicht, wie JavaScript verwendet wird, um den Text in einem Add-In sowie Attribute zu lokalisieren, die den HTML-Elementen im Add-In zugeordnet sind.

Die Lokalisieren von SharePoint-Add-Ins veranschaulicht auch, wie JavaScript zum Lokalisieren von Ressourcen im Add-In-Web verwendet wird.

Remotekomponenten

In diesem Szenario wird die Lokalisierung über die Lokalisierungstechnologien, die der Webtechnologie zugeordnet sind, die das Add-In hosten, auf das Add-In angewendet.

  • Wenn ASP.NET zum Implementieren des Add-Ins verwendet wird, werden Ressourcendateien und JavaScript-Dateien verwendet, um es zu lokalisieren.
  • Wenn eine andere Technologie wie PHP, Python oder Ruby zum Implementieren des Add-Ins verwendet wird, werden die Lokalisierungsfunktionen verwendet, die diesen Plattformen zugeordnet sind.

Wann ist die Option geeignet?

Wenn Sie ein vom Anbieter gehostetes Add-In erstellen, ist die Verwendung der Lokalisierungstechnologie der Webhostingplattform am besten geeignet, da Sie das Add-In auf eine Weise erstellen, die weder benutzerdefinierten Code noch zusätzliche Komplexität mit sich bringt.

Erste Schritte

In den folgenden Artikeln wird beschrieben, wie Sie vom Anbieter gehostete Add-Ins mit Ressourcendateien und JavaScript lokalisieren.

PnP-Beispiele

Gilt für

  • Office 365 mit mehreren Mandanten (MT)
  • Office 365 dediziert (D)
  • SharePoint 2013 lokal