ヘッダーをスキップ
Oracle® Fusion Middleware Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発
11gリリース1 (11.1.1.8.3)
E49666-03
  ドキュメント・ライブラリへ移動
ライブラリ
製品リストへ移動
製品
目次へ移動
目次

前
 
次
 

9 ポータル・リソース管理の概要

この章では、WebCenter Portal Frameworkアプリケーションで使用できる様々なポータル・リソースと、それらに対して実行できるいくつかの一般的な操作について説明します。ポータル・リソースには、ナビゲーション・モデル、ページ・テンプレート、ページ・スタイル、リソース・カタログなどが含まれます。

この章の内容は、次のとおりです。


ヒント:

ポータル・リソースは、アセットと呼ばれる場合もあります。


9.1 ポータル・リソースの概要

Portal Frameworkアプリケーションでは、ポータルの構造、ルック・アンド・フィールおよびコンテンツを定義するための次のポータル・リソースを提供します。

9.2 ポータル・リソースの作成

ポータル・リソースの作成プロセスは、ポータル・リソースのタイプにより異なります。

表9-1に、様々なポータル・リソースの作成に関する詳細の参照先を示します。

表9-1 ポータル・リソースの作成

ポータル・リソース 詳細

ページ・テンプレート

第11.3項「ページ・テンプレートの作成」


ナビゲーション・モデル

第10.2項「ナビゲーション・モデルの作成」


リソース・カタログ

第14.2項「リソース・カタログの作成」


スキン

第13.2項「スキンの作成」


ページ・スタイル

第12.2.1項「ページ・スタイルを作成する方法」


コンテンツ・プレゼンタ表示テンプレート

第27.3項「コンテンツ・プレゼンタ表示テンプレートの作成」


タスク・フロー・スタイル

第12.3.1項「タスク・フロー・スタイルを作成する方法」



9.3 ポータル・リソースの編集

ポータル・リソースの編集プロセスは、ポータル・リソースのタイプにより異なります。

表9-2に、様々なポータル・リソースの編集に関する詳細の参照先を示します。

表9-2 ポータル・リソースの編集

ポータル・リソース 詳細

ページ・テンプレート

第11.4項「ページ・テンプレートの編集」


ナビゲーション・モデル

第10.3項「ナビゲーション・モデルの編集」


リソース・カタログ

第14.3項「リソース・カタログの編集」


スキン

第13.3項「スキンの編集」


ページ・スタイル

第12.2.1項「ページ・スタイルを作成する方法」


コンテンツ・プレゼンタ表示テンプレート

第27.3項「コンテンツ・プレゼンタ表示テンプレートの作成」


タスク・フロー・スタイル

第12.3.1項「タスク・フロー・スタイルを作成する方法」



9.4 ポータル・リソースの削除

ポータル・リソースが不要になった場合は、これを削除できます。


注意:

ポータル・リソースを削除する前に、それが使用されていないことを確認する必要があります。削除するポータル・リソースとしてマークされると、そのリソースは使用中であっても削除されます。


ポータル・リソースを削除するには

  1. アプリケーション・ナビゲータで、削除するポータル・リソースを右クリックし、「削除」を選択します。

  2. 「削除の確認」ダイアログによって、アプリケーション内でそのポータル・リソースが使用されているかどうかが識別されます。詳細を表示するには、「使用方法の表示」をクリックします。

    この情報を使用して、ポータル・リソースを本当に削除するのかどうかを決断できます。

  3. 続行してナビゲーション・モデルを削除するには、「はい」をクリックします。操作を取り消す場合は、「いいえ」をクリックします。

9.5 実行時のポータル・リソースの使用


ヒント:

実行時、ポータル・リソースは、アセットと呼ばれます。


ポータルは、常に進化しているアプリケーションです。ポータルの初期フレームワークがデプロイメントの前に設計されますが、これは実際には起点の役割を担います。ポータルの設計は、ポータルの実際のユーザーによって拡張されていくことが多いです。

この実行時リソース管理では、次のことを行えます。

Portal Frameworkアプリケーションでは、実行時管理コンソールの「アセット」ページより、実行時ポータル・リソース管理を有効にします。管理コンソールを使用すると、適切な権限のあるユーザーは、アプリケーションのデプロイ後もポータルの開発を続けられます(図9-1)。

図9-1 実行時管理コンソールの「アセット」ページ

図9-1の説明が続きます
「図9-1 実行時管理コンソールの「アセット」ページ」の説明

実行時、適切な権限を持つユーザーは、次のリソースを作成および管理できます。

実行時管理コンソールの「アセット」ページを使用することにより、ユーザーはポータル・リソースまたはアプリケーション全体をランタイム環境からダウンロードし、それらをJDeveloperで編集して、デプロイ済のアプリケーションにアップロードして戻すこともできます。

ユーザーは、JDeveloperで最初からポータル・リソースを作成して、それをアーカイブ・ファイルにエクスポートし、デプロイ済ポータルにアップロードすることもできます。これは、WebCenter Portalで使用するために、完全に機能するポータル・リソースを追加で作成する場合のきわめて有用な方法です。

このプロセスは、ラウンドトリップ開発と呼ばれます。詳細は、第9.6項「ラウンドトリップ開発での作業」を参照してください。

9.5.1 ポータル・リソースの実行時管理の有効化

アプリケーションの「アセット」ページにポータル・リソースを公開することにより、ポータル管理者が実行時にそれらを管理できるようにすることが可能です。

WebCenter Portal Frameworkアプリケーション・テンプレートを使用してアプリケーションを作成した場合、「アセット」ページが実行時管理コンソールの一部として自動的に用意されます。

必要に応じて、「アセット」ページをアプリケーション内の別のページに追加できますが、これは、「リソース・タイプのリスト」タスク・フローを対象ページに追加することによって実行できます。

ポータル・リソースを「アセット」ページに公開して、実行時管理を使用可能にするには、そのリソースをアプリケーション・プロジェクトのoracle/webcenter/portalappディレクトリの下に配置し、ポータル・リソースとして明示的に識別されるようにする必要があります。

この項の内容は、次のとおりです。

9.5.1.1 「アセット」ページをページに追加する方法

WebCenter Portal Frameworkアプリケーション・テンプレートを使用して作成されたアプリケーションの場合、「アセット」ページは、実行時管理コンソールの一部としてそのまま使用可能です(図9-1)。

さらに、「アセット」ページをアプリケーション内の任意のページに追加できます。これは、WebCenter Portal Frameworkアプリケーション・テンプレートを使用しないため、実行時管理コンソールがプロジェクトに含まれていない場合に特に有用です。

ページに「アセット」ページを追加する場合、ページの表示アクセス権を持つすべてのユーザーがその「アセット」ページを表示し、リソース・プロパティの表示、リソースのプレビューなどのポータル・リソースに関する表示関連操作を実行できます。ユーザーが新しいリソースの作成、リソースの編集、リソースの削除など、ポータル・リソースに関する他の操作を実行できるようにするには、使用するポータル・リソースのタイプに関する適切な権限を持っている必要があります。これらの権限は、ロール・マネージャ・タスク・フローを使用してプロビジョニングできます。詳細は、第74.4項「ロール・マネージャ・タスク・フローの使用」を参照してください。


ヒント:

Administratorロールには、デフォルトで、「アセット」ページで使用可能なすべてのポータル・リソース・タイプに対する管理アクセス権があります。


「アセット」ページを追加するには:

  1. 「アセット」ページを追加するページを開きます。

  2. 「リソース・パレット」で「WebCenter Portal - サービス・カタログ」を開き、「タスク・フロー」を開きます。

  3. 「アセット・タイプのリスト」タスク・フローを選択して、それをページ上の目的の場所にドラッグします。

  4. 表示されたメニューから、「リージョン」を選択します。

    「アセット」ページ・ライブラリをプロジェクトに追加するよう要求される場合があります。「ライブラリの追加」をクリックして確認します。

  5. 「アセット」ページが対象のページに追加されます。

  6. ユーザーが実行時にポータル・リソースをアップロードおよびダウンロードできるようにするには、「アセット」ページ・タスク・フローが含まれるフォームのusesUploadプロパティをtrueに設定する必要があります。

    <af:form id="f1" usesUpload="true">
    

9.5.1.2 ポータル・リソースを「アセット」ページに組み込む方法

ポータル・リソースを「アセット」ページに組み込み、実行時管理を使用可能にするには、そのリソースをポータル・リソースとして明示的に識別する必要があります。

ナビゲーション・モデルおよびリソース・カタログの場合、ポータル・リソースとして作成チェック・ボックスを選択することにより、最初にリソースを作成するときにポータル・リソースとして識別するオプションがあります。ページ・テンプレートやスキンなど、その他のリソースの場合は、リソースの作成後にそのリソースをポータル・リソースとして識別する必要があります。

ポータル・リソースを「アセット」ページに組み込むには:

  1. アプリケーション・ナビゲータで、「アセット」ページに組み込むポータル・リソースを右クリックし、「ポータル・リソースの作成」を選択します。


    注意:

    ポップアップ・メニューに「ポータル・リソースの作成」オプションが表示されない場合は、そのリソースがoracle/webcenter/portalappディレクトリの下にないということです。リソースを適切なディレクトリに移動するには、リソースを右クリックして、「リファクタ」を選択し、「移動」を選択します。


  2. 「ポータル・リソースの作成」ダイアログ(図9-2)の「表示名」フィールドで、必要に応じて名前を編集します。

    これは、実行時に「アセット」ページにリスト表示される名前であるため、ユーザーが表示名からリソースを簡単に識別できるようにしておきます。

    図9-2 「ポータル・リソースの作成」ダイアログ

    図9-2の説明が続きます
    「図9-2 「ポータル・リソースの作成」ダイアログ」の説明

  3. 「リソース・タイプ」フィールドでは、「アセット」ページに組み込まれているリソースの種類が特定されます。このフィールドを編集することはできません。

  4. 「アイコンURL」フィールドに、ポータル・リソースのグラフィカル表現として使用するイメージのパスとファイル名を入力します。

    このイメージは、ページ・スタイルで、「ページの作成」ダイアログに表示するアイコンを指定するためだけに使用されます。

  5. 「説明」フィールドに、ポータル・リソースの説明を入力します。この説明は、ユーザーがこのリソースをアプリケーションで使用するかどうかを決める際の助けとなるものにする必要があります。

    この説明は、「アセット」ページのポータル・リソースの名前の下に表示されます。

  6. ポータル・リソースでサポートされる追加属性の値を指定します。

  7. ポータル・リソースのリソースレベル・セキュリティを指定する場合は、「セキュリティ」タブをクリックします。そうしない場合は、手順11に移ります。

    リソースレベル・セキュリティでは、個々のポータル・リソースのアプリケーションレベル・セキュリティをオーバーライドして、実行時にリソースの編集および削除を実行できるユーザーまたはグループを指定できます。

  8. 「デフォルトのアクセス・ポリシーをオーバーライド」(図9-3)を選択します。

    図9-3 「ポータル・リソースの作成」の「セキュリティ」タブ

    図9-3の説明が続きます
    「図9-3 「ポータル・リソースの作成」の「セキュリティ」タブ」の説明

  9. 「新規ロールへの権限の追加」アイコン(プラス記号で表される)をクリックし、権限を付与するロールを選択します。

  10. 実行時のポータル・リソースへの完全なアクセス権を付与するには、「管理」チェック・ボックスを選択します。このロールを有するユーザーは、このポータル・リソースを編集および削除できます。

    実行時にポータル・リソースを編集する権限を付与するには、「更新」チェック・ボックスを選択します。このロールを有するユーザーは、このポータル・リソースを編集できますが、削除はできません。


    注意:

    ユーザーには、「アセット」ページにアクセスするための適切な権限も必要です。詳細は、第9.5.1.1項「「アセット」ページをページに追加する方法」を参照してください。


  11. 「OK」をクリックします。

    ポータル・リソースが「アセット」ページに公開され、適切な権限を持つユーザーは実行時にリソースを管理できます。

9.5.1.3 ポータル・リソースのプロパティを更新する方法

「アセット」ページで公開されているポータル・リソースの詳細を更新できます。

ポータル・リソースのプロパティを更新するには:

  1. アプリケーション・ナビゲータで、編集するポータル・リソースを右クリックし、「ポータル・リソースの更新」を選択します。

  2. 「ポータル・リソースの更新」ダイアログで、必要に応じて各フィールドを編集します。

    このダイアログのフィールドの詳細は、第9.5.1.2項「ポータル・リソースを「アセット」ページに組み込む方法」を参照してください。

  3. 完了したら「OK」をクリックします。

9.5.1.4 ポータル・リソースを「アセット」ページから削除する方法

ユーザーが実行時に特定のポータル・リソースを管理できるようにする必要がなくなった場合、そのリソースを「アセット」ページから削除できます。

ポータル・リソースを「アセット」ページから削除するには:

  1. アプリケーション・ナビゲータで、削除するポータル・リソースを右クリックし、「ポータル・リソースの削除」を選択します。

  2. 「ポータル・リソースの削除」ダイアログで、「はい」をクリックして、「アセット」ページからポータル・リソースを削除することを確認します。

    ポータル・リソースが「アセット」ページから削除され、実行時に管理できなくなります。ポータル・リソース自体は削除されないため、Portal Frameworkアプリケーション内では引き続き使用できます。

9.5.1.5 実行時の「アセット」ページの使用方法

実行時には、「アセット」ページで、ポータルに使用できるリソースの管理ツールへアクセスできます。たとえば、管理者は、新規ポータル・リソース(ナビゲーション・モデル、ページ・テンプレート、スキンなど)の作成、既存のリソースの編集、他のアプリケーションからエクスポートしたリソースのアップロードなどを実行できます。

実行時管理コンソールの「アセット」ページを使用して実行時にポータル・リソースを管理する方法については、『Oracle Fusion Middleware Oracle WebCenter Portalの管理』のPortal Frameworkアプリケーションのアセットの管理に関する項を参照してください。

9.6 ラウンドトリップ開発での作業

ポータル・リソースの実行時管理を有効にする場合、これらのリソースをJDeveloperにプルして戻せるようにできます。たとえば、ユーザーが実行時に新しいナビゲーション・モデルをポータルに追加する場合、JDeveloperでそれをさらに調整できます。これを実行するには、「アセット」ページを使用して、デプロイ済アプリケーションからポータル・リソースをダウンロードする必要があります。その後、ポータル・リソースをJDeveloperにインポートし、開発作業を実行し、リソースをエクスポートして、最終的にデプロイ済アプリケーションにアップロードして戻すことができます。これは、ラウンドトリップ開発と呼ばれます。

このプロセスは、WebCenter Portalを含め、「アセット」ページが組み込まれているすべてのデプロイ済Portal Frameworkアプリケーションのポータル・リソースに対して実行できます。


注意:

Oracle WebCenter PortalにはJDeveloperプロジェクト(WebCenterSpacesResources)が用意されており、WebCenter Portalのポータル・リソースの開発に利用できます。第55章「JDeveloperを使用したWebCenter Portalのコンポーネントの開発」には、WebCenterSpacesResourcesプロジェクトを使用してWebCenter Portalで使用するリソースを構築する方法が記載されています。


ラウンドトリップ開発のプロセスは、次のように機能します。

  1. JDeveloperでPortal Frameworkアプリケーションを構築します

  2. アプリケーションをデプロイします

  3. ポータル・リソースを追加または編集し、実行時にアプリケーションにコンテンツを追加します

  4. 「アセット」ページを使用して、ポータル・リソースをEARファイルにダウンロードします

    第9.6.1項「「アセット」ページを使用してポータル・リソースをダウンロードする方法」を参照してください。

  5. EARファイルをJDeveloperにインポートします

    第9.6.2項「ポータル・リソースをJDeveloperにインポートする方法」を参照してください。

  6. JDeveloperでポータル・リソースを編集します

  7. ポータル・リソースをEARファイルにエクスポートします

    第9.6.3項「ポータル・リソースをJDeveloperからエクスポートする方法」を参照してください。

  8. 「アセット」ページを使用して、ポータル・リソースをデプロイ済アプリケーションにアップロードします

    第9.6.4項「「アセット」ページを使用してリソースをアップロードする方法」を参照してください。

  9. 手順3から繰り返します。

さらに、アプリケーションのデプロイ後に、開発者はJDeveloperで引き続きリソースを作成および編集でき、それらのリソースをデプロイ済アプリケーションに定期的にアップロードできます。

図9-4は、前述のラウンドトリップ開発プロセスを示しています。

図9-4 ラウンドトリップ開発

図9-4の説明が続きます
「図9-4 ラウンドトリップ開発」の説明

この項の内容は、次のとおりです。


注意:

JDeveloperで作成し、JDeveloperからエクスポートしたタスク・フローをデプロイ済アプリケーション(またはWebCenter Portal)にアップロードすることはできませんが、実行時に作成したタスク・フローをJDeveloperにインポートし、変更してランタイム・アプリケーションにエクスポートして戻すことは可能です。タスク・フローのインポート、変更およびエクスポートの手順は、タスク・フロー・スタイルのものと同じです。このため、この項で示したエクスポート、インポートおよび編集の各タスクは、タスク・フローおよびタスク・フロー・スタイルに適用できます。

カスタム・タスク・フローの追加とエクスポートの詳細は、第15.4項「ページへのカスタム・タスク・フローの追加」を参照してください。


9.6.1 「アセット」ページを使用してポータル・リソースをダウンロードする方法

ポータル・リソースをJDeveloperで編集する場合、まず、デプロイ済アプリケーションで「アセット」ページを使用して、リソースのメタデータすべてを格納するEARファイルにポータル・リソースをダウンロードする必要があります。

この方法については、Oracle Fusion Middleware Oracle WebCenter Portalの管理のアセットのダウンロードに関する項を参照してください。

9.6.2 ポータル・リソースをJDeveloperにインポートする方法

EARファイルがある場合、これをJDeveloperにインポートし、ここでポータル・リソースを編集できます。


注意:

Portal Frameworkアプリケーションまたは適切なテクノロジ・スコープが含まれるアプリケーションにポータル・リソースをインポートする必要があります。



注意:

ポータル・リソースをJDeveloperにインポートする場合、リソースがすでに存在するときは、JDeveloper内のリソースがアーカイブからのリソースで上書きされます。元のリソースは一時的な場所に保存され、それはログで確認できます。


ポータル・リソースをJDeveloperにインポートするには:

  1. アプリケーション・ナビゲータで、リソースのインポート先のアプリケーションの「ポータル」プロジェクトを右クリックして、「ポータル・リソースのインポート」を選択します。

  2. 「ポータル・リソースのインポート」ダイアログ(図9-5)の「インポート・アーカイブ・ファイル名」フィールドで、インポートするポータル・リソースが含まれるアーカイブ・ファイルを入力するか参照します。

    図9-5 「ポータル・リソースのインポート」ダイアログ

    図9-5の説明が続きます
    「図9-5 「ポータル・リソースのインポート」ダイアログ」の説明

  3. 「OK」をクリックします。


注意:

ポータル・リソースで表示されたり参照されるアーティファクト(アイコンやイメージなど)は、ポータル・リソースがダウンロードされる際にはアーカイブ内に含まれません。ポータル・リソースをインポートする場合には、依存アーティファクトを手動で管理して移動する必要があります。ポータル・リソース・アーティファクトをコンテンツ・サーバーで専用のフォルダ構造を使用して、必要に応じてコンテンツを簡単に識別したり移動したりできるようにすることをお薦めします。

MDS内にアーティファクトを格納しているレガシー・ポータル・リソースを管理している場合には、依存アーティファクトをコンテンツ・サーバーに再配置することをお薦めします。ただし、MDSに格納されたアーティファクトを移動させる必要がない場合、管理者は、MDS WLSTコマンドexportMetadataおよびimportMetadataを使用できます。


9.6.3 ポータル・リソースをJDeveloperからエクスポートする方法

ポータル・リソースの編集後に、それをエクスポートして、デプロイ済アプリケーションにアップロード可能なEARファイルを作成する必要があります。

ポータル・リソースをJDeveloperからエクスポートするには:

  1. アプリケーション・ナビゲータで、エクスポートするリソースを右クリックし、「ポータル・リソースのエクスポート」を選択します。


    注意:

    ポップアップ・メニューに「ポータル・リソースのエクスポート」オプションが表示されない場合は、そのリソースがポータル・リソースではないということです。リソースをポータル・リソースとして作成する方法は、第9.5.1.2項「ポータル・リソースを「アセット」ページに組み込む方法」を参照してください。


  2. 「ポータル・リソースのエクスポート」ダイアログ(図9-6)の「エクスポート・アーカイブ・ファイル名」フィールドで、エクスポート・ファイルのパスおよびファイル名を入力するか参照します。

    既存のファイルを選択した場合、そのファイルのコンテンツは上書きされます。

    図9-6 「ポータル・リソースのエクスポート」ダイアログ

    図9-6の説明が続きます
    「図9-6 「ポータル・リソースのエクスポート」ダイアログ」の説明

  3. 「OK」をクリックします。

    エクスポート・アーカイブには、JSPXファイルやページ定義など、リソースを構成するファイルが含まれています。アーカイブには、generic-site-resources.xmlファイルおよびエクスポートされたリソースに関する情報のみが含まれるレジストリ・ファイルも含まれています。


注意:

ポータル・リソースで表示されたり参照されるアーティファクト(アイコンやイメージなど)は、アーカイブ内に含まれません。ポータル・リソースをアップロードする場合には、依存アーティファクトを手動で管理して移動する必要があります。ポータル・リソース・アーティファクトをコンテンツ・サーバーで専用のフォルダ構造を使用して、必要に応じてコンテンツを簡単に識別したり移動したりできるようにすることをお薦めします。

MDS内にアーティファクトを格納しているレガシー・ポータル・リソースを管理している場合には、依存アーティファクトをコンテンツ・サーバーに再配置することをお薦めします。ただし、MDSに格納されたアーティファクトを移動させる必要がない場合、管理者は、MDS WLSTコマンドexportMetadataおよびimportMetadataを使用できます。


9.6.4 「アセット」ページを使用してリソースをアップロードする方法

最後の手順では、更新済リソースのEARファイルを取得し、「アセット」ページを使用して、リソースをデプロイ済アプリケーションにアップロードして戻します。

この方法については、Oracle Fusion Middleware Oracle WebCenter Portalの管理のアセットのアップロードに関する項を参照してください。

9.7 WebCenter Portalリソースの使用

WebCenter Portalは、ポータルの構築、ソーシャル・ネットワーキング、通信、コラボレーションおよび個人の生産性に対して最新のテクノロジを提供するWebベースのアプリケーションです。WebCenter Portalには、ユーザーがポータルで利用できる様々な組込みポータル・リソースがデフォルトで用意されています。これらの組込みポータル・リソースがユーザーの要件を満たさない場合には、アプリケーション管理者がWebCenter Portal内でさらにリソースを作成できます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalによるポータルの構築のアセットの作成に関する項を参照してください。


ヒント:

WebCenter Portalでは、ポータル・リソースは、アセットと呼ばれます。


場合によっては、必要な機能をすべて提供するポータル・リソースの作成に必要なコントロールが、WebCenter Portalによって提供されないこともあります。そのような場合、もともとWebCenter Portalで作成したポータル・リソースをJDeveloperに移して編集し、WebCenter Portalにアップロードして戻すことが可能です。

また、ページ・スタイルやタスク・フロー・スタイルなど、WebCenter Portalで使用される一部のポータル・リソースは、WebCenter Portalでは作成できません。かわりにこれらのリソースは、JDeveloperで作成し、エクスポートしてWebCenter Portalにアップロードする必要があります。

Oracle WebCenter Portalには特別なJDeveloperプロジェクト(WebCenterSpacesResources)が用意されており、WebCenter Portalで使用するポータル・リソースの開発に利用できます。詳細は、第55.1項「WebCenter Portalのアセットの開発」を参照してください。

JDeveloperでWebCenter Portalリソースを使用している場合、次の点を考慮してください。

ナビゲーション・モデル

ページ・テンプレート