CODE Designer での Web 設定の使用

この製品の WebSphere® Development Studio Client for iSeries® のバージョン 7.0 までは、CODE Designer のインストールはオプションです。IBM® WebFacing Tool のバージョン 7.1 以降には、CODE Designer には存在しない「Web 設定」オプションが含まれています。Web 設定のカスタマイズには、IBM WebFacing Tool の「Web 設定」ビューを使用することを強くお勧めします。

アプリケーションのカスタマイズには、Web 設定で DDS ソースを使用することをお勧めします。CODE Designer の「Web 設定」タブを使用して、Web ブラウザーを通じてアクセスした時のプログラムの外観および機能をカスタマイズすることができます。 DDS ソースを使用して 5250 表示装置を記述するプログラムは、その DDS ソースが WebFacing Tool を使用して変換された後に、Web ブラウザーによってアクセスすることができます。 個々の画面および画面内の個々のフィールドの Web 表示を取り扱うには、「Web 設定」を使用してください。 複数画面または WebFacing プロジェクト全体の Web 表示を変更したい場合には、Style プロパティーを使用します。 CODE Designer のインストールはオプションです。

CODE Designer での DDS ソースのロード

CODE Designer には、WebSphere Development Studio Client for iSeries の Windows®「スタート」メニューからアクセスするか、IBM WebFacing Tool からアクセスすることができます。IBM WebFacing Tool 内から CODE Designer の DDS ソースをロードするには、次のようにします。

  1. WebFacing パースペクティブを開きます。
  2. 「WebFacing プロジェクト」 > 「DDS」を展開します。
  3. メンバーを右クリックして、「アプリケーションから開く」 > 「CODE Designer」を選択します。 プロンプトが出されたらサインオンします。WebFacing サーバー・セットアップに接続していない場合は、接続する 必要があります。CODE Designer がインストールされていないと、メッセージが出されます。
  4. 「ファイル」 > 「開く」を選択し、 「編集用に開く」ダイアログから開きたい DDS ソースを選択して、CODE Designer 内からソース・ メンバーをさらにロードします。 このダイアログで使用可能なサーバーは、通信コンソールを使用して定義されているサーバーです。表示されるライブラリーは、サインオンするときに使用するユーザー ID に対するライブラリー・リスト内のライブラリーです。
注: 既存の接続を展開して、ソース・メンバーを右クリックし、 「アプリケーションから開く」 > 「CODE エディター」を 選択して、リモート・システム・エクスプローラーから CODE Designer で DDS ソースを開くこともできます。

CODE Designer での Web 設定へのアクセス

DDS ソース・メンバーが CODE Designer にロードされた後は、CODE Designer の DDS ツリーにあるアイコンをクリックすることによって「Web 設定」にアクセスすることができます。DDS ツリーは、CODE Designer ウィンドウの左サイドにあります。「Web 設定」には、CODE Designer の「詳細」および「SCREEN」タブ内から DDS オブジェクトを選択することによってもアクセス可能です。選択されたオブジェクトについて「Web 設定」が使用可能であれば、CODE Designer の下方ペインに「Web 設定」タブが表示されます。

CODE Designer のオブジェクトおよび Web 設定

CODE Designer によって、DDS 画面をグラフィカルに設計することができます。 CODE Designer では、各 DDS オブジェクトがアイコンまたはプッシュボタンによって表されます。 例えば、DDS 画面で名前付きフィールドまたはテキスト定数を簡単に作成するためのプッシュボタンがあります。 それぞれの DDS オブジェクトに使用できる「Web 設定」は、処理しているオブジェクトによって異なります。 以下のテーブルは、それぞれの DDS オブジェクトに使用できる「Web 設定」をリストしています。 各設定の詳細については、この文書の「Web 設定の説明」セクションを参照してください。 オブジェクトに「Web 設定」を使用した場合には、後で WebFacing 変換により処理される DDS ソースに特殊なコメントが追加されます。 「Web 設定」のコメントは、文字 *%%WB で始まっています。

表 1. CODE Designer の Web 設定
DDS オブジェクト CODE Designer のグラフィック 使用可能な Web 設定
標準レコード
サブファイル制御レコード
 
日付フィールド
時刻フィールド
タイム・スタンプ・フィールド
メッセージ定数
日付定数
時刻定数
ユーザー定数
システム定数
 
名前付きフィールド (入力可能)
継続フィールド (入力可能)
ソース参照フィールド (入力可能)
データベース参照フィールド (入力可能)
選択別のデータベース参照フィールド (入力可能)
 
名前付きフィールド (出力)
継続フィールド (出力)
ソース参照フィールド (出力)
データベース参照フィールド (出力)
選択別のデータベース参照フィールド (出力)
テキスト定数
 
日付フィールド (隠蔽)
時刻フィールド (隠蔽)
名前付きフィールド (隠蔽)
継続フィールド (隠蔽)
ソース参照フィールド (隠蔽)
データベース参照フィールド (隠蔽)
選択別のデータベース参照フィールド (隠蔽)

Web 設定の説明

キー・ラベル

DDS ソース内の機能またはコマンド・キーについては、Web ページでキーを表すために使用するテキスト・ラベルを指定することができます。ラベルを変更するには、「すでに定義済みのラベル」リストからラベルを選択し、そのキーに使用したいテキストを「新規ラベル」フィールドに入力して、「変更」をクリックしてください。定義したラベルを除去するには、「Web 設定のラベルの変更」リストからラベルを選択し、「除去」をクリックしてください。

キー順序

DDS ソース内の機能またはコマンド・キーについては、Web ページでキーを可視状態にするかどうか、およびキーが表示される順序を指定することができます。この設定を処理するには、「コマンド・キーの順序および可視性を変更する」チェック・ボックスを選択します。キーを可視状態にするには、「隠蔽」リストからキーを選択し、矢印ボタンをクリックしてそれを「表示順序」リストに移動します。キーを隠すには、「表示順序」リストからキーを選択し、矢印をクリックしてそれを「隠蔽」リストに移動します。「表示順序」リスト中で複数のキーが使用可能になっている場合には、キーを選択し、「上へ」または「下へ」ボタンをクリックすることによって、それが表示される順序を変更できます。「コマンド・キーの順序および可視性を変更する」チェック・ボックスが選択されない場合には、定義されたキーは数字順に表示されることになります。

画面サイズ

画面サイズ設定は、ディスプレイ・ファイル用に 2 次画面サイズが選択されている場合に使用可能になります。2 次画面サイズは、DDS ツリーの中のファイル・ノード・アイコン の「プロパティー」ダイアログを使用して設定することができます。「画面サイズ Web 設定」は、アプリケーションをブラウザーで表示するために使用される HTML テーブルのサイズを変更するために使用します。

可視性

可視性設定に使用できるオプションは、「フィールドの隠蔽」または「フィールドの表示」です。「フィールドの表示」が選択されると、フィールドが Web ページ上に表示されます。

位置

位置設定に使用できるオプションは、「スパンの変更」および「位置の変更」です。 DDS ソースが WebFacing Tool によって変換された後に、アプリケーションは、HTML テーブルを使用して Web ページ上で位置決めされます。 HTML テーブルには、DDS 画面と同じ数 (24 x 80 または 27 x 132) の行と桁があります。 位置設定を使用すれば、ソースの変換後の HTML テーブルでのフィールドの位置決め方法を変更することができます。

  • 「スパンの変更」によって、フィールドに割り振る HTML テーブルの行と桁の数を指示することができます。「スパンの変更」を使用する場合として考えられるのは、ご使用のプログラムが元々フィールドに取り込むために使用していたテキスト値の代わりにグラフィックを使用する場合です。例えば、元のプログラムではフィールドのテキストに 7 桁が必要であったとしても、使用したいグラフィックでは 2 桁しか必要ない場合があります。
  • 「位置の変更」によって、フィールドの開始位置となる HTML テーブル内の行と桁を指示することができます。

CODE Designer の画面ビューには、DDS ソースのための行と桁のレイアウトが表示されます。「スパンの変更」および「位置の変更」によって変更を行う場合は、このビューを使用して、フィールドの相互の相対位置がどのようになるかを確認してください。

「位置」設定の追加のオプションは、 「CSS 位置」です。 カスケーディング・スタイル・シート - 位置の設定により、フィールドを制限なしに Web ページの任意の場所に置くことができます。
  • 「行」で、フィールドの行の値を指定することができます。これは、1 以上の正整数でなければ なりません。
  • 「桁」で、フィールドの桁の値を指定することができます。これは、1 以上の正整数でなければ なりません。
  • 「オフセット」で、フィールドを行または桁の値に対して相対的に調整するピクセル数を指定することができます。この数は、0 または正あるいは負の整数とすることができます。
  • 「タブを使用不可にする」により、フィールドの移動後にタブ付けできるかどうかを示すことができます。「タブを使用不可にする」を選択した場合は、このフィールドにタブ付けすることはできません。選択しなかった場合は、フィールドは移動前と同じタブ順序のままとなります。
プログラム定義 HTML

このフィールドによって戻された値がページで使用したい HTML マークアップである場合には、プログラム定義の HTML 設定を使用して、「フィールド値を HTML として使用する」ボックスにチェックマークを付けます。

ユーザー定義 HTML

ユーザー定義 HTML によって、フィールドの値と一緒にか、あるいはそれの代わりに表示できる HTML テキストまたはタグを指定できます。この設定を処理するには、「HTML の指定」チェック・ボックスを選択してください。使用したい HTML タグを入力エリアに入力してください。フィールドの値を HTML のパーツとして使用したい場合には、「挿入フィールド値」ボタンをクリックします。この設定を使用できる 1 つの例は、フィールドの値を太字体フォントで表示したい場合です。これを実行するには、<BOLD> タグを &{FIELD.value} テキストと一緒に使用します。 この例では、入力域を編集して <BOLD>&{FIELD.value}</BOLD> が表示されるようにします。 &{FIELD.value} のコードがデフォルトでそこにない場合には、「フィールド値を挿入」ボタンをクリックして追加できます。

外観およびテキスト

外観およびテキスト設定に使用可能なオプションは、「スタイル・クラスの変更」「フィールド値のオーバーライド」 「定数テキストのオーバーライド」、および「文字を隠す」 です。

  • 「スタイル・クラスの変更」によって、フィールドで使用するスタイル・シート・クラスを指定できます。 例として、すべての数値データは特定のフォントまたはカラーで表示したいので、この目的のためにスタイル・シート・クラス numeric を定義してある場合があります。 プログラムに custno などの顧客番号フィールドがあった場合には、「スタイル・クラスの変更」チェック・ボックスを選択して、数値のスタイル・シート・クラスの名前を入力できます。
  • 「フィールド値のオーバーライド」で、フィールドの戻り値の代わりに表示するテキストを指定することができます。
  • 「定数テキストのオーバーライド」で、テキスト定数用の値セットの代わりに表示するテキストを指定することができます。
  • 「文字を隠す」で、フィールド内の表示したくない文字の範囲を指示することができます。例えば、画面にユーザーが選択するオプションのメニューが表示されていて、それぞれのオプションが (1. ユーザー・タスク- 2. オフィス・タスクのように) 番号順にリストされている場合には、オプションのテキストのみが表示されるように最初の 2 文字を隠した方がよい場合があります。このような例では、「文字を隠す」 を選択し、「開始点 1 終了点 2」の範囲を指定してください。

HTML の挿入

「HTML の挿入」設定は、追加の HTML を付け加えることによってフィールドをカスタマイズする方法を提供します。HTML は、フィールド用に自動的に生成される HTML タグの、およびにオプションで追加することができます。例として、社員番号の入力フィールドがあり、会社のすべての社員番号には 64- の接頭部が付けられるものとします。このフィールドは、以下のようなある種の HTML を追加することによって、より簡単に作成することができます。

<strong>64- prefix mandatory</strong>
value="64-"
<a href="help.htm">このフィールドの詳細については、ここをクリックしてください。</a>

この例では、フィールドのの HTML は、そのフィールドに関する 情報を提供するもので、情報が太字フォントで強調されるように <strong> タグが使用されています。 変換によって生成された HTML では、入力フィールドに <input> タグが使用されるので、<input> タグのに HTML 属性 value="64-" を追加できます。これにより、社員番号の接頭部が事前に取り込まれ、ユーザーはそれを入力する必要がなくなります。フィールドのは、ユーザーがフィールドの詳細を表示するためにクリックすることができるリンクに関する HTML です。

「HTML の挿入」設定で変更しているページをすべてテストしてください。行った変更が、WebFacing 変換によって生成された HTML と矛盾する可能性があります。これを解決する 1 つの方法は、「Web 設定」を使用しないでプログラムを変換し、生成された .html または .jsp ソースを調べて「Web 設定」によって無難に行える変更は何かを理解して、「Web 設定」を適用し、その後で再変換する方法です。

VALUES のオプション

VALUES のオプション設定は、VALUES キーワードによって指定された入力フィールドに使用できます。VALUES キーワードによって指定されたフィールドは、Web ページ上では単一選択ボックスとして表示されます。この選択ボックスに表示されるオプションは、DDS ソース内で VALUES キーワードに対するパラメーターとして指定された値です。

VALUES のオプション Web 設定によって、ユーザーに対して表示されるラベルまたはテキストを変更することができます。例えば、プログラムで予期されている VALUES パラメーターの 1 つが "item8" である場合に、ブラウザーに表示されるテキストを "8 gauge wire" のようにより説明用のものに変更できます。ユーザーに対して表示されるテキストは "8 gauge wire"であっても、プログラムに戻される値は、そのプログラムが予想しているものと同じ "item8" になります。

この「Web 設定」を使用するには、「VALUES キーワードのオプション・テキスト」チェック・ボックスを選択してください。VALUES パラメーターに新規ラベルを設定するには、値を選択し、そのラベルに必要なテキストを「新規ラベル」フィールドに入力してください。

グラフィックの作成

グラフィックの作成設定は、フィールドの代わりにイメージを表示したい場合に使用します。この設定の使用例として、在庫品目のイメージを含む製品データベースがあります。

「ファイル名」フィールドにワークステーション上のイメージ・ファイルへの完全パスまたはイメージ・ファイルへの完全 URL (例えば、http://www.ibm.com/image.gif) を取り込んでください。「ファイル名」フィールドには、値を直接入力するか、あるいは「ブラウズ」ボタンを使用してローカル・ファイルを探して取り込むことができます。指定したローカル・イメージが、WebFacing 変換中に WebFacing プロジェクトの ..¥Web Content¥images¥generated¥ ディレクトリーにコピーされます。このディレクトリー中のイメージは、「エクスポート」ウィザードを使用してプロジェクトを 配置した時に、後からサーバーに公開されます。

イメージの大きさが分かっている場合には、「ピクセル数による幅」および「ピクセル数による高さ」を使用できます。幅および高さ情報を追加しておくことで、イメージを含む Web ページを表現するために必要な時間を短縮できる場合があります。

プログラム内に、イメージ・ファイル名のパーツまたはイメージ・ファイルへの完全 URL として使用できる値を戻すフィールドがある場合には、「フィールドの選択」リストからフィールドを選択し、「挿入フィールド値」をクリックすることによって、それらの値を「ファイル名」フィールドに追加できます。例えば、値 bicycle1 を戻す &{FIELD1.value} があれば、ワークステーション上で処理するグラフィックの bicycle1.gif を容易に参照できます。この例では、「ファイル名」フィールドを「フィールドの選択」リストから取り込んでから、.gif 拡張子を追加します。「フィールドの選択」リストを使用して識別したファイルは、手動で ..¥Web Content¥images¥generated¥ ディレクトリーにコピーする必要があります。

ハイパーリンクの作成

ハイパーリンクの作成設定は、フィールドがハイパーリンクとして表示されるように使用します。 ハイパーリンクを作成するために使用可能な異なる方法が 3 つあります。 それらの方法は: 「静的 URL を指定する」「JavaScript ハイパーリンク」、および 「アクション・ハイパーリンク」です。 ハイパーリンクの外観に関するブラウザーの設定を指定変更したい場合は、 「ブラウザーのハイパーリンクの外観を DDS 外観によって指定変更する」 チェック・ボックスを選択してください。 「ハイパーリンクの作成」設定を「グラフィックの作成」設定と一緒に使用する場合は、そのフィールドをハイパーリンクとしても機能するグラフィックとして表示できます。

注: Web 設定を指定して作成されるアクション・ハイパーリンクがブラウザーに表示されない条件はいくつかあります。 これは、ハイパーリンクがブラウザーでアクティブまたは使用可能な内容に適用されない場合に、エラー条件を防止するために行われます。 例えば次のようになります。
  • 現在最上部ウィンドウまたは最上部レイヤーにないレコードにハイパーリンクがある。
  • このリンクと関連付けられているファンクション・キーが現在アクティブではない。
  • このリンクの一部である参照したフィールドがアクティブ・レコードにない、あるいは読み取り可能ではない。例えば、レコードが、PROTECT キーワードを使用する他のレコードによって保護されている。
ブラウザーのハイパーリンクの外観を DDS 外観によって指定変更する

ほとんどのブラウザーには、Web ページ上のハイパーリンクのカラーと外観の規則に従うか、あるいはユーザーが変更できる ハイパーリンクの外観に対する設定があります。 例えば、未訪問リンクは青のテキストで表示でき、訪問済みリンクは紫のテキストで表示できます。ブラウザーがハイパーリンクを DDS 中のフィールドに使用されるのと同じ外観で表示されるようにしたい場合は、「ブラウザーのハイパーリンクの外観を DDS 外観によって指定変更する」チェック・ボックスを選択してください。

静的 URL を指定する

あるフィールドに表示されるようにしたい特定の URL がある場合は、「静的 URL を指定する」を選択してください。 フィールドの出力値が、ハイパーリンクとして表示されるテキストになります。 ユーザーがリンクをクリックするとブラウザーがロードする位置は、URL フィールドに入力される値です。 リンクをクリックすると別のブラウザー・ウィンドウが起動するようにしたい場合は、そのウィンドウの名前を「ターゲット」フィールドに入力してください。 「ターゲット」フィールドをブランクのままにするか、あるいは *SAME を入力した場合は、現行のブラウザー・ウィンドウでリンクが開きます。

WebFacing ポートレット・ プロジェクトを処理する場合には、「ターゲット」フィールドに *PORTLET を指定してポートレット内でリンクを開くことができます。

URL の一部にしたいフィールド値が DDS 中にある場合は、フィールドを「フィールドの選択」リストから選択し、「挿入フィールド値」ボタンを使用してそのフィールドを「URL」フィールドに追加してください。 「挿入フィールド値」の使用例は、追加のパラメーターの追加先の URL がある場合がそうです。 例えば、http://mysite.com/mywebapp/servlet/MyServlet のような位置にサーブレットがあり、そのサーブレットが変数の parm1 および parm2 と呼ばれる引数を必要としている場合は、「挿入フィールド」の値を使用して URL の構成に役立てることができます。 この例では、最後の URL は http://mysite.com/mywebapp/servlet/MyServlet?parm1=&{FIELD1.value}&parm2=&{FIELD2.value} になると考えられます。 ここで、&{FIELD1.value} および &{FIELD2.value}「挿入フィールド値」を使用して追加したパラメーターで、実行時に変更される値を表します。
注: 異なるレコード様式のフィールド値をハイパーリンク・フィールドの URL の一部として使用する場合、 そのハイパーリンクが表示されるときに、このフィールドが Web ページで使用可能になることを確認する必要があります。 異なるレコード・フォーマットのフィールドは、「フィールドの選択」リストで確認できます。 これは、これらのフィールドにレコード様式名 (例えば、&{RECORD2.FIELD1.value}) が含まれるためです。 ハイパーリンクが表示されたときにどちらのレコード様式も Web ページで使用できない場合は、 そのハイパーリンクを選択したときに例外が発生します。

JavaScript™ ハイパーリンク

リンクをクリックすると呼び出されるようにしたい JavaScript 関数の名前を入力してください。 例えば、myFunction() と入力してください。 この関数は、「スクリプトに挿入」 Web 設定を使用して入力された関数、外部 JavaScript ファイルで定義した関数、または WebFacing に組み込まれている、ファイル webface.js 内の関数とすることができます。 ユーザー独自の外部 JavaScript ファイルを作成する場合は、それらを WebFacing プロジェクトの usr ディレクトリーに入れてください。 このディレクトリーは、パス <project name>¥WebContent¥ClientScript¥usr にあります。 このディレクトリーに入れられるスクリプトはどれも、実行時に WebFacing アプリケーションに対して使用可能です。 簡単なインライン JavaScript 関数がある場合は、その関数全体を「JavaScript ハイパーリンク」フィールドに入力することもできます。

アクション・ハイパーリンク
アクション・ハイパーリンクは、クリックするとカーソルがフィールドに置かれるか、 実行依頼を実行するか、あるいはこの 2 つの組み合わせを実行するリンクを作成します。 「カーソルをフィールドに配置」および「実行依頼」機能には、指定できる値があります。
カーソルをフィールドに配置
このリンクをクリックすると、アプリケーションに戻されたカーソル位置の実行時値が、ここで指定したフィールドの位置になります。 フィールドをドロップダウン・リストから選択できるか、フィールドの名前を手動で入力できます。 「カーソルをフィールドに配置」を選択しない場合は、カーソルは、Web ユーザーによって最後に 選択されたフィールドに置かれます。 このカーソル値は、ブラウザーによって表示されたカーソルを参照するのではなく、DDS レコードのフィールドの 現行カーソル位置を示す WebFacing ランタイム値を参照します。 カーソルが置かれているフィールドに値を割り当てる場合は、フィールドを選択するか、 または「データの入力」フィールドに値を入力します。

「カーソルをフィールドに配置」の項目は、次の形式にすることができます。

&{FIELD}
現行レコードのフィールド。
&{RECORD.FIELD}
指定したレコードのフィールド。

データを入力フィールドの項目は、次の形式にすることができます。

&{FIELD.value}
現行レコードのフィールドの値。
&{RECORD.FIELD.value}
指定したレコードのフィールドの値。

また、データの入力フィールドに値を手動入力することもできます。

実行依頼

「実行依頼」チェック・ボックスを選択すると、「ファンクション・キー」または「JavaScript 関数呼び出し」実行依頼アクションをハイパーリンクに選択できます。 例えば、「ファンクション・キー」ドロップダウン・リストから、ENTERLOGOFF、または DDS で定義済みのファンクション・キーを選択できます。 使用したいファンクション・キーが別の DDS レコードにある場合は、そのファンクション・キーの値を手動で入力してください。 ユーザーがそのファンクション・キー用に作成済みのリンクをクリックすると、プログラムはその関数を実行することになります。 「JavaScript 関数呼び出し」フィールドには、リンクをクリックすると呼び出されるようにしたい JavaScript 関数の名前を入力してください。 この関数は、「スクリプトに挿入」 Web 設定を使用して入力された関数、外部 JavaScript ファイルで定義した関数、または WebFacing に組み込まれている、ファイル webface.js 内の関数とすることができます。 ユーザー独自の外部 JavaScript ファイルを作成する場合は、それらを WebFacing プロジェクトの usr ディレクトリーに入れてください。 このディレクトリーは、パス <project name>¥WebContent¥ClientScript¥usr にあります。 このディレクトリーに入れられるスクリプトはどれも、実行時に WebFacing アプリケーションに対して使用可能です。

「カーソルをフィールドに配置」オプションは「実行依頼」オプションと組み合わせることができます。 特定のフィールドの値を設定して、その値をプログラムに戻すように実行依頼したい場合に行います。これを実行するには、 「カーソルをフィールドに配置」チェック・ボックスを選択し、ドロップダウン・リストからフィールドを選択 (またはフィールドを入力) し、「データの入力」 フィールドで {FIELD.value} を入力 (または特定の値を入力) して、「実行依頼」チェック・ボックスを選択し、 「ファンクション・キー」ラジオ・ボタンを選択して、「ファンクション・キー」 ドロップダウン・メニューから 「ENTER」 を選択します。 「カーソルをフィールドに配置」および「データの入力」フィールドに 使用する入力フォーマットについては、この資料の「カーソルをフィールドに配置」セクションを参照してください。

スクリプトに挿入
「スクリプトに挿入」設定は、通常のレコードまたはサブファイル制御レコード用に作成する JSP ファイルをカスタマイズするために使用します。例えば、サブファイル制御レコード LISTCTL がある場合は、WebFacing 変換は対応する JSP ファイル LISTCTLJavaScript.jsp を作成します。「スクリプトに挿入」設定の「スクリプト記述」フィールドに追加されるコードが、ファイル LISTCTLJavaScript.jsp の生成時にこのファイルに追加されます。この設定によって、任意の JavaScript または JSP スクリプトレットを変換済みプログラムに入力できます。これを使用してフィールドを初期設定できるか、特定のレコード様式に必要な任意の処理を実行できます。例えば、フィールドの初期値がヌルである場合は、そのフィールドの値を設定するコードを追加できます。
if(&{CID}.value="")
{
	&{CID}.value="0001";
}
この例では、コード &{CID}「フィールド名の挿入」ボタンを使用して選択したフィールドを参照します。 「フィールド名の挿入」ボタンの下のフィールドはアンパーサンドと 2 個の大括弧で囲まれています。例えば、&{FIELDNAME}。 その他の例は、WebFacing ユーザーの IP アドレスを判別する JSP コード、またはユーザーのシステムの時刻を表示する JavaScript です。 「スクリプトに挿入」、「ブラウザーに送信」設定と一緒に使用できます。 例えば、スクリプトで決定された値を使用して、「ブラウザーに送信」設定で設定した 隠しフィールドを取り込むことができます。 スクリプトの一部として使用したい既存のフィールドが DDS 中にある場合は、そのフィールドを「フィールド名の挿入」ボタンを使用してスクリプトに追加してください。例えば、H または隠しフィールドを選択し、値をそのフィールドに割り当てられるようにそのフィールドをスクリプトで使用できます。

ブラウザーに送信

「ブラウザーに送信」設定は H または非表示 DDS フィールドに使用できます。この設定は、生成された JSP ファイルをレコード用に変更します。例えば、LISTCTL と呼ばれるレコードに H フィールドがある場合にこの設定が使用されると、HTML 隠し入力フォーム・エレメントが JSP ファイル LISTCTL.jsp に生成されます。隠し入力フォーム・エレメントは HTML コード <INPUT TYPE="hidden" で始まります。「ブラウザーに送信」を使用すると、H フィールドがブラウザー環境の一部となり、値がその環境に基づいてそのフィールドに割り当てられるようにできます。例えば、「スクリプトに挿入」設定を使用して追加したスクリプトによって判別されるユーザーの IP アドレスなど。

ダイナミック・キー・ラベル

「ダイナミック・キー・ラベル」設定は、実行時にコマンド・キーのテキスト・ラベルを決定するために使用することができます。 この設定は、出力フィールドにのみ使用できます。 この設定では、コマンド・キーが出力フィールドと関連付けられ、コマンド・キーのテキストがフィールドの実行時値によって決定されます。 使用例として、アプリケーションが複数の言語をサポートしていて、コマンド・キー・テキストをユーザーのネイティブ言語で 表示したい場合があげられます。 これを行う方法の 1 つに、アプリケーションが使用するテキスト・ストリングを含む言語ごとに 1 つの MSGF を用意して、 各 MSGF を言語特定ライブラリーに書き込む方法があります。 出力フィールドの値が MSGF から読み取られる場合、フィールドに表示されるテキストの言語は、ユーザーの言語用 MSGF を含む ライブラリーをユーザー・プロファイルのライブラリー・リストの上位に入れることによって変更できます。 これで、コマンド・キー・ラベルはその言語で表示されます。

この設定を使用するには、「ダイナミック・キー・ラベル」設定を選択して、 「フィールドの値をコマンド・キー・ラベルとして使用する」を選択します。 「コマンド・キー」リストで、出力フィールドのテキストと関連付けられるキーを選択します。 また、「*AUTO」「コマンド・キー」リストから選択することもできます。 「*AUTO」は、フィールド値が実行時に構文解析され、ラベルを割り当てるコマンド・キーが判別されることを意味します。
注: 現在、限定されたストリング・パターン・セットだけが *AUTO によってサポートされています。 以下の接頭部および区切り記号表にリストされたパターンと、アプリケーションで使用されるコマンド・キー・ラベルの ストリングに関する知識に基づいて、*AUTO がアプリケーションで動作するかどうかを評価してください。 この表は、接頭部と区切り記号によってパターンを識別します。 例えば、F3=Exit が出力値で、*AUTO が 「ファンクション・キーの実行依頼」リストで選択した値である場合は、 ストリング Exit がコマンド・キー・ラベルとして使用されます。 つまり、F が接頭部として扱われ、= が区切り記号として扱われ、 区切り記号に続くテキストがラベルとして使用されます。
接頭部 区切り記号
F =
FP =
CF =
CA =
PF =
警告
  • *AUTO は、実行時のパフォーマンスに影響を与える可能性があります。 出力フィールドとコマンド・キーの 1 対 1 マッピングを確実にしておくと、*AUTO の使用を避けることができます。
  • MSGF を出力フィールドのテキストに使用する場合、MSGF テキストにキーを組み込むことはできません。 例えば Exit では、MSGF のテキストは、F3=Exit ではなく、 Exit でなければなりません。