入力の入力フォーム画面属性

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：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);
    添付ファイルソースをユーザーに制限する
    添付ファイルの作成元を制限して、画像が次のいずれかまたはすべてから取得されるようにするオプションがあります。
    • カメラによるオンサイト
    • ユーザーの電話ギャラリーから
    • ユーザーのファイルシステムから

    [入力属性] レコードで、[ 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 選択肢オプションを選択肢入力の画像としてレンダリングするオプション。値は 画像である必要があります。
    EnableSearch 検索バーを表示するオプション。値は true または false である必要があります。
    SearchPlaceholder プレースホルダーとして検索バーに表示されるテキスト。
    SearchType 検索に使用するクエリを定義します。値は starts_with または contains にすることができます。この属性が設定されていない場合、インスタンスはデフォルトで表示ラベル列で starts_with を使用します。

    カスタムマップ入力

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

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

    重要:

    パラメーター化されたデータアイテムをサポートするカスタムマップ入力では、 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 が定義されていない場合は、このオプションがデフォルトです。
    date
    日付のみを表示します。
    IncludeTimezone

    入力が追加されるモバイルデバイスのタイムゾーン。値は true または false である必要があります。

    true に設定すると、モバイルクライアントは、デバイスのタイムゾーン情報と日付と時刻の値を次の形式でバックエンドインスタンスに送信します。

    YYYY-MM-DDThh:mm:ss.sssTZD

    注:
    デバイスのタイムゾーンが、プラットフォームで構成されているユーザープロファイルのタイムゾーンとは異なります。

    この属性が設定されていない場合、モバイルクライアントの日付/時刻入力値にデバイスのタイムゾーン情報は含まれません。この動作がデフォルトです。日付/時刻の入力値は、次の形式です。

    YYYY-MM-DD hh:mm:ss

    さまざまなアクションタイプの日付/時刻入力の IncludeTimezone 属性の設定については、「 さまざまなアクションアイテムタイプの日付/時刻入力セットアップ」を参照してください。

    アクションアイテムタイプの詳細については、「 アクションアイテムの構成」を参照してください。
    MaxRangeDays

    日付/時刻の入力が追加されたときに将来の日付を選択できるかどうかを決定するオプションの属性。この属性は、正と負の両方の整数値をサポートします。MaxRangeDays を 0 に設定すると、ユーザーは将来の日付を選択できなくなり、現在または過去の日付に制限されます。

    注:
    MaxRangeDaysMinRangeDays、MaxRangeHours、MinRangeHoursと一緒に使用できます。
    MinRangeDays

    日付/時刻の入力が追加されたときに過去の日付を選択できるかどうかを決定するオプションの属性。この属性は、正と負の両方の整数値をサポートします。MinRangeDays を 0 に設定すると、ユーザーは過去の日付を選択できなくなり、現在または将来の日付に制限されます。

    注:
    MinRangeDaysMaxRangeDays、MaxRangeHours、MinRangeHoursと一緒に使用できます。
    MaxRangeHours

    日付/時刻の入力が追加されたときに将来の時間を選択できるかどうかを決定するオプションの属性。この属性は、正と負の両方の整数値をサポートします。MaxRangeHours を 0 に設定すると、ユーザーは将来の日時を選択できなくなり、現在または過去の日時に制限されます。

    注:
    MaxRangeHoursMaxRangeDays、MinRangeDays、MinRangeHoursと一緒に使用できます。
    MinRangeHours

    日付/時刻の入力が追加されたときに過去の時間を選択できるかどうかを決定するオプションの属性。この属性は、正と負の両方の整数値をサポートします。MinRangeHours を 0 に設定すると、ユーザーは過去の日時を選択できなくなり、現在または将来の日時に制限されます。

    注:
    MinRangeHoursMaxRangeDays、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 」と入力します。デフォルトでは、インスタンスではオフになっています。