| Oracle® Fusion Middleware Oracle SOA SuiteでのSOAアプリケーションの開発 12c (12.1.3) E53007-05 |
|
 前 |
 次 |
/appsフォルダの内容をJARファイルに対してエクスポートとインポートを行う方法、/appsフォルダの内容を別のSOAデザインタイムOracle Metadata Services Repository (MDSリポジトリ)に転送する方法、リリース11g MDSリポジトリをJARファイルにエクスポートする方法、およびSOA-MDS転送ウィザードを使用してデータをSOAデザインタイムMDSリポジトリと共有する方法を含む、共有データをSOAデザインタイムMDSリポジトリで管理する方法について説明します。
この章の内容は次のとおりです。
SOAコンポジット・アプリケーションを作成すると、ファイルベースのSOAデザインタイムMDSリポジトリが自動的に作成されます。MDSリポジトリ名は変更できませんが、既存のファイルベースのリポジトリを指すように変更できます。通常は、バージョン制御システム(MDS)の場所を指します。共有操作はデザインタイム・リポジトリに対して行われます。これらの操作をデータベース・ベースMDSリポジトリに対して実行できません。
Oracle JDeveloperで、SOAデザインタイムMDSリポジトリに対して次の操作を実行できます。
Oracle SOA Suiteによって認識される次のフォルダをSOAデザインタイムMDSリポジトリで参照します。
/apps: Oracle Service Busアーティファクトを含めて、共有データが格納されます。
/appsフォルダや/appsのサブフォルダの下に直接フォルダを作成します。
/appsフォルダの下にあるファイルとサブフォルダを削除します。/appsフォルダ自体は、削除できません。
/appsフォルダの選択内容をJARファイルにエクスポートします。/appsフォルダ自体は、JARファイルに含まれていません。
JARファイルの内容を/appsフォルダの下にインポートします。JARファイルに/appsがルート・フォルダとして含まれていると、デザインタイムMDSリポジトリの/appsフォルダの下に作成されます。これによって、/apps/appsのトップレベル・ディレクトリ構造が用意されます。
あるMDSリポジトリから別のMDSリポジトリに/appsフォルダの内容を転送します。
既存のMDSリポジトリ(たとえば、リリース11gデータベース・ベースのMDSリポジトリ)をJARファイルにエクスポートします。このJARファイルはリリース12cデザインタイムMDSリポジトリにインポートできます。
SOAコンポジット・アプリケーションを作成すると、SOA_DesignTimeRepositoryという名前のファイルベースのSOAデザインタイムMDSリポジトリ接続が自動的に含まれます。デフォルトのディレクトリの場所は$JDEV_USER_DIR/soamdsです。
この接続は次の機能を提供します。
設計時に使用するファイル・ベースMDSリポジトリ。データベース・ベース型デザインタイムMDSリポジトリは、サポートされません。
すべてのMDSリポジトリは参照可能です。
デフォルトのリポジトリ場所は、別のフォルダやバージョン制御の場所を指すように変更できます。
すべてのSOA-MDS操作では、このSOAデザインタイムMDSリポジトリを使用します。
ウィザードにより、このMDSリポジトリで、WSDLやスキーマ・ファイルなどのデザインタイム・アーティファクトをSOAプロジェクトから共有できます。
注意:
共有データをSOAデザインタイムMDSリポジトリに追加して、リポジトリをバージョン制御システムでバックアップする場合、このデータをバージョン制御システムに追加する操作はOracle SOA Suiteでは提供されません。この共有データをバージョン制御システムに追加する必要があります。
adf-config.xmlファイルにSOA-MDSリポジトリ(/appsネームスペース)が事前構成されているリリース11g SOAコンポジット・アプリケーションがある場合、すべての共有および消費操作は、adf-config.xmlに定義されている既存のリポジトリに対して実行されます。
SOAコンポジット・アプリケーションが作成されると、名前がSOA_DesignTimeRepositoryであるデフォルトSOA-MDS接続が自動的に含まれます。SOAデザインタイムMDSリポジトリの/appsフォルダが自動的に作成されます。
注意:
Oracle JDeveloperプロジェクトのファイルがSOA_DesignTimeRepositoryを使用して共有されている場合は、元のファイルがSOAプロジェクトからデフォルトのSOA-MDSリポジトリに移動されます。
デフォルトのSOA-MDSの場所を変更する手順は、次のとおりです。
SOAコンポジット・アプリケーションで自動的に作成される際に名前がSOA_DesignTimeRepositoryであるSOA-MDS接続。
MDSリポジトリの/appsフォルダ。このフォルダは最初は空です。
図3-2に示すように、指定された場所がMDS-SOA接続の編集ダイアログに表示されます。
SOA-MDS転送ウィザードによって、SOAデザインタイムMDSリポジトリとWSDL、XSD、WADLおよびXQueryのファイルを共有できます。これらのファイルは他のSOAコンポジット・アプリケーションと共有できます。
ウィザードでは最初に、現在のアプリケーションのadf-config.xmlファイルで定義された既存のデザインタイムMDSリポジトリとファイルの共有を試行します。MDSリポジトリがadf-config.xmlファイルで定義されていないと、SOA_DesignTimeRepositoryを使用してアーティファクトが共有されます。
注意:
XSD、WSDL、WADLおよびXQueryのファイルのみを共有できます。さらに、これらのファイル・タイプのみがデザインタイムMDSリポジトリからランタイムMDSリポジトリに転送できます。
ネイティブのフォーマット・ビルダー・ウィザードを使用して作成した「アプリケーション」ウィンドウでXSDファイルを右クリックした場合、「SOAデザインタイムMDSリポジトリを使用して共有」オプションは使用できません。
SOAデザインタイムMDSリポジトリとデータを共有する手順は、次のとおりです。
SOA-MDS転送ウィザードの「ようこそ」ページが表示され、選択したファイルがSOAデザインタイムMDSリポジトリに転送されることが示されます。
「依存性」ダイアログが表示されます。
さらに別の依存ファイルも表示できます。たとえば、WSDLファイルを選択したと仮定します。WSDLファイルにはスキーマ・ファイル(潜在的に複数のファイル)に依存性が存在する場合があるので、これらのXSDファイルも表示されます。
緑色のチェック・マークは、ファイルのパスが正しく解決可能であることを示します。
注意:
URLがアクセスできないと、エラー・アイコンが表示されます。たとえば、数個の親レベル(たとえば、../../../)を横断するスキーマに依存性があるWSDLファイルを転送すると仮定します。そのような参照がWSDLに存在する場合、適切なターゲット・フォルダを選択しないと、URLの指す場所が/appsフォルダを超えている場合があり、SOAインフラストラクチャでアクセスできません。エラー・アイコンは、ターゲットURLをアクセスできずに転送を続行できないことを示します、取り消すか、「戻る」をクリックして、異なるターゲット・フォルダを選択する必要があります。つまり、すべてのURLの接続先は、/appsフォルダで始まる必要があります。
ファイル転送は、ターゲットSOAデザインタイムMDSリポジトリの/appsフォルダに関係します。依存ファイルは一般的に同じパラレル・レベルにあります。たとえば、転送用に選択したWSDLファイルがWSDLsフォルダにあり、依存するXSDファイルがSchemasフォルダにあります。「アプリケーション」ウィンドウで、SOAコンポジット・アプリケーションのSOAフォルダの下で両方のフォルダが同じパラレル・レベルにあります。ただし、依存ファイルが異なるレベル(共有するファイルよりも高いレベル)にある場合、ファイルの相対階層を判別する必要があります。たとえば、../../../.xsdの場所にあるXSDファイルをfoo.wsdlが参照する場合、ターゲットのデザインタイムMDSリポジトリにおいてappsの下で3つのサブフォルダを手動で作成し、foo.wsdlを下位のフォルダ・レベルに共有する必要があります。これによって、XSDをappsレベルで共有できます。
SOAデザインタイムMDSリポジトリの/appsフォルダの下でサブフォルダを作成および削除できます。/appsフォルダは削除できません。
SOAデザインタイムMDSリポジトリの/appsフォルダで選択内容をJARファイルにエクスポートできます。/appsフォルダ自体は、JARにエクスポートされません。
/appsフォルダの選択内容をJARファイルにエクスポートするには:
「Jarにエクスポート」ダイアログが表示されます。
表3-1 「Jarにエクスポート」ダイアログ
| フィールド | 説明 |
|---|---|
エクスポートするドキュメントの選択 |
ファイルかフォルダの名前を入力して、「検索」をクリックするか、手動で/appsフォルダを展開して識別し、JARファイルにエクスポートするフォルダとファイルを選択します。 |
選択ドキュメントのプレビュー |
エクスポートする内容のプレビューを選択します。 |
JAR名 |
「参照」をクリックして、選択したフォルダおよびファイルをエクスポートするJARファイルを選択します。 |
「Jarにエクスポート」ダイアログは図3-11のようになります。
SOAデザインタイムやデータベース・ベースのMDSリポジトリの/appsフォルダにJARファイルの内容をインポートできます。/appsがルート・フォルダとして含まれているJARファイルをインポートすると、デザインタイムMDSリポジトリの/appsフォルダの下に作成されます。これによって、/apps/appsのトップレベル・ディレクトリ構造が用意されます。
JARファイルの内容を/appsフォルダにインポートするには:
図3-12に示すように、「Jarからインポート」ダイアログが表示されます。
緑色のチェック・マークは、コンテンツがターゲット・リポジトリに存在しないことを示します。コンテンツがターゲット・リポジトリに存在すると、警告アイコンが表示されます。「インポート」をクリックしてコンテンツを上書きするか、「取消」をクリックしてインポート操作全体を取り消すことを選択できます。特定のファイルを選択的にインポートできません。
図3-13に示すように、インポートされるJARファイルの内容が/appsフォルダの下に表示されます。
あるMDSリポジトリの/appsフォルダの選択内容を別のMDSリポジトリの/appsフォルダに転送できます。転送先となるMDSリポジトリのタイプに制限はありません。たとえば、ファイルベース・リポジトリの選択内容をデータベース・ベースMDSリポジトリに移動できますし、その逆もできます。
注意:
Oracle BPELデザイナ、ヒューマン・タスク・エディタまたはその他のエディタを開いた状態で、/appsフォルダの内容を別のMDSリポジトリに転送しないでください。これを行う場合は、転送完了後にエディタを閉じてから再度開いてください。開いた状態のエディタでは、転送による変更が反映されず、完全に閉じないかぎり同期化されない状態になります。
/appsフォルダの選択内容を別のMDSリポジトリに転送する手順は、次のとおりです。
「SOA-MDSに転送」ダイアログが表示されます。
表3-2 「SOA-MDSに転送」ダイアログ
| フィールド | 説明 |
|---|---|
転送するドキュメントの選択 |
転送する内容を選択します。 |
選択ドキュメントのプレビュー |
転送する内容のプレビューを選択します。 |
ターゲット接続 |
内容の転送先となるMDSリポジトリのSOA-MDS接続を選択します。 |
「SOA-MDSに転送」ダイアログは図3-15のようになります。
リリース12cデザインタイムMDSリポジトリにインポートできるJARファイルにリリース11g MDSリポジトリをエクスポートできます。adf-config.xmlファイルが/appsで更新され、情報が格納されます。/appsが定義されたadf-config.xmlファイルがある(つまり、既存の共有リポジトリがある)場合は、リリース12cのリポジトリもエクスポートできます。
既存のリリース11g MDSリポジトリをJARファイルにエクスポートする手順は、次のとおりです。
「Jarにエクスポート」ダイアログが表示されます。
SOAデザインタイムMDSリポジトリで、ファイルを参照および選択できます。たとえば、「Webサービスの作成」ダイアログからアクセスする「WSDLチューザ」ダイアログには、図3-18に示すとおり、SOAデザインタイムMDSリポジトリの選択項目が含まれます。
「タイプ・チューザ」ダイアログには「最近使用したファイル」フォルダが含まれ、このフォルダの情報はOracle JDeveloperセッションの間保持されます。たとえば、新しいBPELプロセスを作成し、SOAデザインタイムMDSリポジトリのスキーマから入力変数を定義する場合は、一度このスキーマに移動します。同じスキーマから出力変数を定義する場合は、そのスキーマは「最近使用したファイル」フォルダに引き続き表示されています。図3-19に、「最近使用したファイル」フォルダを示します。
