---
sourceDocument: Xanadu モバイルの構成とナビゲーション
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/mobile

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu モバイルの構成とナビゲーション

ft:clusterId :

    - mobile

bundleId :

    - mobile

workflow :

    - Platform


---

# パラメーター化されたリスト画面の構成

# パラメーター化されたリスト画面の構成 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：9分

画面に表示されるレコードをフィルタリングするために画面で使用するパラメーターについてユーザーにクエリを実行するリスト画面を構成します。

## 始める前に

必要なロール：admin  
パラメーター化されたリストの作成は、標準リストの作成に似ています。標準リストを作成するために使用するステップに加えて、次のものを作成する必要があります。

* リストのパラメーター化されたデータアイテム。このデータアイテムは、パラメーターを使用して、リストに表示されるデータをフィルターリングします。
* リスト画面のパラメーター。このパラメーターは、リストに渡された値を保存します。
* リスト内のパラメーターをデータアイテムのパラメーターに関連付けるための、画面 UI パラメーターマッピング。
{#config-param-list__ul_c2f_ml4_wlb}

## 手順

1. 移動先 すべてシステムモバイルモバイルアプリビルダー.  
   モバイルアプリビルダー。
2. 作業しているアプリケーションスコープを検索し、アプリケーションスコープの名前を選択します。  
   モバイルアプリビルダー。
3. \[画面\] カテゴリを選択し、\[新規\] を選択します。
4. 画面の作成 ページで リスト オプションを選択し、 続行 を選択します。
5. 必要に応じて次のフィールドに入力します。  
   {#config-param-list__table_br2_cf3_1xb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | **プロパティ** ||
   | 名前 | リスト画面の名前。この名前は、モバイルアプリケーションでタイルとして表示されます。 |
   | 説明 | リスト画面に関する追加情報。 |
   | **画面設定** ||
   | オフラインで利用可能 | 画面がオフラインモードで使用可能かどうかを判断するオプション。 |
   | 画面名を非表示 | 画面名を画面ヘッダーとして表示するかどうかを指定するオプション。これは、テキストがヘッダー名に既に表示される場合や、ユーザーに値を提供しない場合に便利です。 |
   | フィルターを非表示にする | リストにリストフィルターが表示されないようにするオプション。 |
   | アイコン | ランチャー画面に追加されたときにリスト画面を表すために使用されるアイコン。 |
   | カスタムフィルター | レコードタイプをカテゴリ別にフィルタリングするためのカスタムフィルターを追加するオプション。 |
   | 空ステータス | 表示できるデータがない場合に空のスペースに表示する内容を設定します。 |
   | 画面セグメント | リスト画面の追加画面セグメントを構成します。 |
   | トップメニュー関数インスタンス | トップメニュー機能 を使用して追加オプションを表示するかどうかを指定するオプション。 |
   | フッター関数インスタンス | フッター関数を使用して追加オプションを表示するかどうかを決定するオプション。 |
   | UI のパラメーター | フィールドまたは UI 要素の動作を変更します。 |
   | 動的画面タイトル | 要素を作成し、それを UI パラメーターにマッピングできます。これを使用して、ある画面から別の画面に値を渡し、その値を宛先画面のタイトルに含めます。 |
   | アクセスロール | この画面にアクセスできるユーザーロールを決定します。ロールを選択しない場合、どのロールを持つユーザーでも画面にアクセスできます。 |
   [表 : 1. リスト画面レコード]

   {#config-param-list__table_br2_cf3_1xb}
6. \[ アイコン\] セクションで、既存のアイコンを選択するか、アイコンを作成します。  
   このアイコンは、リスト画面に追加するとランチャー画面に表示されます。アイコンの作成の詳細については、「 [モバイルのアイコン](https://servicenow-prod.fluidtopics.net/kcSI0BHOfQYi33oMeE3HTQ "アイコンを使用して、モバイルアプリケーションのナビゲーションとアクションに一意の識別子を提供します。")」を参照してください。
7. 画面セグメントセクションで、新規 を選択します。
8. 必要に応じて次のフィールドに入力します。  
   {#config-param-list__table_cjq_kt3_1xb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | **プロパティ** ||
   | 名前 | 画面セグメント画面の名前。 |
   | 順序 | セグメントが画面に表示される順序。セグメントが、最小値から最大値の順に表示されます。 |
   | スクリーン | リスト画面レコードのリスト名を表示します。 |
   | 最大オフライン行数 | オフライン表示のために表示される行数。 |
   | ストリーム | データアイテムとリストアイテム構成レコードをリスト画面に接続するレコード。 |
   | **インターリーブソート** ||
   | リストストリームインターリーブフィールドをソート | リストストリームインターリーブフィールドを昇順または降順のどちらでソートするかを決定します。 |
   [表 : 2. 画面セグメントレコード]

   {#config-param-list__table_cjq_kt3_1xb}
9. \[ ストリーム\] セクションで、 新規 を選択します。
10. 必要に応じて次のフィールドに入力します。  
    {#config-param-list__table_ldf_253_1xb__entry__2}

    | フィールド | 説明 |
    |-|-|
    | **プロパティ** ||
    | 名前 | ストリームの名前。 |
    | テーブル | リストに表示するデータを含む関連テーブルを選択します。 |
    | インターリーブフィールド | データアイテムをインターリーブするために使用するフィールドを選択します。 |
    | データアイテム | データアイテムは、画面に表示されるデータを提供する、選択したテーブルに対するクエリです。 |
    | リストアイテム構成 | 各レコードの表示方法とそれに関連付けられたアクションを決定します。 |
    [表 : 3. リストストリームレコード]

    {#config-param-list__table_ldf_253_1xb}
11. データ項目 セクションで、新規 を選択します。
12. 必要に応じて \[ プロパティ \] セクションと \[データ \] セクションに入力します。  
    データアイテムの作成の詳細については、「[標準データアイテムの構成](https://servicenow-prod.fluidtopics.net/qa7ZqN8Ndy4pqpuAEp8_jw "パラメーター入力を必要としない画面のデータをクエリするための標準データアイテムを構成します。")」を参照してください。
13. パラメーター セクションで、新規 を選択します。
14. \[データ パラメーター\] 画面の \[名前\] フィールドに、パラメーターの名前を入力します。  
    パラメーター名は、フォームのフィールドと最もよく関連付けられます。たとえば、フィールドが優先度を参照するときは、パラメーター名として「`優先度`」と入力します。
15. \[ タイプ \] フィールドから、パラメーターのデータタイプを選択します。  
    このタイプにより、ユーザーがモバイル UI とやり取りする方法が決まります。たとえば、10 進数や整数のタイプは、モバイルデバイスに数字のみのキーパッドを開くように指示します。次のタイプから選択します。
    * 整数：数字のみのキーパッドを開きます。
    * 文字列：入力にフルキーボードを使用します。優先度やステータスなどのリストパラメーターや、担当者や発信者のような参照フィールドには文字列タイプを使用します。
    * 10 進数：数字のみのキーパッドを開きます
    * ブーリアン：true または false の選択オプションを開きます
    * 日付と時刻：正確な時間セレクタを含むカレンダーを開きます
    * 日付：カレンダーを開きます
    {#config-param-list__ul_xgz_vkj_1xb}
16. \[データアイテム\] フォームの \[条件\] セクションで、パラメーターのクエリ条件を追加します。  
    \[条件\] フィールドは、データベースをクエリするパラメーターと一致させる必要があります。たとえば、\[優先度\] フィールドをクエリするデータ項目を作成する場合は、 `{{data parameter}}` という優先度の条件を作成します。作成したデータパラメーターを条件ビルダーで選択して、必ず選択してください。

    これで、パラメーター化されたリストで使用するパラメーター化されたデータ項目ができました。この例は、Priority という名前のパラメーターを使用して、そのパラメーターの値に一致する優先度のデータ項目をフィルター処理するパラメーター化されたデータ項目を示しています。
17. 階層構成ツリーを使用してリストストリームに戻ります。
18. \[データ項目\] フィールドで、前の手順で作成したパラメーター化されたデータ項目を選択します。
19. リスト画面に戻り、\[UI Parameters (UI パラメーター)\] の下の \[New (新規)\] を選択して、新しい UI パラメーターを作成します。
20. 必要に応じて次のフィールドに入力します。  
    {#config-param-list__table_p4g_1mj_1xb__entry__2}

    | フィールド | 値 |
    |-|-|
    | 名前 | UI パラメーターの名前。 |
    | 表示名 | \[ 名前 \] フィールドに使用されたものと同じテキストが自動的に入力されます。 |
    | **設定** ||
    | パラメータータイプ | このフィールドは、自動的に入力されます。 |
    | スクリーン | このフィールドは、自動的に入力されます。 |
    | 入力スタイル | パラメーターの入力スタイル。\[ インライン\]、\[ポップアップ\]、または\[なし\] から選択します。 |
    | 必須 | パラメーターのユーザー入力が必須かどうかを決定します。 |
    | プレースホルダーテキスト | ユーザーが値を入力する前に、パラメーター入力フィールドに表示されるテキスト。 |
    | 順序 | UI パラメーターが表示される順序を設定するために使用できるオプションのフィールド。複数のパラメーターがある場合は、\[ 順序\] を設定します。 |
    | 入力ソース | パラメーター入力が \[ユーザー入力\] か \[ 自動入力\] かを選択します。この例では \[ユーザー入力 \] を選択します。 |
    | 入力タイプ | ユーザーがこのパラメーターの値を入力する方法。次のオプションのいずれかを選択します。 * テキスト * 選択リスト * 検索リスト * QR/バーコード {#config-param-list__ul_q4g_1mj_1xb} この例では \[選択リスト \] を選択します。 |
    | 繰り越し | このパラメーターが繰り越しパラメーターかどうか。繰り越しパラメーターを使用して、さまざまな画面とアクションの間で情報を移動します。 |
    | 複数選択 | ユーザーが選択リストから複数の値を選択できるかどうかを指定します。このフィールドは、\[入力タイプ\] フィールドが \[選択リスト\] に設定されている場合にのみ表示されます。 |
    | **Data** ||
    | テーブル | ユーザーがパラメーター値を選択する選択リストとして使用するテーブル。このフィールドは、\[ 入力タイプ \] フィールドが \[選択リスト\] または \[検索リスト\] に設定されている場合にのみ表示されます。 |
    | フィールド | ユーザーがパラメーター値を選択する選択リストとして使用するフィールド。このフィールドは、\[ 入力タイプ \] フィールドが \[選択リスト\] または \[検索リスト\] に設定されている場合にのみ表示されます。 |
    | 画面データパラメーターのマッピング | この画面に渡す特定の値を決定します。 |
    [ ]

    {#config-param-list__table_p4g_1mj_1xb}
21. \[ 画面データパラメーターマッピング \] セクションで、データアイテムで作成したデータパラメーターを選択します。
22. \[保存\] を選択します。
23. **オプション:** 入力フォーム画面でのパラメーター化されたデータアイテムのサポートが追加されました。詳細については、「 [入力フォーム画面のパラメーター化されたデータアイテムのサポート](https://servicenow-prod.fluidtopics.net/RT7gTFIk1e7UpZ5DqlWTMw "アドミニストレーターは、入力フォーム画面のユーザー入力と変数に基づいて関連レコードを返すことができるパラメーター化されたデータアイテム画面を構成できます。")」を参照してください。  
    これらの手順により、データアイテムクエリ条件の一部として使用する入力と変数を含む入力フォーム画面を構成できます。この機能は、 モバイルアプリビルダー ではなく Web ベースの UI で構成されます。  
    注:  
    入力フォーム画面には、データアイテムクエリ条件の一部として使用する入力のみ、変数のみ、または入力と変数の両方を含めることができます。入力フォーム画面の作成については、「[入力フォーム画面を構成する](https://servicenow-prod.fluidtopics.net/ntoIHRdKxUgXyzILe88yeQ "入力パラメーターを設定して、ユーザーがモバイルアプリのレコードリストを表示できるようにします。ユーザーはレコード名をタップするだけで、リストからレコードにアクセスできます。")」を参照してください。
    1. ターゲットリストに移動します。たとえば、パラメーター化されたデータアイテムリスト画面を構成する場合は、次のようにします。  
       1. フィルターに `「sys_sg_list_screen.list` 」と入力します
       2. パラメーター化するリスト画面を選択します。
       3. \[ 入力フォーム画面 \] フィールドで、作成した入力フォーム画面を検索します。
       4. \[更新\] を選択します。
       {#config-param-list__ol_e23_xnj_1xb}
    2. 次の表に示すように、入力フォーム画面で作成された入力または変数をデータパラメーターにマッピングします。  
       {#config-param-list__table_pxt_24j_1xb__entry__2}

       | フィールド | 説明 |
       |-|-|
       | 変数 | 入力フォーム画面変数 |
       | スクリーン | ターゲット画面。このフィールドは自動的に入力されます。 |
       | アプリケーション | アプリケーション スコープです。このフィールドは自動的に入力されます。 |
       | 入力 | 入力フォーム画面からのラベルの入力 |
       | データパラメーター | ターゲット画面データアイテムのデータパラメーター |
       [表 : 4. 入力変数パラメーターマッピングフォーム]

       {#config-param-list__table_pxt_24j_1xb}
    {#config-param-list__substeps_jpr_snj_1xb}