単一選択
データ・バインディング
「一般」プロパティーでビューのデータ・バインディングの設定や変更を行います。 このビューは ANY タイプにバインドできます。
構成プロパティー
「構成」で、ビューの外観および動作プロパティーを設定または変更します。
- 画面サイズ
- プロパティー名の横に画面サイズ・アイコン
がある構成プロパティーは、画面サイズごとに異なる値を持つことができます。 値を設定しない場合、画面サイズはそのデフォルト値として次に大きい画面サイズの値を継承します。
- テーマ定義
- テーマ定義は、ビューの色およびスタイルを指定し、その外観を決定します。 ビューのルック・アンド・フィールをテーマ・エディターでプレビューできます。 テーマを参照してください。
| 外観構成プロパティー | 説明 | データ・タイプ |
|---|---|---|
幅![]() |
ビューの幅です。 幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。 例えば、50px、20%、または 0.4em のようにします。 単位タイプが指定されていない場合は、px と見なされます。 | String |
サイズ ![]() |
ビュー内のテキストのサイズ、ラベル・テキストのサイズ、およびテキストの周囲の埋め込みの量。 例えば、スマートフォンでテキストとラベルをより読みやすくするには、この構成オプションを Large に設定して、小さい画面サイズを補正することができます。 | String |
ラベルの配置 ![]() |
ラベルの位置。 | String |
ラベルの幅 ![]() |
ラベルの幅です。 幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。 例えば、50px、20%、または 0.4em のようにします。 単位タイプが指定されていない場合は、px と見なされます。 | String |
| 動作構成プロパティー | 説明 | データ・タイプ |
|---|---|---|
| タブ・インデックス | フォーム・コントロールのタブ・シーケンスのインデックス。 タブのインデックスは 1 から始まり、スパースに設定することができます。 例えば、1、5、10 などと指定できます。 | Integer |
| プレースホルダー | 選択が行われる前に表示されるテキスト。 | String |
以下の表に、単一選択ビューの項目構成プロパティーを示します。
| 項目構成プロパティー | 説明 | データ・タイプ |
|---|---|---|
| 項目ルックアップ・モード | ユーザーが選択できる項目のリストにデータを取り込むために使用される方式。 注: 必ず正しいオプションを選択してください。そうしないと、リストに正しくデータが取り込まれません。
|
String |
| リスト項目サービス | 選択リストに表示される項目のリストにデータを取り込むために使用されるサービス。 このサービスは、項目ルックアップ・モードが「サービスからの項目」の場合に使用されます。 このサービスは、「サービスの入力データ」ビジネス・オブジェクトによって提供されたデータに基づいて選択リストを提供する、適切な Ajax アクセスを伴うサービス・フローです。 このオプションは、ビューをリスト・オブジェクトにバインドする代わりの方法として使用できます。 ヒント: リスト項目サービスでは、 dataという名前の
string 型の入力変数と、ビューにバインドされたデータとして結果を出力する resultsという名前の list 型の出力変数の 2 つの変数を使用します。 リスト項目サービスの出力変数名が results ではない場合、使用できるようになる値はありません。 |
サービス・フロー |
| サービスの入力データ | 選択リストへのデータ取り込みに使用するサービス・フローに渡される、入力データを提供するビジネス・オブジェクト。 このオプションは、項目ルックアップ・モードが「サービスからの項目」の場合に使用されます。 | 任意 |
| 入力データの変化を無視 | サービス入力データの変更時に自動サービス呼び出しを使用不可にします。 このオプションが使用されるのは、「項目ルックアップ・モード」が「サービスからの項目」に設定されたときのみです。 | Boolean |
| 項目入力データ | 選択リストにデータを取り込むビジネス・オブジェクト・リスト。 このプロパティーは、項目ルックアップ・モードが「構成オプションからの項目」の場合にのみ使用されます。 | 任意 [] |
| 項目選択データ | 「表示プロパティー」フィールドで、選択リストに表示されるビジネス・オブジェクトのプロパティーを設定します。 データ・マッピング・プロパティーに値が指定されていない場合、デフォルト値は、 「値」プロパティーの場合は name 、 「表示プロパティー」の場合は value になります。 | SelectDataMapping |
| ビジネス・データの出力 | ビューが複合型にバインドされている場合は、ユーザーが選択するプロパティーが、「表示プロパティー」で指定されたプロパティーおよびビューにバインドされているプロパティーに渡されます。 | SelectDataMapping |
| 静的リスト | 選択リストにデータを設定するための項目の静的リスト。 このオプションは静的リストに対してのみ使用します。 このオプションに変数を指定しないでください。 変数リストの場合は、「構成オプションからの項目」ルックアップ・モードを使用します。 重要: 値ペアの 「名前」 フィールドは、別のフィールドの値を計算するために使用されるため、固有でなければなりません。 変数データがあるアクティビティーから別のアクティビティーに渡される予期しない動作を防止するために、値のペアに使用される名前が固有になるようにしてください。
|
NameValuePair[] |
| 選択のクリアを有効にする | リスト内の選択をクリアするオプションを表示します。 | ブール値 |
選択状態が入力ビジネス・オブジェクト・リストの listSelected プロパティーにコピーされます。 選択状態を取得するには、このプロパティーにビューをバインドします。 例: リスト・ビジネス・オブジェクトを使用した項目へのデータの取り込みを参照してください。
例: 静的リストからの項目の設定
この例では、ラベル Grocery list および 「項目ルックアップ・モード」 が 「静的リストからの項目」 に設定された単一選択ビューを使用します。
| 名前 | 値 |
|---|---|
| 項目1 | パン |
| 項目 2 | 牛乳 |
| 項目 3 | バナナ |
| 項目 4 | 米 |

例: 静的リストの項目を使用した合計の計算
この例では、静的リストの「名前」フィールドの値を使用して、別のフィールドの値を計算しています。
Coach またはページには、単一選択ビュー、整数ビュー、および 10 進数ビューを含む水平レイアウトがあります。 Coach またはページには、ボタン・ビューもあります。
- は Itemです。
- は Itemです。
- は Select Itemです。
- は、 「静的リストからの項目」です。
- には、以下の項目があります。
- 「名前」 は .50、 「値」 は Appleです。
- 「名前」 は .75、 「値」 は Orangeです。
- 「名前」 は .25、 「値」 は Bananaです。
- は 「数量」です。
- は 「数量」です。
- は 「合計」です。
- は 2です。
- には、以下の項目があります。
ここで、Item は単一選択ビューのコントロール ID、Quantity は整数ビューのコントロール ID です。@{Item}*@{Quantity}
ボタン・ビューには、「OK」というラベルが付いています。


例: サービス・フローからの項目の設定
この例では、Ajax アクセスを伴うサービス・フローを使用して、選択リストとして使用されるリストを初期化します。
注意: デフォルトでは、Ajax アクセスは、信頼できる呼び出し元に対してのみ許可されます。 Process Designer 内の Coach またはページを実行するには、サービス・フローの「概要」タブに移動し、「Ajax アクセス」を「すべての呼び出し元からの呼び出しを許可する (Allow calls from all callers)」に変更します。
- は Grocery Listです。
- は 「項目の選択」です。
- は、 「サービスからの項目」です。
- は Retrieve Items Serviceです。
注意: サービス・フローを作成するには、「リスト項目サービス」オプションの隣にある「新規」をクリックしてください。
- には、以下の設定があります。
- 値プロパティー は nameです。
- 表示プロパティー は valueです。
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";


例: リスト・ビジネス・オブジェクトを使用した項目の設定
この例では、Customer 型の cust[] リスト・オブジェクトを使用して、選択リストの名のリストを設定します。 ユーザーが名前を選択すると、選択した名前がテキスト・ボックスに表示されます。 クライアント・サイド・ヒューマン・サービスには、cust と output のプライベート変数があります。これらはいずれも Customer 型です。
- タイプ
StringのIDパラメーター。 - タイプ
Stringのfirstnameパラメーター。 - タイプ
Stringのlastnameパラメーター。
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- は 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 属性」) について詳しくは、 「プロパティーの表示」を参照してください。