コンテンツにスキップ

拡張項目

概要

組織の管理、グループの管理、ユーザの管理に分類項目などの項目を追加します。

利用上の注意

誤った設定を行うとプリザンターが利用できなくなる可能性がありますので、十分なテストを行った上でご利用ください。

拡張項目の設定方法

.\pleasanter\Implem.Pleasanter\App_Data\Parameters\に、CustomDefinitionsフォルダを作成し、配下に以下の構文で拡張したい項目を記載したテキストファイルを作成し、IISを再起動してください。ファイル名は必ずColumn.jsonにしてください。

{
    "Users_ClassA": {
        "LabelText": "名称",
        "GridEnabled": "1",
        "EditorEnabled": "1",
        "LabelText_en": "Name",
        "LabelText_zh": "名称",
        "LabelText_de": "Name",
        "LabelText_ko": "이름",
        "LabelText_es": "Nombre",
        "LabelText_vn": "Tên"
    },

    "Users_DateA": {
        "LabelText": "DateA",
        "GridEnabled": "1",
        "EditorEnabled": "1"
    },

    "Groups_DescriptionA": {
        "LabelText": "DescriptionA",
        "GridEnabled": "1",
        "EditorEnabled": "1",
        "FieldCss": "field-wide",
        "UpdateAccessControl": "ManageTenant"
    },

    "Depts_CheckA": {
        "LabelText": "CheckA",
        "GridEnabled": "1",
        "EditorEnabled": "1"
    }
}
項目名 説明
LabelText 項目の表示名(日本語)を指定します。
GridEnabled 一覧画面に表示する場合には"1"を入れます。表示しない場合は、この行は不要です。
EditorEnabled 編集画面に表示する場合には"1"を入れます。表示しない場合は、この行は不要です。
UseSearch 検索機能を有効にする場合、trueを指定します。
ChoicesText 選択式にする場合には選択肢を入力します。選択肢の区切りには\nを入れます。
FieldCss 入力項目のスタイル(ノーマル、ワイド、マークダウン)を設定します。"field-normal","field-wide","field-markdown"のいずれかを指定します。スタイルを変更しない場合は、この行は不要です。
CreateAccessControl 新規作成時にテナント管理者のみがこの項目値を設定できるよう制限する場合"ManageTenant"を指定します。制限しない場合は、この行は不要です。
UpdateAccessControl 更新時にテナント管理者のみがこの項目値を変更できるよう制限する場合"ManageTenant"を指定します。制限しない場合は、この行は不要です。
ReadAccessControl テナント管理者のみがこの項目値を閲覧することができるよう制限する場合"ManageTenant"を指定します。制限しない場合は、この行は不要です。
LabelText_en 項目の表示名(英語)を指定します。
LabelText_zh 項目の表示名(中国語)を指定します。
LabelText_de 項目の表示名(ドイツ語)を指定します。
LabelText_ko 項目の表示名(韓国語)を指定します。
LabelText_es 項目の表示名(スペイン語)を指定します。
LabelText_vn 項目の表示名(ベトナム語)を指定します。

標準項目のアクセス制限を変更する

Column.jsonには、拡張項目に加えて、ユーザ・組織・グループの標準項目(ログインID、名前、組織名など)も記述できます。標準項目に"ReadAccessControl"・"CreateAccessControl"・"UpdateAccessControl"を指定すると、その項目のアクセス制限を変更できます。項目を追加せず、アクセス制限のみを変更する目的でも使用できます。

下記は、一般ユーザがほかのユーザのログインID・名前・ユーザコードを閲覧できないようにする例です。

{
    "Users_LoginId": {
        "ReadAccessControl": "ManageTenant"
    },
    "Users_Name": {
        "ReadAccessControl": "ManageTenant"
    },
    "Users_UserCode": {
        "ReadAccessControl": "ManageTenant"
    }
}

キーは「テーブル名_項目名」で指定します。テーブル名は、ユーザが"Users"、組織が"Depts"、グループが"Groups"です。拡張項目の設定と同じファイルに記述できます。既定の制限を緩める例は「FAQ:ユーザの管理で生年月日と性別を表示したい」を参照してください。

指定できる値は下記のとおりです。

値 説明
ManageTenant テナント管理者のみに許可します。
ManageService テナント管理者を含むすべてのユーザに許可しません。

閲覧の制限は、画面に加えて、APIとサーバスクリプトにも適用されます。

機能 閲覧できない項目の扱い
画面(ユーザ管理・組織管理・グループ管理) 表示されません。
API(ユーザ・組織・グループの取得) 項目が返りません。
サーバスクリプト(users・depts・groups) 項目は残り、値が null になります(バージョン1.5.10.0以降)。

注意

  • "ManageTenant"・"ManageService"以外の値は指定しないでください。ユーザ・組織・グループでは、テナント管理者を含むすべてのユーザがその項目を閲覧できなくなります。
  • 期限付きテーブル・記録テーブルの項目のアクセス制御については、「項目のアクセス制御」を参考に設定してください。

対応バージョン

対応バージョン 内容
1.5.10.0 以降 標準項目の閲覧の制限を、サーバスクリプトにも適用するよう変更

関連情報