SharePoint Online での Single Part App Pages の使用

  • [アーティクル]

Single Part App Pages では、SharePoint Framework Web パーツまたは SharePoint Online の Microsoft Teams アプリケーションを、ロックされたレイアウトでホストすることができます。 エンド ユーザーは、Single Part App Pages レイアウトを使用しているページを変更したり設定したりできません。

App Pages には、次のような特徴があります。

  • エンド ユーザーはブラウザーを使って Single Part App Pages を編集できない
  • 現在は、単一の Web パーツまたは Microsoft Teams アプリケーションのホスト機能のみをサポートしている
  • エンドユーザーは、モダン サイトで利用可能な 新規>ページのエクスペリエンスを使用して、新しいアプリ ページを作成できます。
  • 開発者は、通常のページ レイアウトから Single Page App ページに、プログラムを使用してページ レイアウトを変更することができます。
  • Single Page App ページに新しいエクスペリエンスはありません。 エンド ユーザーは、モダン アーティクル ページのリボンに表示されている新規/ページ エクスペリエンスを使用して、新しい Article ページまたは Single Page App ページを作成できます。

ページに使用したページ レイアウトを選択すると、アプリのページは最新のページ作成機能のオプションとして公開されます。 アプリ ページとしても利用可能なように構成されたすべての Web パーツは、ページの作成 機能で利用できます。

アプリ ページとして公開されるように、Web パーツを構成できます。 この構成は、Web パーツのマニフェスト ファイルで supportedHosts の値を調整して行います。 supportedHosts の値に "SharePointFullPage" 値が含まれている場合、予定されているアプリ ページ選択ユーザー インターフェイスのオプションとして、Web パーツが公開されます。

以下の Web パーツ マニフェストでは、supportedHosts パラメーターのすべての異なる値を更新することによって、サポートされているすべてのプラットフォームに Web パーツを含めるシナリオを示します。

{
  // ...

  "requiresCustomScript": false,
  "supportedHosts": ["SharePointWebPart", "SharePointFullPage", "TeamsTab"],

  "preconfiguredEntries": [{
    // ...
  }]
}

テナント内で Single Part App ページをプロビジョニングする方法

開発者として、Single Part App ページをプロビジョニングする最も一般的な方法は、PnP PowerShell または CLI for Microsoft 365 を使用する 2 つの方法です。

PnP PowerShell を使用して、以下のスクリプトで既存のページのレイアウトを更新することもできます。

注:

PnP PowerShell はオープン ソース ソリューションであり、アクティブなコミュニティでサポートが提供されています。 Microsoft からのオープン ソース ツールのサポート SLA はありません。

また、CLI for Microsoft 365 を使用して、以下のスクリプトで既存のページのページ レイアウトを更新することもできます。

注:

CLI for Microsoft 365 はオープン ソース ソリューションであり、アクティブなコミュニティでサポートが提供されています。 Microsoft からのオープン ソース ツールのサポート SLA はありません。

Connect-PnPOnline -Url https://contoso.sharepoint.com/sites/marketing
Set-PnPPage -Identity "Page" -LayoutType SingleWebPartAppPage

このコマンドレットの詳細および例については、「PnP PowerShell のドキュメント」を参照してください。

環境に合わせてテナントとページの名前を調整する必要があります。