サブファイル (ドロップダウン)

サブファイル (ドロップダウン) ウィジェットは、5250 サブファイルをレンダリングします。

このウィジェットは、サブファイル・コンポーネントが提供するデータをレンダリングします。

注: このウィジェットを使用する際の DBCS に関する考慮事項については、SBCS での最大長の除去を参照してください。
次の図に、変換においてサブファイル・コンポーネントの例のデータを入力として使用するサブファイル (ドロップダウン) ウィジェットの表示例を示します。
図 1. サブファイル (ドロップダウン) ウィジェットの例
サブファイル (ドロップダウン) ウィジェットの例
  1. 表題のタイプ (両方を表示)
  2. 先行トークン
  3. 説明
  4. 送信ボタン (送信ボタンを表示)
  5. 送信ボタンの表題 (送信)
以下の設定が、このウィジェットに対して構成できます。
表題のタイプ:
ドロップダウン内の各項目の表題を決定する方法を指定します。コンポーネントから先行トークンの値および説明が取り込まれます。つまり、表題として表示する項目を選択できます。例えば、ホスト画面に「5. 表示」というアクションが存在する場合、表題表示として「5」「表示」、または「5. 表示」を選択できます。
サブファイル・アクションを表示 (Show subfile actions)
ドロップダウン・リストに加え、レンダリングされたサブファイルとサブファイル・アクションの説明文 (例: 2=Add) を表示する場合は、このボックスを選択します。このチェック・ボックスは、「説明を表示」を選択した場合には使用できません。
選択時に自動的にサブミット
これを選択した場合、ドロップダウンで選択操作が行われると、その選択内容が実行依頼されます。
送信ボタンを表示
これを選択した場合、サブファイルの下に送信ボタンが表示されます。
送信ボタンの表題
オプション。送信ボタンの表題を指定します。
ボタンのスタイル・クラス (Web のみ)
オプション。生成される送信ボタンに関連する CSS スタイル・クラスです。HTML ボタン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSBUTTON です。詳しくは、スタイル・シートの使用を参照してください。
ボタン行のスタイル・クラス (Web のみ)
オプション。送信ボタンを含む生成されるテーブル行に関連する CSS スタイル・クラスです。デフォルト値は HATSTABLEHEADER です。詳しくは、スタイル・シートの使用を参照してください。
1 レコードあたりの行数 (Rows per record)
行数
サブファイル内の 1 レコードあたりの固定行数を指定します。
Columns placement (Web のみ)

This widget can be configured to display primary columns of data, and optionally to have a details section to view additional detail columns. This setting is useful when displaying table data on a mobile device. For more information about these settings and about other settings for this option that do not appear in the ZIETrans Toolkit GUI, see モバイル装置に関する考慮事項および制限.

Primary columns
Use this field to specify which columns to display, and in what order. The field allows for numeric any-order listing of column numbers with expansion shorthand, and columns are allowed to be displayed more than once or not at all, for example, 1,3,2,5-7,2-3,9.

A hyphen (-) between two numbers indicates a range of columns. You can use the asterisk character (*) to indicate the last available column. An asterisk alone means columns 1 through n where n is the last available column. You can also use 5* as a shorthand for 5-*. These mean the same thing: 1-*, *.

For Web projects, this setting defaults to *, or all columns. For Web projects optimized for mobile devices, this setting defaults to 1-2, or columns 1 and 2.

注: The numbers represent columns provided to the widget by the component. They do not represent the columns originally recognized by the component, which may or may not be excluded, before providing them to the widget.
Detail columns
Use this optional field to specify which detail columns to display when requested, and in what order. The field allows for numeric any-order listing with expansion shorthand.

For Web projects, this setting defaults to empty, or no detail columns section. For Web projects optimized for mobile devices, this setting defaults to 3*, or column 3 through the last column.

Keep detail columns on the server
Select this option to keep the detail columns section on the server until requested by the user. This reduces the amount of HTML output at initial rendering. The default is cleared.
前景色を有効にする
これを選択した場合、ホスト画面の前景色がレンダリングされます。
Web アプリケーションの場合は、前景色はその色を表す CSS スタイルシート・クラスにマップされます。例えば、ホスト画面フィールドが RED とマークされている場合、フィールド・ウィジェットは、そのフィールド用に生成された HTML を、クラス名属性が HRED に設定されているタグで囲みます。この処理によって、ユーザーは、生成される Web ページ上にホスト画面の色を再マップすることができます。
注: blacktheme.css は、ホスト画面フィールドの前景色を直接マップします (例えば、ホスト画面上の赤色のテキストは、生成された Web ページ上で赤色のテキストとして表示されます)。ただし、monochrome.css などの他のスタイルシート・ファイルは、フィールドの色を別の方法でマップし、一貫性のある、最新のスタイルを作成しようとします。
フィールドのスタイル・クラス (Web のみ)
オプション。生成されたフィールドに関連する CSS スタイル・クラスです。HTML タグの class 属性の値には、この値がセットされます。デフォルト値は HATSFIELD です。詳しくは、スタイル・シートの使用を参照してください。
拡張属性を使用可能にする
これを選択した場合、拡張フィールド属性 (明滅、反転表示、下線、および列分離子) が指定されたスタイルで表示されます。詳しくは、スタイル・シートの使用を参照してください。
明滅スタイル (Web のみ)
ホスト画面における明滅テキストのレンダリングに使用する CSS スタイル設定。
反転表示スタイル (Web のみ)
ホスト画面における反転表示テキストのレンダリングに使用する CSS スタイル設定。
[下線の種類] (Web のみ)
ホスト画面における下線付きテキストのレンダリングに使用する CSS スタイル設定。
列分離子スタイル (Web のみ)
ホスト画面における列分離子のレンダリングに使用する CSS スタイル設定。
入力フィールドの下線文字を除去
テキストをレンダリングするときにテキストから下線文字を除去する場合は、このボックスを選択します。
入力フィールドのスペースをトリム
入力フィールドから先行および後続のスペースをトリムするには、このボックスを選択します。
入力フィールドのカーソル位置オプションを使用可能にする (Web のみ)
ユーザーが入力フィールドについて、データ入力モードからカーソル位置決めモードへ切り替えることができるようにするには、このボックスを選択します。データ入力モードでは、ユーザーは入力フィールドにデータを入力できます。カーソル位置決めモードでは、ユーザーはタブまたはその他の方法により、入力フィールド内の任意の文字上にカーソルを置くことができます。この設定は、他のカーソル位置決め機能がないモバイル装置用に最適化された Web プロジェクトを使用する場合に役立ちます。ZIETrans Toolkit GUI に表示されないこのオプションの他の設定について詳しくは、モバイル装置に関する考慮事項および制限を参照してください。
Provide spreadsheet file
If selected, a launcher is provided that will retrieve the table data in spreadsheet file format.
File name prefix
Specifies a prefix for the spreadsheet file name. The default is spreadsheet. The complete file name will be in the form of FileNamePrefix_TimeStamp, where the timestamp format is MMDDYY_HHMMSS, for example, spreadsheet_041506_113020.
File name extension
The extension name for the type of spreadsheet format. Options are .csv and .xls. The .csv file are pure text files, with data columns separated by commas. The .xls files are Microsoft Excel Biff3 files. The default is .csv.
Launcher type
The type of launcher to display to the user. Options are Link, Image, and Button. The default is Link (Web projects).
Launcher caption
The caption for the launcher to display to the user. The default is Download (Web projects).
Button style class (Web のみ)
The CSS style class associated with the generated launcher button. The value of the class attribute of the HTML button tag will be set to this value. The default value is HATSBUTTON. See スタイル・シートの使用 for more information.
Link style class (Web のみ)
Optional. The CSS style class associated with the generated launcher link. The value of the class attribute of the HTML link tag will be set to this value. The default value is HATSLINK. See スタイル・シートの使用 for more information.
ドロップダウンのスタイル・クラス (Web のみ)
オプション。生成されるドロップダウンに関連する CSS スタイル・クラスです。HTML ドロップダウン・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSDROPDOWN です。詳しくは、スタイル・シートの使用を参照してください。
リスト・オプションのスタイル・クラス (Web のみ)
オプション。ドロップダウンの各オプションに関連する CSS スタイル・クラスです。デフォルト値は HATSOPTION です。詳しくは、スタイル・シートの使用を参照してください。
テーブルのスタイル・クラス (Web のみ)
オプション。生成されるテーブルに関連する CSS スタイル・クラスです。HTML テーブル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLE です。詳しくは、スタイル・シートの使用を参照してください。
テーブル・セルのスタイル・クラス (Web のみ)
オプション。生成されるテーブル内の各セルに関連する CSS スタイル・クラスです。HTML テーブル・セル (td) タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLECELL です。詳しくは、スタイル・シートの使用を参照してください。
見出し行のスタイル・クラス (Web のみ)
オプション。生成されるテーブル内の各ヘッダー行または列に関連する CSS スタイル・クラスです。HTML テーブルの行またはセル・タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEHEADER です。詳しくは、スタイル・シートの使用を参照してください。
奇数行のスタイル・クラス (Web のみ)
オプション。テーブル内の奇数番の各行に関連する CSS スタイル・クラスです。奇数行番号の各 HTML テーブル行タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEODDROW です。詳しくは、スタイル・シートの使用を参照してください。
偶数行のスタイル・クラス (Web のみ)
オプション。テーブル内の偶数番の各行に関連する CSS スタイル・クラスです。偶数行番号の各 HTML テーブル行タグの class 属性の値には、この値がセットされます。デフォルト値は HATSTABLEEVENROW です。詳しくは、スタイル・シートの使用を参照してください。
Style (Web のみ)
オプション。スタイル・プロパティー・ダイアログを表示するには、このフィールドの横にあるランチャー・ボタンを使用します。このダイアログでは、CSS の知識がなくてもウィジェットのフォント、色、またはその他のスタイル設定を変更することができます。詳しくは、スタイル・シートの使用を参照してください。
fieldTextAlignment (Web のみ)
Web プロジェクトで Sans Serif などの非モノスペース・フォントを使用すると、レンダリングされたデータはワード間のスペーシングの問題で適切には位置合わせされません。ソース設定 fieldTextAlignment を使用して、データの位置合わせを修正できます。この設定をプロジェクト全体で有効にするには、application.hap ファイルのソース・ビューを開き、SubfileWidgetV6 ウィジェットのクラスを見つけ、次の例に示すように、設定値を NO_SEGMENTING に変更します。
<class name="com.ibm.hats.transform.widgets.SubfileWidgetV6">
.
   <setting name="fieldTextAlignment" value="NO_SEGMENTING"/>
.
</class>
この設定を変換内のコンポーネント・レベルで有効にするには、変換のソース・ビューを開き、SubfileWidgetV6 ウィジェットの ZIETrans:Component タグを見つけ、次の例に示すように、設定値を NO_SEGMENTING に変更します。
...
widget="com.ibm.hats.transform.widgets.SubfileWidgetV6"
...
widgetSettings="...|fieldTextAlignment:NO_SEGMENTING|..."
...
この設定の値は、WORD_BY_WORD および NO_SEGMENTING です。デフォルト値は WORD_BY_WORD です。
注: サブファイル・コンポーネントでデータ認識に「テーブル (可視)」認識オプションを使用している場合、この設定は効果がありません。