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

重要

SharePoint アドインは、2026 年 4 月 2 日に SharePoint Online のサポートが終了しました。 SharePoint でホストされているアドインとプロバイダーでホストされているアドインはどちらも廃止され、政府機関向けクラウドを含む SharePoint Online では機能しなくなります。 アドインの開発、展開、使用に関するガイダンスは、新しい SharePoint Online ソリューション用ではなく、履歴参照と該当する SharePoint Server シナリオ用に保持されます。

オンプレミスのアプリ カタログを通じて展開された SharePoint Server アドインは、この変更によって廃止されません。 パブリック マーケットプレースからの SharePoint アドインの取得は、SharePoint Server の 2026 年 4 月 2 日に終了しました。

この廃止により、SharePoint REST API、CSOM、JSOM、または SharePoint Framework (SPFx) は廃止されません。 SharePoint Online の場合は、ユーザー インターフェイス拡張機能に SPFx を使用し、外部アプリケーションへの認証に Microsoft Entra ID を使用します。 廃止のお知らせとアドインの移行ガイダンスを参照してください。

新しい 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 オンプレミス