| Oracle® Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイド 11g リリース1(11.1.1.7.0) B72923-01 |
|
 前 |
 次 |
| Oracle® Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイド 11g リリース1(11.1.1.7.0) B72923-01 |
|
前 |
次 |
この章では、OmniPortletの概要およびOmniPortletに関連付けられたユーザー・インタフェース要素について説明します。この章の内容は次のとおりです。
OmniPortletのトラブルシューティングの詳細は、第30.5項「OmniPortletのトラブルシューティング」を参照してください。
対象読者
この章は、OmniPortletについて理解し、その機能の使用方法を学ぶ必要のあるユーザーを対象としています。実行時にOracle WebCenter Portal: SpacesでOmniPortletをカスタマイズする方法、さらにOmniPortletに関する問題のトラブルシューティングについて説明します。
OmniPortletとは、開発者がコードを記述せずに、様々なレイアウトを使用して様々なデータ・ソースのデータを公開できるようにするOracle WebCenter Portal: Frameworkのサブコンポーネントです。OmniPortletでは、Webサービス、SQLデータベース、スプレッドシート(つまり、文字で区切られた値を含むファイル)、XML、既存のWebページのアプリケーション・データなどのほとんどすべての種類のデータ・ソースをベースにできます。
|
注意: データソースがスプレッドシートの場合、スプレッドシートのセキュリティを解除するか、HTTP認証のみを要求する必要があります。SSO認証はサポートされません。 |
また、OmniPortletを使用すると、開発者が次のことができるようになります。
表示するデータのソート
カスタマイズされたものを含む、様々なレイアウトを使用したデータのフォーマット
ポートレット・パラメータの使用
ページ・ビューアへのパーソナライズ可能な設定の公開
パーソナライズされたデータを表示するには、データ・ソースから戻される結果を絞り込み、セキュアなデータにアクセスするための資格証明情報をパラメータ化します。デフォルトのOmniPortletでは、ポートレットの最も一般的なレイアウト(表形式、チャート、ニュース、箇条書きリスト、フォーム、HTMLおよびパラメータ・フォーム)が提供されます。
|
注意: 様々なタイプのポートレットの開発、プロデューサおよび他のポートレット技術の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』を参照してください。 ページへのOmniPortletのインスタンスの追加の詳細は、第30.2.1項「ページへのOmniPortletインスタンスの追加」を参照してください。 |
この項の内容は次のとおりです。
OmniPortletのインスタンスをページに追加する手順は、Oracle WebCenter Portal: Frameworkを使用して作成したアプリケーションと、Oracle WebCenter Portal: Spacesアプリケーションを使用して作成したアプリケーションとでは異なります。たとえば、Frameworkアプリケーションでは、ページへのポートレットの追加はアプリケーション開発者が実行する設計時のアクティビティです。FrameworkアプリケーションにおけるOmniPortletのページへの追加の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のOmniPortletを使用したポートレットの作成に関する章を参照してください。
Spacesでは、実行時(アプリケーションを実行しているとき)に、ポートレットをページに追加します。十分な権限を持っているすべてのユーザーが、Composerの「カタログ」からポートレットをドラッグ・アンド・ドロップできます。Spacesでのポートレットのページへの追加の詳細は、第18.5項「ページへのコンポーネントの追加」を参照してください。
|
注意: Spacesでは、ポートレットを移動可能ボックス・コンポーネントに追加しないでください(詳細は、第19.10項「移動可能ボックス・コンポーネントの使用」を参照してください)。移動可能ボックス・コンポーネントは、ポートレットにデフォルトで用意されている |
OmniPortletのインスタンスをページに追加する際は、ポートレットの「コンポーネント・プロパティ」ダイアログにアクセスし、RenderPortletInIFrameプロパティがtrueに設定されていることを確認します。これにより、OmniPortletはビュー・モードで独自のインライン・フレーム(iframe)に表示されます。
「コンポーネント・プロパティ」ダイアログの詳細は、第30.4項「OmniPortletプロパティの設定」を参照してください。
OmniPortletのインスタンスをページに追加した後に、「カスタマイズ」リンクをクリックしてOmniPortletウィザードを起動します。
OmniPortletウィザードは、最初、5つの手順で構成されています。
データ・ソース・タイプを選択します。
データ・ソースを識別します。
|
注意: データソースがスプレッドシートの場合、スプレッドシートのセキュリティを解除するか、HTTP認証のみを要求する必要があります。SSO認証はサポートされません。 |
フィルタリング・オプションを設定します。
ビュー・オプションを設定します。
レイアウト・オプションを設定します。
これらの手順が終了したら、完了です。最初の値を変更する場合は、ポートレットの「操作」メニューから「カスタマイズ」オプションを選択することで、ウィザードに再度入力できます。OmniPortletを設定する場合に行った手順を示すタブが表示されます。データ・タイプは変更できませんが、「ソース」、「フィルタ」、「ビュー」および「レイアウト」タブの値は変更できます。
表30-1に、OmniPortletインスタンスを構成するための手順/タブの概要を示します。
表30-1 OmniPortletウィザードおよび「カスタマイズ」モード
| 手順/タブ | 説明 |
|---|---|
|
タイプ |
データ・ソース・オプションを提供します。ポートレットの初期定義のみに表示され、ポートレットのデフォルトをカスタマイズする場合に使用できません。詳細は、第30.2.3項「データソース・タイプの選択」を参照してください。 |
|
ソース |
使用するWebサービスのURLなど、データソース接続を構成するためのオプションを提供します。ポートレットのデフォルトを編集する場合、後でこれらのオプションを変更できます。詳細は、第30.2.4項「データソースの識別」を参照してください。 |
|
フィルタ |
結果を絞り込むことができるようにFrameworkアプリケーション・レベルでソート・オプションを提供します。ポートレットのデフォルトを編集する場合、後でこれらのオプションを変更できます。詳細は、第30.2.5項「フィルタリング・オプションの設定」を参照してください。 |
|
表示 |
ポートレット・ヘッダー、フッター・テキスト、レイアウト・スタイルおよびキャッシングを表示するためのオプションを提供します。ポートレットのデフォルトを編集する場合、後でこれらのオプションを変更できます。詳細は、第30.2.5項「フィルタリング・オプションの設定」を参照してください。 |
|
レイアウト |
データ・ソースから取得されたコンテンツのレイアウトをカスタマイズするための詳細オプションを提供します。ポートレットのデフォルトを編集する場合、後でこれらのオプションを変更できます。詳細は、第30.2.7項「レイアウト・オプションの設定」を参照してください。 |
|
注意: IBM Linux on Powerプラットフォームでは、OmniPortletを定義するときにアクション・ボタン(「次へ」、「前へ」、「終了」、「取消」)が点に最小化された場合、スタック・サイズ・シェル制限を無制限に増やし、oc4j_portletインスタンスを再起動します。次のコマンドを実行して、スタック・サイズ・シェル制限を無制限に設定します。 |
次の各項では、OmniPortletウィザードの別の手順/タブの詳細を説明します。
OmniPortletを初めて起動する場合、「タイプ」ステップが表示されます(図30-1)。
「タイプ」ステップを使用して、OmniPortletインスタンスに表示されるデータのタイプを指定します。表30-2に、OmniPortletがデフォルトでサポートするデータ型を示します。
表30-2 OmniPortletでサポートされるデータソース・タイプ
| データソース・タイプ | 説明 |
|---|---|
|
スプレッドシート |
文字で区切られた値(CSV)を含むテキスト・ファイルのデータを表示します。 注意: データソースがスプレッドシートの場合、スプレッドシートのセキュリティを解除するか、HTTP認証のみを要求する必要があります。SSO認証はサポートされません。 |
|
SQL |
SQLを使用したデータベースのデータを表示します。 |
|
XML |
XMLファイルのデータを表示します。 |
|
Webサービス |
標準プロトコルを使用してインターネット上でアクセスできる個別のビジネス・サービスのデータを表示します。 |
|
Webページ |
既存のWebコンテンツに基づいてデータを表示します。 |
OmniPortletウィザードを完了した後は、データソース・タイプを変更できません。
データ型を選択したら、データソースを識別する準備が整います。「ソース」タブは、手順1で選択したデータ・タイプに基づいて表示されます。つまり、「ソース」タブに表示されるオプションは、選択したデータ・タイプに応じて異なります。
また、OmniPortletプロデューサが認証の必要なプロキシ・サーバーを使用するように構成されている場合、「ソース」タブには、データ・ソースに接続するために必要な情報を指定できる「プロキシ認証」セクションおよび「接続」セクションが含まれます。
この項では、選択したデータ型に固有の設定など、すべての「ソース」タブに共通の設定について説明します。内容は次のとおりです。
OmniPortletプロデューサがログイン証明を必要とするプロキシ認証を使用するように設計時に設定された場合、この情報を入力できる「プロキシ認証」セクションが「ソース」タブに表示されます。
OmniPortletのプロキシ認証のサポートには、グローバル・プロキシ認証および各ユーザーの認証のサポートが含まれます。これはつまり、OmniPortletインスタンスのログイン・シナリオを指定できるということです。
すべてのユーザーは、指定したユーザー名とパスワードを使用して自動的にログインします。
各ユーザーは、個別のユーザー名とパスワードを使用してログインします。
すべてのユーザーは、指定した同じユーザー名とパスワードを使用してログインします。
「プロキシ認証」セクションは、次のデータ・タイプの場合と、固有のデータ・ソースでアクセスするためにプロキシ・サーバーが必要な場合のみ表示されます。
CSV(文字で区切られた値)
XML
Webページ
|
注意: OmniPortletプロデューサの構成は、Frameworkアプリケーションに適用可能なデザインタイム・アクティビティです。プロキシ認証を使用するようにOmniPortletプロデューサを構成する方法の詳細は、「Edit Producers: OmniPortlet Producer」ページの「ヘルプ」をクリックしたときに表示されるWebCenter Portal: Frameworkのオンライン・ヘルプ・トピックを参照してください。 すべてのユーザーにログインを要求するようにOmniPortletプロデューサを構成する場合は、次のように各ユーザーが実行時に独自のプロキシ・ログイン情報を設定する必要があります。
「カスタマイズ: ソース」タブにアクセスするには、ポートレットの「操作」メニューの「カスタマイズ」リンクをクリックします。「パーソナライズ」ページにアクセスするには、ポートレットの「操作」メニューの「パーソナライズ」リンクをクリックします。 Webページ・データソースを使用する場合は、「ソース」タブの「Webページの選択」ボタンをクリックすると、Web Clipping Studioに「プロキシ認証」セクションが表示されます。 Web Clipping Studioの詳細は、第31章「Webクリッピング・ポートレットの使用」を参照してください。 |
Webページ・データ・ソース以外の各データ・ソースで、「ソース」ステップに、セキュアなデータにアクセスするための接続情報を定義できる「接続」セクションが含まれています。すべてのデータソースの「ソース」ステップに、ポートレット・パラメータを定義できる「ポートレット・パラメータ」セクションが含まれています(図30-2)。
|
注意: 「ユーザー名」、「パスワード」または「接続文字列」に |
ポートレット・パラメータを定義した後に、それらをページ・パラメータにマップできます。詳細は、第30.3項「OmniPortletパラメータの使用」および第22章「ページ、タスク・フロー、ポートレットおよびUIコンポーネントの結付け」を参照してください。
接続情報を編集するには、「接続の編集」ボタンをクリックして「接続情報」ページを開きます(図30-3)。
「接続情報」ページに、接続情報の名前、ユーザー名およびパスワードを入力できます。SQLデータ・ソースの場合、データ・ソースに接続するためのドライバを指定する情報も入力できます。詳細は、第30.2.4.4項「SQL」を参照してください。
|
注意: 「接続情報」ページの詳細は、OmniPortletウィザードの「ソース」タブの「ヘルプ」をクリックします。 |
スプレッドシートは、小規模なデータ・セットを格納するための一般的な方法です。OmniPortletを使用すると、文字で区切られた値(CSV)をデータ・ソースとしてサポートし、スプレッドシートを共有できます。「ソース」タブを使用して、CSVファイルの場所を指定します(図30-4)。
セキュア・サーバーにファイルが格納されている場合、図30-3に示されている「接続情報」セクションで接続情報を指定できます。WebCenter Portalがファイルを読み取るときに使用するキャラクタ・セット、デリミタおよびテキスト修飾子も選択できます。
|
注意:
|
リレーショナル・データベースは、データを格納するための最も一般的な場所です。OmniPortletを使用すると、標準のJDBCドライバを使用して、Oracleおよび他のすべてのJDBCデータベースにデフォルトでアクセスできます。接続情報を構成するときにドライバ・タイプを指定できます。
図30-5に、SQLデータソースの「ソース」タブを示します。
DataDirect JDBCドライバを使用して、他のリレーショナル・データベースにアクセスできます。そのためには、ドライバを認識するようにOmniPortletを構成する必要があります。これは、通常アプリケーション開発者によって実行される設計時のアクティビティです。
|
注意: DataDirectドライバを使用するためのOmniPortletの構成の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』付録Eの追加のポートレット構成に関する項を参照してください。 DataDirectドライバの詳細は、Oracle Technology Network (OTN) ( |
ドライバがインストールされると、「接続情報」ページの「ドライバ名」ドロップダウン・リストにドライバが表示されます(図30-6)。
DataDirectドライバの接続文字列を入力するときに、host_name:portという構文を使用して「接続文字列」フィールドに値を入力する必要があることに留意してください。host_nameは、データベースが実行されているサーバーの名前です。portは、データベースのリスニング・ポートです。
イントラネットまたはインターネットにまたがるXMLデータ・ソースにアクセスできます。「ソース」タブで、データを含むXMLファイルのURLを指定できます(図30-7)。
「XML URL」および「XSL Filter URL」フィールドの横にある「テスト」ボタンを使用して、XMLデータ・ソースおよびXSLフィルタを検証します。
指定したXMLファイルを表形式(ROWSET/ROW)構造にするか、またはデータをROWSET/ROW構造に変換するXMLスタイル・シート(XSL)を指定できます。例30-1に、XMLデータソースのROWSET/ROW構造を示します。
例30-1 XMLデータソースのROWSET/ROW構造
<TEAM>
<EMPLOYEE>
<DEPTNO>10</DEPTNO>
<ENAME>KING</ENAME>
<JOB>PRESIDENT</JOB>
<SAL>5000</SAL>
</EMPLOYEE>
<DEPTNO>20</DEPTNO>
<ENAME>SCOTT</ENAME>
<JOB>ANALYST</JOB>
<SAL>3000</SAL>
<EMPLOYEE>
</TEAM>
例30-1で、<TEAM>タグはrowsetを示し、<EMPLOYEE>タグは行を示します。
XMLファイルの形式にかかわらず、OmniPortletはXMLを調べて、レイアウトを定義するために使用される列名を自動的に決定します。この情報を指定する場合は、データを示すXMLスキーマにURLを指定できます。
XMLファイルがHTTP Basic認証で保護されたセキュアなサーバーに格納されている場合は、「接続情報」ページに接続情報を指定できます。
|
注意: OmniPortletプロデューサは、Frameworkアプリケーションと異なる層に存在し実行され、セッション情報にアクセスできないため、OmniPortletがXMLファイルにアクセスできるようにPUBLICとして公開する必要があります。 |
Webサービスとは、SOAPやHTTPなどの標準プロトコルを使用してインターネット経由でプログラムによりアクセスできる個々のビジネス・サービスです。Webサービスはプラットフォームまたは言語のいずれにも固有でなく、通常はWebサービス・ブローカに登録されます。使用するWebサービスを検索する場合は、Webサービス記述言語(WSDL)ファイルへのURLを取得する必要があります。WSDLファイルにはWebサービスが記述され、予期されるパラメータなど、コールできるメソッドが指定されます。また、戻されたデータも記述されます。
OmniPortletでは、DocumentとRemote Procedure Call (RPC)という両方のタイプのWebサービスがサポートされています。WSDLドキュメント/ファイルが提供されると、解析され、コールできるメソッドのうち使用可能なメソッドが「ソース」タブに表示されます。
XMLデータソースと同様に、XSLファイルを使用してデータを変換することもできますが、OmniPortletではROWSET/ROW形式のWebサービス・データが要求されます。戻されるデータ・セットを示すXMLスキーマを指定することもできますが、OmniPortletはWSDLドキュメント/ファイルを調べて列名を決定します。
図30-8に、Webサービスの例の「ソース」タブを示します。
|
注意: Webクリッピング・ポートレットは、リリース11g (11.1.1.7.0)では使用しないでください。Oracle WebCenter Portalのページレット・プロデューサのページレット・プロデューサを使用してクリッパ・ページレットを使用することを検討してください。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のOracle WebCenter Portalのページレット・プロデューサの管理に関する章を参照してください。 |
OmniPortletを使用すると、既存のWebコンテンツをデータソースとして使用できます。Web ClippingポートレットのWeb Clipping Studioを統合すると、OmniPortletインスタンスのコンテキスト内でWebコンテンツのクリッピングとレンダリングができるようになります。
OmniPortletのWebページ・データ・ソースにより、Web Clippingポートレットによって提供される範囲がスクラップ機能を含むように拡張されます。その他の機能は次のとおりです。
様々なログイン・メカニズムを介した移動(フォームベースおよびJavaScriptベースの送信、Cookieベースのセッション管理を含むHTTP Basic認証およびDigest認証など)。
クリッピングのファジー・マッチング 「ソース」ページのWebクリッピングの順序が変更されたり、文字のフォント、サイズまたはスタイルが変更されても、引き続きWebページ・データソースによって正しく識別され、ポートレット・コンテンツとして提供されます。
様々なWebコンテンツの再利用(HTML 4.0.1およびJavaScriptによって記述されたページ、HTTP GETおよびPOST(フォーム送信)を介して取得されたページの基本的なサポートなど)。
デフォルトでは、Webクリッピングのすべての定義は永続的にOracle Metadata Services (MDS)に格納されています。ただし、Oracle Databaseを使用することもできます。MDSを使用するには、構成ファイルの変更は必要ありません。Oracle DatabaseをWeb Clippingリポジトリとして使用する場合は、設計時にprovider.xmlファイルを更新する必要があります。パスワードなどのセキュアな情報はすべて、Oracle Database暗号化技術を使用してData Encryption Standard(DES)に従って暗号化された形式で格納されます。
データ型としてWeb Pageを選択すると、OmniPortletウィザードの「ソース」タブ(図30-9)に、Web Clipping Studioを起動する「Webページの選択」ボタンが含まれるようになります。
Web Clipping Studioで、Oracle Application Server Web Clippingオンライン・ヘルプを使用するには、ページ上部の「ヘルプ」アイコンをクリックします。ヘルプを使用すると、Webコンテンツを区分けして保存するプロセスを確認することができます。
データソースを選択してデータソース・オプションを指定した後、OmniPortletのフィルタリング・オプションを使用してさらにデータを絞り込むことができます。フィルタリングを効率的に使用するには、「ソース」タブのデータ・ソース・レベルでできるかぎり多くのデータを絞り込み、「フィルタ」タブのオプションを使用してデータを簡素化します。たとえば、SQLデータ・ソースを使用している場合は、WHERE句を使用して指定した列から特定のデータのみを戻すことができます。この場合、「フィルタ」タブをスキップし、ウィザードの「ビュー」タブを続行します。ただし、データソース・レベルでフィルタリング・オプションがない場合は、「フィルタ」タブのオプションを使用してデータをソートできます(図30-10)。
データを指定してフィルタリングした後、OmniPortletの表示オプションおよびレイアウト・オプションを選択できます。「表示」タブ(図30-11)には、ヘッダー・テキストおよびフッター・テキストを追加したり、キャッシングを有効にしたり、後で「レイアウト」タブで絞り込むことができるレイアウト・スタイルを選択したりするためのオプションがあります。
「表示」タブでは、次のレイアウトから選択できます。
表
チャート
ニュース
箇条書き
フォーム
HTML
パラメータ・フォーム
|
注意: OmniPortletで使用できる別のレイアウト・スタイルの詳細は、次の項を参照するか、またはOmniPortletウィザードの「ヘルプ」をクリックします。 |
「レイアウト」タブを使用すると、OmniPortletの外観をさらにカスタマイズすることができます。「レイアウト」タブのオプションは、「ビュー」タブでの選択に応じて変わります。たとえば、「チャート・レイアウト」オプションを選択したら、チャート・ハイパーリンクを選択するためのオプションが提供されます。チャート・ハイパーリンクを使用して、チャートの特定の部分をクリックすると、イベント(別のURLへの移動など)がトリガーされます。
その他のレイアウト・スタイルの場合、各列を定義して、プレーン・テキスト、HTML、イメージ、ボタン、フィールドなどの特定の形式で表示できます。たとえば、イメージへのURLを含むデータ・ソースを選択したとします。このイメージを表示するには、この列の表示に「イメージ」を選択できます。チャート・ハイパーリンクの動作と同様に各列をアクションにマップすることもできます。
この項には、OmniPortletの「レイアウト」タブで使用できるレイアウト・オプションの詳細を説明する次のサブセクションが含まれています。
|
注意: 現在イベントはサポートされていないため、レイアウト設計時にアクションを選択すると、予期しない結果が発生する可能性があります。 |
通常、表に表示するデータの列が1つ以上ある場合、表のレイアウトを使用します。背景色のない表にすべての行を表示するには「プレーン」を、表の1行おきに背景色を表示するには「代替」を選択できます(図30-12)。
|
注意: ポートレットのスタイル・プロパティを使用すると、ポートレットの背景色を制御できます。ポートレットのスタイル・プロパティは、Composerの「プロパティ」パネルを介して公開されます。詳細は、「OmniPortletプロパティの設定」を参照してください。 |
「列のレイアウト」セクションには、ポートレットに表示するデータ列および表示形式を選択するためのオプションがあります。また、URLと、列データを表示する列をハイパーリンクとして関連付けることもできます。セカンダリWebページが新しいウィンドウに表示されるかどうかを指定することもできます。図30-13に、表形式を使用したOmniPortletの例を示します。
|
注意: OmniPortletウィザードの使用方法の詳細は、「レイアウト」タブの「ヘルプ」リンクをクリックします。 |
チャート・レイアウトを使用すると、棒グラフ、円グラフ、折れ線グラフのように、グラフィカルにデータを表示できます。「レイアウト」タブ(図30-14)には、使用するチャート形式(「チャート形式」)および表示するデータソース列(「列のレイアウト」)を指定するためのオプションがあります。
「列のレイアウト」セクションで、チャートで使用するデータソース列(「グループ」)、チャート凡例を作成する場合に使用する値(「カテゴリ」)およびチャートの棒、線、扇形の相対的なサイズ(「値」)を選択できます。
|
注意: チャートの情報をグループ化するには、(たとえば、SQL問合せ文の)データ・レベルで情報をグループ化する必要があります。また、データ・ソースの数値に書式設定された文字列、カンマまたは通貨($32,789.00など)が含まれている場合は、チャートの生成時にそれらはテキストと見なされ無視されます。これらの書式文字を数値として正しく読み取るようにする場合は、それらを削除する必要があります。 |
また、チャートのセクションがハイパーリンクを指す必要があるかどうか、および新しいウィンドウにリンク・ターゲットが表示される必要があるかどうかを選択することもできます。
各棒、扇形、線が別のWebページにリンクするようにチャート・ハイパーリンクを定義できます。たとえば、ページに円グラフとレポートのポートレットを配置してから、扇形にハイパーリンクを設定できます。扇形をクリックすると、扇形のデータに関する詳細情報を含むレポートに行が表示されます。
図30-15に、円グラフの例を示します。この例では、チャート凡例として「カテゴリ」値DEPARTMENTが使用されています。
「ニュース」レイアウトを使用すると、記事および短い記事の説明へのリンクが表示されます。「ニュース」レイアウトを使用すると、Resource Description Framework (RDF)やRSS (Really Simple Syndication)などの標準XML形式で情報を公開できます。
「列のレイアウト」セクション(図30-16)を使用すると、ポートレットの上部に表示されるヘッダー、ロゴ、垂直に移動した場合にポートレットの情報をすべて表示できるようにするスクロール・レイアウトを追加できます。
|
注意: OmniPortletの「ニュース・レイアウト」スクロール・タイプは、Microsoft Internet ExplorerおよびNetscape 7.0でサポートされています。 |
「レイアウト」タブには、URLと列データを関連付けるためのオプションもあります。ユーザーはポートレットの列データをクリックして、指定した目的の位置に移動します。
図30-17に、「ニュース」レイアウトを使用したOmniPortletの例を示します。
|
注意: OmniPortletウィザードの使用方法の詳細は、「レイアウト」タブの「ヘルプ」リンクをクリックします。 |
「箇条書き」レイアウトを使用すると、箇条書きリストまたは番号付きリストでデータが表示されます。「レイアウト」タブ(図30-18)には、様々な異なる箇条書きスタイルおよび番号付けスタイルがあります。
「列のレイアウト」セクションで、ポートレットに列を表示する方法を選択して、URLと列データを関連付けることができます。
図30-19に、「箇条書き」レイアウトを使用したOmniPortletの例を示します。
|
注意: OmniPortletウィザードの使用方法の詳細は、「レイアウト」タブの「ヘルプ」リンクをクリックします。 |
Name: <name>のようにラベルが付いたフィールドを含むフォームでソース・データを表示する場合に「フォーム」レイアウトを使用します。その後、ポートレット・パラメータを使用して、表示するデータを決定できます。
「列ラベル」列を使用して行ラベルを入力し、「列」列を使用してデータ・ソースから使用する列を指定します。また、データ位置の指定、表示モード(テキスト、HTML、イメージ、ボタン、フィールドまたは非表示)の選択、URLまたはイベントと列データの関連付け、および新しいウィンドウでURLターゲットを開くかどうかの指定を行うこともできます。
図30-21に、「フォーム」レイアウトを使用したOmniPortletの例を示します。
|
注意: OmniPortletウィザードの使用方法の詳細は、「レイアウト」タブの右上隅にある「ヘルプ」リンクをクリックします。 |
「HTML」レイアウトを使用すると、OmniPortletコンテンツのカスタマイズされたルック・アンド・フィールを作成できます。「レイアウト」タブ(図30-22)を使用すると、組込みHTMLレイアウトの選択およびコードの変更、または新しいレイアウトの作成が行えます。
OmniPortletが選択したデータ・ソースから取得したデータ列に基づいて独自のHTMLまたはJavaScriptをハンド・コーディングできます。独自のHTMLおよびJavaScriptをコーディングすることで、ポートレットの外観を完全に制御できるため、機能が充実したポートレット・インタフェースを開発できます。
「レイアウト」タブのフィールドの使用方法の詳細は、ウィザードの「ヘルプ」ボタンをクリックします。HTMLレイアウトでのJavaScriptの使用方法の例としては、このタブの「クイック・スタート」ドロップダウン・リストから「ソート可能表」レイアウトを選択します。
|
注意: 各セクション(「ヘッダー」、「繰返し」および「フッター」)に入力できる文字の最大数は、30,000(30k)です。 |
図30-23に、「HTML」レイアウトを使用したOmniPortletの例を示します。
「パラメータ・フォーム」レイアウトを使用すると、OmniPortletコンテンツのカスタマイズされたパラメータ・フォームを作成できます。「レイアウト」タブ(図30-22)を使用すると、組込みパラメータ・フォーム・レイアウトの選択およびコードの変更、または新しいレイアウトの作成が行えます。
OmniPortletが選択したデータ・ソースから取得したデータ列に基づいて独自のパラメータ・フォームをハンド・コーディングできます。独自のパラメータ・フォームをコーディングすることで、ポートレットの外観を完全に制御できるため、機能が充実したポートレット・インタフェースを開発できます。そのためには、「カスタム」スタイル・オプションを選択してから、「カスタムHTML」フィールドを使用してパラメータ・フォームを編集します(図30-25)。
「レイアウト」タブのフィールドの使用方法の詳細は、ウィザードの「ヘルプ」ボタンをクリックします。
OmniPortletを作成してアプリケーションに戻った後、ポートレットの「操作」メニューから「カスタマイズ」オプションを選択して元の選択を修正できます。定義したOmniPortletを修正する場合、タブはOmniPortletウィザードで最初に提供された異なるステップに対応します。この例外は「タイプ」ステップです。最初に選択したデータ・タイプを変更できないため、対応する「タイプ」タブはありません。
カスタマイズ・モードを使用してOmniPortletを修正する場合は、次の点に注意してください。
カスタマイズ・モードを使用してポートレットに行われた変更はすべて、現行のセッション言語およびユーザーのブラウザのロケールにかかわらず、すべてのユーザーに適用されます。
ポートレットの「パーソナライズ」リンクをクリックするか、またはポートレットの「アクション」メニューの「パーソナライズ」オプションを選択することで、実行時にポートレットをパーソナライズすることができます。ポートレットをパーソナライズすると、パーソナライズ・オブジェクトのコピーが作成されます。すべてのプロパティが複製されるため、複製後は「カスタマイズ」モードを使用してポートレットを変更しても、パーソナライズされたバージョンのポートレットには影響しません。ポートレットに対して最新のカスタマイズが行われたことを確認するには、「カスタマイズ」モードで変更した後に、再度「パーソナライズ」をクリックし、「デフォルトに戻す」オプションを選択する必要があります。
OmniPortletのパーソナライズは、ファイルプリファレンス・ストアに格納されます。OmniPortletの構成およびプリファレンス・ストアの変更の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』付録Eの追加のポートレット構成に関する項を参照してください。
1つのOmniPortletに対して最大5つのポートレット・パラメータを定義できます。パラメータは、次の画面で定義できます。
OmniPortletを定義するときのウィザードの「ソース」画面
定義されたOmniPortletに対して「カスタマイズ」を選択したときの「ソース」タブ
図30-26に、「ソース」タブの「ポートレット・パラメータ」セクションを示します。
これらのポートレット・パラメータのいずれかをパーソナライズ可能に選択する(「パーソナライズ可能」チェック・ボックスを選択する)と、「パーソナライズ」画面でその値を設定できます。
|
注意: ポートレット・パラメータの詳細は、オンライン・ヘルプを参照してください。オンライン・ヘルプには、OmniPortletウィザードの「ソース」タブの「ヘルプ」リンクをクリックしてアクセスできます。オンライン・ヘルプには、ポートレット・パラメータの詳細、およびOmniPortletでのそれらの設定方法について記載されています。 |
OmniPortletにポートレット・パラメータを設定した後、状況に応じてポートレットを他のポートレットまたはページのコンポーネントにマップできます。この操作の詳細は、第22章「ページ、タスク・フロー、ポートレットおよびUIコンポーネントの結付け」を参照してください。
OmniPortletには、関連付けられているプロパティがあります。このプロパティには、十分な権限を持つユーザーがコンポーザの「コンポーネント・プロパティ」ダイアログからアクセスできます(図30-27)。
「コンポーネント・プロパティ」ダイアログへのアクセスの詳細は、第18.6.2項「コンポーネントのプロパティの設定」を参照してください。
次の各項では、イベント・サービス・タスク・フローのプロパティと、「パラメータ」タブのプロパティについて説明します。
デフォルトのタスク・フロー・コンテンツは、「コンポーネント・プロパティ」ダイアログの「パラメータ」タブ上のプロパティによって制御されます。このタブのパラメータの詳細は、第30.4.2項「OmniPortletプロパティ」を参照してください。タスク・フローによっては、このタブのパラメータによって、タスク・フローとページ・パラメータおよびページ定義変数を簡単に結び付けることができます。ページとコンポーネントの結付けの詳細は、第22章「ページ、タスク・フロー、ポートレットおよびUIコンポーネントの結付け」を参照してください。
「表示オプション」タブ、「スタイル」タブおよび「コンテンツ・スタイル」タブのプロパティを変更すると、タスク・フローの外観と動作に影響します。これらのプロパティは、すべてのタスク・フローに共通しています。詳細は、第18.6項「ページ・コンポーネントの変更」を参照してください。
「イベント」タブの内容は、タスク・フローでサポートされているイベントによって異なります。詳細は、第18.6.7項「コンポーネントのコンテキスト・イベントの使用」を参照してください。
「パラメータ」タブと「表示オプション」タブのすべてのプロパティから式言語(EL)エディタにアクセスできます。ELエディタを使用すると、定数値のかわりに変数値を選択または指定できます。エディタを開くには、プロパティ・フィールドの横にある「編集」アイコンをクリックします。エディタの使用の詳細および一般的なEL式の説明は、付録B「式言語(EL)式」を参照してください。
|
注意: 「コンポーネント・プロパティ」ダイアログの汎用の「表示オプション」タブでELを入力すると、入力内容が自動的に検証されます。EL構文が無効な場合、エラーが表示され、値は適用も保存もされません。汎用の表示オプションとは、表18-1に掲載されているオプションです。 汎用以外の表示オプションには、ELの検証は行われません。 |
表30-3は、OmniPortlet固有のプロパティについて説明しています。
表30-3 OmniPortletコンポーネント・プロパティ
| プロパティ | 説明 | 場所 |
|---|---|---|
|
|
これを使用して、OmniPortletが定義されたときに指定されたパラメータにページ・パラメータをマッピングします。これらのパラメータを使用して、ポートレットとページをコンテキストに応じて結び付けることができます。詳細は、第22章「ページ、タスク・フロー、ポートレットおよびUIコンポーネントの結付け」を参照してください。 |
「パラメータ」タブ |
|
|
OmniPortletの場合、このプロパティを |
「表示オプション」タブ |
|
|
「表示オプション」タブ |
|
|
|
これを使用して、部分的なページのリフレッシュを初期化します。これは、ページ全体を再描画しないでページの一部の領域をリフレッシュする方法です。 |
「表示オプション」タブ |
|
|
これを使用すると、インライン・フレーム(
ページのインラインにポートレットを配置すると、インライン・フレームにポートレットを配置するより優れたユーザー・エクスペリエンスを提供できます。ただし、場合によってはインライン・フレームにポートレットを含めることが必要になります。例:
|
「表示オプション」タブ |
|
|
「表示オプション」タブ |
この項では、OmniPortletの使用中に発生する可能性がある問題のトラブルシューティングに役立つ情報を提供します。
「カスタマイズ」リンクを使用してOmniPortletを定義できない
「カスタマイズ」リンクを使用すると、実行時にOmniPortletを定義できません。
問題
OmniPortletでは、RenderPortletInIFrameの値はtrueのみをサポートします。これは、OmniPortletをインライン・フレーム内でレンダリングする必要があるということです。したがって、OmniPortletプロパティのRenderPortletInIFrameはtrueに設定する必要があります。RenderPortletInIFrameプロパティは、設計時に「Display」オプションの下の「プロパティ・インスペクタ」で使用できます。実行時、RenderPortletInIFrameプロパティはコンポーザの「プロパティ」パネルで使用できます。
解決策
現在、RenderPortletInIFrameプロパティはfalseの値を保持しているため、実行時に「定義」リンクをクリックしても、「タイプ」タブが表示されない場合があり、OmniPortletの定義を続行できません。
「アクション」メニューから「カスタマイズ」を選択するか、またはFrameworkアプリケーションの場合、設計時にOracle JDeveloperの「構造」ウィンドウでOmniPortletを選択して、Property InspectorでRenderPortletInIFrameをtrueに設定します。
