入力可能な入力フォーム画面の属性

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：21分

    • 入力フォーム画面ではさまざまなタイプの入力を使用でき、さまざまな属性を使用して入力を構成できます。

    入力属性を使用して、入力の外観を定義し、制限を設定します。例には、最小値と最大値の設定、または入力値のパーセンテージ表示などがあります。

    注:
    すべての属性で、大文字と小文字が区別されます。

    一般的な属性

    この属性は、入力タイプに関係なく、任意の入力フォーム画面で使用できます。

    属性 説明
    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 属性を構成して、ユーザーが複数のバーコードグループをスキャンできるようにする必要があります。
    図 : 1. モバイルアプリでのバーコードスキャン
    モバイルアプリでバーコードをスキャンする例。
    この属性はバーコード入力で使用できます。
    属性 説明
    MaxEntries マルチスキャンと複数のバーコードグループの構成にのみ使用されます。ユーザーが一度にスキャンできるバーコードの最大数を設定します。たとえば、値を 5 に設定すると、ユーザーは 5 回再スキャンできます。
    注:
    この属性は、マルチスキャンバーコード入力にのみ使用します。バーコード入力が単一のスキャンを対象としている場合、属性は必要ありません。

    バーコード入力を使用した入力フォーム画面の作成については、「 シングルスキャンおよびマルチスキャンバーコード入力で入力フォーム画面を構成する 」および「 グループ化されたスキャンバーコード入力を使用して入力フォーム画面を構成する」を参照してください。

    ブーリアン入力

    true または false の値を持つ入力にはブーリアン入力を使用します。ブーリアン入力を構成して、チェックボックスまたはトグルスイッチのいずれかとして表示できます。

    		 チェックボックスまたはトグルスイッチとして設定されたブール入力の例。

    これらの属性は、ブーリアン入力で使用できます。

    属性 説明
    RenderType ブーリアン入力の表示タイプを指定します。
    チェックボックス
    入力をチェックボックスとして表示します。
    トグル
    入力をトグルとして表示します。

    選択肢の入力

    選択肢の入力を使用して、ユーザーに選択肢を示します。手動でこれらの選択肢を作成することも、既存のテーブルとフィールドを使用して選択肢を提供することもできます。

    ユーザーが単一の選択肢または複数の選択肢を選択できるように、選択肢入力を構成します。カテゴリ内の複数のチップを選択するオプションは、チップに + 記号でマークされます。

    表示するチップの数を定義して、ユーザーが単一の入力フォーム画面で利用可能なすべてのオプションを表示できるようにします。表示するチップ数が規定数を超えると、[ すべて表示 ] ボタンが表示されます。[ すべて表示 ] ボタンをタップすると、すべてのオプションがリストされたページが開きます。
    図 : 2. 入力フォーム画面の単一および複数選択肢の入力オプション
    入力フォーム画面の単一および複数選択肢の入力オプション。

    これらの属性は、選択肢の入力で使用できます。

    属性 説明
    MultiSelect ユーザーが入力に対して複数の選択肢を選択できるようにするオプション。値は [true] または [false] である必要があります複数選択オプションは、チップに「+」記号で示されます。
    Table 選択フィールドが配置されているテーブル。
    注:
    手動で選択肢を作成するのではなく、既存のテーブルとフィールドの選択肢を使用するには、このオプションを使用します。Field属性を使用して、このテーブルのフィールドを選択する必要があります。
    Field 選択肢を含むフィールド。
    注:
    手動で選択肢を作成するのではなく、既存のテーブルとフィールドの選択肢を使用するには、このオプションを使用します。この属性で定義されたフィールドは、 Table 属性で定義されたテーブル上にある必要があります。
    Inline 選択入力の表示方法を選択するオプション。デフォルトでは、値は false です。つまり、選択肢の表示が同じ画面に表示されるため、別の画面に移動する必要がありません。視覚的な例については、「選択肢入力の概要」の画像を参照してください。

    true を選択すると、選択後にユーザーが追加の画面に移動する必要があるリストタイプのオプションが表示されます。

    図 : 3. セカンダリ画面の必要性を示すインライン選択リストスタイルのオプション
    セカンダリ選択画面の必要性を示すインライン選択オプション。
    InlineMaxItems 入力フォーム画面セクションに表示するチップの数を定義するオプション。[値] フィールドには、次の入力を使用できます。
    • 空:デフォルトの最大 8 つの選択値が表示されます。選択肢が 8 個を超える場合は、[ すべて表示 ] ボタンが表示されます。
    • 負の数値:8 値を超えても、すべての選択値を表示します。
    • 正の数値:定義された選択値の数を表示します。入力した数値よりも多くの選択肢がある場合は、[ すべて表示 ] ボタンが表示されます。
    次の図は、入力された値が 8 で、選択肢の値が 12 個あるシナリオを示しています。最初の画面には 8 つの値が表示されます。ユーザーが [ すべて表示 ] ボタンをタップすると、新しい画面が開き、12 個の選択値がすべて表示されます。
    図 : 4. [すべて表示] ボタンのある選択リスト
    [すべて表示] ボタンのある選択リスト。
    RenderType 選択オプションを選択肢入力の画像としてレンダリングするオプション。値は image である必要があります。

    カスタムマップ入力

    カスタムマップ入力を使用して、モバイルアプリのインドアマップにリンクを追加します。ユーザーはこれらのマップを使用して、デスク、会議室、ロッカーなどのリソースへの道順案内を利用でき、リソースの予約ができます。

    アドミニストレーターは、カスタムマップ入力のソートとフィルタリングを可能にするクエリ条件を使用して、パラメーター化されたデータアイテムを構成することもできます。

    重要:

    パラメーター化されたデータアイテムをサポートするカスタムマップ入力では、 ScreenId 属性のみを使用する必要があります。パラメーター化されたデータアイテムをサポートするカスタムマップ入力には、他のタイプの属性を使用しないでください。

    詳細参照修飾子を使用する既存のカスタムマップ入力を変更してパラメーター化されたデータアイテムを使用する場合は、 ScreenId 属性のみを使用し、他のすべての属性を削除します。
    [次へ] を選択してマップを表示するモバイルアプリで、カスタムマップ入力がどのように表示されるかを示します。
    これらの属性は、カスタムマップ入力で使用できます。
    注:
    モバイルアプリビルダーを使用してカスタムマップ入力タイプをモバイルアプリに追加できますが、インスタンスのプラットフォーム Web UI で属性を設定する必要があります。
    属性 説明
    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 日付/時刻の入力の表示タイプを指定します。
    日付と時刻
    日付と時刻を表示します。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 数値入力の表示タイプを指定します。
    整数
    3、1003、57 などの整数全体を表示します。integer を使用すると、エンドユーザーは整数のみを入力でき、小数点以下桁数を入力できません。
    表示タイプは整数で、値が 60 の Number of outlets という入力を示しています。
    線
    入力を行フィールドとして表示します。
    値が 73 の [サブスクリプション期間 (月)] という入力を示す、レンダリングタイプと呼ばれる線。
    パーセンテージ
    入力の数値の後にパーセント記号 (%) を表示します。
    パーセンテージと呼ばれる表示タイプは、8% の値を持つパーセンテージで利率と呼ばれる入力を示しています。
    スライダー
    入力をスライダー値とボックス入力として表示します。スライダーとその構成方法の詳細については、「 数値入力のスライダーオプションの構成」を参照してください。
    スライダーと呼ばれるレンダリングタイプは、値が 44.25 のパッケージの重量 (キログラム) と呼ばれる入力を示しています。
    注:
    どの表示タイプでどのアトリビュートを使用できるかを示す表については、 数値の表示タイプと互換性のある入力属性を参照してください。
    SkipValidationWhenHidden
    注:
    この属性は、線とパーセンテージの表示タイプでのみ使用できます。
    true または false のいずれかに設定できます。デフォルトでは false に設定されています。つまり、デフォルトでは、関連付けられた UI ルールの検証が非表示の入力に対して実行されます。非表示の入力の検証をスキップする場合にのみ、 これを true に設定してください。
    このテーブルにリストされている次の入力属性は、スライダーの表示タイプにのみ適用されます。詳細については、「スライダータイプとその入力属性」を参照してください。
    属性 説明
    DefaultValue

    ユーザーが最初にスライダーを表示したときに表示される値。値が入力されていない場合、表示される値はゼロです。デフォルト値は、最小値と最大値の間である必要があります。

    注:
    優先度の高いロードメカニズムが構成されていない限り、この定義された値が開始点です。「入力フォーム画面のロードメカニズム」を参照してください。
    StepSize スライダーの各ステップのサイズ。ステップは、最大数と最小数の間で割り切れる数値である必要があります。たとえば、最小数が 20、最大数が 80 の場合、StepSize は 2、5、10 などの数値にすることができます。
    ReferencePoint true に設定すると、マーカーがスライダーに追加され、ユーザーに視覚的な参照ポイントが提供されます。
    注:
    視覚的にわかりやすくするために、この入力属性は入力属性 VisualStepsEnabled と共に使用しないでください。
    VisualStepsEnabled true に設定すると、スライダーは指定された StepSize 入力属性に基づいて視覚的な増分を表示します。
    注:
    視覚的にわかりやすくするために、この入力属性は入力属性 ReferencePoint と一緒に使用しないでください。
    EnforceStepSize true に設定すると、ユーザーは StepSize 値と一致しない値を数値ボックスに入力できません。
    Decoration ユーザーがセクションをタップするか、値を入力したときに表示される対応するラベルを使用して、スライダーのセクションを定義します。各セクションを特定の色に関連付けて、視覚的に表現できるようにすることができます。詳細については、「数値入力のスライダーオプションの構成」を参照してください。

    ランキング入力

    ランキング入力を使用して、ユーザーが利用可能な選択肢を設定または優先度の順にソートできるようにします。ユーザーは、利用可能な選択肢をタップしてドラッグします。

    ランキング入力の選択肢は、手動で定義する必要があります。

    		 ランキング入力の例。

    このトピックにリストされている一般的な属性以外のランキング入力の属性はありません。

    参照入力

    テーブルのフィールドを参照する入力には、参照入力を使用します。これらの入力は、インスタンス上のフォームの 参照フィールド のように機能します。条件、参照修飾子、および検索オプションを使用して参照入力を構成すると、ユーザーは必要なものをすばやく見つけることができます。

    オプションの検索オプションでは、「テキスト用」キーワード検索が使用され、モバイルビュー内の要素を検索できます。

    これらの属性は、参照入力で使用できます。

    表 : 1. 必要な属性
    属性 説明
    SourceTable 参照修飾子のソーステーブル
    SourceFieldName ソーステーブル内の参照フィールドのフィールド名
    TargetTable 参照修飾子のターゲットにするテーブル。

    次の追加属性はオプションです。

    表 : 2. 追加属性
    属性 説明
    MultiSelect ユーザーが入力に対して複数の選択肢を選択できるようにするオプション。値は [true] または [false] である必要があります
    MobileViewId 参照リストアイテムに使用するモバイルビュー ID (ビュー構成)。
    EnableSearch 検索バーを表示するオプション。値は [true] または [false] である必要があります
    SearchPlaceholder プレースホルダーとして検索バーに表示されるテキスト
    Conditions エンコードされたクエリーを入力して、参照リストに条件を適用します。これらのクエリの作成の詳細については、「 エンコードされたクエリ文字列」を参照してください。
    SearchType 検索に使用するクエリーを定義します。値は starts_with または contains です。この属性が構成されていない場合、インスタンスはデフォルトで表示ラベル列で starts_with を使用します。

    この例では、インシデント [incident] テーブルの [アサイン先] フィールドに対する入力フォーム画面入力を作成します。この入力を作成するには、[TargetTable]、[SourceTable]、および [SourceFieldName] の 3 つの必須属性を使用します。

    1. ユーザーは、ユーザーのリストからそのインシデントを割り当てるユーザーを選択します。したがって、[TargetTable] 属性を sys_user に設定します。
    2. インシデントレコードにユーザーを追加するため、 SourceTable 属性は インシデントに設定されます。
    3. 選択したユーザーが [アサイン先] フィールドに割り当てられるように、[SourceFieldName] を assigned_to に設定します。
    図 : 5. で構成されたassigned_toフィールドの参照入力 モバイルアプリビルダー
    モバイルアプリビルダーで構成されたassigned_toフィールドの入力フォーム画面入力。
    図 : 6. で構成されたassigned_toフィールドの参照入力属性 モバイルアプリビルダー
    モバイルアプリビルダー で構成されたassigned_toフィールドの入力フォーム画面の入力属性。

    署名入力

    署名入力を使用して、入力フォーム画面で電子署名をキャプチャします。署名入力は、入力フォーム画面のセクションまたはページに含めることができます。

    図 : 7. モバイルデバイスの入力フォーム画面での署名入力
    モバイルデバイスの入力フォーム画面での署名入力。

    署名入力では、オプションの IsOverlay 属性を使用できます。デフォルトでは、署名は完全なモーダルウィンドウに表示されます。IsOverlay属性 Value が true に設定されている場合、署名はハーフモーダルウィンドウに表示されます。

    属性 説明
    IsOverlay 署名入力をハーフモーダルウィンドウで開くかどうかを設定します。値はtrue または false に設定できます。true の値を指定すると、署名はハーフモーダルウィンドウで開くように構成されます。
    注:
    署名入力がページ上の唯一の入力として構成されていて、 isOverlay 属性が true に設定されている場合、 isOverlay 属性は無視され、署名入力は全画面に表示されます。
    署名入力を含む入力フォーム画面の作成については、「 署名入力で入力フォーム画面を構成」を参照してください。
    注:
    DataSouceId属性とElementIdentifier属性を使用するデータソースのロードメカニズムは、署名入力と互換性がありません。

    文字列入力

    テキスト入力には文字列入力を使用します。この入力の最大文字数を定義できます。

    		 文字列入力の例

    これらの属性は、文字列入力で使用できます。

    属性 説明
    Inline 入力をインラインで表示するか、別のモーダルで入力を開くオプション。値は [true] または [false] である必要があります
    MaxLength 入力値の最大文字数
    ShowDeleteAll 入力フィールドにテキストがある場合は常に削除ボタンを表示するオプション。この値は true または false である必要があり、デフォルトでは false に設定されています。
    ConfirmDeletion ShowDeleteAllの使用時に、テキストが削除される前にユーザーに確認メッセージを表示するオプション。値は true または false である必要があり、デフォルトでは true に設定されています。

    画面入力

    画面入力を使用して、リスト画面を選択可能なリスト入力に変換します。ユーザーは複数のリストアイテムを選択し、キャッシュへのライトバック操作を実行できます。

    モバイルアプリでの画面入力の例

    これらの属性は、画面入力で使用できます。

    属性 説明
    ScreenId 選択可能なリスト入力に使用されるリスト画面を設定します。値はリスト画面の sys_id です。
    GetDataFromParent リスト画面を親画面から選択可能なリスト入力に変換します。親リスト画面に適用されるフィルターは、画面入力に引き継がれます。この属性を有効にするには、 true を入力します。デフォルトでは、インスタンスではオフになっています。