コンテンツにスキップ

user

概要

サーバスクリプトでユーザの情報を読み取るためのオブジェクトです。「usersオブジェクト」のGetメソッドで取得します。

プロパティ

No プロパティ名 get set type 説明
1 UserId ○ int ユーザID
2 DeptId ○ int 組織ID
3 LoginId ○ string ログインID
4 Name ○ string 名前
5 UserCode ○ string ユーザコード
6 TenantManager ○ bool テナント管理者
7 Disabled ○ bool 無効

閲覧できない項目

バージョン1.5.10.0以降、サーバスクリプトを実行したユーザが閲覧できない項目は、値が null になります(項目そのものは残ります)。既定では、TenantManager・Disabled はテナント管理者のみが閲覧できます。

閲覧できる項目は、Column.json で変更できます。詳細は「拡張項目」を参照してください。

使用例

下記の例では「usersオブジェクト」からユーザID 1 の「userオブジェクト」を取得し,ユーザの名前と組織IDをログに出力します。

JavaScript
let user = users.Get(1);
context.Log(`${user.Name},${user.DeptId}`);

サンプルコード

1. 担当者が無効になっているレコードに、一覧で印を付ける

一覧を表示するとき、行ごとに担当者の「userオブジェクト」を取得し、Disabled(無効)であれば、その行に色を付けます。

実務での使いどころ

退職・休職・異動でアカウントを無効にしたあと、その人が担当者のまま残っている顧客・案件・問い合わせを見つけて、担当を引き継ぎたいときに使えます。一覧のフィルタでは、担当者が無効かどうかでは絞り込めません。

事前準備

1:「顧客台帳」テーブルで、担当者(Owner)を有効化してください。

2:「テーブルの管理 > スタイル」タブで、以下のスタイルを登録してください(出力先:一覧)。

.grid-row.disabled-owner td {
    background-color: #fde2e2;
}

3:スクリプトを登録します。

3-1:「テーブルの管理 > サーバスクリプト」タブで「新規作成」を選択する。
 3-2:タイトル: 任意の名前(例:markDisabledOwner)
 3-3:スクリプト: 下記サンプルコードを貼り付け
 3-4:条件: 「行表示の前」にチェック

JavaScript

条件:行表示の前

// 一覧で、担当者が無効(退職・休職など)になっているレコードの行に印を付ける。
// 行の見た目は、テーブルの管理の「スタイル」に登録した CSS のクラス(disabled-owner)で決める
const OWNER_COLUMN = 'Owner';

const ownerId = Number(model[OWNER_COLUMN]);
if (ownerId) {
    const owner = users.Get(ownerId);
    if (owner && owner.Disabled) {
        model.ExtendedRowCss = 'disabled-owner';
    }
}

注記

  • 管理者や分類項目([[Users]])の担当者を見るときは、OWNER_COLUMNをその項目名にしてください。

対応バージョン

対応バージョン 内容
1.5.10.0 以降 閲覧できない項目の値を null にするよう変更

関連情報