概要
ServiceNowのフォーム画面について、ディクショナリの設定でフィールドの必須入力化や文字数上限設定などができますが、
他にもClient Scriptでフィールドを装飾したりメッセージを表示させることなどが可能になります。
カスタマイズにはGlideForm APIを用います。
以下、どのAPIでどのような見た目になるのか、備忘録的にまとめていきます。
環境
PDIで作成しています。
バージョンはSan Diegoです。
System Administrator（admin）で操作しています。
1.フィールド名の横にアイコンを表示させる
addDecoration('フィールド名', 'アイコン', 'タイトル','色')
| パラメータ | 説明 | タイプ |
|---|---|---|
| フィールド名 | アイコンを表示させたいフィールド名 | String |
| アイコン | フィールド名の左側に表示させるアイコンの種類（下記の画像参照） | String |
| タイトル | カーソルをアイコンにあてた際に表示させる文言 | String |
| 色 | アイコンの色（color-RGBカラー名、もしくはCSSカラーで入力） | String |
画面のイメージ
Client Scriptのイメージ
function onLoad(){
g_form.addDecoration('number','icon-star','星のアイコンです','color-yellow');
}
上記イメージでは、Numberフィールド名の横にアイコンを設定し、アイコンにカーソルを当てた際に「星のアイコンです」と表示、またアイコンの色を黄色にする、といった設定を行っています。
星以外にも、アイコンには以下のようなものを設定できます。
2.フィールド名を点滅させる
flash('フィールド名', '色', 'カウント')
| パラメータ | 説明 | タイプ |
|---|---|---|
| フィールド名 | 背景色を点滅させたいフィールド名。次の形式で入力する。 '<テーブル名>.<フィールド名>' |
String |
| 色 | フィールド名の背景で点滅させたい色（RGBカラー名もしくはCSSカラーで入力） | String |
| カウント | 以下の数字を入力してフィールド名が点滅する秒数を指定する。 2 : 1秒間点滅 0 : 2秒間点滅 -2 : 3秒間点滅 -4 : 4秒間点滅 |
Number |
画面のイメージ
Client Scriptのイメージ
function onLoad(){
g_form.flash('incident.number','yellow',-4);
}
上記イメージでは、Numberフィールド名の背景が黄色に4秒間点滅する、といった設定を行っています。
3.フォーム上部にメッセージを表示する
addErrorMessage('メッセージ')
| パラメータ | 説明 | タイプ |
|---|---|---|
| メッセージ | フォーム上部に表示させたいエラーメッセージの内容 | String |
画面のイメージ
Client Scriptのイメージ
function onLoad(){
g_form.addErrorMessage('エラーメッセージです');
}
上記イメージでは、画面上部に「エラーメッセージです」と赤枠内にメッセージを表示します。
addInfoMessage('メッセージ')
| パラメータ | 説明 | タイプ |
|---|---|---|
| メッセージ | フォーム上部に表示させたいインフォメーションメッセージの内容 | String |
画面のイメージ
Client Scriptのイメージ
function onLoad(){
g_form.addInfoMessage('インフォメーションメッセージです');
}
上記イメージでは、画面上部に「インフォメーションメッセージです」と青枠内メッセージを表示します。
4.画面上にメッセージウィンドウを表示する
alert('メッセージ')
| パラメータ | 説明 | タイプ |
|---|---|---|
| メッセージ | ウィンドウに表示させたい警告メッセージの内容 | String |
画面のイメージ
Client Scriptのイメージ
function onLoad(){
alert('警告ウィンドウを表示します');
}
上記イメージでは、ブラウザ画面の上部に「警告ウィンドウを表示します」というメッセージが表示されたウィンドウを表示します。ウィンドウ内には「OK」ボタンが表示されます。
confirm('メッセージ')
| パラメータ | 説明 | タイプ |
|---|---|---|
| メッセージ | ウィンドウに表示させたい確認メッセージの内容 | String |
画面のイメージ
Client Scriptのイメージ
function onLoad(){
confirm('確認ウィンドウを表示します');
}
上記イメージでは、ブラウザ画面の上部に「確認ウィンドウを表示します」というメッセージが表示されたウィンドウを表示します。ウィンドウ内には「OK」ボタンと「キャンセル」ボタンが表示されます。
showFieldMsg('フィールド名','メッセージ','タイプ')
| パラメータ | 説明 | タイプ |
|---|---|---|
| フィールド名 | メッセージを表示させたいフィールド名 | String |
| メッセージ | フィールドの下に表示させるメッセージの内容 | String |
| タイプ | 以下の文言を入力してメッセージの枠の種類を指定する。 error：赤枠 info：青枠 warning：黄枠 |
String |
画面のイメージ
Client Scriptのイメージ
function onLoad(){
g_form.showFieldMsg('number','エラーフィールドメッセージです','error');
g_form.showFieldMsg('number','インフォメーションフィールドメッセージです','info');
g_form.showFieldMsg('number','警告フィールドメッセージです','warning');
}
上記イメージでは、Numberフィールドの下に「エラーフィールドメッセージです」という赤枠メッセージ、「インフォメーションフィールドメッセージです」という青枠メッセージ、「警告フィールドメッセージです」という黄色枠メッセージが表示されます。
5.ファイル添付ができないようにする
disableAttachments()
画面のイメージ
Client Scriptのイメージ
function onLoad(){
g_form.disableAttachments();
}
上記イメージでは、フォームのタイトルバーのクリップアイコンが非表示になり、ファイル添付ができなくなります。
参考
そのほかにもFormのメッセージを非表示にしたり、入力値を受け取るAPIなど多数用意されています。
詳細は以下を参照ください。
GlideForm
Scripting alert, info, and error messages