単一選択

ドロップダウン・リストを生成します。 静的に、またはサービスを使用して、リストにデータを取り込むことができます。

データ・バインディング

一般」プロパティーでビューのデータ・バインディングの設定や変更を行います。 このビューは ANY タイプにバインドできます。

構成プロパティー

「構成」で、ビューの外観および動作プロパティーを設定または変更します。

画面サイズ
プロパティー名の横に画面サイズ・アイコン 画面サイズ・アイコン がある構成プロパティーは、画面サイズごとに異なる値を持つことができます。 値を設定しない場合、画面サイズはそのデフォルト値として次に大きい画面サイズの値を継承します。
テーマ定義
テーマ定義は、ビューの色およびスタイルを指定し、その外観を決定します。 ビューのルック・アンド・フィールをテーマ・エディターでプレビューできます。 テーマを参照してください。
以下の表に、単一選択ビューの外観構成プロパティーを示します。
表 1. 単一選択ビューの外観構成プロパティー
外観構成プロパティー 説明 データ・タイプ
画面サイズ・アイコン ビューの幅です。 幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。 例えば、50px、20%、または 0.4em のようにします。 単位タイプが指定されていない場合は、px と見なされます。 String
サイズ 画面サイズ・アイコン ビュー内のテキストのサイズ、ラベル・テキストのサイズ、およびテキストの周囲の埋め込みの量。 例えば、スマートフォンでテキストとラベルをより読みやすくするには、この構成オプションを Large に設定して、小さい画面サイズを補正することができます。 String
ラベルの配置 画面サイズ・アイコン ラベルの位置。 String
ラベルの幅 大画面アイコン ラベルの幅です。 幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。 例えば、50px、20%、または 0.4em のようにします。 単位タイプが指定されていない場合は、px と見なされます。 String
以下の表に、単一選択ビューの動作構成プロパティーを示します。
表 2. 単一選択ビューの動作構成プロパティー
動作構成プロパティー 説明 データ・タイプ
タブ・インデックス フォーム・コントロールのタブ・シーケンスのインデックス。 タブのインデックスは 1 から始まり、スパースに設定することができます。 例えば、1、5、10 などと指定できます。 Integer
プレースホルダー 選択が行われる前に表示されるテキスト。 String

以下の表に、単一選択ビューの項目構成プロパティーを示します。

表 3. 単一選択ビューの項目構成プロパティー
項目構成プロパティー 説明 データ・タイプ
項目ルックアップ・モード ユーザーが選択できる項目のリストにデータを取り込むために使用される方式。 注: 必ず正しいオプションを選択してください。そうしないと、リストに正しくデータが取り込まれません。
空で開始
以下を使用して、プログラムで選択リストにデータを取り込みます。appendItem(value, displayText)メソッド。
サービスからの項目
選択リストには、「リスト項目サービス」オプションで指定されたサービスからデータが取り込まれます。
静的リストからの項目
選択リストには、「静的リスト」オプションに入力されたプロパティーによりデータが取り込まれます。
構成オプションからの項目
選択リストには、「項目入力データ」オプションで指定されたビジネス・オブジェクト・リストからデータが取り込まれます。
String
リスト項目サービス 選択リストに表示される項目のリストにデータを取り込むために使用されるサービス。 このサービスは、項目ルックアップ・モードが「サービスからの項目」の場合に使用されます。 このサービスは、「サービスの入力データ」ビジネス・オブジェクトによって提供されたデータに基づいて選択リストを提供する、適切な Ajax アクセスを伴うサービス・フローです。 このオプションは、ビューをリスト・オブジェクトにバインドする代わりの方法として使用できます。
ヒント: リスト項目サービスでは、 dataという名前の string 型の入力変数と、ビューにバインドされたデータとして結果を出力する resultsという名前の list 型の出力変数の 2 つの変数を使用します。 リスト項目サービスの出力変数名が results ではない場合、使用できるようになる値はありません。
サービス・フロー
サービスの入力データ 選択リストへのデータ取り込みに使用するサービス・フローに渡される、入力データを提供するビジネス・オブジェクト。 このオプションは、項目ルックアップ・モード「サービスからの項目」の場合に使用されます。 任意
入力データの変化を無視 サービス入力データの変更時に自動サービス呼び出しを使用不可にします。 このオプションが使用されるのは、「項目ルックアップ・モード」「サービスからの項目」に設定されたときのみです。 Boolean
項目入力データ 選択リストにデータを取り込むビジネス・オブジェクト・リスト。 このプロパティーは、項目ルックアップ・モードが「構成オプションからの項目」の場合にのみ使用されます。 任意 []
項目選択データ 「表示プロパティー」フィールドで、選択リストに表示されるビジネス・オブジェクトのプロパティーを設定します。 データ・マッピング・プロパティーに値が指定されていない場合、デフォルト値は、 「値」プロパティーの場合は name「表示プロパティー」の場合は value になります。 SelectDataMapping
ビジネス・データの出力 ビューが複合型にバインドされている場合は、ユーザーが選択するプロパティーが、「表示プロパティー」で指定されたプロパティーおよびビューにバインドされているプロパティーに渡されます。 SelectDataMapping
静的リスト 選択リストにデータを設定するための項目の静的リスト。 このオプションは静的リストに対してのみ使用します。 このオプションに変数を指定しないでください。 変数リストの場合は、「構成オプションからの項目」ルックアップ・モードを使用します。
重要: 値ペアの 「名前」 フィールドは、別のフィールドの値を計算するために使用されるため、固有でなければなりません。 変数データがあるアクティビティーから別のアクティビティーに渡される予期しない動作を防止するために、値のペアに使用される名前が固有になるようにしてください。
NameValuePair[]
選択のクリアを有効にする リスト内の選択をクリアするオプションを表示します。 ブール値

選択状態が入力ビジネス・オブジェクト・リストの listSelected プロパティーにコピーされます。 選択状態を取得するには、このプロパティーにビューをバインドします。 例: リスト・ビジネス・オブジェクトを使用した項目へのデータの取り込みを参照してください。

例: 静的リストからの項目の設定

この例では、ラベル Grocery list および 「項目ルックアップ・モード」 「静的リストからの項目」 に設定された単一選択ビューを使用します。

「静的リスト」には、以下の名前と値のペアがあります。
表 4。 静的リスト
名前
項目1 パン
項目 2 牛乳
項目 3 バナナ
項目 4
実行時の結果は次のようになります。
このイメージは、「食料品リスト」というタイトルのリストを示しています。このリストには、「ミルク」、「パン」、「バナナ」、「ライス」という項目が含まれています。 バナナが強調表示されます。

例: 静的リストの項目を使用した合計の計算

この例では、静的リストの「名前」フィールドの値を使用して、別のフィールドの値を計算しています。

Coach またはページには、単一選択ビュー、整数ビュー、および 10 進数ビューを含む水平レイアウトがあります。 Coach またはページには、ボタン・ビューもあります。

単一選択ビューには、以下のプロパティーがあります。
  • 「一般」 > 「共通」 > 「ラベル」Itemです。
  • 「一般」 > 「共通」 > 「コントロール ID」Itemです。
  • 「構成」 > 「動作」 > プレースホルダーSelect Itemです。
  • 構成 > 「項目」 > 項目ルックアップ・モード は、 「静的リストからの項目」です。
  • 構成 > 「項目」 > 静的リスト には、以下の項目があります。
    • 「名前」.50「値」Appleです。
    • 「名前」.75「値」Orangeです。
    • 「名前」.25「値」Bananaです。
整数ビューには、以下のプロパティーがあります。
  • 「一般」 > 「ラベル」「数量」です。
  • 「一般」 > 「コントロール ID」「数量」です。
10 進数ビューには、以下のプロパティーがあります。
  • 「一般」 > 「ラベル」「合計」です。
  • 「動作」 > 「小数点以下の桁数」2です。
  • イベント > 値の数式 には、以下の項目があります。
    @{Item}*@{Quantity}
    ここで、Item は単一選択ビューのコントロール ID、Quantity は整数ビューのコントロール ID です。

ボタン・ビューには、「OK」というラベルが付いています。

実行時に、以下の画面が表示されます。
このイメージは、アイテムの「アイテムの選択」、ブランクの「数量」、およびゼロの「合計」を示しています。
項目を選択して数量を入力し、「OK」をクリックします。 結果は次のとおりです。
このイメージは、アイテムに対して選択されたオレンジ、数量 5、および合計 3.75を示しています。
「単一選択」ビューの「名称」フィールドに数値が表示されているため、数量と選択されたアイテムによって合計を判別できます。 「合計」フィールドの値は、単価 (単一選択ビューの 「コントロール ID」) に数量 (整数ビューの「コントロール ID」) を乗算したものです。

例: サービス・フローからの項目の設定

この例では、Ajax アクセスを伴うサービス・フローを使用して、選択リストとして使用されるリストを初期化します。

注意: デフォルトでは、Ajax アクセスは、信頼できる呼び出し元に対してのみ許可されます。 Process Designer 内の Coach またはページを実行するには、サービス・フローの「概要」タブに移動し、「Ajax アクセス」を「すべての呼び出し元からの呼び出しを許可する (Allow calls from all callers)」に変更します。

Coach またはページには、以下の構成プロパティーを含む単一選択ビューがあります。
  • 「構成」 > 「動作」 > 「ラベル」Grocery Listです。
  • 「構成」 > 「動作」 > プレースホルダー「項目の選択」です。
  • 「構成」 > 「項目」 > 項目ルックアップ・モード は、 「サービスからの項目」です。
  • 「構成」 > 「項目」 > 「項目のリスト」サービスRetrieve Items Serviceです。

    注意: サービス・フローを作成するには、「リスト項目サービス」オプションの隣にある「新規」をクリックしてください。

  • 構成 > 項目 > 項目選択データ には、以下の設定があります。
    • 値プロパティーnameです。
    • 表示プロパティーvalueです。
このサービス・フローは、「項目の取得サービス (Retrieve Items Service)」という名前で、開始イベント、サーバー・スクリプト、および終了イベントが互いにワイヤリングされています。 サーバー・スクリプトには、変数を初期化する以下のコードが含まれています。
tw.local.results = new tw.object.listOf.NameValuePair();

tw.local.results[0] = new tw.object.NameValuePair();
tw.local.results[0].name = "Item 0";
tw.local.results[0].value = "Milk";

tw.local.results[1] = new tw.object.NameValuePair();
tw.local.results[1].name = "Item 1";
tw.local.results[1].value = "Bread";

tw.local.results[2] = new tw.object.NameValuePair();
tw.local.results[2].name = "Item 2";
tw.local.results[2].value = "Bananas";

tw.local.results[3] = new tw.object.NameValuePair();
tw.local.results[3].name = "Item 3";
tw.local.results[3].value = "Rice";
実行時の結果は次のようになります。
選択可能リストと長方形を示す画像。
これは選択可能な項目のリストです。
選択可能リストと長方形を示す画像。
項目のリストがサービス・フローから取得されます。 リストに表示されるプロパティーは、「項目選択データ」の下の「表示プロパティー」オプションで決定されます。 「表示プロパティー」として name と入力すると、項目 0、項目 1 などが選択リストに表示されます。
項目を選択すると、その項目が「項目」フィールドに表示されます。
選択可能リストと長方形を示す画像。
「項目」フィールドの値は、「ビジネス・データ・マッピング」の下の「表示プロパティー」オプションによって決定されます。これは、「単一選択」ビューの出力として使用されるプロパティーでもあります。

例: リスト・ビジネス・オブジェクトを使用した項目の設定

この例では、Customer 型の cust[] リスト・オブジェクトを使用して、選択リストの名のリストを設定します。 ユーザーが名前を選択すると、選択した名前がテキスト・ボックスに表示されます。 クライアント・サイド・ヒューマン・サービスには、custoutput のプライベート変数があります。これらはいずれも Customer 型です。

Customer ビジネス・オブジェクトの構造を以下に示します。
  • タイプStringIDパラメーター。
  • タイプStringfirstnameパラメーター。
  • タイプStringlastnameパラメーター。
cust[] リスト・オブジェクトには、以下のデフォルト値があります。
var autoObject = [];
autoObject[0] = {};
autoObject[0].ID = "000";
autoObject[0].firstName = "Pierre";
autoObject[0].lastName = "de Fermat";
autoObject[1] = {};
autoObject[1].ID = "001";
autoObject[1].firstName = "Isaac";
autoObject[1].lastName = "Newton";
autoObject[2] = {};
autoObject[2].ID = "002";
autoObject[2].firstName = "John";
autoObject[2].lastName = "Venn";
autoObject
Coach またはページの単一選択ビューには、以下のプロパティーがあります。
  • 「一般」 > 「ラベル」Nameです。
  • 「一般」 > 「バインディング」output.firstNameです。
  • 「構成」 > 「動作」 > 「プレースホルダー」「名前の選択」です。
  • 構成 > 「項目」 > 「項目ルックアップ・モード」 は、 「構成オプションからの項目」です。
  • 「構成」 > 「項目」 > 「項目入力データ」Customer[]です。
  • 構成 > 項目 > 項目選択データ には、以下の設定があります。
    • 値プロパティーIDです。
    • 表示プロパティーfirstNameです。
  • 「構成」 > 「項目」 > 「出力ビジネス・データ」 には、以下の設定があります。
    • 値プロパティーIDです。
    • 表示プロパティーfirstNameです。
テキスト・ビューには、以下のプロパティーがあります。
  • 「一般」 > 「ラベル」Textです。
  • 「一般」 > 「バインディング」cust.listSelected.firstNameです。
実行時の結果は次のようになります。
選択可能リストを示す画像。
選択すると、選択した名前がテキスト・ビューに取り込まれます。
選択可能リストを示す画像。

イベント

「イベント」プロパティーでビューのイベント・ハンドラーの設定や変更を行います。 イベントをプログラムでトリガーするかユーザーがビューと対話したときにトリガーするように設定できます。 イベントを定義およびコーディングする方法については、 ユーザー定義イベントを参照してください。

単一選択ビューには以下のタイプのイベント・ハンドラーがあります。

  • On load: Coach またはページのロード時にアクティブ化されます。 例:

    console.log(me.getItemCount());

  • On change: バインドされたデータの変更時にアクティブ化されます。 例:

    ${SingleSelect2}.reloadServiceItems(me.getSelectedIndices());

  • On service items: 呼び出されたサービスが項目のリストを返したときにアクティブ化されます。 「項目ルックアップ・モード」「サービスからの項目」に設定されている場合にのみアクティブ化されます。

    console.log("SingleSelect1 item service retrieved items successfully");

  • On service error: 呼び出されたサービスがサービス・エラーを返したときにアクティブ化されます。 「項目ルックアップ・モード」「サービスからの項目」に設定されている場合にのみアクティブ化されます。

    me.clearItems();

方法

単一選択ビューに使用できるメソッドの詳細情報については、 単一選択 JavaScript API を参照してください。

その他のリソース

Coach またはページの作成方法については、 Coach の作成を参照してください。
標準プロパティー (「一般」「構成」「位置決め」「可視性」、および 「HTML 属性」) について詳しくは、 「プロパティーの表示」を参照してください。