入力可能な入力フォーム画面の属性
入力フォーム画面ではさまざまなタイプの入力を使用でき、さまざまな属性を使用して入力を構成できます。
入力属性を使用して、入力の外観を定義し、制限を設定します。例には、最小値と最大値の設定、または入力値のパーセンテージ表示などがあります。
一般的な属性
この属性は、入力タイプに関係なく、任意の入力フォーム画面で使用できます。
| 属性 | 説明 |
|---|---|
| DescriptionRenderType | 入力の説明の表示タイプを定義します。 html：入力の [説明] フィールドのテキストを HTML タグで書式設定できるようにします。 |
| DataSourceId | 入力値をロードするデータソースメカニズムを作成するたびに、この属性を定義します。詳細については、「データソース」を参照してください。 注: この属性は署名入力ではサポートされていません。 |
| ElementIdentifier | 入力値をロードするデータソースメカニズムを作成するたびに、この属性を定義します。詳細については、「データソース」を参照してください。 注: この属性は署名入力ではサポートされていません。 |
添付ファイルの入力
|
添付ファイルの入力を使用して、ユーザーが入力フォーム画面でファイルを添付できるようにします。添付ファイルの入力には、ファイルをアップロードするためのスクリプト化されたアクションアイテムと actionResult オブジェクトが必要です。
注: 添付ファイルの入力は、スクリプト化されたアクションでのみサポートされています。 |
 |
(function WriteBackAction(parm_input, parm_variable, actionResult) {
//other write-back inputs and variables here
actionResult.addAttachment("attach", "incident", gr.getUniqueValue()); //where "attach" is the input name from above screenshot, and “incident” is the table name
})(parm_input, parm_variable, actionResult);
- 添付ファイルソースをユーザーに制限
- 添付ファイルの作成元を制限して、画像のソースが次のうちの 1 つまたはすべてになるようにすることもできます。
- カメラを介したオンサイト
- ユーザーの電話ギャラリーから
- ユーザーのファイルシステムから
[入力属性] レコードで、[ HiddenAttachmentSources] を選択します。値 フィールドからカメラ、ファイル、またはギャラリーのいずれかを選択し、保存 を選択します。複数の添付ファイルソースを含める場合は、このプロセスを繰り返します。詳細については、「ユーザーが使用できる添付ファイルソースを定義します」を参照してください。
属性 説明 HiddenAttachmentSources 画像の出典を希望しない場所を決定します。[値] フィールドから、カメラ、ファイル、またはギャラリーのいずれかのソース値を選択します。 注:イメージやファイルが複数のソースから取得されないようにするには、現在構成している属性を保存した後に HiddenAttachmentSources 属性を追加します。
バーコード入力
バーコード入力を使用して、単一または複数のバーコードをスキャンします。バーコードは、数字の形とさまざまな幅の平行線のパターンの機械可読コードです。これらのコードは、製品、部品、資産などのアイテムを識別するために使用されます。この入力タイプを使用すると、モバイルアプリを使用してアイテムに関する情報を ServiceNow インスタンスに入力できます。
- バーコード入力は、単一スキャン、複数スキャン、またはグループ化されたスキャン用に構成できます。単一のスキャンでは、ユーザーは 1 回のみスキャンできます。この場合、ユーザーはスキャンアイコンをタップして再スキャンする必要があります。これにより、スキャン値がクリアされます。単一のスキャンバーコード入力の属性を構成する必要はありません。
- マルチスキャン入力は、 MaxEntries 属性を使用して設定できます。入力フォーム画面のバーコード入力が MaxEntries 属性で構成されている場合、ユーザーはスキャンインターフェイスを離れることなく、複数のバーコードを順番にすばやくスキャンできます。
- グループ化されたスキャンは、セットにグループ化する必要がある資産に関連付けられた複数のバーコードをスキャンするように構成できます。グループ化されたバーコード入力を設定するには、バーコード入力のみを持つバーコードセクションを入力フォーム画面に作成する必要があります。次に、グループ化されたバーコードセクションのセクション MaxEntries 属性を構成して、ユーザーが複数のバーコードグループをスキャンできるようにする必要があります。
| 属性 | 説明 |
|---|---|
| MaxEntries | マルチスキャンと複数のバーコードグループの構成にのみ使用されます。ユーザーが一度にスキャンできるバーコードの最大数を設定します。たとえば、値を 5 に設定すると、ユーザーは 5 回再スキャンできます。 注: この属性は、マルチスキャンバーコード入力にのみ使用します。バーコード入力が単一のスキャンを対象としている場合、属性は必要ありません。 |
バーコード入力を使用した入力フォーム画面の作成については、「 シングルスキャンおよびマルチスキャンバーコード入力で入力フォーム画面を構成する 」および「 グループ化されたスキャンバーコード入力を使用して入力フォーム画面を構成する」を参照してください。
ブーリアン入力
|
true または false の値を持つ入力にはブーリアン入力を使用します。ブーリアン入力を構成して、チェックボックスまたはトグルスイッチのいずれかとして表示できます。 |
 |
これらの属性は、ブーリアン入力で使用できます。
| 属性 | 説明 |
|---|---|
| RenderType | ブーリアン入力の表示タイプを指定します。
|
選択肢の入力
|
選択肢の入力を使用して、ユーザーに選択肢を示します。手動でこれらの選択肢を作成することも、既存のテーブルとフィールドを使用して選択肢を提供することもできます。 ユーザーが単一の選択肢または複数の選択肢を選択できるように、選択肢入力を構成します。カテゴリ内の複数のチップを選択するオプションは、チップに + 記号でマークされます。 表示するチップの数を定義して、ユーザーが単一の入力フォーム画面で利用可能なすべてのオプションを表示できるようにします。表示するチップ数が規定数を超えると、[ すべて表示 ] ボタンが表示されます。[ すべて表示 ] ボタンをタップすると、すべてのオプションがリストされたページが開きます。 |
|
これらの属性は、選択肢の入力で使用できます。
| 属性 | 説明 |
|---|---|
| MultiSelect | ユーザーが入力に対して複数の選択肢を選択できるようにするオプション。値は [true] または [false] である必要があります複数選択オプションは、チップに「+」記号で示されます。 |
| Table | 選択フィールドが配置されているテーブル。 注: 手動で選択肢を作成するのではなく、既存のテーブルとフィールドの選択肢を使用するには、このオプションを使用します。Field属性を使用して、このテーブルのフィールドを選択する必要があります。 |
| Field | 選択肢を含むフィールド。 注: 手動で選択肢を作成するのではなく、既存のテーブルとフィールドの選択肢を使用するには、このオプションを使用します。この属性で定義されたフィールドは、 Table 属性で定義されたテーブル上にある必要があります。 |
| Inline | 選択入力の表示方法を選択するオプション。デフォルトでは、値は false です。つまり、選択肢の表示が同じ画面に表示されるため、別の画面に移動する必要がありません。視覚的な例については、「選択肢入力の概要」の画像を参照してください。 true を選択すると、選択後にユーザーが追加の画面に移動する必要があるリストタイプのオプションが表示されます。 |
| MaxItemInline | 入力フォーム画面セクションに表示するチップの数を定義するオプション。[値] フィールドには、次の入力を使用できます。
|
| RenderType | 選択オプションを選択肢入力の画像としてレンダリングするオプション。値は image である必要があります。 |
カスタムマップ入力
|
カスタムマップ入力を使用して、モバイルアプリのインドアマップにリンクを追加します。ユーザーはこれらのマップを使用して、デスク、会議室、ロッカーなどのリソースへの道順案内を利用でき、リソースの予約ができます。 アドミニストレーターは、カスタムマップ入力のソートとフィルタリングを可能にするクエリ条件を使用して、パラメーター化されたデータアイテムを構成することもできます。 重要:
パラメーター化されたデータアイテムをサポートするカスタムマップ入力では、 ScreenId 属性のみを使用する必要があります。パラメーター化されたデータアイテムをサポートするカスタムマップ入力には、他のタイプの属性を使用しないでください。 詳細参照修飾子を使用する既存のカスタムマップ入力を変更してパラメーター化されたデータアイテムを使用する場合は、 ScreenId 属性のみを使用し、他のすべての属性を削除します。 |
|
| 属性 | 説明 |
|---|---|
| CustomMapConfigId | sys_sg_custom_map_config テーブルの sys_id |
| CustomMapDefaultProviderId | sys_sg_custom_map_provider テーブル内のプロバイダーレコードの sys_id |
| CustomMapInputs | sys_sg_input テーブル内のフロアの sys_id。この値は JSON 配列として入力する必要があります。 |
| ScreenId | カスタムマップ入力のソートとフィルタリングに使用されるパラメーター化されたデータアイテムのsys_id。 重要: この属性を他のカスタムマップ入力属性と一緒に使用することはできません。カスタムマップ入力で ScreenId 属性を使用する場合は、入力で他の属性を使用しないでください。 |
| TargetTable | sn_wsd_core_space に設定します。 |
日付/時刻の入力
|
日付/時刻の入力を使用して、ユーザーが日付と時刻の値を入力できるようにします。日付と時刻、または日付のみに入力を設定できます。 |
 |
これらの属性は、日付/時刻入力で使用できます。
| 属性 | 説明 |
|---|---|
| RenderType | 日付/時刻の入力の表示タイプを指定します。
|
| IncludeTimezone |
入力が追加されるモバイルデバイスのタイムゾーン。値は [true] または [false] である必要があります true に設定すると、モバイルクライアントは、日付と時刻の値とともにデバイスのタイムゾーン情報を次の形式でバックエンドインスタンスに送信します。 YYYY-MM-DDThh:mm:ss.sssTZD 注:
デバイスのタイムゾーンは、プラットフォームで設定されているユーザープロファイルのタイムゾーンとは異なります。 この属性が構成されていない場合、モバイルクライアントでは、日付/時刻の入力値にデバイスのタイムゾーン情報が含まれません。この動作がデフォルトです。日付/時刻の入力値は次の形式です。 YYYY-MM-DD hh:mm:ss さまざまなアクションタイプの日付/時刻入力の IncludeTimezone 属性の設定については、「 さまざまなアクションアイテムタイプの日付/時刻入力セットアップ」を参照してください。 アクションアイテムタイプの詳細については、「 アクションアイテムの設定」を参照してください。 |
| MaxRangeDays |
日付/時刻入力が追加されたときに将来の日付を選択できるかどうかを決定するオプションの属性。この属性は、正と負の両方の整数値をサポートします。MaxRangeDaysを 0 に設定すると、ユーザーは将来の日付を選択できなくなり、現在または過去の日付に制限されます。 注:
MaxRangeDays は、 MinRangeDays、 MaxRangeHours、および MinRangeHoursと一緒に使用できます。 |
| MinRangeDays |
日付/時刻入力が追加されたときに過去の日付を選択できるかどうかを決定するオプションの属性。この属性は、正と負の両方の整数値をサポートします。MinRangeDaysを 0 に設定すると、ユーザーは過去の日付を選択できなくなり、現在または将来の日付に制限されます。 注:
MinRangeDays は、 MaxRangeDays、 MaxRangeHours、および MinRangeHoursと一緒に使用できます。 |
| MaxRangeHours |
日付/時刻入力が追加されたときに未来の時間を選択できるかどうかを決定するオプションの属性。この属性は、正と負の両方の整数値をサポートします。MaxRangeHoursを 0 に設定すると、ユーザーは将来の日時を選択できなくなり、現在または過去の日時に制限されます。 注:
MaxRangeHours は、 MaxRangeDays、 MinRangeDays、および MinRangeHoursと一緒に使用できます。 |
| MinRangeHours |
日付/時刻入力が追加されたときに過去の時間を選択できるかどうかを決定するオプションの属性。この属性は、正と負の両方の整数値をサポートします。MinRangeHoursを 0 に設定すると、ユーザーは過去の日時を選択できなくなり、現在または将来の日時に制限されます。 注:
MinRangeHours は、 MaxRangeDays、 MinRangeDays、および MaxRangeHoursと一緒に使用できます。 |
数値入力
|
数値入力を使用して、ユーザーが数値を入力できるようにします。オプションの最小値と最大値を定義して、入力の数値範囲を定義します。 オプションで、数値入力をパーセンテージとして表示するように構成できます。 デフォルトでは、数値入力は小数点以下桁数をサポートしています。 |
 |
これらの属性は、数値入力で使用できます。
| 属性 | 説明 |
|---|---|
| CustomErrorMessage | 指定できるカスタムエラーメッセージを設定します。このメッセージは、関連する UI ルール条件が満たされた場合に表示されます。 |
| Max | 入力の最大値を指定します。 |
| Min | 入力の最小値を指定します。 |
| RenderType | 数値入力の表示タイプを指定します。
|
| SkipValidationWhenHidden | true または false のいずれかに設定できます。デフォルトでは false に設定されています。つまり、デフォルトでは、関連付けられた UI ルールの検証が非表示の入力に対して実行されます。非表示の入力の検証をスキップする場合にのみ、 これを true に設定してください。 |
ランキング入力
|
ランキング入力を使用して、ユーザーが利用可能な選択肢を設定または優先度の順にソートできるようにします。ユーザーは、利用可能な選択肢をタップしてドラッグします。 ランキング入力の選択肢は、手動で定義する必要があります。 |
このトピックにリストされている一般的な属性以外のランキング入力の属性はありません。
参照入力
テーブルのフィールドを参照する入力には、参照入力を使用します。これらの入力は、インスタンス上のフォームの 参照フィールド のように機能します。条件、参照修飾子、および検索オプションを使用して参照入力を構成すると、ユーザーは必要なものをすばやく見つけることができます。
オプションの検索オプションでは、「テキスト用」キーワード検索が使用され、モバイルビュー内の要素を検索できます。
これらの属性は、参照入力で使用できます。
| 属性 | 説明 |
|---|---|
| SourceTable | 参照修飾子のソーステーブル |
| SourceFieldName | ソーステーブル内の参照フィールドのフィールド名 |
| TargetTable | 参照修飾子のターゲットにするテーブル。 |
次の追加属性はオプションです。
| 属性 | 説明 |
|---|---|
| MultiSelect | ユーザーが入力に対して複数の選択肢を選択できるようにするオプション。値は [true] または [false] である必要があります |
| MobileViewId | 参照リストアイテムに使用するモバイルビュー ID (ビュー構成)。 |
| EnableSearch | 検索バーを表示するオプション。値は [true] または [false] である必要があります |
| SearchPlaceholder | プレースホルダーとして検索バーに表示されるテキスト |
| Conditions | エンコードされたクエリーを入力して、参照リストに条件を適用します。これらのクエリの作成の詳細については、「 エンコードされたクエリ文字列」を参照してください。 |
| SearchType | 検索に使用するクエリーを定義します。値は starts_with または contains です。この属性が構成されていない場合、インスタンスはデフォルトで表示ラベル列で starts_with を使用します。 |
この例では、インシデント [incident] テーブルの [アサイン先] フィールドに対する入力フォーム画面入力を作成します。この入力を作成するには、[TargetTable]、[SourceTable]、および [SourceFieldName] の 3 つの必須属性を使用します。
- ユーザーは、ユーザーのリストからそのインシデントを割り当てるユーザーを選択します。したがって、[TargetTable] 属性を sys_user に設定します。
- インシデントレコードにユーザーを追加するため、 SourceTable 属性は インシデントに設定されます。
- 選択したユーザーが [アサイン先] フィールドに割り当てられるように、[SourceFieldName] を assigned_to に設定します。
署名入力
署名入力を使用して、入力フォーム画面で電子署名をキャプチャします。署名入力は、入力フォーム画面のセクションまたはページに含めることができます。
署名入力では、オプションの IsOverlay 属性を使用できます。デフォルトでは、署名は完全なモーダルウィンドウに表示されます。IsOverlay属性 Value が true に設定されている場合、署名はハーフモーダルウィンドウに表示されます。
| 属性 | 説明 |
|---|---|
| IsOverlay | 署名入力をハーフモーダルウィンドウで開くかどうかを設定します。値はtrue または false に設定できます。true の値を指定すると、署名はハーフモーダルウィンドウで開くように構成されます。 注: 署名入力がページ上の唯一の入力として構成されていて、 isOverlay 属性が true に設定されている場合、 isOverlay 属性は無視され、署名入力は全画面に表示されます。 |
文字列入力
|
テキスト入力には文字列入力を使用します。この入力の最大文字数を定義できます。 |
 |
これらの属性は、文字列入力で使用できます。
| 属性 | 説明 |
|---|---|
| Inline | 入力をインラインで表示するか、別のモーダルで入力を開くオプション。値は [true] または [false] である必要があります |
| MaxLength | 入力値の最大文字数 |
| ShowDeleteAll | 入力フィールドにテキストがある場合は常に削除ボタンを表示するオプション。この値は true または false である必要があり、デフォルトでは false に設定されています。 |
| ConfirmDeletion | ShowDeleteAllの使用時に、テキストが削除される前にユーザーに確認メッセージを表示するオプション。値は true または false である必要があり、デフォルトでは true に設定されています。 |
画面入力
画面入力を使用して、リスト画面を選択可能なリスト入力に変換します。ユーザーは複数のリストアイテムを選択し、キャッシュへのライトバック操作を実行できます。
これらの属性は、画面入力で使用できます。
| 属性 | 説明 |
|---|---|
| ScreenId | 選択可能なリスト入力に使用されるリスト画面を設定します。値はリスト画面の sys_id です。 |
| GetDataFromParent | リスト画面を親画面から選択可能なリスト入力に変換します。親リスト画面に適用されるフィルターは、画面入力に引き継がれます。この属性を有効にするには、 true を入力します。デフォルトでは、インスタンスではオフになっています。 |