【pleasanter】項目連携というものに今更気がついた

前回、プリザンターのフィルターについていろいろ調べてみましたが、その中で「項目連携」という言葉に気が付きました。いままで気が付かずスルーしていた機能でした。項目連携単体、項目連携のフィルターでの利用について、やってみたいと思います。

※おことわり
2024年6月時点の情報です。プリザンターのバージョンは 1.3.50.2 です。Google Chrome でやっています。
javascript,html,cssともに初心者です。調べながら、やってみながら、きっとこうすればいいんだ！という感じで書いていますので、間違っている場合、効率的な書き方ではない可能性が大いにあります。間違ってるよ！とか、こうしたほうがいいよ！ということがありましたら、コメント等で教えていただけると大変ありがたいです。

１．プリザンターの項目連携とは
２．やってみる
４．フィルターでの「項目連携」の利用
５．もうちょっとあれこれやってみる
６．wikiを使った場合も項目連携はできるのか
６．最後に
７.参考文献、記事

１．プリザンターの項目連携とは

プリザンター公式マニュアルより

概要
「エディタ」の「分類項目」に親子関係を設定することができます。親の分類項目を選択した場合に子の分類項目の選択肢が自動で親の分類項目の選択した値に対応したものに切り替わるようにすることができます。
引用元：https://pleasanter.org/manual/table-management-column-relations

分類項目に親子関係を設定することができる。つまり分類Aで「関東」を選んだら分類Bでは関東の都道府県「東京都、神奈川県・・・」だけが選択肢として表示される、みたいなことを実現する機能。ってことかな。

知らなかったのでこれまで apiGet とか、項目のフィルターとかでやっていたような。。。

脳内で理解した図解

少なくとも2段階の親子関係が必要と思われる

①地方区分テーブル(関東、関西等)があり、都道府県テーブルが地方区分テーブルを参照している。

②店舗テーブルは①の地方区分テーブルと都道府県テーブルを参照している。

店舗テーブルにおいても①の地方区分テーブル、都道府県テーブルのリレーションシップを生かしたい。（店舗テーブルにおいても地方区分で「関東」を選んだらと同区検名は「関東」の都道府県だけを選択肢に表示したい）

というときに「項目連携」という機能を設定するとよいぞ、ということかな。

２．やってみる

（１）使用するサイト（親テーブル）

●テーブル名：地方区分マスタ
・サイトID：508
・タイトル：地方区分

●テーブル名：都道府県マスタ
・サイトID：517
・タイトル：都道府県
・分類A：地方区分（サイト508をリンク）

（２）子テーブルの作成

（１）で作成済の親テーブル（マスタテーブル）を参照する子テーブル「店舗一覧」を作成していきます。
タイトルは「店舗名」、分類A「地方区分」→地方区分マスタを参照、分類B「都道府県」→都道府県マスタを参照。

●テーブル：店舗一覧
・サイトID：565
・タイトル：店舗名
・分類A：地方区分（サイト508をリンク）
・分類B：都道府県（サイト517をリンク）

（３）項目連携

さてと、この時点で「店舗一覧」テーブルで「新規作成」でレコードを作成してみましょう。

店舗名を入力し、地方区分に「関東」を選択。都道府県を選択しようとすると。。。全部出てきてしましますね。

ここで！項目連携を設定していきます。
①テーブルの管理＞エディタタブ
下のほうにスクロールしていくと「項目連携の設定」なるものがあるではないですか！
（なんでいままで気が付かなかったんだろう。。。）

②項目連携の設定の「新規作成」をクリックします。
③タイトルを入力します（特に何でも）
④項目連携を設定する項目を有効化します。

項目の上下の並びも肝心なのだそうです。
○○を設定すると、✖✖がきまる（✖✖の選択肢が絞り込みされる）の、○○が上で✖✖が下でないといけません。
この場合「地方区分」によって「都道府県」の範囲が決まるので、「地方区分」が上で「都道府県」が下です。

どうかな～。見てみましょう。お！地方区分「関東」を選択したら、都道府県は関東の都道府県に絞り込みされましたね！

４．フィルターでの「項目連携」の利用

エディタで「項目連携」を設定すると、フィルタでも利用することができます。

現在のフィルタの状態を見てみましょう。
地方区分を選択しても、都道府県名は絞り込みされていません。

フィルタの項目連携を設定します。
①テーブルの管理＞フィルタタブ
②下のほうの「項目連携を利用する」のチェックをオンにする。

すると、地方区分を選択→都道府県は地方区分で絞り込みされた都道府県のみが表示されるようになりました。

ただですね。ちょっと「あれ？」と思ったのは、地方区分を選択せず、いきなり都道府県だけでフィルタすると一瞬フィルタされてぱっと元に戻っちゃう現象が起きました。フィルタで「項目連携を利用する」を適用すると親の地方区分を選択してからでないと都道府県を指定しても、フィルタが効かない状態になるのかもしれません。ものによっては逆に不便になるかもしれません。使いよう、ですね。

５．もうちょっとあれこれやってみる

以前、リンクしている項目を並べ替えして表示するとか、ほかの項目で絞り込みして表示するとかをやりました。
【pleasanter】テーブル間のリンクとプルダウンリスト～Sort、Filter～
そんな風にごにょごにょやっても項目連携は生きるのか、やってみる（疑りぶかい）

「都道府県マスタ」にチェックA「非表示」項目を設けました。
ここがオンの場合は「店舗一覧」テーブルで選択肢に表示しないことにします。
また、レコードID順に選択肢が表示されるようにしたいと思います。
つまり、地域区分「四国」を選択すると非表示チェックがオフの県だけがID順に表示され、徳島県・愛媛県と選択肢として表示されるようにしたい。

「店舗一覧」テーブルの「都道府県」の選択肢の部分を以下のコードで書き換えます。
ColumnSorterHashでレコードID順に表示されるように、
ColumnFilterHashでチェックA（非表示）がオフのレコードだけ表示
、としています。

[
    {
        "SiteId": 517,
        "View": {
            "ColumnSorterHash": {
                "ResultId": "asc"
            },
            "ColumnFilterHash":{ 
                "CheckA":false
            }
        }
    }
]