WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

アプリケーションまたはライブラリーへのプロジェクトの変換

既存のプロジェクトをアプリケーションまたはライブラリーに変換するために、2 つのオプションを使用できます。 「単一プロジェクトの変換」は、参照のないプロジェクトを変換する場合に使用します。 「複数プロジェクトの分析および変換」は、1 つ以上のプロジェクト、および任意の参照されるリソースを変換する場合に使用します。

始める前に:
アプリケーションまたはライブラリーに変換できるのは、メッセージ・ブローカー・プロジェクト、Java™ プロジェクト、メッセージ・セット・プロジェクト、および PHP プロジェクトです。 例えば、以下のシチュエーションでプロジェクトを変換するとします。
  • 旧バージョンの WebSphere Message Broker の既存のプロジェクトをインポートしました。 そのプロジェクトを新しいアプリケーションの基礎として使用します。 この場合、プロジェクトをアプリケーションに変換してから、ソリューションを完成させるのに必要な残りのリソースを追加できます。
  • 幾つのソリューションで再利用するリソースが含まれるプロジェクトが既に存在しているとします。 プロジェクトをライブラリーに変換し、他の必要なリソースを追加してから、該当するアプリケーションからそのライブラリーを参照します。
  • WebSphere Message Broker の旧バージョンからリソースをインポートして、メッセージ・フロー・プロジェクトを メッセージ・ブローカー・プロジェクトにマイグレーションしました。 プロジェクト (メッセージ・ブローカー・プロジェクト、Java プロジェクト、およびメッセージ・セット・プロジェクトなど) の全部または一部を、自動的にアプリケーションおよびライブラリーに変換できます。

他のリソースへの参照のないプロジェクトを変換する場合、アプリケーションまたはライブラリーへの単純な変換で十分です (アプリケーションまたはライブラリーへの単一プロジェクトの変換を参照)。 インポートされるすべてのプロジェクト、または他のリソースへの参照を含むプロジェクトを変換するために、変換ウィザードが用意されています。このウィザードは、リソースの変換方法を決定するためのルールを使用します。 また、このウィザードは、選択したプロジェクトが参照する関連プロジェクト (Java プロジェクトやメッセージ・セット・プロジェクトなど) も変換します (変換ウィザードを使用した 1 つ以上のプロジェクトの変換を参照)。

アプリケーションまたはライブラリーへの単一プロジェクトの変換

単一プロジェクトをアプリケーションまたはライブラリーに変換する場合、以下の制約事項が適用されます。
  • メッセージ・ブローカー・プロジェクト、Java プロジェクト、メッセージ・セット・プロジェクト、および PHP プロジェクトだけを変換できます。
  • 複数のプロジェクトを選択してアプリケーションまたはライブラリーに変換できますが、一度に複数のメッセージ・ブローカー・プロジェクトを変換することはできません。 複数の メッセージ・ブローカー・プロジェクトを変換するには、変換ウィザードを使用する必要があります。
  • ライブラリーを参照するプロジェクトは変換できません。
  • メッセージ・ブローカー・プロジェクトが別のメッセージ・ブローカー・プロジェクトによって参照されている場合、ライブラリーにのみ変換できます。
  • 「単一プロジェクトの変換」オプションを選択すると、存在しないプロジェクトへの参照の有無の検査などの前提条件検査は行われません。 プロジェクトに他のリソースへの参照が含まれている可能性がある場合は、ウィザードを使用して、すべてのプロジェクトおよびリソースを分析します。 プロジェクトを変換する前に前提条件検査を実行するには、オプションの「複数プロジェクトの分析と変換」を選択します。
前提条件検査を行わずに単一プロジェクトをアプリケーションまたはライブラリーに変換するには、以下の手順を実行します。
  1. 「ブローカー開発」ビューで変換するプロジェクト (複数可) を右クリックし、「アプリケーションまたはライブラリーへの変換」 > 「単一プロジェクトの変換」をクリックします。
  2. 「アプリケーション」または「ライブラリー」のいずれかを選択します。
  3. 「終了」をクリックします。
プロジェクトがアプリケーションまたはライブラリーに変換され、「ブローカー開発」ビューに表示されます。 元のプロジェクトの内容は、新しいアプリケーションまたはライブラリーの下に表示されます。

変換ウィザードを使用した 1 つ以上のプロジェクトの変換

前提条件検査を行った上でプロジェクトをアプリケーションまたはライブラリーに変換するには、以下の手順を実行します。

  1. 「ブローカー開発」ビューで、変換するリソースを選択します。 「独立リソース」フォルダー内で複数のプロジェクトを選択するか、「独立リソース」フォルダーを右クリックしてすべてのプロジェクトを選択することができます。
  2. 「独立リソース」フォルダー、または選択したプロジェクトのいずれかを右クリックして、「アプリケーションまたはライブラリーへの変換」 > 「複数のプロジェクトの分析および変換」をクリックします。 「アプリケーションおよびライブラリーへのプロジェクトの変換」ウィザードが開きます。
  3. 変換可能なプロジェクトがリストされます。 このウィザードでは、ステップ 2 で選択したプロジェクトが事前選択されています。 変換するプロジェクトを選択して「次へ」をクリックします。

    ウィザードで前提条件チェックが完了します。 正常な変換を妨げるエラーが検出される場合は、それらのエラーがリストされます。 例えば、存在しないプロジェクトを参照している場合は、 メッセージ・ブローカー・プロジェクトを変換することはできません。 すべてのエラーが修正されるまで、変換を続行することはできません。

  4. エラーを選択して「選択項目の修正」をクリックします。

    あるいは、「すべて修正」をクリックして、リストされているすべてのエラーを修正できます。 1 つのエラーに対して複数の解決方法がある場合は、開いている「クイック・フィックス」ダイアログ・ボックスで解決方法を選択できます。 修正済みのエラーは、緑のチェック・マークで示されています。

    1 つ以上の修正を適用した後、必要に応じて修正を元に戻すことができます。 「キャンセル」をクリックしてから、前提条件検査中に行われた修正を元に戻すかどうか指定します。

    エラーに修正を適用すると、ウィザードで前提条件チェックが再実行されます。 新しいエラーが発生すると、それらがリストされてエラーを修正できるようになります。

    エラーが存在しない場合は、「次へ」をクリックします。 あるいは、「キャンセル」をクリックし、エラーを手動で修正してからステップ 1 から 3 を繰り返します。

  5. 提案された変換アクションを確認します。

    ウィザードは、必要な変換アクションを分析して、これから行う変更の要約を表示します。 提案された新しいアプリケーションおよびライブラリーが、ツリー形式で表示されます。 アプリケーションまたはライブラリーを展開して、そこで参照されるリソースを確認します。 「変換アクション」ペインに、選択したリソースを変換するために行われる変更がリストされます。

    ウィザードは、以下の規則を適用して、プロジェクトをアプリケーションまたはライブラリーに変換します。
    • 最上位の メッセージ・ブローカー・プロジェクト、または別の メッセージ・ブローカー・プロジェクトによって参照されていない メッセージ・ブローカー・プロジェクトは、アプリケーションに変換されます。
    • 別の メッセージ・ブローカー・プロジェクトによって参照されている メッセージ・ブローカー・プロジェクトは、ライブラリーに変換されます。
    • メッセージ・ブローカー・プロジェクトではない参照先プロジェクトを変換する場合は、ライブラリーに変換されます。ただし、データ設計プロジェクトおよびアダプター接続プロジェクトの場合は除きます。 これらのプロジェクトは変更されず、アプリケーションまたはライブラリーから参照されます。参照先プロジェクトを変換しない場合、参照先プロジェクトは変更されず、参照元プロジェクトは元のプロジェクトを参照します。

      例えば、 メッセージ・ブローカー・プロジェクトは、メッセージ・セットを参照します。 メッセージ・ブローカー・プロジェクトとメッセージ・セット・プロジェクトの両方が変換のために選択されている場合、メッセージ・ブローカー・プロジェクトはアプリケーションに変換され、メッセージ・セット・プロジェクトはライブラリーに変換されます。 ただし、メッセージ・ブローカー・プロジェクトが変換のために選択されている場合で、参照先のメッセージ・セット・プロジェクトが選択されていない場合、メッセージ・ブローカー・プロジェクトはメッセージ・セットを参照するアプリケーションに変換されます。 メッセージ・セットは変換されません。

    • メッセージ・ブローカー・プロジェクトではないプロジェクトで、複数のプロジェクトによって参照されているプロジェクトは、ラッパー・ライブラリーに変換されます。 ラッパー・ライブラリーは、元のプロジェクト (メッセージ・セット・プロジェクトなど) を参照するライブラリーです。 他のプロジェクトからのプロジェクト参照は、このラッパー・ライブラリーを参照するように更新されます。
    • メッセージ・ブローカー・プロジェクトではないスタンドアロン・プロジェクトは、ライブラリーに変換されます。
    • 壊れた参照が含まれている メッセージ・ブローカー・プロジェクトは変換されません。修正できるように、壊れた参照が報告されます。
  6. 変換に対する変更を元に戻すことはできません。 したがって、「エクスポート」をクリックしてワークスペースをバックアップするためのプロンプトが出されます。
  7. 後で参照できるように、「すべての変換アクションをファイルに保存」をクリックして、すべての変換されたプロジェクトの変換アクションを保存できます。 その後、この単一文書を .txt ファイルとして保存できます。
  8. 提案された変更を完了するには、「終了」をクリックします。
選択したプロジェクトと、影響を受ける参照先プロジェクトが、アプリケーションおよびライブラリーに変換され、「ブローカー開発」ビューに表示されます。
次に行う事柄: アプリケーションまたはライブラリーを作成したので、以下のいずれかのタスクに進むことができます。

Java プロジェクトを参照する メッセージ・ブローカー・プロジェクトを変換した場合には、Java プロジェクトをライブラリーに変換して、他のアプリケーションから使用可能にすることができます。 「ブローカー開発」ビューで Java プロジェクトを右クリックして、「新規ライブラリーへのプロジェクトの組み込み」をクリックします。 Java プロジェクト用のライブラリーが作成されて、アプリケーションと Java プロジェクトの間の参照が再作成されます。

またアプリケーションおよびライブラリー間における変換の指示に従って、アプリケーションからライブラリーに、またはライブラリーからアプリケーションに変換できます。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:48:37


タスク・トピックタスク・トピック | バージョン 8.0.0.5 | bc23535_