1.0 概要
2.0 従来のリリースからの変更点
3.0 制限
3.1 XSL 変換および
デバッグ
4.0 既知の問題
4.1 大きな XML ファイルをオープンすると、ワークベンチが突然クローズする場合がある
4.2 「XML to SQL」では、BLOB、CLOB、および Binary データ・タイプはサポートされない
4.3 「XML to SQL」は、不適切な日付または時刻形式に対して SQLException をスローする
4.4 アラビア語/ヘブライ語マシンでデータベース・テーブルから XML スキーマを生成する
4.5 DBCS マシンで DB2 XML エクステンダー用のテストの一式および DAD ファイルを生成する
4.6 DBCS 文字を含むデータベース・テーブルからの XML スキーマの生成
4.7 無限ループのある XSL スタイルシートを XML ファイルに適用する
4.8 XML カタログ設定がリモート XSL ランチャーで認識されない
4.9 「XHTML から XML データを抽出 (Extract XML data from XHTML)」オプションを使用
せずに XHTML テンプレート用の XSL を生成する
4.10 再ロードしても RMX および XMX エディターに変化がない
4.11 妥当性検査と未解決の URI
4.12 Bean に同じパラメーター名のメソッドがある場合に Java Bean XML/XSL クライアント
・ウィザードを使用する際の問題
4.13 XML スキーマまたは DTD ファイルの生成時に発生する可能性のある BiDi エンコードに
関する問題
4.14 「XSL 変換出力 (XSL Transform output)」ビューは、リモート XML 変換のトレース時
に空になっている
4.15 XML スキーマのネーム・スペースを名前変更すると、新規ネーム・スペースが作成され
る
4.16 XML エディターのペイント問題
4.17 XSL デバッグおよび変換ウィザードの使用中または XML ディジタル・シグニチャーの
作成中に外部ツール・エラーが発生する
4.18 XSL デバッガーでブレークポイントの使用可能/使用不可フラグが無視される
以下の XML 開発環境ツールが WebSphere Studio で使用可能です。これらのツールは、XML エディター、DTD エディター、XML スキーマ・エディタ ー、XSL エディター、XSL デバッグ・ツールとトランスフォーメーション・ツ ール、XML から XML へのマッピング・エディター、RDB から XML へのマッピ ング・エディター (DB2 XML エクステンダーの DAD を生成するために使用可能) です。 また、任意の JDBC データベースから XML データを保管し検索する Java クラス・ライブラリーとウィザード、XML セキュリティー・サポート、XPath 式ウィザードと多くのジェネレーター (Java Bean からの XML DOM/XSL 生成、および XHTML ファイルからの XSL/XML 生成など) も含まれます。
WebSphere Studio Version 5.1 では、以下の機能拡張が行われています。
- XML ファイルの作成ウィザードに、新規オプションが追加された。
- 「XML スキーマ・グラフ (XML schema Graph)」ビューが拡張された。
- XSL 変換およびデバッグ・ツールの機能が変更された。 これによって変換およびデバッグを別々に実行できるようになりました。
XML/XSL ファイルへのパスまたはファイル名に ASCII 文字以外の文字が含まれている 場合は、XSL デバッグおよび変換が正しく機能しないことがあります。
XML エディターを使用して大きなファイルをオープンする際には注意が必要です。 ワークベンチのメモリー制限を超えると、ワークベンチはデータを保管せずに突然クローズします (警告またはエラー・メッセージは表示されません)。XML ファイル内のエレメント数 (サイズではありません) は、必要なメモリー量を示す一番良い指標です。 また、メモリー要件は、ワークベンチでほかに何がオープンしているかによっても異なります。 場合によっては 15 メガバイトのファイルをオープンすることもできますが、1 メガバイトのファイルでも 問題が発生することがあります。 したがって、大きな XML ファイルを開く場合は、その前にすべてのデータをワークベンチで保管することをお勧めします。
注: WebSphere Studio に割り振る最大メモリーは、変更することができます。詳しくは、ワークベンチの README を参照してください。
「XML to SQL」は、列の型が Binary、BLOB、または CLOB の場合には、データベース・テーブルを正しく更新しません。 これは、INSERT および UPDATE アクションに適用されます。
データ型が Date、Time、または Timestamp の列を持つデータベース・テーブルを更新する場合には、 「XML to SQL」ウィザード、または xmltosql および sqltoxml JAR ファイルは、 入力 XML ソースのストリング値がターゲットのデータベース製品で受け入れられないと、SQLException をスローします。 日時形式には、製品ごとに若干の違いがあります。SQL 照会ビルダーを使用して、これらの型の正しい形式を判別できます。
データベース・テーブルから XML スキーマ・ファイルを生成すると、特にアラビア語 またはヘブライ語のプラットフォームにおいて、「タスク (Tasks)」ペインでエラー・ メッセージ「早すぎるファイルの終わり (Premature end of file)」が表示されることが あります。
メッセージが表示されても、スキーマ・ファイルは正しく生成されます。指定した ターゲット・ワークスペース・フォルダーをリフレッシュしてから、XSD エディターで ファイルをオープンしてください。
Windows でテストの一式ファイルを生成する場合、生成されたバッチ・ファイルが CRLF を使用する必要がある場合は、行区切り文字として CR を使用します。 その結果、ファイルが正しく動作しないことがあります。この場合、 NotePad などのテキスト・エディターを使用して、行区切り文字を手動で挿入して ください。
また、DAD ファイルが正しく動作するように、プラットフォームの デフォルトのエンコードで DAD ファイルを生成する必要があることに注意してください。 これは、XML ファイルの設定エディターから正しいエンコード値を選択することで 可能になります。
全幅のアルファベットおよび数字を使用した名前を含むデータベース・テーブルから XML スキーマを生成すると、タスク・ビューにエラーが表示されます。DBCS 文字を含むデータベース・テーブルおよび列名は使用しないことをお薦めします。
XML ファイルに適用する XSL スタイルシートに無限ループがあると、以下のようなエラー・メッセージを受け取る場合があります。
Xalan dies with a java.lang.StackOverflowError,
most likely due to deep recursion.スタイルシートを修正してから変換を再実行してください。 スタイルシートを修正しないですぐに変換を再実行すると、 別のエラー・メッセージを受け取ります。仮想マシンの別の場所でメモリー・エラーが発生した可能性があります。 この場合、WebSphere Studio をクローズして再始動し、XSL スタイルシートを修正して問題を解決してください。
XSL ファイルを DTD または XSD ファイルを含む XML ファイルに対して適用する際、 XSL デバッガーをローカルの XSL プロセスで起動すると、XML カタログに含まれるすべての設定が維持されます。
XSL ファイルが外部の Java Bean を呼び出し、XSL デバッガーをリモート XSL プロセスで起動する必要がある場合、XML カタログでの URI からキーへのマッピングは維持されることはなく java.io.FileNotFound 例外を受け取ります。
これを回避するには、XML ファイルを変更して、含まれている DTD または XSD が直接 (つまり、XML カタログを通さずに) 検出されるようにしてください。
データがすでに XML ファイルに保管されているとき、ユーザーは「XHTML から XML データを抽出」オプションを選択せずに、「XHTML テンプレートのための XSL」ウィザードを呼び出します。
現在の制限のため、ウィザードで生成された dataLogic ファイルを手作業で編集して、 変換の対象であるその XML ファイルに固有のデータ関連ロジックを指定しなければなりません。 サンプルの dataLogic ファイルは「XSL からの XML および HTML」のサンプル・プロジェクトに含まれています。
データ関連のロジック・ファイルを手作業で編集しない場合は、XSL ファイルはデータを何も含まないスケルトン HTML ファイルを作成します。
編集対象のファイルの内容がディスク上で変更されたときにプロンプトで表示される再ロード・オプションは、何も行いません。 これは特にチーム・サポートにとっては注意すべき点です。 ユーザーがファイルをチェックアウトし、ファイルのコンテンツがエディターのものと異なっているとき、 エディターは再ロードするようプロンプトを出します。ただし再ロードしても何も起きません。 この場合には、RMX セッションまたは XMX セッションをクローズしてから再オープンし、新たにチェックアウトされたファイルを編集してください。
XML パーサーは、解決できない URI (例: DOCTYPE 宣言の中など) があると、致命的入出力エラーを報告して、その後の処理を停止します。 未解決の URI は、構文エラーやセマンティック・エラーとしては表示されないため、パーサーは処理を行いません。 原則的には、文書は未検査のままになります。
Java Bean XML/XSL クライアント・ウィザードでは、Bean に同じパラメーター名を持つメソッドがあると、入力フォームのフィールドも同じ名前で生成されます。
この問題に対しては、メソッド・パラメーターの名前を変更して、Bean の生成に使用するメソッドのパラメーターに名前の重複が ないようにしてください。
ヘブライ語またはアラビア語のエレメントを含む DTD ファイルから XML スキーマを生成したり、 ヘブライ語またはアラビア語のエレメントを含む XML スキーマから DTD を生成したりする場合、特定のエレメント名が、 対応する 16 進数のヘブライ語とアラビア語のエンコード値でエンコードされる場合があります。 この問題を避けるには、 生成を実行する前に、元の DTD または XML スキーマ・ファイルのエンコード方式属性を UTF-8 に変更してください。つまり、XML 宣言は以下のようになります。
<?xml version="1.0" encoding="UTF-8"?>
影響されるエンコード値は以下のとおりです。
- ISO-8859-8-I
- ISO-8859-8
- Windows-1256
- ISO-8859-6
XSL デバッグ・パースペクティブの「XSL 変換出力 (XSL Transform output)」ビューには、 リモート・アプリケーション上で起動された XSL 変換のトレース時の出力は表示されません。
XML スキーマのターゲット・ネーム・スペースを変更する場合には、接頭部 Q1 の新規ネーム・スペースが作成されます。 これを避けるには、最初にグローバル要素およびタイプを文書の先頭に移動します (実際にそれらが参照される前に移動します)。 次に、ターゲットのネーム・スペースの変更を適用してください。
XML エディターでは、ペイントの問題、または最新表示の問題が発生することがあります。
Linux で XSL デバッグおよび変換ウィザードを使用して、「XSL ランチャーの選択 (Select XSL Launcher)」ページで「リモート XSL アプリケーション (Remote XSL application)」を選択すると、javaw エラーが発生する場合があります。
さらに、XML ディジタル・シグニチャーを作成しようとすると、keytool エラーが 発生することがあります。
これらのエラーのいずれかを回避するには、PATH 環境変数に JAVA_HOME\bin へのパスを追加する必要があります。このパスは、「ウィンドウ (Windows)」>「設定 (Preferences)」>「インストール済み JRE 設定 (Installed JRE preferences)」で指定したデフォルト JRE から取り込みます (例えば、WS_installdir\eclipse\jre\bin です)。
XSL エディターのポップアップ・メニューから「ブレークポイントを使用可能に する (Enable Breakpoint)」および「ブレークポイントを使用不可にする (Disable Breakpoint)」を選択できますが、XSL デバッガーではブレークポイントの使用可能/使用 不可フラグは無視されます。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.