1.0 概要
2.0 前のリリースからの変更点
3.0 制限
3.1 ページ・テンプレートが Web ページに適用されない場合の大文字小文字
4.0 既知の問題
4.1 JSP バリデーターが従属 Java 変更に対して自動コンパイルを実行しない
4.2 パフォーマンスのヒント: 活動状態にないプロジェクトをクローズする
4.3 パフォーマンスのヒント: 自動検証を使用不可にする
4.4 Page Designer Classic を使用可能または使用不可にする
4.5 Page Designer ツールバー・メニューのカスタマイズに関する制限
4.6 アプレットにおける中断リンクの警告
4.7 Page Designer を使用して
HTML ファイルおよび JSP ファイルにアプレットを挿入する
4.8 Shockwave が含まれた HTML ファイルをプレビューすると、WebSphere Studio が突然終了する
4.9 Windows 2000/XP 上での一部の GB18030 文字の表示に関する問題
4.10 WebArt Designer、Animated GIF Designer、および PageDesigner classic における BiDi 問題
4.11 JSP は明示的なインポート・ステートメントを使用する必要がある
4.12 Page Designer Classic に対する双方向言語サポート
4.13 Web プロジェクトにおけるリレーショナル・データのマイグレーション
4.14 WebSphere 5 サーバー上の J2EE 1.3 レベルの DBCS 環境で設計された JSP および Java サーブレットには追加のコードの断片が必要
4.15 「高速編集 (Quick Edit)」ビューへの項目のドラッグ・アンド・ドロップ
4.16 「高速編集 (Quick Edit)」ビューで単純アクションを使って「断片 (Snippet)」ビュー項目を使用する
4.17 Page Designer に対するモバイル言語サポート
4.18 Page Designer に対するページ・テンプレート・サポート
4.19 Web Site Designer でサイト・パーツを使用する場合の注意事項
4.20 色およびフォントのシステム設定の変更
4.21 エディターの未保管ファイルに関する検索注釈
4.22 Web Site Designer またはページ・テンプレートを使用する場合の ClearCase の制限
4.23 データベース Web ページ・ウィザードによって生成された JSP 内の JavaScript フォーム実行依頼の問題
WebSphere Studio の Web 開発環境では、Web アプリケーションの開発に必要なツールが提供されています。 Web アプリケーションには、静的 Web ページ、JavaServer Pages (JSP)、Java サーブレット、XML デプロイメント記述子 (web.xml)、およびその他の Web リソースが含まれます。 この README ファイルには、Web 開発環境で使用されるツールに関連する既知の問題、制約、および対応策について説明されています。
Web プロジェクト内の「Web コンテンツ (Web Content)」および「Java ソース (Java Source)」フォルダー名が構成可能になりました。 デフォルト名は WebContent および JavaSource です。ただし、新規 Web プロジェクトのデフォルト名は「Web ツール (Web Tools)」->「新規プロジェクト (New Project)」設定ページで変更できます。 既存のプロジェクトのフォルダーは、Navigator を使用して名前変更できます。
注: デフォルト以外のフォルダー名は、WebSphere Studio バージョン 5.0.0 と互換性がありません。 ワークスペースにバージョン 5.0.0 との互換性を持たせる必要がある場合は、デフォルト名を変更しないでください。HTML/JSP ページの編集操作を支援するために、2 つの新規ビューが Web パースペクティブに追加されています。 パレット・ビューには項目のセットが含まれており、それらは Page Designer の Web ページにドラッグ・アンド・ドロップすることができます。「高速編集 (Quick Edit)」ビューを使用すれば、Page Designer でスクリプトやタグ・イベント・スクリプトを追加/編集することができます。 詳しくは、ヘルプ・システムを参照してください。
いずれかのページ・テンプレート・ウィザードを使用しているときに、ページ・テンプレートが Web ページに適用されない原因として、以下のようないくつかの状況が考えられます。
- 選択したページ・テンプレートのエンコード方式と異なる方式を持つ Web ページには、ページ・テンプレートは適用されない。
- 選択したページ・テンプレートまたは Web ページのいずれかが XML Style JSP によって記述されているときは、ページ・テンプレートが適用されない。
- すでにページ・テンプレートが関連付けられている Web ページには、ページ・テンプレートは適用されない。
JSP バリデーターは、JSP ファイルが参照している Java クラスが変更されても、 その JSP ファイルの再検証を自動的には実行しません。 JSP バリデーターは、プロジェクト・ナビゲーターでファイルを選択し、「検証の実行 (Run Validation)」をコンテキスト・メニューから選択することにより再度実行することができます。
パフォーマンスを向上させるために、アクティブに作業を行っていないプロジェクトは すべてクローズすることをお勧めします。 「すべて再ビルド (Rebuild All)」を実行すると、オープンされているプロジェクトのみが再ビルドされます。
デフォルトでは、Web プロジェクトにリソースを保管すると、バリデーターが自動的に実行されます。リソースを保管するときにバリデーターが自動的に実行されないようにするには、J2EE ナビゲーター・ビューのコンテキスト・メニューから Web プロジェクト「プロパティー」ダイアログをオープンします。 そして、「検証」ページの「検証設定をオーバーライド (Override validation preferences)」オプションを使用可能にし、「リソース変更の保管時に検証を自動実行 (Run validation automatically when you save changes to resources)」 オプションを使用不可にします。ユーザーはすべてのプロジェクトの自動的な検証 (およびビルド) を使用不可にすることができます。 「ウィンドウ」>「設定」と選択し、「ワークベンチ」ページから「リソース変更のときにビルドを自動的に実行」を使用不可にします。 自動ビルドを使用不可にすると、ビルド (および検証) を「プロジェクト」>「プロジェクトの再ビルド」と選択することにより手動で実行することができます。
Page Designer の WebSphere Studio V4 バージョン (Page Designer Classic として知られている) は、設計が変更されてバージョン 5 になりました。 新しいバージョンの Page Designer (インターフェースおよび製品資料では、Page Designer と表記されている) を使用することをお勧めします。 またデフォルトのバージョンでもあります。 Page Designer Classic はインストール可能なフィーチャーとしては提供されませんが、以下の方法で使用可能になります。
Page Designer は、ビューを使用した属性編集機能や簡略化されたタグ・ライブラリーのサポートなど、使いやすさと機能が向上しています。
Page Designer Classic から引き継いでいないフィーチャーもあります。以下がその内容です。
- 双方向 (BiDi) サポート
- 動的エレメント (動的テーブルを含む)
- アクセス可能性チェッカー
Page Designer Classic に含まれる特定のフィーチャーに対するサポートを必要としない限り、デフォルトの Page Designer をお使いください。 Page Designer Classic を使用可能にするには、以下のようにしてください。
Page Designer Classic をインストールする:
- インストールする前に WebSphere Studio を終了する。
- Windows エクスプローラーで WSAD INSTALL DIR/bin ディレクトリーをオープンして pdclassic.exe をダブルクリックする。
- WebSphere Studio を再始動すると、「更新 (Update)」ダイアログが表示されます。「はい」ボタンをクリックする。
注: これが初回のワークベンチの使用であれば、このステップと後続のステップは実行 されません。- 「構成変更」ダイアログ。「検出された変更 (Detected Changes)」領域のチェック・ボックスを選択する。 次に、「完了」プッシュボタンをクリックする。
- 「インストール/更新」ダイアログで、「はい」プッシュボタンをクリックする。 ワークベンチは変更を有効にするため再始動します。
Page Designer Classic をデフォルトの Web エディターとしてマッピングする:
Page Designer Classic のインストール後、デフォルトでは、このエディターといくつかの HTML および JSP ファイル・タイプ (*.htm、*.html、*.jsp、*.jhtml、*.shtml、*.shtm、および *.html-ss など) 間のファイル関連付けがマッピングされます。J2EE ナビゲーター・ビュー・コンテキスト・メニューから、「オープン元」>「Page Designer Classic」を使用して、Page Designer Classic の中の選択されたファイルをオープンできます。 しかし、ユーザーが Page Designer Classic を HTML および JSP ファイル・タイプのデフォルトのエディターにしたいときは、 次のように操作してください。
- 「ウィンドウ (Window)」>「設定 (Preferences)」と選択する。
- 「ワークベンチ」設定を展開して、「ファイルの関連付け」ページをオープンする。
- 適用したいファイル・タイプを「ファイル・タイプ」リスト・ボックスから選択する (1 度に 1 つ)。
- 「エディターの選択 (Editor Selection)」ダイアログから「Page Designer Classic」を選択して 、「デフォルト」プッシュボタンをクリックする。
- ステップ 3 と 4 を適用するファイル・タイプごとに繰り返す。
注: 後で Page Designer Classic を使用不可にしてから、再び使用可能にすると、 ファイル・アソシエーションも復元されます。しかし、マップされたファイル・タイプに対応するデフォルトのエディターは新しい Page Designer に戻ります。
オプションとして、 ユーザーが Page Designer Classic の編集設定を更新することができます。「ウィンドウ」>「設定」と選択し、そして「Web ツール」設定を展開します。 「Page Design (Classic)」を展開して希望の更新を行います。
Page Designer Classic を使用不可にする
このフィーチャー (ヘルプを含む) を使用不可にして 、デフォルトの Page Designer の使用を再開するには以下のステップを行います。
- 「ヘルプ」>「ソフトウェアの更新」>「管理機能の更新」と選択する。
- 「構成のインストール」ビューで、「現行構成」を展開し、「Page Designer Classic 5.1.0」を見つけて選択する。
- 「プレビュー」ペインの右下コーナーの「使用不可」プッシュボタンをクリックする。
- 「フィーチャーのインストール」ダイアログで、「完了」プッシュボタンをクリックする。
- 「インストール/更新」ダイアログで、「はい」プッシュボタンをクリックする。 ワークベンチは変更を有効にするため再始動します。
Page Designer Classic を使用可能にする (使用不可にしたあとで)
Page Designer Classic を再度使用可能にする際、 pdclassic.exe は再実行しないでください。代わりに、次のように操作してください。
- 「ヘルプ」>「ソフトウェアの更新」>「管理機能の更新」と選択する。
- 「構成のインストール」ビュー内で、「使用不可のフィーチャー」 というツールバーをクリックする。
- 「現行構成」を展開して Page Designer Classic 5.1.0 を見つけて選択する。
- 「プレビュー」ペインの右下コーナーの「使用可能」プッシュボタンをクリックする。
- 「フィーチャーのインストール」ダイアログで、「完了」プッシュボタンをクリックする。
- 「インストール/更新」ダイアログで、「はい」プッシュボタンをクリックする。 ワークベンチは変更を有効にするため再始動します。
「パースペクティブのカスタマイズ (Customize Perspective)」ダイアログ (「ウィンドウ」>「パースペクティブのカスタマイズ」と選択してアクセスする) を使ってツールバーをカスタマイズしたあと、Page Designer の「ツールバー」 メニューを使って さらにカスタマイズすることはできません。 この場合、どちらのツールバー項目を表示するかをカスタマイズするために、「パースペクティブのカスタマイズ」ダイアログを使わなければなりません。
LinksBuilder は、完全修飾の Java クラス名が使われたとき、アプレットのコード属性値に無効なリンクとして間違ったフラグを立てる場合があります。
<applet code="aaa.bbb.AnApplet" codebase="MyApplets">この警告は無視をしても安全で、アプレットをサーバーで実行する際にも、その動作への影響はありません。この警告は、パス区切り文字として、('.') 区切り文字の代わりに ('/') を 使い、.class 拡張子を明示的に記述すれば避けられます。例:
<applet code="aaa/bbb/AnApplet.class" codebase="MyApplets">
Web プロジェクトの Java ソース・フォルダー (デフォルトでは、JavaSource) はサーバー・サイドのクラスであり、アプレットのソース・コードをこのフォルダーに置くことはできません。アプレットの開発には以下をお勧めします。
- アプレットのために Java プロジェクトを作成し、アプレット・クラスをそのプロジェクトに作成する。
- アプレットのクラス・ファイルを、Web プロジェクトの Web コンテンツ・フォルダー (デフォルトでは、WebContent) にコピーする。フォルダーはサーバー・サイド・クラス専用であるため、それらは WEB-INF フォルダーにコピーしないでください。 (クラス・ファイルを見るためには、「フィルター」をビューの「メニュー」ボタンのドロップダウン・リストから選択して、 プロジェクト・ナビゲーター・ビューのフィルターを変更する必要があります。)
- Page Designer で「挿入」>「その他」 >「Java アプレット」と選択して、Web ページにアプレットを挿入する。 そのとき、ユーザーは適切な code および codebase の属性を設定しなければなりません。
たとえば、アプレット・クラスが aaa.bbb.AnApplet でファイル構造が以下のとおりであるとします。
WebContent/index.htmlコードは "aaa.bbb.AnApplet" です。
WebContent/MyApplets/aaa/bbb/AnApplet.classこの場合、index.html の applet タグには以下の記述が含まれていなければなりません。
codebase is "MyApplets"
この問題に対する既知の次善策はありません。
GB18030 は中華人民共和国の標準文字セットで、拡張コード・ページと Unicode へのマッピングのテーブルを指定します。システム・ロケールが中国語 (簡体字) で Microsoft GB18030 サポート・パッケージがインストールされている場合、WebArt Designer と Animated GIF Designer は GB18030 文字を 0xA840 〜 0xA9A0 の範囲について正しく表示できません。
WebArt Designer の場合、この問題は、「WebArt Gallery」ビューのテキスト・フィールド、「Logo Wizard」(テキスト 1/4 を指定) ダイアログのテキスト・フィールド、「Edit Bookmarks」ダイアログのテキスト・フィールド、および「Bookmark」メニューのメニュー項目に発生します。
Animated GIF Designer の場合、この問題は、「Frame Properties (Comment Frame)」ダイアログのコメント・フィールド、「Frame Thumbnail」ビューのコメント・フレーム、および「Create Animated Banner」ダイアログのテキスト・フィールドに発生します。
たとえば、GB18030 '0xA877' 文字 (Unicode では、U+2573 四角形に X) を入力すると GB18030 '0xA876' (Unicode では、U+2572 四角形にバックスラッシュ) が表示されます。
WebArt Designer および Page Designer Classic を Windows XP 上の双方向言語で使う場合、Logo イメージの作成に失敗することがあります。右から左方向に文字を書いて Logo イメージを作成するときに文字間隔を指定すると、Logo 内の文字順序が再配列されません。 Windows XP で双方向言語文字を使用して正しい Logo イメージを作成するには、文字間隔としてゼロを指定する必要があります。
AnimatedGif Designer におけるアニメーション表示のバナーについても同じ制限があります。
JSP ファイルでページのスクリプト環境に使用可能な型を記述するには、 ページ・ディレクティブの「import」属性を使用する必要があります。 一部の型は、J2EE1.2 プロジェクトに含まれている JSP ファイルに暗黙的にインポートされますが、J2EE1.3 プロジェクトで使用するとエラーとなります。 この問題に対処するには、JSP ページに型をいつも明示的にインポートする必要があります (型がデフォルトのインポート・リスト (java.lang.*、javax.servlet.*、javax.servlet.jsp.*、および javax.servlet.http.*) に含まれている場合を除く)。
Page Designer Classic に対する両方向サポートを使用可能にするには、Windows でアラビア語またはヘブライ語に対してシステム・デフォルト・ロケールとユーザー・デフォルト・ロケールの両方を設定します。
リレーショナル・データを WebSphere Studio 4.0.3 プロジェクトからマイグレーションするには、以下の操作を行う必要があります。
- 4.0.3 ワークスペースから、使用可能な各データベースごとに DDL ファイルを生成する。
- Web プロジェクト・ソース/データベース・フォルダーからデータベースを除去する (「データ定義 (Data Definition)」ビューを使用して)。
- WebSphere Studio バージョン 5 で 4.0.3 ワークスペースをオープンする。
- リレーショナル・データを復元したい Web プロジェクトをマイグレーションする。
- 「ファイル (File)」>「インポート (Import)」>「ファイル・システム (File System)」とクリックし、4.0.3 ワークスペースから DDL ファイルを指定する。
- データ・パースペクティブの「データ定義 (Data Definition)」ビューで、「ローカルに対して実行 (Run against Local)」を選択し、ターゲット Web プロジェクトを指定する。
リレーショナル・データ作成物が復元されます。
この項目は、WebSphere 5 サーバー上の J2EE 1.3 レベルの DBCS 環境で設計された JSP および Java サーブレットに適用されます。 いずれかの要求パラメーターまたは属性にアクセスする際には、あらかじめ以下のコード断片をソースに組み込んでおく必要があります。
if(request.getCharacterEncoding() == null){
request.setCharacterEncoding(<encoding>); // typically this would be the encoding of the JSP or servlet
}
//...normal jsp/servlet code which access request objects like
// <%=request.getParameter("message")%>
上記のことが行われておらず、かつ要求にエンコード情報が組み込まれていないと、すべての要求パラメーターは ISO-8859-1 で構文解析されます。したがって、いずれかの入力パラメーターに DBCS 文字が含まれていると、それらは正しく表示されません。
「断片 (Snippets)」ビューまたは「パレット (Palette)」ビューから項目またはテキストを「高速編集 (Quick Edit)」ビューにドラッグ・アンド・ドロップする前に、まず、「高速編集 (Quick Edit)」ビューが「アクション/コード断片の挿入 (Insert an action/code snippet)」手順から消去されていることを確認してください。
各 JavaScript 「断片 (Snippet)」ビュー項目ごとに、対応する単純アクションが「高速編集 (Quick Edit)」ビューに設けられています。 「高速編集 (Quick Edit)」ビューでは、単純アクションを「断片 (Snippets)」ビューの項目と組み合わせて同一イベント・スクリプト内で使用しないでください。 項目を結合する必要がある場合は、断片項目の配置に注意してください。 エディターに単純アクションがすでに含まれているときに、「断片 (Snippets)」ビューから「高速編集 (Quick Edit)」ビューに項目をドラッグ・アンド・ドロップすると、断片項目が間違った場所に挿入されることがあります。 これが発生したら、単純アクションを削除してから、再挿入してください。
モバイル言語 (cHTML、WML、など) でサポートされていない属性を、「挿入 (Insert)」ダイアログまたは「属性 (Attributes)」ビューから挿入することができます。
ただし、「ツール (Tools)」>「HTML 構文の妥当性検査 (Validate HTML Syntax)」 (cHTML 文書の場合) または「ツール (Tools)」>「WML 構文の妥当性検査 (Validate WML Syntax)」 (WML 文書の場合) を使用してコードの妥当性を検査することができます。
ページ・テンプレートは Page Designer によってのみサポートされ、Page Designer Classic によってはサポートされません。 Page Designer を使用して、ページ・テンプレート機能を使用する HTML/JSP ページを編集することができます。
- 一部のサイト・パーツは、特定の文書タイプを持つページに挿入できません。 「挿入 (Insert)」ダイアログで「OK」をクリックした後で、エラー「このサイト・パーツは使用できません (Cannot use this site part)」を受け取ります。つまり、選択したサイト・パーツの仕様ファイルをターゲット・ページの文書タイプで使用すると、無効なソースが生成されます。 たとえば、ページの文書タイプが cHTML または WML の場合は、ほとんどすべてのサイト・パーツに、それらのマークアップ言語では無効なタグが含まれています。
- 関連する仕様ファイルが原因で、ナビゲーション・バーに無効なソースが含まれていることがあります。 「タスク (Tasks)」ビューで多くのエラーや警告が出た場合は、ナビゲーション・バーの仕様ファイルが原因になっていることが考えられます。 仕様ファイルを編集してエラーを訂正してください。
- ページのナビゲーション・バーに壊れた文字が含まれていることがあります。 このエラーは、ページに指定されたエンコード規則に従ってエンコードできない文字がナビゲーション・ラベルに含まれている場合に発生します。 これを回避するには、ナビゲーション・ラベルに使用する文字のタイプを、ページで使用するエンコード方式に限定するか、またはもっと表現性に富むエンコード規則をページに使用します。
- 「サイト・マップの挿入 (Insert Site Map)」ダイアログにリストされているすべてのサンプル仕様ファイルは、サイト構造のレベル 1 からレベル 5 までのページを処理できます。 siteedit:sitemap タグの属性ビューで 5 を超える終了レベルを設定した場合でも、レベル 5 を超えるページへのリンクはサイト・マップに組み込まれません。
色とフォントのシステム設定を変更するときは、WebSphere Studio を再始動して、新規の設定を Page Designer の設計ページと「Palette」ビューに適用する必要があります。
XML Editor のようなマルチページ・エディターの「ソース・エディター (Source Editor)」および「ソース (Source)」ページでは、検索機能は、エディターの内容からではなく、ファイル・システムに保管されたリソースから作業しています。 どの未保管エディターの場合も、検索注釈は信頼できないことがあります。この問題を回避するには、ファイルを保管してから検索を行ってください。
Web Site Designer を使用して Web プロジェクトを処理する場合は、まず、ClearCase リポジトリーで HTMLや JSP ファイル、およびその関連ファイルなどのプロジェクト・ファイルを調べてください。
また、Web プロジェクトでページ・テンプレートを使用する場合も、まず、ClearCase リポジトリーで該当するファイルを調べてください。
Database Web Pages Wizard によって生成された一部の JSP (特に、「***MasterView.jsp」というタイトルの JSP) では、
「戻る (Back)」、「最新表示 (Refresh)」などのタイトルを持つページ内のリンクは、一部のブラウザーでしか機能しないことがあります。 一部のブラウザー (特に、Mozilla および Konqueror) では問題が認められています。
大部分のブラウザーでこの問題を修正するには、JSP の「submitForm」という関数の JavaScript コードを変更してください。
メソッドの変数 'document.<formName>.elements.action' を 'document.<formName>.action' に変更してください。
たとえば、関数 submitForm(nav){ if(nav == 'SCHEMA_TABLEInputForm'){ document.myForm.elements.action = "/Web3/SCHEMA_TABLEInputForm.html"; } else if(nav == 'SCHEMA_TABLEMasterView'){ document.myForm.elements.action = "/Web3/SCHEMA_TABLEMasterView"; } else{ document.myForm.elements.action = "/Web3/SCHEMA_TABLEDetailsView"; } は、
関数 submitForm(nav){ if(nav == 'SCHEMA_TABLEInputForm'){ document.myForm.action = "/Web3/SCHEMA_TABLEInputForm.html"; } else if(nav == 'SCHEMA_TABLEMasterView'){ document.myForm.action = "/Web3/SCHEMA_TABLEMasterView"; } else{ document.myForm.action = "/Web3/SCHEMA_TABLEDetailsView"; } になります。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.