ビジネス・オブジェクトの使用

26 ビジネス・オブジェクトの使用

ビジネス・オブジェクトを作成して、データ・ソースから取得した属性とメソッドをフィルタリングし、データ・ビジュアライゼーションを使用して、取得したデータをポータル・ページにレンダリングします。

権限:

この章のタスクを実行するには、次のいずれかのポータル・レベルの権限が必要です。

Assets: Create, Edit, and Delete Assets、またはCreate AssetsおよびEdit Assets (標準権限)
Application Integration Visualization: Manage Application Integration Visualization (アドバンスト権限)

トピック:

26.1 ビジネス・オブジェクトについて

WebCenter Portalでは、ビジネス・オブジェクトを使用してRESTまたはSQLのデータ・ソースからデータを取得することにより、アプリケーション統合の複雑さを軽減できます。取得されたデータは、データ・ビジュアライゼーションでビジュアライゼーション・テンプレートを使用して、ポータル・ページにレンダリングできます。たとえば、いずれかの組込みビジュアライゼーション・テンプレートでデータを表示したり、開発者がJDeveloperでカスタム・ビジュアライゼーション・テンプレートを作成することができます。

これを実現するための基本ステップは、次のとおりです。

データ・ソースを作成します。ページに表示するデータの取得元となるRESTまたはSQLのデータ・ソースを作成します(「RESTデータ・ソースの作成」および「SQLデータ・ソースの作成」を参照)。
(オプション)ビジネス・オブジェクトを作成します。データ・ソースから取得された属性およびメソッドをフィルタリングする必要がある場合は、ビジネス・オブジェクトを作成します(「ビジネス・オブジェクトの作成」を参照)。独自のビジネス・オブジェクトを作成しない場合は、データ・ビジュアライゼーションの定義ウィザードでデータ・ソースが選択されたときに自動的にビジネス・オブジェクトが1つ作成され、そのデータ・ソースのすべての属性およびメソッドがそのビジネス・オブジェクトに追加されます。手動で作成したビジネス・オブジェクトは、ポータルの「アセット」ページおよびデータ・ビジュアライゼーションの定義ウィザードにリストされますが、自動的に作成されたビジネス・オブジェクトは内部的なもので、一切公開されません。
ビジュアライゼーション・テンプレートを決定します。組込みビジュアライゼーション・テンプレートのいずれかを使用できるか(「組込みビジュアライゼーション・テンプレートについて」を参照)、または開発者と連携してカスタム・ビジュアライゼーション・テンプレートを作成する必要があるかを決定します。ポータルにアップロードされたカスタム・ビジュアライゼーション・テンプレートは、ポータルの「アセット」ページに表示されます。これをすべてのポータルで使用できる共有アセットとして使用可能にすることもできます。
データ・ビジュアライゼーションを構成します。ページにデーダ・ビジュアライゼーション・コンポーネント(データ・プレゼンタのビジュアライゼーション)を追加した後、コンポーネントを構成して、ページでレンダリングするデータ・ビジュアライゼーションを定義します(「データ・ビジュアライゼーションの構成」を参照)。

ビジネス・オブジェクトの主な機能は、ポータル・ページ上に表示するデータのソースを単純化することです。データ・ソースが複雑ではない場合、ビジネス・オブジェクトは、データ・ソースがデータ・ビジュアライゼーションの定義ウィザードで選択されたときに、WebCenter Portalによって自動的に作成されます。自動的に作成されたビジネス・オブジェクトの場合、そのデータ・ソースのすべての属性とメソッドがビジネス・オブジェクトに追加されます。この場合、各属性および各メソッドの表示名と説明を構成することはできません。通常、上級ユーザーは、データ・ビジュアライゼーションの構築に関連する制限された属性セットを使用して、ポータル・アセットとしてビジネス・オブジェクトを手動で作成します。ビジネス・オブジェクトはポータル・レベルでのみ(ポータル・アセットとして)作成でき、アプリケーション・レベルで(共有アセットとして)作成することはできません。

ビジネス・オブジェクトでは、複数のスカラー属性およびコレクション属性を公開できます。RESTでは、基礎となるRESTデータ・ソースからのサポートに基づいて、GET、PUT、POST、DELETEなどの複数のメソッドをサポートできます。各ビジネス・オブジェクトには対応するデータ・サービスへの参照が含まれ、データ・サービスには、バックエンド・データ・ソースにアクセスするための実際のモデルを提供する、基礎となるデータ・コントロールへの参照が含まれます。

デフォルトでは、ビジネスオブジェクトは存在しません。ビジネス・オブジェクトはポータル・レベルでのみ(ポータル・アセットとして)作成でき、アプリケーション・レベルで(共有アセットとして)作成することはできません。

26.2 ビジネス・オブジェクトの作成

ビジネス・オブジェクトを作成する前に、「ビジネス・オブジェクトについて」を参照してください。

データ・ソースからのすべての属性とメソッドを含む自動で作成されたビジネス・オブジェクトを使用することも、指定するデータのみを取得するビジネス・オブジェクトを手動で作成することもできます。データ・ソースに複数の階層レベルおよび様々なレベルのデータが含まれている場合、1つのレベルのみを選択してビジュアライゼーションを作成できます。たとえば、データ・ソースから2つのイテレータ(電話番号などの繰返しデータ)が戻される場合、ビジネス・オブジェクトに両方のイテレータを含めることができますが、データ・ビジュアライゼーションでは、最初のイテレータのみが使用されます。両方のイテレータを使用する必要がある場合は、2つの個別のビジネス・オブジェクトを作成する必要があります。手動で作成されたビジネス・オブジェクトは、単純であると考えられます。

ビジネス・オブジェクトは特定のポータルに関連付けられているため、ポータル・レベルでのみ(ポータル・アセットとして)作成でき、アプリケーション・レベルで(共有アセットとして)作成することはできません。データ・ソースから取得した属性とメソッドをフィルタリングするためにビジネス・オブジェクトを作成する場合、最初から作成することも、既存のビジネス・オブジェクトのコピーを作成して編集することもできます。新しいビジネス・オブジェクトを最初から作成するには、この項内のステップに従います。既存のビジネス・オブジェクトをコピーして新しいコピーを編集するには、次の項を参照してください。

ビジネス・オブジェクトを作成するには:

ビジネス・オブジェクトを作成するポータルの「アセット」ページに移動します。

詳細は、「ポータル・アセットへのアクセス」を参照してください。
左側のペインで、「統合」の下の「ビジネス・オブジェクト」をクリックします。
ツールバーで「作成」をクリックし(図26-1)、新規ビジネス・オブジェクトの作成ウィザードを開いて、ビジネス・オブジェクトに含めるデータ要素を定義します。

図26-1 ビジネス・オブジェクトの作成

「図26-1 ビジネス・オブジェクトの作成」の説明
「名前」フィールドに、ビジネス・オブジェクトの名前を入力します。

ビジネス・オブジェクトを選択すると、名前がリストに表示されます。

ノート:
ビジネス・オブジェクト名には、予約語Business Objectを含めることはできません。

図26-2 新規ビジネス・オブジェクトの作成ウィザード
(オプション)「説明」フィールドに、ビジネス・オブジェクトの説明を入力します。

この説明は、「アセット」ページ内の名前の下に表示されます。ユーザーがこの特定のビジネス・オブジェクトを使用するかどうかを判断する際に説明が役立つことを確認します。
「データ・ソース」タブで、データ・ソースを定義してビジネス・オブジェクトのデータを取得します。

ノート:

既存のRESTデータ・ソースを選択する必要があり、かつ、基礎となるデータが変更されたことがわかっている場合は、データ・ソースを編集するために、ウィザードを終了してポータルの「アセット」ページに移動でき、ここで、「スキーマのリフレッシュ」を選択して、属性の追加、削除、名前変更などの変更が加えられたデータ・ソースおよびビジネス・オブジェクトをリフレッシュできます。より重大な構造上の変更を行う場合は、データ・ソースと、それが使用されるすべてのデータ・ビジュアライゼーションを再作成する必要があります。
1. 「タイプ」リストから、ビジネス・オブジェクトのデータ取得元となるデータ・ソースのタイプ(RESTまたはSQL)を選択します。
  生成されるリストには、選択したタイプのポータル・アセットであるすべてのデータ・ソースが示されます。
2. データ・ソースの生成されたリストから、必要なデータ・ソースを選択します。
3. 「メソッド」リストから、データを取得するために使用するメソッド(GETなど)を選択します。
4. 生成されたメソッドのリストで、メソッドの「展開」アイコンをクリックして、選択したデータ・ソースに関連付けられている属性を表示し、チェック・ボックスを選択してビジネス・オブジェクトに必要な各属性を選択します。すべてのチェック・ボックスを選択解除するには、「子の選択解除」アイコンをクリックします。
  
  図26-3 新規ビジネス・オブジェクトの作成: 属性
「構成」タブで、次の手順を実行します。
1. メソッドまたは属性の横にある「編集」アイコンをクリックして、データ・ソースから取得されたソースの名前または説明を変更します。
2. メソッドまたは属性の横にある「削除」アイコンをクリックして、ビジネス・オブジェクトによって取得するデータからそれらを削除します。
パラメータが存在する場合は、「パラメータ」タブで「編集」をクリックし、パラメータの名前や値を変更します。

リストされているパラメータは、データ・ソースから取得されたものです。たとえば、バインド変数を含む問合せを使用してSQLデータ・ソースを作成すると、すべてのバインド変数がパラメータとして表示されます。同様に、RESTデータ・ソースの場合、パラメータはリソースURL (http://example.com/stocks?symbol=ORCLなどで、この場合symbolはパラメータです)で指定されます。ビジネス・オブジェクト内のパラメータ名は、構文paramName_methodの形式で表記されています。たとえば、前述のRESTデータ・ソースの例を使用すると、デフォルト・ビジネス・オブジェクトのパラメータ名はsymbol_GETとなります。必要に応じて、パラメータの名前を変更できます。
「プレビュー」タブで「テスト」をクリックし、選択に基づいたデータ・ソースから取得されたデータをプレビューします。
「保存」をクリックします。

新規作成されたビジネス・オブジェクトが、「アセット」ページにリストされます。「使用可能」列のチェック・ボックスはデフォルトで選択されています。これは、このビジネス・オブジェクトが公開され、ユーザーがデータ・ビジュアライゼーションへのバインドにこのビジネス・オブジェクトを使用できることを示しています。

データ・ビジュアライゼーションの構成を参照してください。

図26-4 「アセット」ページでの新規ビジネス・オブジェクト

26.3 ビジネス・オブジェクトの編集

ビジネス・オブジェクトを編集して、その構成設定を変更できます。

ビジネス・オブジェクトを編集するには:

ビジネス・オブジェクトを所有するポータルの「アセット」ページに移動します。詳細は、「ポータル・アセットへのアクセス」を参照してください。
左側のペインで、「統合」の下の「ビジネス・オブジェクト」をクリックします。
編集するビジネス・オブジェクトの「アクション」列で、「編集」クイック・リンク(図26-5)をクリックし、ビジネス・オブジェクトの編集ウィザードを開きます。

図26-5 ビジネス・オブジェクト・アセットの編集
ビジネス・オブジェクトの編集ウィザード(図26-6)で、「名前」と「説明」や「データ・ソース」、「構成」および「パラメータ」の各タブでの設定について必要な変更を行います。設定の詳細は、「ビジネス・オブジェクトの作成」を参照してください。

図26-6 ビジネス・オブジェクトの編集ウィザード
「保存」をクリックしてビジネス・オブジェクトへの変更を保存し、ウィザードを閉じます。

26.4 ビジネス・オブジェクトの管理

次のオプションは、アセット・ページに表示され、ビジネス・オブジェクトの管理に使用できます。