このセクションでは、HTML Cleanup ツールを適用して設定する方法について説明します。 HTML Cleanup ツールは、入力中の HTML/XHTML のコーディングと構造の問題を特定してレポートします。また、オプションとして、特定した問題を修正してコードを変換するほか、コードを XHTML に変換します。

このセクションの内容:

HTML Cleanup とは

HTML Cleanup ツールは、入力中の HTML/XHTML のコーディングと構造の問題を特定してレポートします。また、特定した問題を修正してコードを変換したり、オプションとしてコードを XHTML に変換したりすることもできます。変換されたコードは、出力として返されます。

デフォルトでは、HTML Cleanup ツールは HTML ファイルをクリーンアップするように設定されています。コードを XHTML に変換したり、HTML フラグメントを処理したり、ASP、JSP、PHP ファイルを処理したい場合、「HTML Cleanup の構成」で説明するように設定を変更することができます。

HTML Cleanup ツールを別のテストに連結すると、Web シナリオのステップ実行中に、発生するブラウザー リクエストに対応することができます。あるいは、設定パネルの [入力] タブで指定したファイルやテキストに対して、HTML Cleanup ツールをスタンドアロンのテストとして使用できます。

HTML Cleanup ツールは 4.01 の HTML 文字エンティティをサポートします。

テスト スイート ツールとして HTML Cleanup ツールを使用すると、機能テスト シナリオの一部として、HTML の問題を特定してクリーンアップすることができます。静的解析の最中に HTML の問題を特定するには、Cleanup HTML カテゴリの "Check HTML Well-Formedness" ルールを使用します。このルールには、HTML Cleanup ツールと同じカスタマイズ オプションがあります。なお、静的解析オプションを指定した場合、問題を修正して任意に XHTML にコードを転換することでコードを変換できないので注意してください。

HTML Cleanup の設定

次のオプションを設定できます。

  • 通知メッセージを表示: デフォルトのツール設定では、このオプションは、クリーンアップ時に実施された変更を SOAtest がレポートするかどうかを指定します。"変換されたソース" 出力を Edit ツールに送らないように HTML Cleanup の設定を変更した場合、このオプションは、目的の変換を行うために必要な変更を SOAtest がレポートするかどうかを指定します。メッセージは結果ウィンドウにレポートされ、[ウィンドウ] メニューからアクセスすることができます。

  • ASP、JSP、PHP ファイルを処理: 利用可能な ASP、JSP、および PHP ファイルに対して、指定されたターゲット アクションの実行を試みるかどうかを指定します。なお、このオプションが有効な場合、SOAtest はそれらのファイル中の ASP <% ...%>、JSP <% ...%>、および PHP <? ...?> タグを無視するほか、HTML 属性や属性値を動的に生成する JSP スクリプトレットとカスタム アクションを無視するので注意してください。

  • 埋め込みスクリプトおよびスタイルを保持する: 特別な文字が入っているものも含めて、すべてのスクリプトとスタイルを外部ファイルに抽出するかどうかを指定します。

  • ターゲット文書タイプ: 実行するクリーンアップのタイプとレベルを設定します。利用できるオプションについては、「ターゲット文書タイプのカスタマイズ」を参照してください。

  • XML 宣言の追加: 変換されたソースの先頭に XML 宣言 (<?xml version="1.0"?>) を追加するかどうかを指定します。このオプションは XHTML (DTD) モードでだけ利用できます。

  • DOCTYPE 宣言の ID を変更: 文書にすでに DOCTYPE 宣言がある場合、DOCTYPE 宣言の ID を置き換えるかどうかを指定します。あるいは、文書に DOCTYPE 宣言がない場合、DOCTYPE 宣言と ID を追加するかどうかを指定します。このオプションは XHTML (DTD) モードでだけ利用できます。

ターゲット文書タイプのカスタマイズ

設定パネルの [ターゲット文書タイプ] フィールドでオプションを変更することで、HTML Cleanup で実行するクリーンアップのタイプとレベルを設定できます。

利用できるモードは、以下の表のとおりです。

オプション説明例

HTML フラグメント

HTML フラグメントをクリーンアップしますが、XHTML への変換は実行しません。このモードでは、SOAtest は以下の処理を行います。

  • 足りない終了タグを追加し、足りない終了タグが未知のタグに追加されたかどうかをレポートします。
  • 属性のデフォルト値を設定します (つまり、デフォルトが "true" の属性)。
  • 属性値を引用符で囲みます。
  • 数値を必要とする属性に、数値以外の値が設定されていないかをチェックします。
  • 孤立した終了タグを削除します。このモードでは、SOAtest は一般的な構造の問題には対処しません。

注意

これがデフォルト モードです。

<html>
hello world
<table WIDTH=20>

は以下に変換されます。

<html>

hello world

<table WIDTH="20"></table></html>

HTML ドキュメント

完全な HTML 文書をクリーンアップしますが、XHTML への変換は実行しません。このモードでは、SOAtest は以下の処理を行います。

  • "HTML フラグメント" モードのすべてのアクションを実行します。
  • 標準的な HTML の要件を確実にファイルが満たすようにすることによって、全般的なドキュメント構造に関する問題を修正します。
  • ドキュメント は次の要素を必要とします: <HTML> <HEAD> <TITLE> </TITLE> </HEAD> <BODY> </BODY> </HTML>
  • フレームセットは次の要素を必要とします: <HTML> <HEAD> <TITLE> </TITLE> </HEAD> <FRAMESET> </FRAMESET> </HTML>

<html>
hello world
<table WIDTH=20>

は以下に変換されます。

<html><head><title></title></head><body>
hello world
<table WIDTH="20"></table></body></html>

XHTML フラグメント

HTML フラグメントをクリーンアップし、XHTML に変換します。このモードでは、SOAtest は以下の処理を行います。

  • "HTML フラグメント" モードのすべてのアクションを実行します。
  • 必要な場合、埋め込まれたスクリプトとスタイル シートを外部ファイルに移動します。
  • さまざまなタグに対して欠けている属性を追加します (たとえば、IMG タグの src 属性を追加します)。
  • すべての属性が小文字であることを保証します。

<html>
hello world
<table WIDTH=20>

は以下に変換されます。

<html>
hello world
<table width="20"> </table></html>

XHTML (DTD)

HTML 文書をクリーンアップし、XHTML に変換します。このモードでは、SOAtest は以下の処理を行います。

  • "XHTML フラグメント" および "HTML ドキュメント" モードのすべてのアクションを実行します。
  • デフォルトの DTD (W3C の XTML Transitional DTD) または DTD の [パブリック ID] と [システム ID] フィールドで指定した DTD に準拠する XHTML へ文書の変換を試みます。
  • DOCTYPE 宣言を追加します。
  • [XML 宣言の追加] オプションが有効な場合、変換されたソースの先頭に XML 宣言 (<?xml version="1.0"?>) を追加します。

<html>

hello world

は以下に変換されます。

<?xml version="1.0"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html><head><title />
</head><body>
hello world
<table width="20">
</table></body></html>

変換されたファイルの保存


Cleanup HTML ツールで変換したファイルを保存したい場合、以下のように Write File ツールの出力を追加します。

  1. テスト ケース エクスプローラーで HTML Cleanup ツールのノードを右クリックし、ショートカット メニューから [出力の追加] を選択します。[出力の追加] ダイアログが表示されます。



  2. 左側のリストから [変換されたソース] を選択し、右側のリストから [Write File] を選択して [完了] をクリックします。[変換されたソース] > [Write File] ノードが [HTML Cleanup] ノードに追加されます。
  3. (オプション)「Write File」で説明するように、Write File ツールをカスタマイズします。
  • No labels

Need assistance? Visit our support page