SharePoint アドイン モデルにおけるローカライズ

  • [アーティクル]

新しい SharePoint アドイン モデルにおいて、アドインのローカライズを実装する方法は、完全信頼コードの場合とは異なります。 一般的な完全信頼コード (FTC) /ファーム ソリューション シナリオでは、Web パーツ、ユーザー コントロール、Web コントロールなどのカスタム コンポーネントのローカライズが、リソース ファイル、.Net マネージド コード、プロパティ、宣言型コードの組み合わせで実装されました。 すべての成果物は、SharePoint ソリューションを使用して展開されている機能にパッケージ化されています。

SharePoint アドイン モデル シナリオでは、JavaScript またはアドインを構築する Web テクノロジと関連付られたローカライズ機能を使用して、ローカライズを実装します。 ローカライズされたリソースによっては、クラシック リソース ファイルを使用することもできます。たとえば、アドイン定義の機能フレームワーク要素を使用してアドイン Web にデプロイされた要素をローカライズする必要がある場合などです。

基本ガイドライン

ローカライズの実装については、大まかに次のような基本ガイドラインが提供されています。

  • ユーザーが特定の言語とカルチャで Web サイトを作成できるようにするには、オンプレミスの SharePoint および Office 365 環境に適切な言語パックをインストールする必要があります。
  • Script Editor アドイン パーツのコンテンツをローカライズする場合は、JavaScript を使用して SharePoint アドインでローカライズを実装することもできます。

ローカライズのシナリオ

アドインへローカライズを実装する必要が出るケースには、2 つの異なるシナリオがあります。

  • SharePoint ホスト型アドイン
  • プロバイダー ホスト型アドイン

アドイン Web コンポーネントまたは資産

このシナリオでは、ローカライズは JavaScript を使用してアドインに適用されます。

  • SharePoint ホスト型アドインは、SharePoint サーバー内のサーバー ベースのリソース ファイルにアクセスできませんが、機能要素 *.resx ファイルにアクセスできます。
  • SharePoint ホスト型アドインおよび Office アドインのローカライズ方法は、両方とも JavaScript を使用しているため、非常に似ています。

適切な場合

SharePoint ホスト型アドインを作成するときは、JavaScript の使用が最適です。 これは、JavaScript を使用してローカライズを実装し、ローカライズのサポートに必要なすべての JavaScript ファイルを SharePoint ホスト型アドインで展開できるためです。

作業の開始

Core.JavaScriptCustomization (O365 PnP サンプル)) のシナリオ 2 は、JavaScript を使用してアドイン内のテキストや、アドイン内の HTML 要素に関連付けられた属性をローカライズする方法を示しています。

また、SharePoint アドインをローカライズする では、JavaScript を使用してアドイン Web 内の資産をローカライズする方法も示しています。

リモート コンポーネント

このシナリオでは、アドインをホストしている Web テクノロジに関連付けられたローカライズ テクノロジを使用して、ローカライズがアドインに適用されます。

  • ASP.NET を使用してアドインを実装する場合、ローカライズするリソース ファイルや JavaScript ファイルが使用されます。
  • PHP、Python、Ruby などの別のテクノロジを使用してアドインを実装する場合は、これらのプラットフォームに関連付けられているローカライズ機能が使用されます。

適切な場合

プロバイダー ホスト型アドインを作成する場合は、Web ホスティング プラットフォームに付属しているローカライズ テクノロジを使用すると、カスタム コードの導入や複雑性が発生しない方法でアドインを構築するため最適です。

作業の開始

次の記事では、リソース ファイルと JavaScript を使用してプロバイダー向けのホスト型アドインをローカライズする方法について説明します。

PnP サンプル

適用対象

  • Office 365 マルチテナント (MT)
  • Office 365 専用 (D)
  • SharePoint 2013 オンプレミス