List Filter Online のインストールとページへの追加方法

はじめに

List Filter Online は、1 つのSharePoint Frameworkパッケージとして提供されます。インストールは 2 つの手順で行い、通常は 2 人の担当者が分担します。SharePoint 管理者がテナントのアプリ カタログにパッケージをアップロードし、サイト所有者が Web パーツをページに追加してリストまたはライブラリを指定します。この記事では、ダウンロードした ZIP ファイルからページの発行までの両方の手順を順を追って説明し、新しいバージョンがリリースされたときに Web パーツを更新する方法も説明します。

前提条件

開始する前に、次の点を確認してください。

• テナントにアプリ カタログがあること。ない場合は、SharePoint 管理者が SharePoint 管理センターの More features (その他の機能) > Apps (アプリ) で作成します。
• パッケージをアップロードするために、SharePoint 管理者であるか、アプリ カタログの所有者グループのメンバーであること。
• Web パーツを追加して構成するために、サイトの所有者であるか、ページの編集アクセス許可を持っていること。
• ダウンロードしたパッケージがあること。Vitextra.ListFilterOnline.<year>Q<quarter>.zip という名前の ZIP ファイル (例: Vitextra.ListFilterOnline.2026Q4.zip) で、ソリューション ファイル vitextra.list-filter.sppkg が含まれています。アップロードする前に .sppkg ファイルを展開してください。

手順 1. パッケージをアプリ カタログにアップロードする

1. テナントのアプリ カタログ サイトを開き、Apps for SharePoint に移動します。
2. vitextra.list-filter.sppkg をアップロードするか、リストにドラッグします。
3. 表示されたダイアログで Enable this app and add it to all sites (このアプリを有効にして、すべてのサイトに追加する) を選択し、Enable app (アプリを有効にする) で確定します。パッケージはテナント全体への展開用に作成されているため、この手順の後は、Web パーツはテナントのすべてのサイトで使用でき、Add an app (アプリの追加) でサイトに追加する必要はありません。

アプリ カタログと展開ダイアログのスクリーンショット付きの一般的な手順は、KB10035. クラウドベースの製品のインストールで説明しています。

手順 2. Web パーツをページに追加する

1. リストを表示するモダン ページを開き、右上の Edit (編集) をクリックします。新しいページが必要な場合は、サイトの New (新規) > Page (ページ) から作成します。
2. セクション内で Web パーツを配置する場所にポインターを合わせ、+ (プラス) ボタンをクリックします。
3. ツールボックスの検索ボックスに List Filter と入力するか、Documents, lists, and libraries (ドキュメント、リスト、ライブラリ) グループまでスクロールして、List Filter を選択します。

Web パーツがページに追加され、次の手順で説明する構成チェックリストがすぐに表示されます。

構成チェックリスト

データ ソースが完成するまで、Web パーツには Not Configured (未構成) という見出しと 3 つの行を持つチェックリストが表示されます。各行には、チェック マークまたは Not Configured のいずれかが付いています。

1. Site (サイト) — リストを含むサイトです。既定では現在のサイトがすでに選択されているため、通常この行はすぐに完了します。
2. List or Library (リストまたはライブラリ) — 表示する、リストまたはドキュメント ライブラリです。
3. Columns (列) — テーブルに表示する列です。少なくとも 1 つの列を選択するまで、この行には You must select at least one column to display for this view. というメッセージが表示されます。

編集モードでは、チェックリストの末尾に Configure Web Part (Web パーツの構成) ボタンがあり、Web パーツのプロパティ ペインが開きます。Web パーツの鉛筆アイコンでも同じペインが開きます。

最小限の構成

必須の 3 つのパラメーターはすべて、プロパティ ペインの最初のグループである Data Source (データ ソース) グループにあります。

1. Scope (スコープ): ページが属するサイトのリストを表示するには、Current Site (現在のサイト) のままにします。テナント内の別のサイトのリストを表示するには、Other Site (別のサイト) を選択します。下に Site URL ピッカーが表示されるので、サイトの名前または URL を入力し、候補から選択します。選択したサイトは、ロゴ、タイトル、URL とともに表示されます。
2. List (リスト): ドロップダウンからリストまたはライブラリを選択します。ドロップダウンには、選択したサイトのリストとライブラリが一覧表示されます。
3. Columns (列): Select Columns (列の選択) をクリックします。Columns パネルで、テーブルの Display (表示) 列にある、表示する列をオンにして、Save (保存) をクリックします。この時点で、列の Caption (キャプション) と Order (順序) を変更することもできます。その他のオプションについては、KB10258. List Filter Online での列の構成: 見出し、形式、表示オプションで説明しています。

3 つ目のパラメーターが設定されるとすぐに、チェックリストが消え、Web パーツにリストの最初の項目が表示されます。

発行と確認

Republish (再発行) (新しいページの場合は Publish (発行)) をクリックします。ユーザーと同じようにページを開き、次の点を確認します。

• テーブルに、想定どおりの列と項目が表示されている。
• ユーザーには、アクセス権のある項目のみが表示される。Web パーツは現在のユーザーの権限でリストを読み取るため、リストのアクセス許可がそのまま適用されます。
• 必要に応じて、フィルター パネルとコマンド ツール バーが表示されている。どちらも既定で有効になっており、Filter pane (フィルター パネル) グループと Command toolbar (コマンド ツール バー) グループでオフにできます。

新しいバージョンへの更新

List Filter Online の新しいリリースは、最初のインストールと同じ方法でインストールします。新しい vitextra.list-filter.sppkg を Apps for SharePoint にアップロードし、既存のファイルを置き換えることを確認して、もう一度 Enable this app and add it to all sites を選択します。パッケージはテナント全体に展開されるため、Web パーツがあるすべてのページで次回の読み込み時に新しいバージョンが使用されます。再構成は必要なく、既存の Web パーツの設定は保持されます。ページで実行されているバージョンよりも新しいバージョンがある場合、Web パーツはページの編集者に There is a new version of this app. Get it now. というメッセージを表示します。

まとめ

List Filter Online のインストールとは、テナント全体への展開を指定して 1 つの .sppkg ファイルをアプリ カタログにアップロードし、List Filter Web パーツをページに追加して、3 つの必須パラメーター (Site、List or Library、Columns) を設定することです。その後は、Web パーツがページのすべてのユーザーに対して、それぞれの権限で動作します。