ポータル・ブラウザ・タスク・フローの使用

7 ポータル・ブラウザ・タスク・フローの使用

ポータル・ブラウザ・タスク・フローをポータル・ページに追加すると、ポータル・ユーザーはポータル・ブラウザに移動することなく、ページ上でポータルを直接使用できます。

権限:

この章のタスクを実行するには、ポータル・マネージャであるか、ポータル・レベルのBasic Services: Edit Page Access, Structure, and Content (標準権限)またはPages: Edit Pages (アドバンスト権限)のいずれかの権限を持つポータル・メンバーであることが必要です。

権限の詳細は、「ポータルのロールと権限について」を参照してください。

内容は次のとおりです。

ポータル・ブラウザ・タスク・フローについて

WebCenter Portalには、ページへの追加が可能な次の2つのポータル・タスク・フローが用意されています。

ポータル・ブラウザ・タスク・フロー: まったく同じ機能の領域をポータル・ブラウザに追加し、そのページのポータルをユーザーが使用できるようにすることで、ポータル・ブラウザへの移動がなくなります。このタスク・フローでの作業の詳細は、『Oracle WebCenter Portalでのポータルの使用』の使用可能なポータルの表示とアクセスに関する項を参照してください。
ポータル・メンバー・タスク・フロー: ポータル・メンバーを表示し、新しいメンバーの追加や、すべてのメンバーへのメール・メッセージの送信、ロールによるリストのフィルタリング、メンバーの検索を制御できます。このタスク・フローの詳細は、「「ポータル・メンバー」タスク・フローの使用」を参照してください。

図7-1 ポータル・ブラウザ・タスク・フロー

「図7-1 ポータル・ブラウザ・タスク・フロー」の説明

ページへのポータル・ブラウザ・タスク・フローの追加

ポータル・ブラウザ・タスク・フローをページに追加する手順は、その他のコンポーネントをページに追加する手順と同じです。「ページへのコンポーネントの追加」を参照してください。

ノート:

WebCenter Portalに用意されているデフォルトのポータル・カタログではポータル・ブラウザ・タスク・フローを使用できないため、ページで使用できるようにしたカスタム・リソース・カタログにそれを追加した場合は、そのエントリのみが表示されます。

詳細は、「リソース・レジストリからのリソースの追加」を参照してください(「リソース・カタログ・アイテムの追加」ダイアログで、「タスク・フロー」、「デザインタイム」、「ポータル・ブラウザ」の順に選択します)。ポータル・ページの編集にカスタム・リソース・カタログを使用するには、それが使用可能であることを確認し、「ポータルのリソース・カタログの変更」の説明に従って、ポータルでページによって使用されるように設定します。

ポータル・ブラウザ・タスク・フローのプロパティの使用

「ポータル・ブラウザ」には関連するプロパティがあり、これらのプロパティには、十分な権限を持つユーザーが、タスク・フローの「アクション・メニューの表示」からアクセスできます。たとえば、「パラメータ」を選択して、「パラメータ」ダイアログを表示します。

図7-2 ポータル・ブラウザ・タスク・フローのプロパティ

「図7-2 ポータル・ブラウザ・タスク・フローのプロパティ」の説明

次の各項では、ポータル・ブラウザ・タスク・フローのプロパティについての情報を提供し、タスク・フローのパラメータについて説明します。

ポータル・ブラウザ・タスク・フローのプロパティの設定

ページ・エディタでは、ポータル・ブラウザ・タスク・フローのツールバーの「アクション・メニューの表示」で、プロパティのダイアログ(「パラメータ」、「アクセス」、「表示オプション」、「スタイル」および「コンテンツ・スタイル」)にアクセスできます。

図7-3 「ポータル・ブラウザ」コンポーネント・ツールバー: アクション・メニューの表示

「図7-3 「ポータル・ブラウザ」コンポーネント・ツールバー: アクション・メニューの表示」の説明

ポータル・ブラウザ・コンポーネントのプロパティを設定するには:

ページ・エディタでページを開きます。
「ポータル・ブラウザ」コンポーネント・ツールバーで、「アクション・メニューの表示」をクリックし、設定する次のプロパティを選択します。
- パラメータによって、デフォルトのタスク・フロー・コンテンツが制御されます。各パラメータの詳細は、「ポータル・ブラウザ・タスク・フローのパラメータ」を参照してください。パラメータをイベントに結び付けたり、パラメータを使用してタスク・フローとページ・パラメータおよびページ定義変数を簡単に結び付けることができます。「ページとコンポーネントの結付け」を参照してください。
- アクセス設定で、特定のロール、ユーザーまたはグループに対してコンポーネントを表示または非表示にします。「コンポーネント・アクセスの設定」を参照してください。
- 「表示オプション」、「スタイル」および「コンテンツ・スタイル」のプロパティは、すべてのユーザーのタスク・フローの外観および動作に影響を及ぼします。これらのプロパティは、すべてのタスク・フローに共通しています。「コンポーネント・プロパティの変更」を参照してください。
「パラメータ」ダイアログと「表示オプション」ダイアログから式言語(EL)エディタにアクセスできます。ELエディタを使用すると、定数値のかわりに変数値を選択または指定できます。プロパティの横にあるアイコンをクリックし、「式ビルダー」を選択してエディタを開きます。

ノート:

「表示オプション」ダイアログにELを入力する際、閉じ大カッコがないなど無効な構文が検出された場合にのみ、パーサーはエラーを報告します。検証は構文に対してのみ行われ、式の値に対しては行われません。汎用の表示オプションとは、表10-1に掲載されているオプションです。

ELの検証は、汎用ではない表示オプションに対しては実行されません。

ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。Oracle WebCenter Portalの開発の「式言語式」を参照してください。
変更を保存します。

ポータル・ブラウザ・タスク・フローのパラメータ

次の表は、ポータル・ブラウザ・タスク・フローに固有のパラメータについて説明しています。

表7-1 ポータル・ブラウザ・タスク・フローのパラメータ

パラメータ	説明
`Advanced Query`	カスタム基準に基づいてポータルのリストを取得するためのEL式を指定します。この式には、選択対象となる母集団、`WHERE`句、ソート基準などが含まれることがあります。この式は`#{`および`}`で囲まないでください。オプションで、引用符とバックスラッシュのエスケープ文字としてバックスラッシュを使用します(エスケープ文字を使用してもしなくても式の構文は有効です)。例: 特定の条件に基づいて結果をソートするには、次のようにします(この例では、検出可能なポータルをアルファベット順にソートし、次に最終更新日でソートします)。 `spaceContext.spacesQuery.unionOf.ALL_QUERIABLE.sort['sp.discoverable']['asc'].sort['sp.lastUpdateDate']['desc']` ノート: 取得したデータをフィルタリングする場合は、拡張問合せで使用されるEL式に必要なフィルタリングを含める必要があります。`Filter`パラメータで指定した値は、`Advanced Query`パラメータの設定時には無視されます。たとえば、2つのポータル`MyPortal1`および`MyPortal2`を取得して、ユーザーがポータル・メンバーである場合にのみそのポータルを表示するには(Filterオプション)、`Advanced Query`パラメータを次のように設定します。 `spaceContext.spacesQuery.unionOf.USER_JOINED.where[wCond['sp.displayName']['=' ]['MyPortal1']['or'][wCond['sp.displayName']['=']['MyPortal2']]]` その他の例については、「式エディタ」で「ポータル情報」を選択し、次に例のリストから選択して関連するEL式を表示します。式を使用する場合は、それを囲んでいる`#{`および`}`、ならびにすべてのバックスラッシュ・エスケープ文字を削除するようにしてください。 EL式に関してサポートが必要な場合、アプリケーション開発者がEL式を提供できます。詳細は、Oracle WebCenter Portalの開発の「式言語式」および`oracle.webcenter.spaces.query.SpacesQueryParameters`のJavaDocを参照してください。
`Display Tool Bar`	ツールバーを表示するかどうか指定します。 `#{true}` (デフォルト): ツールバーを表示します。 `#{false}`: ツールバーを非表示にします。
`Display View`	「ポータル・ブラウザ」でポータルを表示する際のレイアウトのタイプを指定します。 `Card Layout`: ポータルをカード表示します。 `Tiled Layout` (デフォルト): ポータルをタイル表示します。
`Filter`	ポータル・ブラウザ・タスク・フローで表示するポータルを指定します。 `Show All` (デフォルト) `Show Joined` `Show Moderated` `Show Public` `Show Discoverable` (すべてのパブリック・ポータルとプライベート・ポータル) ノート: `Advanced Query`パラメータを使用する場合、この設定は無視されます。この場合、拡張問合せで使用されるEL式に必要なフィルタリングを含める必要があります。例は、`Advanced Query`パラメータの説明を参照してください。
`Portal Launched on Selection`	ポータル・ブラウザ・タスク・フローでポータルを選択した場合に、そのポータルに移動するかどうかを指定します。 `#{true}` (デフォルト): ポータルをクリックすると、そのポータルがホーム・ページで開きます。 `#{false}`: ポータルをクリックしても、そのポータルに移動しません。そのかわりに、ポータルを選択すると、選択したポータルが強調表示された状態で同じページにとどまることができます。