SharePoint アドイン モデルにおけるマスター ページ

重要

このガイダンスは、従来の SharePoint エクスペリエンスと SharePoint アドイン モデルに適用されます。 カスタム マスター ページは、最新の SharePoint Online エクスペリエンスではサポートされておらず、従来のカスタマイズ アプローチと見なされます。

新しい SharePoint アドイン モデルで SharePoint サイトにカスタム マスター ページを実装する方法は、完全信頼コード / ファーム ソリューションの場合とは異なります。 一般的な完全信頼コード (FTC) ファーム / ソリューション シナリオでは、カスタム マスター ページはカスタム ブランドを実装するよう作成されます。 マスター ページは通常、宣言型コードと FTC / ファーム ソリューションを使用してマスター ページを展開し、それらを SharePoint サイトに登録します。

SharePoint アドイン モデルのブランド化シナリオでは、カスタム マスター ページを使用できます。 リモート プロビジョニング パターンを使用して SharePoint サイトでカスタム マスター ページを展開して登録できます。

カスタム マスター ページの基本ガイドライン

カスタム マスター ページについては、大まかに次のような基本ガイドラインが提供されています。

  • カスタム マスター ページを使用して SharePoint サイトをカスタマイズすることができますが、長期にわたる追加コストと将来の更新に関する課題が生じることに留意してください。

    • ほとんどの場合、テーマ、構成された外観、および代替 CSS により、一般的なすべてのブランド化シナリオを達成できます。

      See the Branding SharePoint Sites (SharePoint Add-in Recipe) to learn all about the different branding options you have for SharePoint sites with the SharePoint Add-in model. The recipe will help you consider the short and long-term impact of customization from an operational and a maintenance perspective. 特定のブランド化要件を実装するためにカスタム マスター ページが必要ない場合があります。

    • カスタム マスター ページを使用する場合は、主要な機能更新プログラムが Microsoft 365 に適用されるときに、カスタム マスター ページに変更を適用するように準備してください。

  • カスタム マスター ページを SharePoint サイトに展開して登録するには、リモート プロビジョニングを使用します。
  • 宣言型コードやサンドボックス コードを使用して、SharePoint サイトにマスター ページを展開して登録しないでください。

チーム サイトと発行サイト

どのような場合にカスタム マスター ページが必要となるでしょうか。

SharePoint サイトにカスタム ブランドを適用する場合は、チーム サイトと発行サイトの両方をブランド化する必要があります。 一般に、オンプレミスと Microsoft 365 の両方のシナリオで SharePoint 上に構築されたイントラネットでは、チーム サイトと発行サイトの組み合わせが使用されます。

カスタム ブランド化の要件では、多くの場合、テーマと JavaScript 埋め込み手法では実現できない特定のレイアウト変更が必要です。

このようなシナリオでは、通常、チーム サイトは、発行サイトが行うカスタム ブランドの量を必要とせず、モバイル デバイス用のすぐに使用できる SharePoint コンテンポラリー ビューで、チーム サイトのモバイル デバイスをサポートするのに十分です。 この場合、サイトの発行にはカスタム マスター ページのみを使用し、AlternativeCSS とカスタム SharePoint テーマ (*.spcolor ファイル)、フォント スキーム (*.spfont ファイル)、および構成済みとして定義された背景画像を使用することをお勧めします。

展開に関する考慮事項

  • 発行サイトにカスタム マスター ページを展開する場合は、カスタム マスター ページをルート サイトに展開するだけで済みます。
  • 発行されていないサイトにカスタム マスター ページを展開する場合は、カスタム マスター ページを各サイトに展開する必要があります。

通常、カスタム マスター ページはサイトがプロビジョニングされるときに適用されます。 リモート プロビジョニング プロセスは、このアプローチに適しています。 通常、Web ブラウザーを使用して SharePoint ブランド化のカスタマイズを手動で適用するのは、他のサイト コレクションやサブ サイトを含むように拡張する予定のない 1 つの SharePoint サイトをプロトタイプ化または変更する場合だけです。

SharePoint サイトのカスタム マスター ページおよびページ レイアウトの詳細

カスタム ブランド化の要件を実装する唯一の方法がカスタム マスター ページであるシナリオでは、カスタム マスター ページとページ レイアウトを作成することができます。 このアプローチに関連する長期的なメンテナンス コストに関するこの記事の冒頭で行われたポイントに留意してください。

  • SharePoint サイト用のカスタム マスター ページを使用すると、最高レベルのカスタマイズ (無制限) を実行できます。
  • SharePoint サイト用のカスタム マスター ページを短期および長期間にわたって実装およびメンテナンスするには、大量の時間が必要です。
  • サービス更新プログラムに付属するすぐに使えるマスター ページに対する変更は、カスタム マスター ページには反映されません。
  • カスタム マスター ページはサイトごとのレベルで適用できます。
  • カスタム マスター ページを使用する場合は、すぐに使えるマスター ページの 1 つから始めて、ニーズに合わせて変更することをお勧めします。
    • カスタム マスター ページを使用して行うカスタマイズの量を最小限に抑えるようにしてください。これにより、Microsoft 365 サービスがすぐに使用できるマスター ページに変更を加えた場合に、カスタム マスター ページにレプリケートする必要がある場合に、それらを簡単に更新できます。
  • SharePoint マスター ページには多くの必須コンテンツ プレースホルダーがあり、削除しないでください。またはページがエラーになる可能性があります。 必要なコンテンツ プレースホルダーを削除した場合は、その場所をデプロイしてマスター ページをサイトに割り当てる分、エラーが表示されます。

SharePoint サイト用のカスタム マスター ページとページ レイアウトが適しているケース

このオプションは、ブランド化のニーズが特定の場合、または発行サイトを使用している場合に適切に機能します。

  • Web ブラウザーを使用してカスタム マスター ページを手動でアップロードし、構成された外観に手動で割り当てることができます。
  • リモート プロビジョニング パターンを使用してカスタム マスター ページをアップロードし、SharePoint サイトに割り当てることもできます。

PnP サンプル

適用対象

  • Microsoft 365 マルチテナント (MT)
  • Microsoft 365 Dedicated (D) の一部
  • SharePoint 2013 オンプレミス - 一部

専用およびオンプレミスの場合のパターンは SharePoint アドイン モデル手法と同じですが、使用可能なテクノロジは異なる可能性があります。

  • Last updated on