アプリケーション・ディスカバリー・アシスタントを使用したアプリケーションとプロジェクトの作成
AppScan® ソース には、強力な アプリケーション・ディスカバリー・アシスタント が組み込まれています。これを使用すると、Java™ ソース・コードと Microsoft™ Visual Studio ソリューション用のアプリケーションとプロジェクトを迅速に作成、構成できます。アプリケーション・ディスカバリー・アシスタント を使用して、Java™ プロジェクトが含まれている Eclipse ワークスペースを見つけることもできます。アプリケーション・ディスカバリー・アシスタント では、ソース、ソリューション、、またはワークスペース・ディレクトリーをポイントできます。その後の処理は AppScan® ソース によって行われます。
このタスクについて
アプリケーション・ディスカバリー・アシスタント を使用して、Java™ ソース、Microsoft™ Visual Studio ソリューション、または Eclipse の各ワークスペースの組み合わせが含まれているロケーションを検索できます。アプリケーション・ディスカバリー・アシスタント の最終パネルでは、Java™ のみのアプリケーション/プロジェクト構造の設定を指定できます。このパネルには、Microsoft™ Visual Studio ソリューションまたは Eclipse ワークスペースでのアプリケーション・ファイルとプロジェクト・ファイルの配置との関係は一切ありません。アプリケーション・ファイルは自動的にソリューションまたは ワークスペースのルートに配置されます。プロジェクト・ファイルは自動的に個々の ソリューションまたは ワークスペース・プロジェクトのルートに配置されます。
手順
- 以下のアクションのいずれかを実行して、アプリケーション・ディスカバリー・アシスタントを起動します。
- メイン・メニュー・バーから を選択します。
- 「エクスプローラー」ビューの「クイック・スタート」セクションで、「アプリケーションのディスカバー」を選択します。
- 「エクスプローラー」ビューのツールバーで、「アプリケーション・メニューの追加」下矢印ボタンをクリックして、メニューから「アプリケーションのディスカバー」を選択します。
- 「エクスプローラー」ビューで、「すべてのアプリケーション」を右クリックして、メニューから を選択します。
- 「ロケーションの検索」パネルで、スキャン対象のソース・コード、ソリューション、またはワークスペースが格納されている場所を指定します。さらに、アプリケーションのディスカバリーの完了直後にスキャンが開始するように設定できます。
このパネルで、「次へ」をクリックして、アプリケーション・ディスカバリー・アシスタント の追加オプション (外部依存関係の指定、除外ルール、Java™ アプリケーション/プロジェクト構造の設定など) を設定できます。または、「開始」をクリックしてアプリケーション・ディスカバリーを開始できます。「開始」をクリックすると、以下のようになります。
- 外部依存関係の場所は何も設定されません。アプリケーションに外部依存関係がある場合、それらの依存関係が指定されていないと、スキャンに悪影響が及びます。
- すぐに使用可能な除外ルールが使用されます (デフォルトのルールのリストについては、デフォルトのアプリケーション・ディスカバリー・アシスタント除外ルールを参照してください)。
- Java™ ソースを探している場合は、1 つのプロジェクトとアプリケーションが作成されます (検出されたすべてのソース・ルートが 1 つのプロジェクトに入れられます)。
「次へ」をクリックすると、次のステップに進みます。
- 「外部依存関係」パネルで、アプリケーションのそれぞれの外部依存関係のパス (JDK または Web サーバーへのパスなど) を設定します。このパネルでの作業を完了するには、以下の手順に従います。
このパネルで、「次へ」をクリックして、アプリケーション・ディスカバリー・アシスタント の追加オプションを設定できます。または、「開始」をクリックしてアプリケーション・ディスカバリーを開始できます。「開始」をクリックすると、以下のようになります。
- すぐに使用可能な除外ルールが使用されます (デフォルトのルールのリストについては、デフォルトのアプリケーション・ディスカバリー・アシスタント除外ルールを参照してください)。
- Java™ ソースを探している場合は、1 つのプロジェクトとアプリケーションが作成されます (検出されたすべてのソース・ルートが 1 つのプロジェクトに入れられます)。
「次へ」をクリックすると、次のステップに進みます。
- 「除外ルール」パネルで、ファイルおよびディレクトリーをフィルターで除外するためのルールを指定します。ルールを設定するには PERL、Grep、EGrep、または完全一致正規表現を使用します。例えば、temp という名前のディレクトリーを アプリケーション・ディスカバリー 検索から除外する場合は、PERL
.*[\\/]temp
という除外ルールを追加できます。デフォルトで、PERL 正規表現のセットが、一部の共通ディレクトリーを除外するために提供されています (完全なリストについては、デフォルトのアプリケーション・ディスカバリー・アシスタント除外ルールを参照してください)。このリストを変更する場合、または新しいルールを作成する場合は、以下の手順に従います。
重要: 有効な除外ルールは、テーブル内にチェック・マーク付きで示されています。また、無効なルールは赤いX
で示されています。すべてのルールが有効になるまで、アプリケーション・ディスカバリーを開始したり、アプリケーション・ディスカバリー・アシスタントで作業を続行したりすることはできません。この後の手順:
- Java™ ソースのみを検索している場合は、「次へ」をクリックして アプリケーション・ディスカバリー・アシスタント アプリケーション/プロジェクト構造を設定できます。または、「開始」をクリックしてアシスタントを実行できます。
- Microsoft™ Visual Studio ソリューションまたは Eclipse ワークスペースのみを検索する場合、「開始」をクリックしてアシスタントを実行できます。「次へ」をクリックすると、アシスタントが Java™ ソース・ディスカバリーにのみ適用されるパネルに進みます。
「次へ」をクリックすると、次のステップに進みます。
- 「アプリケーションおよびプロジェクトの作成」パネルは、Java™ ソース・ディスカバリーにのみ適用されます。このパネルで、作成するアプリケーションおよびプロジェクトの構造を、以下のように指定します。
- 検出されたすべてのソース・ルートに対して単一のプロジェクトを作成する場合、「プロジェクト」メニューで「単一のプロジェクトを作成」を選択します。これを選択すると、単一のアプリケーションの作成のみを選択できます。
- 検出されたソース・ルートごとに個別のプロジェクトを作成する場合、「プロジェクト」メニューで「検出されたソース・ルートごとにプロジェクトを作成 」を選択します。これを選択すると、1 つのアプリケーションを作成するか、複数のアプリケーションを作成するかを選択できます。作成されるすべてのプロジェクトが含まれる単一のアプリケーションを作成するには、「アプリケーション」メニューで「単一のアプリケーションを作成」を選択します。作成されるプロジェクトごとにアプリケーションを作成するには、「アプリケーション」メニューで「プロジェクトごとにアプリケーションを作成 」を選択します。
さらに、アプリケーションおよびプロジェクト定義ファイルを格納する場所を選択します。
「ファイルを自動的に編成」を選択すると、以下のようになります。
- 単一のプロジェクトを作成する場合、プロジェクト・ファイルおよびアプリケーション・ファイルは検索場所に作成されます。
- 単一のアプリケーションでソース・ルートごとにプロジェクトを作成する場合、ソース・ルートごとのプロジェクト・ファイルはソース・ルートの上にあるディレクトリー内に作成され、アプリケーション・ファイルは検索場所に作成されます。
- ソース・ルートごとにプロジェクトを作成し、プロジェクトごとにアプリケーションを作成する場合、ソース・ルートごとのプロジェクト・ファイルおよびアプリケーション・ファイルはソース・ルートの上にあるディレクトリー内に作成されます。
特定のディレクトリーを指定すると、すべてのアプリケーション・ファイルおよびプロジェクト・ファイルはそのディレクトリー内に作成されます。
- 前のパネルで行った設定のいずれかを変更するには、「戻る」をクリックします。アプリケーション・ディスカバリー の設定が完了したら、「開始」をクリックして、ソース・ルートの検索ロケーションをスキャンします。
タスクの結果
アプリケーション・ディスカバリーでの作業が完了したら、アプリケーション・ディスカバリーの結果として作成された新しいアプリケーションおよびプロジェクトが、「エクスプローラー」ビューに表示され、スキャンの準備が整いました (アプリケーション・ディスカバリーの完了直後にスキャンが開始するように設定している場合は、スキャンが開始します)。
ディスカバリー中に問題が発生すると、アプリケーション・ディスカバリー・アシスタントは、完了時にディスカバリー・レポートを提供します。たとえば、アプリケーションに依存関係があり、その依存関係が「外部依存関係」パネルで指定されていなかった場合、レポートには外部依存関係を解決できないことを通知する警告が表示されます。ディスカバリー・レポート内で、以下の操作を行います。
- 「終了」をクリックしてアプリケーションとプロジェクトを作成します。「警告を無視してスキャンを続行」を選択すると、アプリケーションとプロジェクトが直ちにスキャンされます。
- 「戻る」をクリックして アプリケーション・ディスカバリー・アシスタント の設定を変更するか、アプリケーション・ディスカバリー を再実行します。
- アプリケーションもプロジェクトも作成しないでディスカバリー・レポートを閉じるには、「キャンセル」をクリックします。