双方向アプリケーション・サポート

この章では、双方向言語でのアプリケーション開発用に HATS により提供される各機能の使用方法について説明します。この内容の大部分は、ヘブライ語とアラビア語のアプリケーション開発者に当てはまります。アラビア語のユーザーに固有の機能は個別に説明します。

HATS では、双方向言語をサポートするために以下の各機能を提供します。

この章では、上記のすべての機能について説明します。

注:
標準ポートレット統合オブジェクト、グローバル変数のオーバーライド、ポートレット通信、リモート・ポートレット用の Web サービス、ライト・ペン (アテンション) およびライト・ペン (選択) のホスト・コンポーネントに双方向サポートはありません。

ソフトウェア環境

双方向アプリケーション・サポートの要件を以下に示します。

ホスト端末の操作

HATS ホスト端末では Host On-Demand 双方向固有のキー・ストロークが使用可能なため、以下の双方向機能を実行することができます。以下のホスト・ファンクション・キーは、3270、5250 および VT の両方のセッションで使用可能です。

Ctrl+L: ラテン語レイヤー (Latin Layer)
このキー組み合わせにより言語レイヤーがラテン語に変更され、オペレーター情報域 (OIA) は英語を表示するために更新されます。
Ctrl+N: BIDI レイヤー
このキー組み合わせにより、言語レイヤーは双方向に変更され、OIA は双方向言語を表示するために更新されます。
Ctrl+S: 画面を反転
画面方向が左から右の場合、このキー組み合わせにより画面イメージの方向は右から左に変更され、言語レイヤーは BIDI に変更されます。画面方向が右から左の場合は、このキー組み合わせにより画面イメージは逆方向の左から右に変更され、言語レイヤーはラテン語に変更されます。これは、VT 可視セッションでは使用できません。
Ctrl+F: フィールド反転
フィールド方向が左から右の場合、このキー組み合わせによりフィールドの方向が右から左に変更され、カーソルもフィールドの反対側に移動します。言語レイヤーは、双方向に変更されます。フィールド方向が右から左の場合、このキー組み合わせによりフィールドの方向が左から右に変更され、カーソルもフィールドの反対側に移動します。言語レイヤーはラテン語に変更されます。これは 5250 セッションのみで使用可能です。

以下のホスト・ファンクション・キーは、3270 セッションでのみ使用可能です。

Ctrl+P: プッシュ
フィールドと逆の方向で、テキストを入力および編集できます。
Ctrl+O: プッシュ終了
プッシュ・モードが終了し、カーソルはプッシュ・セグメントの最後に移動します。
Ctrl+A: 自動プッシュ
言語レイヤーを変更して、左から右、および右から左の双方向が混在したテキストを入力できます。

以下のホスト・ファンクション・キーは、5250 セッションでのみ使用可能です。

Ctrl+C: クローズ
1 つのキー・ストローク方向で (左から右、右から左のどちらでも) 入力したデータは、以前に逆の方向で入力したデータと連結されます。カーソルの方向はフィールドの方向と同一に設定され、言語レイヤーはデフォルトでフィールドと同一方向に設定されています。現在の画面方向が左から右である場合、連結されたテキストではカーソルは右側の最初のヌルに置かれます。現在の画面方向が右から左である場合、連結されたテキストではカーソルは左側の最初のヌルに置かれます。

以下のホスト・ファンクション・キーは、Arabic VT セッションでのみ使用可能です。

Ctrl+K: 列見出し
「列見出し」モードによって、テキストの列の間にブランクを入れて挿入部分を中断させ、データの列に対する英語のタイトルが正しい位置を維持することができます。

以下のホスト・ファンクション・キーは、Hebrew VT セッションでのみ使用可能です。

Ctrl+D : カーソルの方向
現在のカーソル方向が左から右の場合は、Ctrl+D を押すと右から左に変更され、再度押すと左から右に戻ります。この機能は、「可視」テキスト・タイプにのみ使用できます。カーソル方向を「右から左」に設定しても、カーソルのアドレッシングおよび移動、文字の挿入および削除、行における削除または表示での削除は影響を受けません。以下の機能が、右から左へのカーソル方向設定から影響を受けます。

Ctrl+D : 文字セット・モード
この機能により、文字セットが 7 ビットと 8 ビット間で切り替わります。現在の文字セットが DEC Hebrew (8 ビット) または ISO Hebrew Supplemental (8 ビット) である場合には、Ctrl+B を押すと、現在の文字セットが Hebrew NRCS (7 ビット) に変更されます。現在の文字セットがヘブライ語 NRCS (7 ビット) である場合には、Ctrl+B を押すと、2 つの 8 ビット文字セットのいずれかが次の規則に基づいてロードされます。

ホスト端末に関する制限

ホスト端末では Unicode フィールドがサポートされません。そのため、Unicode フィールドで言語を切り替えることはできません。

双方向のテキストと数字を含む複雑なテキストを画面認識基準に使用しないでください。

画面キャプチャー

双方向のセッションでは、画面は左から右、右から左のどちらの方向でも取り込めます。取り込まれた画面は、取り込まれた状態のまま表示されます。画面を右から左の画面として取り込むには、左から右の画面で Ctrl+S (画面を反転) を押してから、「画面キャプチャーを作成」をクリックします。

双方向ホスト・コンポーネントの認識

通常、ホスト・コンポーネントの方向は画面方向と同じです。ただし、ホスト・コンポーネントの方向が通常の画面方向と逆である場合もあります。HATS プロジェクトで双方向コード・ページを使用する場合、「画面と逆方向のコンポーネントを認識」というラベルが付いたチェック・ボックスが「ホスト・コンポーネントを挿入」ウィザードと「画面組み合わせを作成」ウィザードに追加されます。変換にホスト・コンポーネントの追加時、ホスト・コンポーネントの方向が画面方向と逆である場合はこのボックスを選択してください。このボックスを選択すると、HATS は、画面方向と逆の方向であるコマンド・プロンプト、ファンクション・キー、選択リスト、サブファイル、およびヒント付き入力フィールドを認識します。

ファンクション・キーと選択リスト設定では、混在する双方向テキストが使用されます。これはつまり、BIDI1 = BIDI2 のようなストリングは、BIDI1 と BIDI2 が双方向テキストのセグメントで、ファンクション・キーおよび選択リストとして認識されることを意味します。

デフォルトでは、画面のデフォルト・レンダリングでは、(英語セッションと同様に) LTR (左から右) コンポーネントのみが識別されます。ただし、プロジェクト設定エディターで「レンダリング」タブの「デフォルト・レンダリング」セクションで「画面と逆方向のコンポーネントを認識」プロパティーを選択すると、デフォルト・レンダリングで左右両方向のコンポーネントが認識されます。

また、デフォルトでは画面変換のコンポーネントは画面方向に基づいてのみ認識されます。プロジェクト・レベルでは、コンポーネントが認識されない場合に、HATS が逆の画面方向を使用してコンポーネントの認識を試行することを指定できます。これを指定するには、プロジェクト・エディターの「レンダリング」タブの「デフォルト・レンダリング」の下の「拡張」セクションで、「画面と逆方向のコンポーネントを認識」チェック・ボックスを選択します。このように選択してもまだコンポーネントが認識されない場合は、「コンポーネント・レンダリングの失敗時にデフォルト・レンダリングを使用」設定での指定内容に従ってレンダリングが実行されます。

この設定は、コンポーネント・レベルでも指定できます。そのためには、「レンダリング・オプション」パネルで、「ホスト・コンポーネントを挿入」ウィザードを使用して、変換にコンポーネントを追加する場合に、「レンダリングの拡張設定」ボタンをクリックして、「画面と逆方向のコンポーネントを認識」ボックスを選択します。コンポーネント・レベルでのこの設定の値は、プロジェクト設定から継承されません。以下のテーブルは、プロジェクト・レベルおよびコンポーネント・レベルでのこの設定の可能な組み合わせと使用される設定を示しています。一般情報については、拡張レンダリングを参照してください。

表 16. プロジェクトとコンポーネントの設定の組み合わせ
プロジェクト設定 コンポーネント設定 使用される設定
クリア クリア コンポーネント
クリア 選択 コンポーネント
選択 クリア プロジェクト
選択 選択 コンポーネント

ウィジェット方向の制御

アプリケーションが WebSphere® Application Server で稼働する場合、ウィジェット表示の制御を可能にする特別なチェック・ボックスが 2 つあります。この制御は、以下に適用されます。

この 2 つのチェック・ボックスは以下のとおりです。

「ウィジェットの方向を反転させる」チェック・ボックスが選択されている場合、左から右の画面では GUI イメージの方向が右から左の方向に変更されます。同様に、「ウィジェットでテキストを反転」のチェック・ボックスが選択されている場合、GUI イメージ内のテキストは RTL (右から左) に変更されます。

例えば、以下のテキストを表示している左から右の画面があるとします (大文字は双方向言語データで、小文字は英語データのままです)。

BIDI TEXT

pf01=help

この画面を RTL としてカスタマイズすると、次のように表示されます。

TXET IDIB

pleh=10fp

ユーザーの観点から見ると、ファンクション・キー以外はすべて正確に表示されています。ファンクション・キーは認識されてはいますが、逆方向に表示されています。

カスタマイズ画面を正確に表示するには、カスタマイズ画面にファンクション・キー・ホスト・コンポーネントを挿入する際、「ウィジェットの方向を反転させる」および「ウィジェットでテキストを反転」の両方のチェック・ボックスを選択する必要があります。

これを実行すると、画面は以下のように表示されます。

TXET IDIB

pf01=help

双方向性プロジェクトにおいて、テキスト入力フィールドの代りにドロップダウン・リストを使用すると、ドロップダウン・リスト項目の表題は、画面方向の影響を受けません。ウィジェットの「ウィジェットでテキストを反転」チェック・ボックスを選択していなければ、表題は常に可視 LTR フォーマットで表示されます。選択されている場合、表題は可視 RTL フォーマットで表示されます。

また、双方向性 HATS アプリケーションの作成時、保護フィールドから可視入力フィールドに複数行のテキストのコピー、貼り付けを行うと、テキストが反転する場合があります。一度に 1 行のコピー、貼り付けを行うと、テキストの方向は維持されます。

ウィジェット位置合わせの制御

HATS コンポーネント要素を含んだウィジェットに適切な位置合わせを割り当てるために、以下の HATS 構成パネルにある「コンポーネントの位置合わせ」設定を使用できます。

さらに、個々のウィジェットに適切な位置合わせを割り当てるために、フィールド・ウィジェットおよびテーブル・ウィジェットに対して、「レンダリング・オプション」ウィザードのウィジェット設定ダイアログにある「フィールドの位置合わせ」設定および「テーブルの位置合わせ」設定も使用できます。

これらの設定の値は、left および right です。プロジェクト設定内の「コンポーネントの位置合わせ (Component Alignment)」設定は、プロジェクト内の全ウィジェットの位置合わせに影響します。プロジェクト設定の値セットは、「変換の作成」ウィザードと「画面カスタマイズの作成」ウィザードのデフォルトになります。個別ウィジェットに指定した位置合わせによって、デフォルト・レンダリングに指定した値がオーバーライドされます。

カスタマイズされたコンポーネントとウィジェットの双方向サポート

Web プロジェクトなどで新しいコンポーネントとウィジェットをカスタマイズする場合は、次のように双方向の対の片方を使用する必要があります。

import com.ibm.hats.transform.widgets.BIDI.LabelWidgetBIDI

public class newBIDILabel extends LabelWidgetBIDI implements HTMLRenderer

グローバル変数

グローバル変数が抽出される際、抽出されたデータは見ている画面の方向も含めて、画面に表示されたとおりのものです。画面イベントのアクションとして画面に挿入されているグローバル変数は、画面方向に応じて挿入されています。

Web アプリケーションとリッチ・クライアント・アプリケーションの両方において、静的テキストおよび入力フィールドからの双方向データは、Rational SDP 環境およびランタイム環境の両方で、可視形式で、グローバル変数に保管されます。

「グローバル変数の挿入」ウィザードを使用して、グローバル変数値を静的テキストとして双方向性画面の変換に挿入する場合、「グローバル変数を可視形式で挿入」というオプションがあります。グローバル変数値を静的テキストとして可視形式で挿入するには、このオプションを選択します。値を静的テキストとして論理形式で挿入するには、このオプションをクリアします。

グローバル変数が、論理 VT セッションから抽出される場合、抽出されるデータは、可視形式に変換されます。VT 論理セッションに挿入されたグローバル変数は、論理形式に変換されます。テキストの方向は画面方向に対応して設定されます。

テキスト置換

プロジェクト・レベルまたは HATS コンポーネント・タグ・レベルの双方向セッションでテキスト置換を使用する場合、使用可能なチェック・ボックスがさらに 3 つあります。

LTR 画面で一致
このオプションを選択すると、左から右の表示画面上のテキストに対するテキスト置換が正確に実行されます。
RTL 画面で一致
このオプションを選択すると、右から左の表示画面上のテキストに対するテキスト置換が正確に実行されます。
画面を反転させて比較
このボックスと「LTR 画面で一致」チェック・ボックスを選択した場合、反転ストリングは右から左の画面に一致します。左から右の画面上で「画面を反転」ボタンをクリックした場合、データは整合します。

このボックスと「RTL 画面で一致」チェック・ボックスを選択した場合、反転ストリングは左から右の画面に一致します。右から左の画面上で「画面を反転」ボタンをクリックした場合、データは整合します。

「LTR 画面で一致」または「RTL 画面で一致」のいずれかを選択する必要があります。

例えば、左から右のホスト画面にテキスト NO on が含まれていたと仮定します。テキスト置換で、no から yes への変換と大/小文字の区別なしを定義すると、選択したチェック・ボックスにより、結果は以下のように異なります。

表 17. 双方向テキスト置換のオプションと結果
選択されたオプション LTR 画面 RTL 画面
LTR 画面のみ一致 yes on no ON
RTL 画面のみ一致 NO on yes ON
LTR 画面と RTL 画面に一致 yes on yes ON
LTR 画面と反転画面に一致 yes on no sey
RTL 画面と反転画面に一致 NO sey yes ON
LTR と RTL の両画面と反転画面に一致 yes sey yes sey

グローバル規則

双方向セッションでプロジェクト・レベルまたは画面レベルのグローバル規則を使用する場合、(テキスト置換の場合と同様に) さらに 3 つのチェック・ボックスを選択できます。

LTR 画面で一致
このオプションを選択すると、左から右の表示画面上のテキストに対して、設定されたグローバル規則が正確に実行されます。
RTL 画面で一致
このオプションを選択すると、右から左の表示画面上のテキストに対して、設定されたグローバル規則が正確に実行されます。
画面を反転させて比較
このボックスと「LTR 画面で一致」チェック・ボックスを選択した場合、反転ストリングは右から左の画面に一致します。左から右の画面上で「画面を反転」ボタンをクリックした場合、データは整合します。

このボックスと「RTL 画面で一致」チェック・ボックスを選択した場合、反転ストリングは左から右の画面に一致します。右から左の画面上で「画面を反転」ボタンをクリックした場合、データは整合します。

詳しくは、表 17を参照してください。

ユーザーによる画面方向反転の可能化

アプリケーション・キーパッド設定ではユーザーの便宜のために、双方向変換で「画面を反転」ボタンを提供できます。このボタンは、アプリケーション・キーパッド (Web アプリケーション) と変換ビュー・ツールバー (リッチ・クライアント・アプリケーション) に表示されます。 このボタンをクリックすると、画面の方向が切り替わります。これは、ホスト・システムでは Alt+Enter キーを押して実行していた操作です。

プロジェクト・レベルでは、プロジェクト・エディターの「レンダリング」タブの「アプリケーション・キーパッド」セクションに「画面を反転」ボタンを組み込むことができます。変換レベルでは、変換エディターの「アプリケーション・キーパッドを挿入」機能を使用して「画面を反転」ボタンを組み込むことができます。

新しい HATS プロジェクトを作成して双方向コード・ページを選択すると、 「接続設定」パネルに「カスタマイズしていない画面の反転を使用可能にする」と「カスタマイズした画面の反転を使用可能にする」という 2 つのチェック・ボックスが追加されます。これらのチェック・ボックスを使用して、組み込んだ「画面を反転」ボタンがこれらの画面に表示されるかどうかを決定します。デフォルトでは、どちらのボックスも選択されています。1 番目のボックスを選択すると、2 番目のボックスが選択可能になります。 2 番目のボックスのみを選択することはできません。

カスタマイズされていない画面とは、いずれの画面カスタマイズにも一致しない画面です。カスタマイズされていない画面がユーザーに対して表示される場合、画面の方向は直前の画面と同じです。1 番目の画面がカスタマイズされていない画面の場合、その画面方向は左から右になります。直前の画面で画面の方向が変更された場合は、次のカスタマイズされていない画面にはこの変更が継承され、次のカスタマイズされた画面ではリセットされます。

カスタマイズされた画面の初期画面方向は、画面がカスタマイズされた場合と同一の方向です。カスタマイズされている場合も、カスタマイズされていない場合でも、「画面を反転」をクリックすると画面方向が変更されます。画面認識の間、反転された画面は、反転される前の同一画面とは別の画面として認識されます。そのため、「画面を反転」ボタンを使用すると、画面が認識されない場合もあります。カスタマイズ画面上に表示されるすべてのホスト・コンポーネントの方向が適切であると開発者が確信している場合、その画面の「画面を反転」ボタンは使用可能にする必要はありません。カスタマイズ画面の「画面を反転」ボタンは使用不可にすることをお勧めします。

アラビア語アプリケーションのユーザーに対して「画面を反転」ボタンを使用可能にすると、別のチェック・ボックスで成形の方向を制御できるようになります。詳しくは、アラビア語コード・ページの機能を参照してください。

VT 双方向表示オプション

VT 双方向セッションの場合、双方向ユーザーに対して正常に動作するように、端末に一部の特定の双方向プロパティーを設定する必要があります。VT 「BIDI 表示オプション」ボタンが、以下のオプションにアクセスするために、「接続設定」パネルに追加、表示されます。

テキスト・タイプ (ヘブライ語)
保管されるテキスト文字のフォーマットを決定します。「可視」または「論理」を選択してください。デフォルトは「可視」です。
カーソルの方向 (ヘブライ語可視)
カーソルの方向を左から右 (LTR) または右から左 (RTL) に設定します。カーソルの方向を RTL に設定すると、デフォルトではカーソルは表示された各文字の左に移動するので、すべての文字は RTL の方向に表示されます。一般的には、カーソルの方向が RTL に設定されていると、RTL 方向の入力データを受け入れるように設計されているアプリケーションだけが正常に動作します。デフォルトは LTR です。
スマート配列 (アラビア語/ヘブライ語論理)
異なるテキスト属性をもつ文字のセグメントを別々に配列するかどうかを決定します。デフォルトは「オフ」です。
テキスト属性表示 (アラビア語/ヘブライ語論理)
スマート配列がオンのときのみ使用可能です。デフォルトは「はい」です。

プロンプト・アクションの方向

VT 双方向論理セッションについては、2 つのラジオ・ボタン (LTR 方向と RTL 方向) があります。アプリケーション開発者は、これらのボタンを使用して、マクロの記録時に迅速にアクションが実行されるように、入力制御方向 (暗黙的 LTR または暗黙的 RTL) を制御できます。

デフォルトの入力制御方向は、LTR 方向です。つまり、プロンプト値は、暗黙的な LTR 形式で表示されます。

マクロ SQL 照会の双方向オプション

双方向言語 (アラビア語とヘブライ語) 用の SQL ウィザードでは、特定の双方向プロパティーを設定する必要があります。これらの設定にアクセスするには、「拡張マクロ」エディター・パネルの「拡張」ボタンをクリックします。このパネルは、使用中のワークステーションで双方向言語を構成している場合だけに表示されます。以下の設定を使用できます。

ホスト・ファイル・タイプ
このオプションは、ホスト・ファイルを論理形式と可視形式のどちらで保存するかを指定します。デフォルトは「可視」です。(このオプションは、Java™ 用 AS/400® ツールボックスから JDBC ドライバーに対して使用することはできません。)
ローカル・ファイル・タイプ
このオプションでは、ローカル・ファイルを論理形式と可視形式のどちらにするかを指定します。デフォルトは、論理形式です。
ホスト・ファイルの方向
ホスト・ファイルを LTR 形式と RTL 形式のどちらで保存するかを指定します。デフォルトは、LTR 形式です。 (このオプションは、Java 用 AS/400 ツールボックスから JDBC ドライバーに対して使用することはできません。)
ローカル・ファイルの方向
このオプションでは、ローカル・ファイルを LTR 形式と RTL 形式のどちらにするかを指定します。デフォルトは、LTR 形式です。
「ラームとアリフ」の拡張
「ラームとアリフ」文字の動作を指定します。SQL ウィザードのステートメントによってホストからアラビア語のデータを受信する場合、「ラームとアリフ」文字が 2 つの文字に拡張されます (「ラームとアリフ」文字の後にスペースがある場合は、「ラーム」の後に「アリフ」が続きます)。
「ラームとアリフ」の圧縮
「ラームとアリフ」文字の動作を指定します。SQL ウィザードのステートメントによってホストにアラビア語のデータを送信する場合、「ラーム」とその後に続く「アリフ」が 1 つの文字に圧縮され、「ラームとアリフ」文字の後にスペースが追加されます。このオプションは、アラビア語のシステムだけで使用可能になります。デフォルトはオンです。(このオプションは、Java 用 AS/400 ツールボックスから JDBC ドライバーに対して使用することはできません。) .
対称スワッピング
大括弧などの対称文字の動作を指定します。画面を反転させると、反対向きの相手と置換されます。デフォルトはオンです。(このオプションは、Java 用 AS/400 ツールボックスから JDBC ドライバーに対して使用することはできません。)
双方向互換
数表示が混在する双方向テキストの処理方法を制御します。
数表示形状
SQL ウィザードのステートメントで、ホスト・ファイルの数表示の形状を指定します。数表示形状は、NOMINAL、NATIONAL、および CONTEXTUAL のいずれかです。このオプションは、アラビア語のシステムだけで使用可能になります。デフォルトは、NOMINAL です。(このオプションは、Java 用 AS/400 ツールボックスから JDBC ドライバーに対して使用することはできません。)

右から左の印刷サポート

双方向ファイルは、RTL ファイルまたは LTR ファイルのいずれかです。RTL データを正しく印刷するには、双方向 3270E デフォルト接続の接続エディターの「印刷」タブに表示される「RTL 印刷を使用可能にする」 チェック・ボックスを選択する必要があります。PDF ファイルと非 PDF ファイルの両方がサポートされています。

このチェック・ボックスは、印刷が可能な場合に使用可能になります。

アラビア語アプリケーションの場合、RTL 印刷を有効にすると、以下の 2 つのチェック・ボックスが選択可能になります。

BMS マップのサポート

BMS マップの双方向言語サポートには、次の内容が含まれます。

  1. 双方向コード・ページ : BMS マップ・セットを双方向プロジェクトにインポートする場合は、次のコード・ページを使用する必要があります。
  2. 双方向属性: BMS マップ・セットを双方向プロジェクトにインポートするときには、「BIDI オプション」ボタンが表示されます。このボタンをクリックして、以下の BIDI 属性を設定します。

統合オブジェクトのサポート

統合オブジェクトのサポートには、抽出したテキストの再配列などを可能にする双方向固有のプロパティーによる統合オブジェクト Bean の拡張が含まれています。詳しくは、「HATS Web アプリケーション・プログラマーズ・ガイド」の章『HATS の双方向 API の使用』を参照してください。

統合オブジェクトの Web ページ (モデル 1 および JSF) のサポートには、実行時に抽出/挿入したデータの正しい再配列、および高水準の GUI を使用した、画面および抽出/挿入コントロールの方向に対するアプリケーション開発者による完全な制御が含まれます。

以下の機能がサポートされています。

ホスト画面の抽出では、以下の 4 つの共通の状態が発生することがあります。

LTR 画面の左寄せ領域が抽出される
画面方向のラジオ・ボタンと制御方向のラジオ・ボタンを LTR に設定した LTR 画面において抽出すると (デフォルト)、発生します。
LTR 画面の右寄せ領域が抽出される
画面方向のラジオ・ボタンと制御方向のラジオ・ボタンを RTL に設定した RTL 画面において抽出すると、発生します。
RTL 画面の右寄せ領域が抽出される
画面方向のラジオ・ボタンを LTR に設定し、制御方向のラジオ・ボタンを RTL に設定した LTR 画面において抽出すると、発生します。
RTL 画面の左寄せ領域が抽出される
画面方向のラジオ・ボタンを RTL に設定し、制御方向のラジオ・ボタンを LTR に設定した RTL 画面において抽出すると、発生します。
注:
JSF Web ページを処理している場合、テーブル内の双方向テキストの位置合わせが正しく表示されないことがあります。これは、JSF の設計上の制限です。

ボトムアップ Web サービスのサポート

統合オブジェクトから生成されたモデル 1 および JSF の Web ページのサポートに加え、HATS には、統合オブジェクトから生成されたボトムアップ Web サービス用の双方向サポートが用意されています。この場合、Web サービスは、統合オブジェクトのすべての双方向機能を継承します。この Web サービスは、抽出されたテキストの再配列などを可能にするプロパティーによって拡張されています。詳しくは、「HATS Web アプリケーション・プログラマーズ・ガイド」の章『HATS の双方向 API の使用』を参照してください。これらのプロパティーは、サンプル JSP ページや Web サービス・エクスプローラーなどのツールを使用してテストできます。

HATS Toolkit によって生成されたサンプル JSP ページは論理 LTR アプリケーションであるため、これらのアプリケーションで Web サービスの結果が正しく表示されるのは、プロンプトを呼び出して再配列を抽出し、どちらの場合でも RTL 再配列を「FALSE」に設定するように設定している場合のみです。それ以外の場合、結果は正しく表示されません。しかし、プロパティー値の変更が Web サービスにどのように影響するかを確認するために、「誤った」結果を表示することもできます。

サンプル JSP ページで論理 LTR 以外の抽出再配列の正しい結果を表示する必要がある場合、HATS Toolkit によって生成された Result.jsp ファイルを手動で編集する必要がある場合があります。 <body> タグがある行の後に、<div dir=rtl> (論理 RTL の場合)、<bdo dir=ltr> (可視 LTR の場合)、または <bdo dir=rtl> (可視 RTL の場合) という行を挿入します。

論理 LTR 以外の再配列の場合に Web サービス・エクスプローラーを使用することはお勧めしません。

双方向固有のプロパティー値を事前定義し、ユーザーがこれらの値をオーバーライド可能かどうかを制御することができます。これらの値を設定するには、統合オブジェクトからサービス・サポート・ファイルが生成されたときに「BIDI オプション」をクリックします。 「ユーザーによる値のオーバーライドの許可 (Allow user to override the values)」を選択した場合は、対応するプロパティーのパラメーターとしてヌルまたは空ストリングが設定された場合に、事前定義値が通知されます。

ユーザー向けの情報

双方向コード・ページを使用している HATS アプリケーションは、可視入力フィールドと呼ばれる特別な入力フィールドを提供します。論理データの入力および表示をインプリメントする通常のフィールドと異なり、可視フィールドは可視データの入力および表示をインプリメントします。可視フィールドにデータを入力する際、以下の機能を使用できます。

Alt+Shift: 言語選択
このキー組み合わせにより、言語レイヤーがラテン語と双方向言語に切り替わります。
Alt+Enter: 画面を反転
このキー組み合わせにより、画面の方向が反転します。
Shift+NumLock: プッシュ
フィールドと反対方向のテキストを入力および編集することができます。
Shift+NumPad 「/」文字: プッシュ終了
プッシュ・モードが終了し、カーソルはプッシュ・セグメントの最後に移動します。
Alt+NumPad 「/」文字: 自動プッシュ
言語レイヤーを変更して、左から右、および右から左の双方向が混在したテキストを入力できます。自動プッシュは、右からの左の方向に数字を入力するときに特に有用です。プッシュおよびプッシュ終了の機能は、入力されたテキストの言語に応じて自動的にアクティブになります。右から左の方向のフィールドでは、数字またはラテン語を入力すると、言語を変更しなくても自動的にプッシュが開始されます。さらにラテン文字または数字を入力すると、プッシュ・モードが継続します。その他の文字が入力されると自動的にプッシュ・モードは終了します。この機能により、プッシュおよびプッシュ終了を使用しなくても組み込み数字やラテン語で双方向のテキストを入力することができます。

左から右のフィールドでは、双方向の文字を入力すると、自動的にプッシュが開始されます。数字またはラテン文字を入力すると、自動的にモードが終了します。ユーザーは、プッシュやプッシュ終了の代わりに言語レイヤー選択を使用して、組み込み双方向言語でラテン語テキストを入力することができます。

最初に「最初に自動プッシュ・モードを使用可能にする」設定を使用して自動プッシュ・モードを使用可能または使用不可にできます。プロジェクト・エディターでは、2 とおりの方法でこの設定を行うことができます。「概要」タブで現在のテーマへのリンクをクリックし、「最初に自動プッシュ・モードを使用可能にする」設定を使用します。「その他」タブで「クライアント設定」セクションを選択し、「最初に自動プッシュ・モードを使用可能にする」設定を使用します。

注:
統合オブジェクトへのインターフェースとなる JSF Web ページ上の自動プッシュを使用する場合、必要に応じてフィールド・サイズを手動で変更し、デフォルト・ブラウザー入力フィールド・サイズにより許可される文字よりも多くの文字を入力する必要がある場合があります。

フィールド自動反転

Alt+NumPad 5
フィールド自動反転がアクティブにされている場合、パスワード・フィールド以外のすべてのフィールドは、(上記に説明したのと) 同じ動作を行います。3270 セッションの右から左の画面では、フィールド自動反転が、操作のデフォルト・モードです。

フィールド反転

Alt+Numlock
フィールド反転がアクティブになっている場合、現在の (フォーカスの置かれている) フィールドへの入力方向が変更されます。フィールドが空の場合、カーソルが、フィールドの反対側に位置合わせされます。フィールドが空でない場合、カーソル位置は変りません。フィールド反転は、現在のフィールドに限りアクティブになります。フォーカスが外れると、入力方向はその前の値に戻ります。

クリップボードの機能

双方向データを使用して、プラットフォームの論理エディターから HATS の可視フィールドに、または HATS の可視フィールド (静的テキストを含む) からプラットフォームの論理エディターに、クリップボード操作 (コピー、貼り付け、切り取りなど) を行う場合、この処理は、 Windows® プラットフォームで実行されます。Windows ユーザーは、クリップボードを使用して、HATS と、論理データを使用する他のアプリケーションの間で、データを交換できます。

Internet Explorer のクリップボード操作は、メニュー・バーの「編集」オプション、またはショートカット・キー (Ctrl+C、Ctrl+X、Ctrl+V) のどちらを使用しても、実行できます。

Windows プラットフォームで Mozilla ブラウザーを使用する場合は、ショートカット・キーを使用して呼び出した場合にのみ、双方向データのクリップボード操作がサポートされます。

オペレーター情報域 (OIA)

双方向セッションには、オペレーター情報域 (OIA) に表示されるセッション関連情報のほかに、画面と入力の方向、アクティブなレイヤー、自動フィールド反転モードの状況、および成形の状況 (アラビア語セッションの場合) が含まれます。

双方向セッション (キーボード) の関連情報は、ホスト・システムで使用されている形式と類似した形式で表示されます。HATS 変換の OIA でこの情報を表示するには、プロジェクト設定エディターの「レンダリング」タブで「オペレーター情報域」を選択し、次に「OIA を表示」チェック・ボックスを選択します。プロジェクト設定エディターの「OIA を表示」チェック・ボックスがクリアされている場合は、Web アプリケーションでは HATS 双方向状況域がステータス・バーに表示されますが、リッチ・クライアント・アプリケーションでは表示されません。

キーボード・レイヤーの自動切り替え

HATS Web プロジェクトでこの機能を使用すると、画面が反転する際に、双方向言語とラテン語間のキーボード・レイヤーの自動切り替えをシミュレートできます。シミュレーションは、キーボードの再マップを使用して実行されます。 これにより、フィールド・タイプ入力方向に応じて、アラビア/ヘブライ文字またはラテン文字が強制的に追加されます。 例えば、反転された画面では、テキストのタイプ入力が、右から左へ行われる場合、アラビア/ヘブライ文字が、実際のキーボード・レイヤー状態にかかわらず、挿入されます。 この機能を使用可能にするには、「プロジェクト設定」エディターの「概要」タブで、現在のテーマをクリックし、「キーボード・レイヤーの自動切り替えを有効にする」を選択してください。 この設定は、「プロジェクト設定」エディターの「その他」タブの「クライアント設定」セクションでも選択できます。

HATS リッチ・クライアント・プロジェクトの振る舞いは、この機能が使用可能である場合と常に同様になります。

注:
「パスワード」フィールド、および可視入力フィールドに基づいていない、その他の特別なフィールドは、システム・キーボード設定にしたがって機能します。すなわちキーボードの再マップはこのようなタイプのフィールドに対して実行されません。

IBM i 5250 Unicode サポート

5250 システムを使用する Unicode フィールドに表示される双方向性テキストは、可視入力フィールドを使用するのではなく、(最初のストロング文字に従って) コンテキスト配列方式を使用して表示および編集されます。

アラビア語コード・ページの機能

以下の機能は、アラビア語コード・ページを使用するプロジェクトに限定されるものです。

成形の方向

アプリケーション・キーパッド設定で「画面を反転」ボタンを使用可能にすると、アラビア語コード・ページ・プロジェクトの場合は「RTL 整形」ボタンも表示されます。「RTL 整形」ボタンをクリックすると、RTL 成形の状態がオンとオフで切り替わります。RTL 成形の選択を解除にすると、ユーザーが画面方向とは無関係に LTR ファイルを現在編集中であるということが、HATS に対して通知されます。RTL 成形をオンにすると、現在 RTL ファイルが画面方向とは無関係に編集されていることが HATS に対して通知されるため、同じアラビア語成形データを両方の画面方向で正しく送信することができます。LTR ファイルを編集および送信する前に、RTL 整形の選択が解除されていることを確認する必要があります。また、RTL ファイルを編集および送信する前には、RTL 整形が選択されていることを確認します。

アラビア語の選択的形状

場合により、ホストへの分離フォーマットでのデータ送信が必要になります。そのような要件を満たすために、2 つのチェック・ボックスを使用して、アラビア語セッション用の成形不可フィールド・プロパティーが追加されました。

対称スワッピングおよび数字スワッピング

これらのオプションは、アラビア語の 3270 セッションでのみ有効です。対称スワッピングが使用可能である場合、スワッピング文字は右から左の画面にスワップインされます。数字スワッピングが使用可能である場合、英語の数表示は右から左の画面ではアラビア語の数表示に置換され、アラビア語の数表示は右から左の画面では英語の数表示に置換されます。これらのパラメーターは、接続エディターの「拡張」タブの「オプションの拡張接続設定を構成してください。」セクションで設定されています。パラメーターは symmetricSwapEnabled および numericSwapEnabled として識別されます。また、パラメーターの値は true または false のどちらかです。

HATS ホスト端末は、対称パラメーターおよび数値スワッピング・パラメーターの影響も受けます。

アラビア (西洋) 数字の入力を使用不可にする

新規の HATS プロジェクトを作成してから、または HATS 接続を作成または編集してから、アラビア語コード・ページ 420 を選択する場合、設定「RTL 画面でのアラビア (西洋) 数字の入力を使用不可にする」が表示されます。このオプションを選択し、アラビア (西洋) 数字の入力を使用不可にします。すなわち、RTL 画面でアラビア (インド) 数字のみを入力できるようにします。 これを実行して、送信時に、すべての数字がアラビア (西洋) 数字として送信されるようにします。

キーボード・レイヤーの自動切り替え

アラビア語のキーボードには、一部のキーがわずかに異なる、101 キーボード・レイアウトと 102 キーボード・レイアウトの 2 つのレイアウトがあります。キーボード・レイヤーの自動切り替え機能を使用すると、以下のマッピングが実行されます。

ホスト端末に関する制限

英語のシステム・キーボード・レイアウトとアラビア語キーボード 101 の両方で以下の制約事項が適用されます。

これらの制限は、アラビア語キーボード 102 には見られません。

アラビア語キーボード 102 を使用する場合は、次の制限が発生します。

これらの文字を正しく表示するには、キーボード・レイヤーを「英語」に切り替える必要があります。

画面キャプチャー

右から左に取り込まれた画面でのアラビア語セッションの場合、大括弧と数表示はアプリケーションの対称スワッピングおよび数字スワッピングのオプションの影響を受けます。

注:
アラビア語のセッションの場合、キャプチャーされた画面でユーロ記号がブロックとして表示されます。

System i Access for Web でのアラビア語印刷セッションの設定

以下は、System i® Access for Web 上でアラビア語データを正しく提示するための設定の要約です。

グローバル設定の場合:

SCS レポート:

AFP レポート:

その他の考慮事項

HATS ファイルへの追加

プロジェクトでアラビア語のコード・ページが使用される場合、画面イベント (.evnt) ファイルの記述タグには <orientation>true</orientation> タグが追加されます。値 true は、画面が右から左の方向にカスタマイズされることを示しています。その他の場合は、左から右の方向にカスタマイズされます。

双方向コード・ページを使用しているプロジェクトの場合、接続 (.hco) ファイルが、以下の値を取ることができる、<hodconnection> タグの追加 enableScrRev 属性を持ちます。

(blank)
「画面を反転」ボタンはどの画面にも表示されません。
NotCustomized
「画面を反転」ボタンは画面カスタマイズに一致しない画面にのみ表示されます。
Customized
「画面を反転」ボタンはすべての画面に表示されます。

アラビア語コード・ページを使用しているプロジェクトの場合、接続 (.hco) ファイルが、true または false のいずれかの値を取ることができる、<hodconnection> タグの追加 disableFldShp 属性を持ちます。

3270 セッションで印刷が選択されている場合、<classSetttings> タグに追加の printRTLSupport 設定が表示されます。アラビア語 3270 セッションでは、さらに 2 つの設定が対称スワッピングと数値スワッピングに対して、すなわち、printSymSwapSuppot および printNumSwapSupport が表示されます。この 2 つの印刷設定は、機能の使用可能または使用不可にそれぞれ対応する true または false のいずれかの値を持ちます。

プロジェクトで双方向コード・ページが使用される場合、アプリケーション (.hap) ファイルには、<textReplacement> タグ内の <replace> タグの属性が追加されます。

matchLTR
画面方向が左から右の場合、テキストは置換されます。
matchRTL
画面方向が右から左の場合、テキストは置換されます。
matchReverse
画面方向が反転の場合、テキストは置換されます。