データ・ビジュアライゼーションの使用

23 データ・ビジュアライゼーションの使用

ビジュアライゼーション・テンプレートを使用してデータ・ビジュアライゼーションを作成、構成および管理し、取得されたデータを視覚的に表示します。

権限:

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

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

ノート:

SQLデータ・ソースでは、データ視覚化を使用してデータを表示、更新または挿入する場合に必要なデータベース権限は、データベースの表のデータを表示、更新または挿入する場合に必要な権限と同じです。このような権限には、CONNECT、SELECT、CREATE INDEXTYPE、CREATE SEQUENCE、CREATE SESSION、CREATE TABLEなどがあります。視覚化の表示および更新には、少なくともCONNECT、RESOURCE、CREATE SESSIONおよびCREATE TABLE権限が必要ですが、ユーザー固有の使用例に応じて、追加権限が必要になる場合があります。

トピック:

23.1 データ・ビジュアライゼーションについて

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

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

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

デフォルトでは、データ・ビジュアライゼーションは存在しません。データ・ビジュアライゼーションはポータル・レベルで(ポータル・アセットとして)のみ作成でき、アプリケーション・レベルで(共有アセットとして)は作成できません。

23.2 データ・ビジュアライゼーションのポータル・ページへの追加

ページにデータ・ビジュアライゼーションを追加するには、まずデフォルトのアプリケーション統合のビジュアライゼーション・コンポーネントをページに追加します。その後、このコンポーネントを構成して、必要な固有のデータ・ビジュアライゼーションを作成できます。詳細は、「データ・ビジュアライゼーションについて」を参照してください。

データ・ビジュアライゼーションをポータル・ページに追加するには:

ページ・エディタで、データを表示するページを開きます。

詳細は、「ページ・エディタでのページのオープン」を参照してください。
ページ内のデータ・ビジュアライゼーションを追加する領域で「コンテンツの追加」をクリックして、リソース・カタログを開きます。
リソース・カタログで、「データ・プレゼンタのビジュアライゼーション」を見つけて選択し、アプリケーション統合のビジュアライゼーション・コンポーネントをページに追加します(図23-1)。

ヒント:

リソース・カタログのアプリケーション統合のビジュアライゼーション・コンポーネントの場所は、ページで使用されているリソース・カタログによって異なります。たとえば、デフォルト・ポータル・カタログでは、アプリケーション統合のビジュアライゼーション・コンポーネントは「アプリケーション統合」フォルダにあります。

図23-1 新しいアプリケーション統合のビジュアライゼーション・コンポーネント

新しいデータ・ビジュアライゼーションがポータルの「アセット」ページに表示されますが、それを「アセット」ページから編集、コピー、削除することはできません。データ・ビジュアライゼーションを変更するには、ページを編集して、アプリケーション統合のビジュアライゼーション・コンポーネントに対して「構成」をクリックします。
「データ・ビジュアライゼーションの構成」に説明されているように、データ・ビジュアライゼーションを構成して、ビジネス・オブジェクトによって取得されるデータをビジュアライゼーション・テンプレートに表示する固有のデータ・ビジュアライゼーションを作成します。

23.3 データ・ビジュアライゼーションの構成

ページにデータ・ビジュアライゼーションを追加した後、データ・ビジュアライゼーションを構成して、データ・ソースから取得されたデータをビジュアライゼーション・テンプレートに表示できます。

ノート:

カスタム・ビジュアライゼーション・テンプレート、またはデータ・ビジュアライゼーションで選択されたデータ・ソースから取得されたデータの構造を変更した場合、ページで変更の結果が正常に生成されるように、新しいデータ・ビジュアライゼーションを構成する必要があります。

新しいデータ・ビジュアライゼーションまたは既存のデータ・ビジュアライゼーションを構成するには:

データ・ビジュアライゼーションを含むページをページ・エディタで開きます。

詳細は、「ページ・エディタでのページのオープン」を参照してください。
ページでデータ・ビジュアライゼーションを選択して、「構成」(図23-2および図23-3)をクリックし、データ・ビジュアライゼーションの定義ウィザードを開きます(図23-4)。

図23-2 データ・ビジュアライゼーションの構成: 新規

図23-3 データ・ビジュアライゼーションの構成: 既存

図23-4 データ・ビジュアライゼーションの定義ウィザード
次のように、「データ・ソース」ページで、既存のSQLデータ・ソースまたはRESTデータ・ソースを選択して次のステップに進むか、オプションが限られた新しいRESTデータ・ソースを作成します。
ノート:
- データ・ビジュアライゼーションの定義ウィザードは、基本的なRESTデータ・ソースの作成と編集をサポートします。より多くのオプションを持つRESTデータ・ソースが必要な場合は、「RESTデータ・ソースの作成」を参照してください。データ・ソースを作成した後は、データ・ビジュアライゼーションの定義ウィザードでそれを選択できます。
- 既存のRESTデータ・ソースを選択する必要があり、かつ、基礎となるデータが変更されたことがわかっている場合は、データ・ソースを編集するために、ウィザードを終了してポータルの「アセット」ページに移動でき、ここで、「スキーマのリフレッシュ」を選択して、属性の追加、削除、名前変更などの変更が加えられたデータ・ソースおよび関連するビジネス・オブジェクトをリフレッシュできます。より重大な構造上の変更を行う場合は、データ・ソースと、それが使用されるすべてのデータ・ビジュアライゼーションを再作成する必要があります。
1. 既存のデータ・ソースの行内のアイコンをクリックしてデータ・ソースをコピーまたは編集するか、「データソースの追加」をクリックして新しいRESTデータ・ソースを作成します。
2. データ・ソース・ウィザードの「ソース」ページで、RESTデータ・ソースの「名前」とオプションの「説明」を入力します。
  
  図23-5 データ・ソース・ウィザード: 「ソース」ページ
3. RESTデータ・ソースが作成される場所の有効なURLを「リソース・パス」に入力して、「テスト」をクリックし、リソース・パスが有効でデータが返されることを確認します。たとえば、リソース・パスhttp://dev.markitondemand.com/Api/v2/Quote?symbol=AAPLでは、株価が提供されます。
  
  ノート:
  リソース・パスは、少なくともGETメソッドを、他のメソッド(PUT、POST、DELETE)とともにサポートする必要があります。
4. 指定したリソース・パスに基づいて内容が移入された「パラメータ」のリストで、必要に応じてパラメータを削除または追加します。
  
  ノート:
  「リソース・パス」のURLを変更すると、パラメータのリストがリフレッシュされ、必要なデータ・ソースのパラメータを再度指定する必要がある場合があります。
5. 「データ・ソースの戻りタイプ」でいずれかを選択し、「リソース・パス」のURLによって返されるデータ型を指定します。URLによって返されるデータは、XML形式またはJSON形式にすることができます。
6. 必要に応じて、「ポータル・プロキシの使用」および「認証を使用する」を選択または選択解除します。外部URLの場合は、「ポータル・プロキシの使用」を選択します。
7. 「次へ」をクリックします。
8. 「認証を使用する」を選択した場合は、次の操作を実行します。
  - 「認証」ページで、既存の資格証明を選択するか、「資格証明の追加」をクリックして、新しい資格証明を作成します(新しい資格証明を作成するために必要な権限が付与されている場合)。
  - 「資格証明」ページで、「セキュリティ・タイプの選択」リストから選択します。
    - 基本認証: サポートは、WebCenter Portalの外部アプリケーション・サービスを介して提供されます。RESTサービスのユーザー名とパスワードは、外部アプリケーション・サービスを使用して、OPSS資格証明ストアに格納されます。実行時にデータ・ビジュアライゼーションがレンダリングされる場合、WebCenter Portalによってこれらの資格証明が取得されて、ページにデータが表示されます。
    - OAuth: サポートは、RESTデータ・コントロールと統合されたOWSMによって提供されます。ADF RESTデータ・コントロールは、IDM OAuthサーバーを使用するOAuth 2.0のみをサポートします。IDM以外のソリューションを使用して保護される外部RESTサービスはサポートされません。
    - Taleoトークン・ジェネレータ: カスタム・セキュリティ・プロバイダによって認証が提供され、実行時にセキュリティが伝播されます。認証に成功した場合、Taleoトークンが発行されます。データを取得するために、このトークンがそれ以降の各リソース・リクエストに渡される必要があります。
    図23-6 データ・ソース・ウィザード: 「資格証明」ページ
  - 「構成」で、セキュリティ・タイプに応じてログイン情報を定義または編集します。
    - 「基本認証」の場合は、「ログイン」にユーザー名を入力し、「パスワード」を入力します。
    - 「OAuth」の場合は、OAuthサーバーで構成されたクライアントIDとパスワードに対応するように、ログイン・ユーザー名を入力し、パスワードを入力し、OAuthサーバーのトークン・ジェネレータURLを入力します。
    - 「Taleoトークン・ジェネレータ」の場合は、「ログイン」にユーザー名を入力し、「パスワード」を入力し、Taleoエンド・ポイントにアクセスするために、「ログインURL」と「組織コード」を入力します。ユーザーは、定義されたログインURLで、ユーザー名、パスワードおよび組織コード(会社ID)を使用して認証される必要があります。
「次へ」をクリックして「テンプレート」ページを表示します。

図23-7 データ・ビジュアライゼーションの定義ウィザード: 「テンプレート」ページ
「テンプレート」ページで、次の操作を実行します。
1. データ・ソースから取得されたデータを表示するためのビジュアライゼーション・テンプレート(プレゼンテーション・タイプ)を選択します。
  
  表示されるテンプレートは、現在選択されているデータ・ソースに適したものです。リソース・パスのURLを指定すると、WebCenter Portalにより、URLによって返されるデータに基づいてデータ・ソースが作成されます。このとき、(パラメータ値によって、または現在使用できるデータが限られているために) URLによって単一レコードのみが返される場合、WebCenter Portalでは、常に単一レコードが返されるという前提でデータ・ソースを作成します。この場合、フォーム・テンプレートが単一データ・レコードの表示に適しているため、このテンプレートのみが選択肢としてウィザードに表示されます。表テンプレートまたはリスト・テンプレートはデータのレコードの繰返しに適しているため、これらのテンプレートは選択肢として表示されません。データ・ソースによって取得されたデータが繰り返される可能性があることがわかっており、かつ、リスト・テンプレートまたは表テンプレートを選択する必要がある場合は、データ・ソースが作成されるときに、指定したリソース・パスのURLによって繰返しデータが返される必要があります。または、「アセット」ページでデータ・ソースを作成して、繰返しデータを含むレスポンス・ペイロードを指定できます。その後、ここでそのデータ・ソースを選択すると、リストと表を含むすべての適切なテンプレートが選択肢としてウィザードに表示されます。
  
  図23-7は、組込みテンプレートと、Partner Detailsという名前の1つのカスタム・テンプレートを示しています。組込みのビジュアライゼーション・テンプレートの詳細は、「組込みビジュアライゼーション・テンプレートについて」を参照してください。「ビジュアライゼーション・テンプレートの作成または編集」で説明されているように、カスタム・ビジュアライゼーション・テンプレートはJDeveloperで開発されて、ポータルにアップロードされます
  
  ノート:
  ページ・エディタでデータ・ビジュアライゼーションを構成している間に公開された、カスタム・ビジュアライゼーション・テンプレートを選択すると、エラーが発生する場合があります。期待される結果を実現するには、カスタム・ビジュアライゼーション・テンプレートが公開されるまで、ページ・エディタを開始しないでください。
2. 「次」をクリックして、「設定」と「パラメータ」の2つのタブを持つ、選択したテンプレートの「オプション」ページを表示します。

「設定」タブで、選択したテンプレートに応じて、ページの取得されたデータのビジュアライゼーションに追加する要素を選択および設定します。

表23-1に、組込みおよびカスタムのビジュアライゼーション・テンプレートで使用可能な要素を示します。

表23-1 ビジュアライゼーション・テンプレートの設定

テンプレート	「設定」ページ	設定
面グラフ		グラフ・タイトル「主要な縦軸」および「主要な横軸」「Y軸タイトル」および「X軸タイトル」ズームの有効化凡例の位置凡例タイトル
棒グラフ		グラフ・タイトル「主要な縦軸」および「主要な横軸」「Y軸タイトル」および「X軸タイトル」ズームの有効化凡例の位置凡例タイトル
フォーム		ナビゲーション・コントロールを含めるヘッダーの追加アクションのリフレッシュ表示フィールド名属性(使用可能なビジネス・オブジェクトおよびデータ・ソースの属性) 出力形式(次のステップを参照)
折れ線グラフ		グラフ・タイトル「主要な縦軸」および「主要な横軸」「Y軸タイトル」および「X軸タイトル」ズームの有効化凡例の位置凡例タイトル
リスト・ビュー		フェッチ・サイズ表示列名属性(使用可能なビジネス・オブジェクトおよびデータ・ソースの属性) 出力形式(次のステップを参照)
円グラフ		グラフ・タイトル円 3D効果の有効化ソートの有効化スライスチャートの脚注凡例の位置凡例タイトル
表	ノート: フィルタの有効化を選択した場合は、ビュー・モードでデータをフィルタ処理できます。編集モードのフィルタリングでは、期待した結果が生成されません。	ヘッダー行の表示フィルタの表示ソートの有効化ツールバーの有効化ヘッダーの追加アクションのリフレッシュページ区切りの有効化ページ当たりのアイテム数表示列名属性(使用可能なビジネス・オブジェクトおよびデータ・ソースの属性) 出力形式(次のステップを参照)
カスタム・テンプレートの例		カスタム・テンプレートに固有

取得したデータに対して「出力形式」を定義するテンプレートでは、データ・アイテムの現在の出力形式(「一般」など)をクリックして、「format列」ダイアログを開きます。
必要に応じて、「一般」、「通貨」、「パーセンテージ」、「数値」、「リンク」から選択して、データ・アイテムの形式を指定します。
ノート:
- 「リンク」の場合、URLを完全なURL (http://で始まる)またはポータルのWebアドレスとの相対URLにする必要があります。
- 表のビジュアライゼーションでは、列のフィルタリングはサポートされていません。SQL問合せで、タイムスタンプを含むデータベース列からデータを選択する場合、次の例のように、SQLデータ・ソースを作成するときにSQL問合せでデータベース列を日付形式に変換する必要があります。
```
TO_DATE(TO_CHAR(date_timestamp_column,'MM/dd/yyyy'),'MM/dd/yyyy') 
```
図23-8 「format列」ダイアログ
「パラメータ」タブで、次を定義します。
- ビジュアライゼーション・パラメータ: ページに他のコンポーネントからの入力を取得するため
- データソース・パラメータ: データ・ソースからデータを取得するため
このタブを使用すると、ビジュアライゼーション・パラメータ値をデータ・ソース・パラメータに渡すことができます。これにより、視覚化間で値の受渡しが可能になるマスター/ディテール関係が構築され、この値は、バックエンド・データ問合せを実行するために、データ・ソース・パラメータを介してデータ・ソースに渡されます。ビジュアライゼーション・パラメータを作成または削除することもできます。新しいデータ・ビジュアライゼーションには、パラメータはありません。
図23-9 データ・ビジュアライゼーションの定義ウィザード: オプション・ページ(「パラメータ」タブ)
「保存」をクリックします。
新しいデータ・ビジュアライゼーションがページに追加され、選択したデータ・ソースから取得されたデータが選択したビジュアライゼーション・テンプレートに表示されます。
図23-10に、リスト・ビューと円グラフの組込みテンプレートの例を示します。

図23-10 ポータル・ページでのデータ・ビジュアライゼーション

23.4 データ・ビジュアライゼーションの削除

データ・ビジュアライゼーションを削除するには:

データ・ビジュアライゼーションを含むページをページ・エディタで開きます。

詳細は、「ページ・エディタでのページのオープン」を参照してください。
ページでデータ・ビジュアライゼーションを選択して、「アクション・メニューの表示」をクリックし、「削除」を選択します(図23-11)。

図23-11 データ・ビジュアライゼーションの削除

23.5 データ・ビジュアライゼーションの管理

「アセット」ページには、データ・ビジュアライゼーションを管理するための限られたオプションが用意されています。「アセット」ページからデータ・ビジュアライゼーションを編集、コピー、削除することはできません。データ・ビジュアライゼーションを変更するには、ページを編集して、データ・プレゼンタのビジュアライゼーション・コンポーネントに対して「構成」をクリックします(「データ・ビジュアライゼーションの構成」を参照)。

23.6 データ・ビジュアライゼーションのトラブルシューティング

データ・ビジュアライゼーションの使用中に、要求どおりにデータがレンダリングされない場合、様々な問題のトラブルシューティングが必要になることがあります。

リスト・ビュー・テンプレートでテキストの位置がそろわない

スペースのない長いテキスト値を持つ列を選択するSQLデータ・ソースを使用する場合、出力が折り返されず、正しく整列されずに表示されます

解決策: ソース・データにスペースを追加します。

テンプレートまたはデータの変更がデータ・ビジュアライゼーションに表示されない

カスタム・ビジュアライゼーション・テンプレート、またはデータ・ビジュアライゼーションで選択されたデータ・ソースから取得されたデータの構造を変更した場合、この変更によってデータ・ビジュアライゼーションが自動的に更新されることはありません。

解決策: 更新されたテンプレートまたはデータ・ソースを選択して、新しいデータ・ビジュアライゼーションを構成します。

RESTデータ・ソースの変更がデータ・ビジュアライゼーションに表示されない

RESTデータ・ソースで選択された基礎となるデータが変更された場合、ページのデータ・ビジュアライゼーションで変更が反映されません。

解決策: RESTデータ・ソースで選択されたデータに対する変更でデータ・ビジュアライゼーションを更新するには、ウィザードを終了して、データ・ソースを編集するためにポータルの「アセット」ページに移動し(「RESTデータ・ソースの編集」を参照)、ここで「スキーマのリフレッシュ」を選択して、データ・ソースおよび関連するビジネス・オブジェクトを、追加、削除または名前変更した属性などの変更でリフレッシュできます。より重大な構造上の変更を行う場合は、データ・ソースと、それが使用されるすべてのデータ・ビジュアライゼーションを再作成する必要があります。

リソース・パスのURLの変更後にパラメータが失われる

データ・ビジュアライゼーションの定義ウィザードでリソース・パスのURLを変更すると、データ・ソースのパラメータのリストがリフレッシュされ、以前に指定したパラメータが失われます。

解決策: データ・ビジュアライゼーションの定義ウィザードで必要なデータ・ソースのパラメータを再度指定します。

選択肢として予期されるビジュアライゼーション・テンプレートが表示されない

データ・ビジュアライゼーションの定義ウィザードで選択可能なテンプレートに、表やリストなどの一部の予期されるテンプレートが含まれません。

説明: リソース・パスのURLを指定すると、WebCenter Portalにより、URLによって返されるデータに基づいてデータ・ソースが作成されます。このとき、(パラメータ値によって、または現在使用できるデータが限られているために) URLによって単一レコードのみが返される場合、WebCenter Portalでは、常に単一レコードが返されるという前提でデータ・ソースを作成します。この場合、フォーム・テンプレートが単一データ・レコードの表示に適しているため、このテンプレートのみが選択肢としてウィザードに表示されます。表テンプレートまたはリスト・テンプレートはデータのレコードの繰返しに適しているため、これらのテンプレートは選択肢として表示されません。

解決策: データ・ソースによって取得されるデータが繰り返される可能性があることがわかっており、かつ、リスト・テンプレートまたは表テンプレートを選択する必要がある場合は、データ・ソースが作成されるときに、指定したリソース・パスのURLによって繰返しデータが返される必要があります。または、「アセット」ページでデータ・ソースを作成して(「RESTデータ・ソースの作成」を参照)、繰返しデータを含むレスポンス・ペイロードを指定できます。その後、そのデータ・ソースを選択すると、リストと表を含むすべての適切なテンプレートが選択肢としてウィザードに表示されます。

新しいビジュアライゼーション・テンプレートが選択後に表示されない

ページ・エディタでデータ・ビジュアライゼーションを構成している間に公開された、カスタム・ビジュアライゼーション・テンプレートを選択すると、エラーが発生する場合があります。

解決策: カスタム・ビジュアライゼーション・テンプレートが公開されるまで、ページ・エディタを開始しないでください。

リンクのURLがターゲットにリンクしない

取得したデータに対してリンクの出力形式を定義すると、データ・ビジュアライゼーションでリンクをクリックしたときにそのターゲットが表示されません。

解決策: 完全なURL (http://で始まる)またはポータルのWebアドレスとの相対URLを指定します。