入力可能な入力フォーム画面の属性
入力フォーム画面ではさまざまなタイプの入力を使用でき、さまざまな属性を使用して入力を構成できます。
入力属性を使用して、入力の外観を定義し、制限を設定します。例には、最小値と最大値の設定、または入力値のパーセンテージ表示などがあります。
一般属性
この属性は、入力タイプに関係なく、任意の入力フォーム画面で使用できます。
| 属性 | 説明 |
|---|---|
| DescriptionRenderType | 入力の説明の表示タイプを定義します。 html：入力の [説明] フィールドのテキストを HTML タグで書式設定できるようにします。 |
添付ファイルの入力
添付ファイルの入力を使用して、ユーザーが入力フォーム画面でファイルを添付できるようにします。添付ファイルの入力には、ファイルをアップロードするためのスクリプト化されたアクションアイテムと 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);
バーコード入力
バーコード入力を使用して、単一または複数のバーコードをスキャンします。バーコードは、数字とさまざまな幅の平行線のパターンの形式の機械可読コードです。これらのコードは、製品、部品、資産などのアイテムを識別するために使用されます。この入力タイプを使用して、モバイルアプリでインスタンスに ServiceNow アイテムに関する情報を入力できます。
- バーコード入力は、シングルスキャン、マルチスキャン、またはグループ化されたスキャン用に設定できます。シングルスキャンでは、ユーザーは 1 回だけスキャンできます。この場合、ユーザーはスキャンアイコンをタップして再スキャンする必要があります。これにより、スキャン値がクリアされます。単一のスキャンバーコード入力の属性を設定する必要はありません。
- マルチスキャン入力は、 MaxEntries この属性を使用して構成できます。入力フォーム画面のバーコード入力にこの MaxEntries 属性が設定されている場合、ユーザーはスキャンインターフェイスを離れることなく、複数のバーコードを順番にすばやくスキャンできます。
- グループ化されたスキャンは、セットにグループ化する必要がある資産に関連付けられた複数のバーコードをスキャンするように構成できます。グループ化されたバーコード入力を設定するには、入力フォーム画面にバーコード入力のみを含むバーコードセクションを作成する必要があります。次に、ユーザーが複数のバーコードグループをスキャンできるように、グループ化されたバーコードセクションのセクション MaxEntries 属性を設定する必要があります。
| 属性 | 説明 |
|---|---|
| MaxEntries | マルチスキャンとバーコードの複数グループを設定する場合にのみ使用されます。ユーザーが一度にスキャンできるバーコードの最大数を設定します。たとえば、値を 5 に設定すると、ユーザーは 5 回再スキャンできます。 注: この属性は、マルチスキャンバーコード入力にのみ使用します。バーコード入力が単一のスキャンを対象としている場合、属性は必要ありません。 |
バーコード入力を含む入力フォーム画面の作成については、「」およびグループ化されたスキャンバーコード入力を使用して入力フォーム画面を構成する「」を参照してくださいシングルスキャンおよびマルチスキャンのバーコード入力で入力フォーム画面を構成する。
ブーリアン入力
true または false の値を持つ入力にはブーリアン入力を使用します。ブーリアン入力を構成して、チェックボックスまたはトグルスイッチのいずれかとして表示できます。 |
 |
これらの属性は、ブーリアン入力で使用できます。
| 属性 | 説明 |
|---|---|
| RenderType | ブーリアン入力の表示タイプを指定します。
|
選択肢の入力
選択肢の入力を使用して、ユーザーに選択肢を示します。手動でこれらの選択肢を作成することも、既存のテーブルとフィールドを使用して選択肢を提供することもできます。 選択肢の入力は、テキストまたは画像として表示できます。 ユーザーが単一の選択肢または複数の選択肢を選択できるように、選択肢の入力を構成できます。 |
これらの属性は、選択肢の入力で使用できます。
| 属性 | 説明 |
|---|---|
| MultiSelect | ユーザーが入力に対して複数の選択肢を選択できるようにするオプション。値は [true] または [false] である必要があります |
| Table | 選択フィールドが配置されているテーブル。 注: 手動で選択肢を作成するのではなく、既存のテーブルとフィールドの選択肢を使用するには、このオプションを使用します。属性を使用して Field 、このテーブルのフィールドを選択する必要があります。 |
| Field | 選択肢を含むフィールド。 注: 手動で選択肢を作成するのではなく、既存のテーブルとフィールドの選択肢を使用するには、このオプションを使用します。この属性で定義されたフィールドは、属性で Table 定義されたテーブルに存在する必要があります。 |
| 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 | 日付/時刻の入力が追加されたときに将来の日付を選択できるかどうかを決定するオプションの属性。この属性は、正と負の両方の整数値をサポートします。0 に設定するMaxRangeDaysと、ユーザーは将来の日付を選択できなくなり、現在または過去の日付に制限されます。 注: MaxRangeDaysは、 MaxRangeHoursと一緒にMinRangeHours使用できますMinRangeDays。 |
| MinRangeDays | 日付/時刻の入力が追加されたときに過去の日付を選択できるかどうかを決定するオプションの属性。この属性は、正と負の両方の整数値をサポートします。0 に設定するMinRangeDaysと、ユーザーは過去の日付を選択できなくなり、現在または将来の日付に制限されます。 注: MinRangeDaysは、 MaxRangeHoursと一緒にMinRangeHours使用できますMaxRangeDays。 |
| MaxRangeHours | 日付/時刻の入力が追加されたときに将来の時間を選択できるかどうかを決定するオプションの属性。この属性は、正と負の両方の整数値をサポートします。0 に設定するMaxRangeHoursと、ユーザーは将来の日時を選択できなくなり、現在または過去の日時に制限されます。 注: MaxRangeHoursは、 MinRangeDaysと一緒にMinRangeHours使用できますMaxRangeDays。 |
| MinRangeHours | 日付/時刻の入力が追加されたときに過去の時間を選択できるかどうかを決定するオプションの属性。この属性は、正と負の両方の整数値をサポートします。0 に設定するMinRangeHoursと、ユーザーは過去の日時を選択できなくなり、現在または将来の日時に制限されます。 注: MinRangeHoursは、 MinRangeDaysと一緒にMaxRangeHours使用できますMaxRangeDays。 |
数値入力
数値入力を使用して、ユーザーが数値を入力できるようにします。オプションの最小値と最大値を定義して、入力の数値範囲を定義します。 オプションで、数値入力をパーセンテージとして表示するように構成できます。 デフォルトでは、数値入力は小数点をサポートします。 |
 |
これらの属性は、数値入力で使用できます。
| 属性 | 説明 |
|---|---|
| RenderType | 数値入力の表示タイプを指定します。
|
| Max | 入力の最大値を指定します。 |
| Min | 入力の最小値を指定します。 |
ランキング入力
ランキング入力を使用して、ユーザーが利用可能な選択肢を設定または優先度の順にソートできるようにします。ユーザーは、利用可能な選択肢をタップしてドラッグします。 ランキング入力の選択肢は、手動で定義する必要があります。 |
このトピックにリストされている一般的な属性以外に、入力をランク付けするための属性はありません。
参照入力
テーブルのフィールドを参照する入力には、参照入力を使用します。これらの入力は、インスタンスのフォームの 参照フィールド のように機能します。条件、参照修飾子、および検索オプションを使用して参照入力を構成すると、ユーザーは必要なものをすばやく見つけることができます。
オプションの検索オプションでは、「テキスト用」キーワード検索が使用され、モバイルビュー内の要素を検索できます。
これらの属性は、参照入力で使用できます。
| 属性 | 説明 |
|---|---|
| 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 に設定します。
署名入力
署名入力を使用して、入力フォーム画面で電子署名をキャプチャします。署名入力は、入力フォーム画面のセクションまたはページに含めることができます。
署名入力で optional IsOverlay 属性を使用できます。デフォルトでは、署名は完全なモーダルウィンドウに表示されます。IsOverlay属性 Value が true に設定されている場合、署名はハーフモーダルウィンドウに表示されます。
| 属性 | 説明 |
|---|---|
| IsOverlay | 署名入力をハーフモーダルウィンドウで開くかどうかを設定します。[値] は true または false に設定できます。値が true の場合は、半モーダルウィンドウで開くように署名が設定されます。 注: 署名入力がページ上の唯一の入力として設定され、属性が isOverlaytrue に設定されている場合、属性は isOverlay 無視され、署名入力は全画面で表示されます。 |
署名入力のある入力フォーム画面の作成については、「」を参照してください 署名入力を使用して入力フォーム画面を構成する。
文字列入力
テキスト入力には文字列入力を使用します。この入力の最大文字数を定義できます。 |
 |
これらの属性は、文字列入力で使用できます。
| 属性 | 説明 |
|---|---|
| Inline | 入力をインラインで表示するか、別のモーダルで入力を開くオプション。値は [true] または [false] である必要があります |
| MaxLength | 入力値の最大文字数 |
| ShowDeleteAll | 入力フィールドにテキストがある場合には常に削除ボタンを表示するオプション。この値は true または false である必要があり、デフォルトでは false に設定されています。 |
| ConfirmDeletion | の使用 ShowDeleteAll時にテキストが削除される前にユーザーに確認メッセージを表示するオプション。値は true または false である必要があり、デフォルトでは true に設定されています。 |
画面入力
画面入力を使用して、リスト画面を選択可能なリスト入力に変換します。ユーザーは複数のリストアイテムを選択し、キャッシュへのライトバック操作を実行できます。
これらの属性は、画面入力で使用できます。
| 属性 | 説明 |
|---|---|
| ScreenId | 選択可能なリスト入力に使用されるリスト画面を設定します。値はリスト画面の sys_id です。 |
| GetDataFromParent | リスト画面を親画面から選択可能なリスト入力に変換します。親リスト画面に適用されるフィルターは、画面入力に引き継がれます。この属性を有効にするには、 true を入力します。デフォルトでは、インスタンスでオフになっています。 |