コンテンツにスキップ

view.OnSelectingWhere

概要

viewオブジェクトのOnSelectingWhereです。サーバスクリプトで拡張SQLのOnSelectingWhereを動的に指定する際に使用します。

使用例

以下の例では、ユーザID 3 以外のユーザに Name が SelectingWhereName の拡張SQLを適用します。

JavaScript
1
2
3
if (context.UserId !== 3) {
    view.Filters.OnSelectingWhere = 'SelectingWhereName';
}
JSON
{
    "Name": "SelectingWhereName",
    "SpecifyByName": true,
    "OnSelectingWhere": true,
    "CommandText": "([Issues].[Status]=900)"
}

サンプルコード

Note

コード内の【 ... 】は適宜修正してください。

1. 「予定超過」ビューを選んだとき、実績工数が予定工数を超えたタスクに絞る

タスク管理の一覧で「予定超過」ビューを選んだときのみ、view.OnSelectingWhereで拡張SQL「OverEstimate」を当て、実績工数が予定工数を超えたタスクに絞ります。

実務での使いどころ

一覧のフィルタは、項目に入っている値で絞るもので、「実績工数が予定工数より大きい」のように項目どうしを比べる条件は作れません。拡張SQLの条件を、ビューを選んだときのみ当てれば、利用者はビューを切り替えて、予定を超えたタスクを見られます。

事前準備

1:プリザンターのサーバのApp_Data/Parameters/ExtendedSqlsの下に、下記の拡張SQLのJSONファイルを置き、プリザンターを再起動してください(拡張SQL)。拡張SQLは、画面からは設定できません。

JSON(ExtendedSqls/OverEstimate.json)
{
    "Name": "OverEstimate",
    "Description": "実績工数(NumA)が予定工数(NumB)を超えたタスク(PostgreSQL)",
    "SpecifyByName": true,
    "OnSelectingWhere": true,
    "CommandText": "(\"Issues\".\"NumA\" > \"Issues\".\"NumB\")"
}

2:「タスク管理」テーブル(期限付きテーブル)で、以下の項目を有効化してください。

項目コード 内容
数値A(NumA) 実績工数
数値B(NumB) 予定工数

3:「ビュー」タブで「予定超過」ビューを作成し、ビューのIDを控えてください。

4:サーバスクリプトを登録します。

4-1:「テーブルの管理 > サーバスクリプト」タブで「新規作成」を選択する。
 4-2:タイトル: 任意の名前(例:overEstimateView)
 4-3:スクリプト: 下記サンプルコードを貼り付け、【 】を3で控えたビューのIDにする
 4-4:条件: 「ビュー処理時」にチェック

JavaScript
// 「予定超過」ビューのID(テーブルの管理の「ビュー」タブで確かめる)
const OVER_ESTIMATE_VIEW_ID = 【「予定超過」ビューのID】;

// 「予定超過」ビューを選んだときのみ、拡張SQL「OverEstimate」の条件(実績工数 > 予定工数)で絞り込む
// 一覧のフィルタでは、項目どうしを比べる条件は作れない
if (view.Id === OVER_ESTIMATE_VIEW_ID) {
    view.OnSelectingWhere = 'OverEstimate';
}

注記

  • 拡張SQLのJSONは、PostgreSQLの書き方です。SQL Serverの場合は、CommandTextを([Issues].[NumA] > [Issues].[NumB])のように書きます。記録テーブルの場合は、IssuesをResultsにします。
  • SpecifyByNameをtrueにした拡張SQLは、view.OnSelectingWhereで名前を指定したときのみ当たります。
  • 拡張SQLのJSONを変えたときは、プリザンターの再起動が必要です。
  • 同じ比べ方を、項目を変えていくつも使う場合は、view.AddColumnPlaceholderで項目を差し込む形にすると、拡張SQLを1つにまとめられます。
2. 「重複の疑い」ビューを選んだとき、支払先・請求日・金額が同じレコードに絞る

支払管理の一覧で「重複の疑い」ビューを選んだときのみ、view.OnSelectingWhereで拡張SQL「DuplicateSuspects」を当て、支払先・請求日・金額が同じレコードが、同じテーブルにほかにもあるものに絞ります。

実務での使いどころ

請求書の二重登録・二重払いの見直しに使えます。CSVの取り込みや複数の人の入力で、同じ請求書が2回登録されることがあります。一覧のフィルタは、そのレコードの項目の値で絞るもので、「ほかのレコードに同じ値があるか」という条件は作れません。支払の前に「重複の疑い」ビューを開けば、確かめるべきレコードのみが並びます。

事前準備

1:プリザンターのサーバのApp_Data/Parameters/ExtendedSqlsの下に、下記の拡張SQLのJSONファイルを置き、プリザンターを再起動してください(拡張SQL)。拡張SQLは、画面からは設定できません。

JSON(ExtendedSqls/DuplicateSuspects.json)
{
    "Name": "DuplicateSuspects",
    "Description": "支払先(ClassA)・請求日(DateA)・金額(NumA)が同じレコードが、同じテーブルにほかにもあるもの(PostgreSQL)",
    "SpecifyByName": true,
    "OnSelectingWhere": true,
    "CommandText": "(exists (select 1 from \"Results\" as \"Other\" where \"Other\".\"SiteId\" = \"Results\".\"SiteId\" and \"Other\".\"ResultId\" <> \"Results\".\"ResultId\" and \"Other\".\"ClassA\" = \"Results\".\"ClassA\" and \"Other\".\"DateA\" = \"Results\".\"DateA\" and \"Other\".\"NumA\" = \"Results\".\"NumA\"))"
}

2:「支払管理」テーブル(記録テーブル)で、以下の項目を有効化してください。

項目コード 内容
タイトル(Title) 請求書番号
分類A(ClassA) 支払先
日付A(DateA) 請求日
数値A(NumA) 金額

3:「ビュー」タブで「重複の疑い」ビューを作成し、ビューのIDを控えてください。並び替えを支払先・請求日の昇順にしておくと、同じ値のレコードが隣に並びます。

4:サーバスクリプトを登録します。

4-1:「テーブルの管理 > サーバスクリプト」タブで「新規作成」を選択する。
 4-2:タイトル: 任意の名前(例:duplicateSuspectsView)
 4-3:スクリプト: 下記サンプルコードを貼り付け、【 】を3で控えたビューのIDにする
 4-4:条件: 「ビュー処理時」にチェック

JavaScript
// 「重複の疑い」ビューのID(テーブルの管理の「ビュー」タブで確かめる)
const DUPLICATE_SUSPECTS_VIEW_ID = 【「重複の疑い」ビューのID】;

// 「重複の疑い」ビューを選んだときのみ、拡張SQL「DuplicateSuspects」の条件
// (支払先・請求日・金額が同じレコードが、同じテーブルにほかにもある)で絞り込む
// 一覧のフィルタは、そのレコードの値で絞るもので、ほかのレコードと比べる条件は作れない
if (view.Id === DUPLICATE_SUSPECTS_VIEW_ID) {
    view.OnSelectingWhere = 'DuplicateSuspects';
}

注記

  • 拡張SQLのJSONは、PostgreSQLの書き方です。SQL Serverの場合は、"Results"を[Results]、"Other"."ClassA"を[Other].[ClassA]のように書きます。期限付きテーブルの場合は、ResultsをIssues、ResultIdをIssueIdにします。
  • 比べる項目は、CommandTextのand "Other"."ClassA" = "Results"."ClassA"の部分を足したり外したりして変えられます。
  • 同じテーブル(同じサイトID)のレコードどうしを比べます。ほかのテーブルのレコードとは比べません。
  • 支払先・請求日・金額のどれかが空のレコードは、絞り込みの対象になりません。金額を入力していないレコードは一覧で0と表示されますが、0を入力したレコードとは同じ値として扱いません。
  • 請求日は時刻まで比べます。時刻の入ったレコード(取り込みなど)は、日付が同じでも時刻が違えば対象になりません。
  • ビューにフィルタ(請求日の範囲など)を設定すると、フィルタと拡張SQLの両方で絞り込みます。
  • 拡張SQLは、テーブルの権限確認を行いません(拡張SQL)。レコードのアクセス制御を使うテーブルでは、見る人に見えないレコードと値が同じレコードも、「重複の疑い」に出ます。

対応バージョン

対応バージョン 内容
1.2.2.0 以降 機能追加

関連情報