はじめに
Pleasanterのルックアップは、リンクを指定した上で、リンク先の特定の項目を転記することができる機能です。いわゆる、Excelのvlookupとかと同じイメージです。
このルックアップ、オプションがいろいろありますが、少々理解が難しいこともあり、改めて、オプション指定で何が起こるのか、可能な限りわかりやすくまとめてみたいと思います。
注意
- ルックアップを使うためには、リンク機能を知っておく必要がありますが、こちらについては理解している前提で整理しています。
- 以下に示したサイトは、基本的に自動ポストバックを設定、選択の都度、値が転記されるような設定を前提としています。
基本
参照するマスタサイト
「分類A(ClassA)」を転記します。分類A(ClassA)は単純にテキストを入力しています。
ルックアップで転記する側
転記先イメージ
分類I(ClassI)にルックアップを指定、分類J(ClassJ)にルックアップしてきた値を転記します。
分類I(ClassI)の設定（"選択肢一覧の設定"）
[
{
"SiteId": 315196,
"Lookups": [
{
"From": "ClassA",
"To": "ClassJ"
}
]
}
]
"SiteId"にルックアップ参照するサイトIDを指定します。
"Lookups"の"From"にルックアップ参照するサイトの転記したい項目(=ClassA)を指定、"To"に転記させたい項目(ClassJ)
ルックアップした結果
分類I(ClassI)に"マスタ２－１－１"を選択すると、同レコードの分類A(ClassA)の値"データ１"が、転記先の分類J(ClassJ)が転記されました。
Typeの指定
マニュアルには以下のように記載されています。
実際に試してみます。
参照するマスタサイト
基本の時と同じく、分類A(ClassA)を転記します。今回はこの分類A(ClassA)を以下のように設定します。
テーブルの管理
値と表示名を定義する形で設定します。
ルックアップで転記する側が"Type" : 0 のとき
転記先イメージ
こちらも同じように、分類A(ClassA)にルックアップを指定、分類B(ClassB)に転記します。
分類A(ClassA)の選択肢一覧の設定
[
{
"SiteId": 315180,
"Lookups": [
{
"From": "ClassA",
"To": "ClassB",
"Type": 0
}
]
}
]
ルックアップした結果
表示名である"組織A"ではなく、値"1"が転記されました。
ルックアップで転記する側が"Type" : 1 のとき
ルックアップ参照するサイトは、"Type":0 のと同じです。
転記先イメージ
分類C(ClassC)を以下のように設定します。
[
{
"SiteId": 315180,
"Lookups": [
{
"From": "ClassA",
"To": "ClassD",
"Type": 1
}
]
}
]
ルックアップした結果
今度は、表示名"組織A"が転記されました。
"Type" : 0 の応用
転記先の項目を、転記元と同じように選択肢を指定、値と表示名を定義する形で設定します。
転記先イメージ
転記先項目の分類H(ClassH)は以下のように設定
転記元と同じ選択肢一覧を設定します。
分類G(ClassG)の選択肢一覧の設定は以下のとおり
[
{
"SiteId": 315180,
"Lookups": [
{
"From": "ClassA",
"To": "ClassH",
"Type": 0
}
]
}
]
"Type": 0 を指定します。
ルックアップした結果
選択肢項目として、"組織A"が転記されました。
Overwrite/OverwriteForm
OverwriteとOverwriteFormは、転記先の項目に値が入力済だった場合、どのような動きになるか、を制御します。
まずはマニュアル
ちょっと難しい。
Overwriteの指定
trueの場合
基本で使用したサイトで確認します。未設定のため、規定値Trueの動作になります。
パターン１
実施前 → まだ、値は保存されていない状態
ここで、分類J(ClassJ)に任意の値を入力します。
そこから、分類I(ClassI)を変更します。
分類J(ClassJ)は変更されません。
パターン２
実施前 → 画面を開いた時点で、値が表示される。すでに値は保存済の状態。ここから、分類I(ClassI)を変更します。
ここから、分類I(ClassI)を変更します。
値が転記されました。
falseの場合
以下のように設定を変更します。
[
{
"SiteId": 315196,
"Lookups": [
{
"From": "ClassA",
"To": "ClassJ",
"Type": 0,
"Overwrite": false
}
]
}
]
パターン１
実施前 → まだ、値は保存されていない状態
ここで、分類J(ClassJ)に任意の値を入力します。
そこから、分類I(ClassI)を変更します。
分類J(ClassJ)は変更されません。trueのパターン１と変わりません。
パターン２
実施前 → 画面を開いた時点で、値が表示される。すでに値は保存済の状態。ここから、分類I(ClassI)を変更します。
ここから、分類I(ClassI)を変更します。
今度は値が転記されませんでした。
"OverwriteForm"の指定
falseの場合
既定値のため、"Overwrite"の"true"のパターンで示したものと挙動は同じ。
trueの場合
以下のように設定を変更します。
[
{
"SiteId": 315196,
"Lookups": [
{
"From": "ClassA",
"To": "ClassJ",
"Type": 0,
"OverwriteForm": true
}
]
}
]
パターン１
実施前 → まだ、値は保存されていない状態
ここで、分類J(ClassJ)に任意の値を入力します。
そこから、分類I(ClassI)を変更します。
今度は値が転記されました。
パターン２
実施前 → 画面を開いた時点で、値が表示される。すでに値は保存済の状態。ここから、分類I(ClassI)を変更します。
ここから、分類I(ClassI)を変更します。
値が転記されました。こちらは変わりません。
整理してみる。
少々ややこしいので整理してみました。
| No | Overwrite | OverwriteForm | DB保存済の状態で、選択肢を変更した場合 | 値を画面から入力後、選択肢を変更した場合 |
|---|---|---|---|---|
| 1 | TRUE | FALSE | 上書きする | 上書きしない |
| 2 | FALSE | FALSE | 上書きしない | 上書きしない |
| 3 | TRUE | TRUE | 上書きする | 上書きする |
| 4 | FALSE | TRUE | 上書きしない | 上書きする |
ひとことでまとめると・・
- Overwriteは、DB保存済の値を上書きするか否かを制御する
- OverwriteFormは、画面入力値を上書きするか否かを制御する
終わりに
選択肢一覧に設定できるオプションとしては、「選択肢一覧を他の項目の値で絞り込む」というのがありますが、こちらはさらに難しくなるため、また別の機会に整理したいと思います。