手順 2: Oracle E-Business Suite 成果物のアプリケーション定義ファイルを作成する
完了までの時間: 15 分
目的：Microsoft SharePoint Server のビジネス Data Catalog機能は、基幹業務 (LOB) アプリケーションのデータを公開し、ポータルに組み込みます。 このデータをポータル サイトに組み込むには、Microsoft Office SharePoint Server で使用できるアプリケーション定義ファイルを作成する必要があります。
Microsoft Office SharePoint Server 2007 SDK で使用できるビジネス Data Catalog定義エディター ツールを使用すると、ビジネス Data Catalog用のアプリケーション定義ファイルを作成できます。 このツールでは定義ファイルの XML ファイルが自動的に生成されるため、XML エディターでファイルを手動で作成する必要はありません。
作成する Microsoft Office SharePoint Server アプリケーションの目的は次のとおりです。
従業員名に基づいてビジネス データ リスト Web パーツを使用して、MS_SAMPLE_EMPLOYEE インターフェイス テーブル内の従業員に対してクエリを実行します。
MS_SAMPLE_EMPLOYEE インターフェイス テーブルで Microsoft Office SharePoint Server からフルテキスト検索を実行します。
これらの要件ごとに、ビジネス Data Catalog定義エディター ツールで一連のタスクを完了する必要があります。 このトピックでは、これらのタスクを実行する方法について説明します。
前提条件
ビジネス Data Catalog定義エディターが Microsoft Office SharePoint Server 2007 SDK の一部としてインストールされている必要があります。
「手順 1: Oracle E-Business Adapter を使用して WCF サービスを作成および発行する」の説明に従って WCF サービスを発行します。
WCF LOB サービスに接続し、エンティティを作成する
WCF サービスに接続して、サービスの Web サービス記述言語 (WSDL) を抽出する必要があります。 WSDL から、ビジネス Data Catalog定義エディターによって メソッドが抽出されます。 これらのメソッドを使用して、エンティティを作成できます。 このチュートリアルでは、エンティティが作成されます。
WCF サービスに接続してエンティティを作成するには
ビジネス Data Catalog定義エディターを起動します。 [スタート] メニューの [Microsoft Business Data Catalog 定義エディター] をクリックします。
ツール バーの [ LOB システムの追加] をクリックします。
[LOB システムの追加] ウィンドウで、[ Web サービスに接続] をクリックします。
[ URL ] ボックスに、WCF サービスの URL を入力します。 このチュートリアルでは、URL は次のようになります。
https://<COMPUTER_NAME>:<PORT_NUMBER>/MS_SAMPLE_EMPLOYEE/InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.svcこの URL は、「 手順 1: Oracle E-Business Adapter を使用して WCF サービスを作成および発行する」で説明されているように、WCF サービスが正常に発行されたかどうかをテストするときに使用できます。
[Connect] をクリックします。
WCF アダプター サービス開発ウィザードで選択した操作を表示するには、[ Web メソッドの追加 ] タブをクリックします。次の方法が表示されます: 選択します。
Select メソッドをデザイン サーフェイスにドラッグします。 メソッドをデザイン サーフェイスにドラッグすると、エンティティが作成され、そのエンティティの一部になります。
追加する[OK] をクリックします。
[ LOB システムの名前を入力 します] ダイアログ ボックスで、[ LOB システム名 ] ボックスに名前を入力します。 この例では、 MS_SAMPLE_EMPLOYEE呼び出し、[OK] をクリック します。
ビジネス Data Catalog定義エディターでは、新しく作成されたエンティティが Entity0 として一覧表示されます。 エンティティの名前を Employee に変更します。 エンティティの名前を変更するには、次の手順を実行します。
[MS_SAMPLE_EMPLOYEE] ノードを展開し、[エンティティ] ノードを展開します。
[Entity0] ノードを選択します。
[プロパティ] ウィンドウの [名前] ボックスに「 Employee 」 と 入力します。
メソッドのユーザー名とパスワード ヘッダーを指定する
Oracle E-Business Suite のMS_SAMPLE_EMPLOYEE インターフェイス テーブルに対して Select 操作用の WCF サービスを作成する場合は、「 手順 1: Oracle E-Business Adapter を使用して WCF サービスを作成および発行する」のエンドポイント動作構成の一部として、ユーザー名とパスワード ヘッダーを指定しました。 Select メソッド プロパティには、同じ値を指定する必要があります。
Select メソッドのユーザー名とパスワード ヘッダーを指定するには
[メタデータ オブジェクト] ペインで、[ 従業員 ] ノードを展開し、[メソッド] ノード を 展開します。
[選択] ノードをクリックし、[プロパティ] ウィンドウで [プロパティ] ボックスの省略記号 (...) ボタンをクリックします。
[PropertyView コレクション エディター] ウィンドウで [追加] をクリックし、[プロパティ] ウィンドウで [名前] ボックスに「HttpHeaderUserName」と入力します。 [PropertyValue] ボックスに「MyUserHeader」と入力します。 [種類] ボックスに [System.String] を選択します。
[PropertyView コレクション エディター] ウィンドウで [ 追加] をクリックし、[プロパティ] ウィンドウで [名前] ボックスに 「HttpHeaderPassword 」 と 入力します。 同様に、[PropertyValue] ボックスに「MyPasswordHeader」と入力します。 [種類] ボックスに [System.String] を選択します。
[OK] をクリックします。
シナリオ 1: ビジネス データ リスト Web パーツを使用した従業員のクエリ
ビジネス データ リスト Web パーツから従業員を検索し、従業員名に基づいて使用できるアプリケーション定義ファイルを作成するには、次の一連のタスクを実行する必要があります。
Select メソッドで、フィルターを作成し、FILTER パラメーターにマップします。
Select メソッドの Finder メソッド インスタンスを作成します。 Finder メソッドは、フィルターに基づいてレコードの一覧を取得します。
フィルターを作成し、FILTER パラメーターにマップするには
フィルターを作成します。
[メタデータ オブジェクト] ペインで、[ 従業員 ] ノードを展開し、[メソッド] ノード を 展開します。
Select メソッドを展開し、[フィルター] を右クリックし、[フィルターの追加] をクリックします。
[プロパティ] ウィンドウの [FilterType ] プロパティで、[ 等しい] を選択します。
[プロパティ] ウィンドウの [名前] ボックスに 「EmployeeName 」 と 入力します。
Select メソッドの FILTER パラメーターにフィルターをマップします。
[メタデータ オブジェクト] ペインで、[ 従業員 ] ノードを展開し、[メソッド] ノード を 展開します。
Select メソッドを展開し、[パラメーター] ノードを展開します。
[フィルター] ノードを展開し、2 番目の [フィルター] ノードをクリックします。
[プロパティ] ウィンドウで、FilterDescriptor リストから EmployeeName を選択します。
Select メソッドの Finder メソッド インスタンスを作成するには
[メタデータ オブジェクト] ペインで、[ 従業員 ] ノードを展開し、[メソッド] ノード を 展開します。
[選択] ノードを展開し、[インスタンス] を右クリックし、[メソッド インスタンスの追加] をクリックします。
[メソッド インスタンスの作成] ウィンドウで、[メソッド インスタンスの種類] の [Finder] をクリックします。 [ 戻り値 の 種類][Descriptor] の [戻る] を選択します。
する[OK] をクリックします。
[プロパティ] ウィンドウの [名前] ボックス に「Finder_Instance 」 と 入力します。
シナリオ 2: Microsoft Office SharePoint Server から MS_SAMPLE_EMPLOYEE インターフェイス テーブルを Full-Text 検索する
Microsoft Office SharePoint Server のインターフェイス テーブルでフルテキスト検索を実行するために使用できるアプリケーション定義ファイルMS_SAMPLE_EMPLOYEE作成するには、次の一連のタスクを実行する必要があります。
Select メソッドで識別子を作成し、FILTER パラメーターと従業員名を格納する戻り値にマップします。
Select の Specific Finder メソッド インスタンスを作成します。 Specific Finder メソッドは、識別子 、つまり従業員名に基づいて特定のレコードを検索します。
ID 列挙子メソッド インスタンスを作成します。
識別子を作成し、FILTER パラメーターと従業員名の戻り値にマップするには
Employee エンティティの識別子を作成します。
[メタデータ オブジェクト] ペインで、 Employee ノードを展開します。
[識別子] ノードを右クリックし、[識別子の追加] を選択します。
[プロパティ] ウィンドウの [名前] ボックスに 「EmployeeName 」 と 入力します。
[種類] ボックスに [System.String] を選択します。
する
識別子を Select メソッドの FILTER パラメーターにマップします。
[メタデータ オブジェクト] ペインで、[ 従業員 ] ノードを展開し、[メソッド] ノード を 展開します。
Select メソッドを展開し、[パラメーター] ノードを展開します。
FILTER パラメーターを展開し、2 番目の FILTER ノードをクリックします。
[プロパティ] ウィンドウで、[識別子] の一覧から [EmployeeName[Employee] を選択します。
識別子を従業員名の戻り値にマップします。
[メタデータ オブジェクト] ペインで、[ 従業員 ] ノードを展開し、[メソッド] ノード を 展開します。
Select メソッドを展開し、[パラメーター] ノードを展開します。
Return ノード、2 番目の Return ノード、Item ノードの順に展開し、[名前] ノードをクリックします。
[プロパティ] ウィンドウで、[識別子] の一覧から [EmployeeName[Employee] を選択します。
Select メソッドの Specific Finder メソッド インスタンスを作成するには
[メタデータ オブジェクト] ペインで、[ 従業員 ] ノードを展開し、[ メソッド ] ノードを展開します。
[選択] ノードを展開し、[インスタンス] を右クリックし、[メソッド インスタンスの追加] を選択して [メソッド インスタンスの作成] ウィンドウを開きます。
する[メソッド インスタンスの作成] ウィンドウで、[メソッド インスタンスの種類] に [Specific Finder ] を選択 します。 [ 戻り値 の種類][説明] の [ 戻り値] を選択します。
する[OK] をクリックします。
[プロパティ] ウィンドウで、[名前] ボックス に「SpeciFinder_Instance 」 と 入力します。
Select メソッドの Id 列挙子メソッド インスタンスを作成するには
[メタデータ オブジェクト] ペインで、[ 従業員 ] ノードを展開し、[ メソッド ] ノードを展開します。
[選択] ノードを展開し、[インスタンス] を右クリックし、[メソッド インスタンスの追加] を選択して [メソッド インスタンスの作成] ウィンドウを開きます。
する[メソッド インスタンスの作成] ウィンドウで、[メソッド インスタンスの種類] の [Id 列挙子] を選択します。 [ 戻り値 の種類][説明] の [ 戻り値] を選択します。
[OK] をクリックします。
[プロパティ] ウィンドウで、[名前] ボックス に「IDEnumerator_Instance 」 と 入力します。
メソッド インスタンスの既定のパラメーターを設定する
Select メソッドでは、列名を指定する必要があります。 そのため、前に作成した Finder、Specific Finder、Id Enumerator メソッド インスタンスの COLUMN_NAMES パラメーターに既定値を指定する必要があります。 さらに、ID 列挙子メソッド インスタンスの FILTER パラメーターの既定値も指定する必要があります。
メソッド インスタンスの既定のパラメーターを設定するには
[メタデータ オブジェクト] ペインで、[ 従業員 ] ノードを展開し、[メソッド] ノード を 展開します。
[選択] ノードを展開し、[パラメーター] ノードを展開します。
COLUMN_NAMES ノードを展開し、COLUMN_NAMES パラメーターを選択します。
[プロパティ] ウィンドウで、[ DefaultValues ] ボックスに対する省略記号ボタン (...) をクリックします。
[DefaultValueView コレクション エディター] ダイアログ ボックスで、[追加] をクリックし、プロパティ ウィンドウの [SelectMethodInstance] ボックスの一覧の [Finder_Instance] をクリックします。
[値] ボックスに「」と入力
*します。同様に、手順 5 と 6 を繰り返して、 SpecificFinder_Instance および IDEnumerator_Instance メソッド インスタンスの既定値を追加します。
[ DefaultValueView コレクション エディター ] ダイアログ ボックスで、[ OK] をクリックします。
次に、IDEnumerator_Instance メソッド インスタンスの FILTER パラメーターの既定値を追加します。 FILTER ノードを展開し、FILTER パラメーターを選択します。
[プロパティ] ウィンドウで、[ DefaultValues ] ボックスに対する省略記号ボタン (...) をクリックします。
[DefaultValueView コレクション エディター] ダイアログ ボックスで、[追加] をクリックし、プロパティ ウィンドウの [SelectMethodInstance] ボックスの一覧の [IDEnumerator_Instance] をクリックします。
[値] ボックスに「」と入力
%します。
[ DefaultValueView コレクション エディター ] ダイアログ ボックスで、[ OK] をクリックします。
Oracle E-Business Suite に接続するためのシングル Sign-On を設定する
このトピックのすべての手順を完了すると、SharePoint アプリケーションにインポートできるアプリケーション定義ファイルが作成されます。 アプリケーションから メソッドを呼び出して、Oracle E-Business Suite から関連データを取得します。 これを有効にするには、Oracle E-Business Suite のユーザーと SharePoint アプリケーションのユーザーとの間にマッピングを作成する必要があります。 このマッピングは、アプリケーション定義ファイルをインポートした後、SharePoint サーバーの全体管理コンソールで作成します。
ただし、マッピングを作成するには、ビジネス Data Catalog定義エディターで SecondarySsoApplicationId プロパティを設定する必要があります。
SecondarySsoApplicationId プロパティを設定するには
[メタデータ オブジェクト] ペインで、[ MS_SAMPLE_EMPLOYEE ] ノードを展開し、[ インスタンス ] ノードを展開します。
[MS_SAMPLE_EMPLOYEE_Instance] をクリックし、[プロパティ] ウィンドウの [プロパティ] ボックスに対する省略記号 (...) ボタンをクリックします。
[PropertyView コレクション エディター] ダイアログ ボックスで、[追加] をクリックし、[プロパティ] ウィンドウで[名前] ボックスに「SecondarySsoApplicationId」と入力します。 同様に、PropertyValue ボックスに「OracleSSO」と入力します。 [種類] ボックスに [System.String] を選択します。
[OK] をクリックします。
アプリケーション定義をファイルにエクスポートする
これで、Oracle E-Business Suite インスタンス メタデータを含むアプリケーション定義が作成されました。 この定義は、Microsoft Office SharePoint Server にインポートできる XML ファイルにエクスポートする必要があります。
アプリケーション定義をファイルにエクスポートするには
[メタデータ オブジェクト] ペインで、[ MS_SAMPLE_EMPLOYEE ] ノードを右クリックし、[ エクスポート] をクリックします。
ファイルを Employee.xml として保存します。
次の手順
ここで、Oracle E-Business Suite からデータを取得する SharePoint アプリケーションを作成する必要があります。 手順については、「 手順 3: Oracle E-Business Suite からデータを取得する SharePoint アプリケーションを作成する」を参照してください。