第 8 章ポータルデスクトップサービスの管理

この章では、Sun Java System Portal Server デスクトップサービスの管理方法について説明します。

デスクトップの概要

ここでは、デスクトップコンポーネントとその基本構造、およびその管理方法について説明します。

デスクトップ用語集

表 8-1 は、デスクトップに関連する用語の説明を示しています。

最初の列は用語を示し、2 番目の列は用語の定義を示します。

表 8-1 デスクトップ用語集
用語	定義
デスクトップ	Portal Server にプライマリエンドユーザーインタフェースを提供します。
プロバイダ	Portal Server が使用する汎用リソースのインタフェースとして機能します。JSP プロバイダは、JSP ファイルをコンパイルおよび実行し、マークアップを生成します。XML プロバイダは XML ファイルを変換してマークアップを生成します。Portal Server は、ポータルページで表示するマークアップに関する情報をプロバイダに照会できます。
ポートレット	ポータルのコンテキストの範囲内で要求を処理し、コンテンツを生成する、プラグイン可能な Web コンポーネント。ポートレットは、ポートレットコンテナ (JSR168 エクスポートグループによって定義されるポートレット仕様の実装) によって管理されます。概念的にはソフトウェアプロバイダと同じです。
チャネル	デスクトップにコンテンツを表示します。通常は行と列で編成します。実行時のチャネルは、チャネルのサポートに必要なプロバイダオブジェクト、設定ファイル、およびすべてのデータファイル (JSP、HTML テンプレートなど) から構成されます。
コンテナまたはコンテナチャネル	主に、他のチャネル (子チャネルと呼ばれる) のコンテンツを含めたり、集約したりすることでコンテンツを生成するチャネルです。

ポータルデスクトップのアーキテクチャとコンテナ階層

デスクトップは、Portal Server のプライマリエンドユーザーインタフェースです。デスクトップはサーブレットで実装され、さまざまな API とユーティリティ (Sun Java^TM System Access Manager API、リソースバンドル、プロパティファイル、およびメールサーバーを始めとするバックエンドサーバーなど) によってサポートされています。

デスクトップは、プロバイダアプリケーションプログラミングインタフェース (PAPI) を使用してコンテンツを拡張、集約するメカニズムを提供します。コンテンツプロバイダ、またはプロバイダは、コンテナ階層、および一部のチャネルを構築するための基本的なビルディングブロックを有効にします。通常、チャネルは行と列で編成しますが、コンテナチャネルを実装することで、この配備を変更することもできます。プロバイダは、コンテンツを生成するプログラムエンティティで、チャネル中に表示されます。生成したコンテンツは、ページ全体、フレーム、またはチャネルなどの任意のマークアップで構成できます。

ポータルのコンテンツ量が増加した場合にも、ポータルの構成、開発、および一般ユーザーによる使用実績は、参照するコンテンツのグループの格納方法によって簡略化できます。Portal Server は、コンテンツの集約においてコンテナプロバイダの柔軟で拡張性の高いセットを提供します。

図 8-1 は、デスクトップコンテナ階層の例を示しています。この図では、タブコンテナが最上位コンテナです。タブコンテナには、2 つのタブチャネルであるタブ 1 とタブ 2 があります。タブ 1 はテーブルコンテナで、内部に 5 つのチャネルを格納します。

タブコンテナ: 複数のテーブル、単一コンテナ、またはタブコンテナを格納します。このコンテナには、バナーおよびポータルのためのメニューバーも格納されます。

タブチャネル: チャネルを切り替えるためにタブ付きのユーザーインタフェースを提供して、他のチャネルの出力を集約します。実行時にタブコンテナの構成を修正して、表示するリーフチャネルを変更できます。

テーブルコンテナ: 他のチャネルのコンテンツを行と列に集約します。このコンテナの機能は、Sun Portal Server 3.0 フロントプロバイダに相当します。このコンテナは、他チャネルのコンテンツの入れ物と考えることができます。

ユーザー定義のチャネル

それぞれのタブコンテナにはコンテンツリンクが含まれます。コンテンツリンクを選択すると、ユーザーが現在のタブのコンテナに表示するチャネルを選択できるページが表示されます。このリリースでは、このページの右上に「新しいチャネルの作成」というリンクが追加されています。「新しいチャネルの作成」リンクを選択すると、ユーザーが新しいチャネルを作成するためのページが表示されます。ただし、ユーザーが作成できるチャネルは管理者が定義することができます。

表示されるページで新しいチャネルを作成するには、ユーザーは表 8-2 に示される情報をフォームに指定する必要があります。

表 8-2 ユーザー定義のチャネル
フォームのフィールド	フィールドのタイプ	フィールドの説明
チャネル名	テキストフィールド	チャネル名には英数字 (a ～ z、A ～ Z、0 ～ 9) だけを使用できます。
チャネルのタイトル	テキストフィールド	チャネルのタイトルバーに表示されるタイトルです。
チャネルの説明	テキストフィールド	コンテンツリンクページに表示されるチャネルの説明です。
チャネルのタイプ	コンボボックス	新しいチャネルの作成に使用できるプロバイダのリストです。
チャネルのカテゴリ	コンボボックス	タブのコンテナのカテゴリのリストです。
チャネルを表示	「する」、「しない」のラジオボタン	「作成」ボタンの選択後にブラウザが更新されたときに、新しいチャネルが自動的に表示されるようにする場合は、「チャネルを表示」の「する」を選択します。「作成」ボタンの選択後にブラウザが更新されたときに、新しいチャネルが自動的に表示されないようにする場合は、「しない」を選択します。この場合、コンテンツリンクからチャネルを選択することで、チャネルをブラウザに表示できます。どちらの場合も、ブラウザで新しいチャネルを選択、表示したときは、そのチャネルのタイトルバーに表示される「編集」ボタンを選択して、プロパティを更新する必要があります。
作成	ボタン	新しいチャネルを作成するときに選択します。
取消し	ボタン	ユーザーがデスクトップの表示に戻るときに選択します。

ユーザー定義のチャネルを作成すると、コンテンツページに「チャネルの削除」リンクが表示されるようになります。ユーザーがリンクをクリックすると、ユーザーが作成したすべてのチャネルが表示され、チャネルを削除することができます。

ポータルデスクトッププロバイダ

Sun Java System Portal Server は、次の 2 つのタイプのプロバイダを使用します。

ビルディングブロックプロバイダ: 拡張可能なプロバイダで、そのインタフェースは公開されています。これらのプロバイダは、汎用リソース (JSP ファイルなど) に接続します。これらのプロバイダは、ポータルデスクトップに複数のチャネルを作成できるため、プロバイダとチャネルの間の関係は一対多となります。

コンテンツプロバイダ: 拡張不可能なプロバイダで、表示する固有のデータセットを必要とします (たとえば、ブックマークプロバイダは特定のテンプレートとデータを必要とする)。この種類のプロバイダは、ビルディングブロックプロバイダとは異なります。

ポータルデスクトップは、コンテンツ、プロバイダ、ポートレット、チャネルデータを格納するためにディスプレイプロファイルを使用します。詳細については、第 10 章「ディスプレイプロファイルの管理」を参照してください。

ポータルデスクトップサービス

デスクトップサービスは、Sun Java System Access Manager サービスを使用して、各組織またはサブ組織のアプリケーションとユーザー固有の属性を格納します。管理者は、次にディスプレイプロファイルポリシーを作成し、それをユーザーに割り当てます。管理者はまた、Sun Java System Access Manager 管理コンソールを使用して、デスクトップ属性を修正します。デスクトップ属性についての詳細は、『Sun Java System Portal Server 2005Q1 Technical Reference Guide』を参照してください。

サンプルデスクトップ

Portal Server では、サンプルデスクトップに次のチャネルが含まれます。

これらのチャネルは、サンプルポータルに合わせてカスタマイズおよび設定されています。配備するには、ユーザーインタフェースの修正が必要になることがあります。

ポータルデスクトップのカスタマイズ

Portal Server を配備する場合、ポータルの開発と、カスタマイズが主な作業になります。まず、プロバイダ、チャネル、およびコンテナチャネルを作成、拡張してからオンラインヘルプを配備し、見た目と使い心地などを変更します。必要に応じて、サンプルデスクトップを、サイトのポータルをカスタマイズする際の出発点として使用できます。ポータルのカスタマイズの詳細については、『Sun Java System Portal Server 6 2005Q1 Desktop Customization Guide』を参照してください。

チャネルのホット配備の概要

Portal Server を使用すると、再起動せずに稼動中のシステムでプロバイダとチャネルを配備できます。すなわち「ホット配備」が可能です。この場合、ユーザーセッションに割り込みが起こりません。

ホット配備を実現する 3 つのテクノロジは次のとおりです。

プロバイダクラスローダ: プロバイダ、およびプロバイダで使用するクラスをリロードします。プロバイダクラスローダを正しく実行するには、すべてのクラス (または JAR ファイル) を定義済みのディレクトリに配置する必要があります。

ディスプレイプロファイルの再表示: Sun Java System Access Manager 管理コンソール、dpadmin コマンドなどの外部ソースで変更する場合、メモリ内のデスクトップ設定、つまりディスプレイプロファイルを更新します。

ポータルデスクトップテンプレートと JSP のリロード: 設定されたデスクトップタイプに適切なテンプレートと JSP ファイルを取得します。

プロバイダアーカイブの概要

par ユーティリティで、チャネル、ポートレット、プロバイダ、および関連するすべてのファイルを Portal Server システムにパッケージ化したり、システムから移動したりすることができます。チャネル、ポートレット、プロバイダは .par ファイル形式で格納されます。.par ファイルに含められるファイルは次のとおりです。

ポータルデスクトップサービスの管理

デスクトップは、ユーザーのディスプレイプロファイルのマージしたセットに含まれるすべてのドキュメントをさらにマージし、それを使用してユーザーのデスクトップを構成します。ディスプレイプロファイルのマージしたセットには、ユーザーに関連するすべてのディスプレイプロファイルドキュメントが含まれます。ディスプレイプロファイルは、Sun Java System Access Manager 組織ツリーの異なるレベルで定義されます。ツリーのさまざまなレベルのディスプレイプロファイルドキュメントをマージまたは結合して、ユーザーのディスプレイプロファイルを作成します。たとえば、ユーザーのディスプレイプロファイルを形成するユーザーのディスプレイプロファイルドキュメントは、ロールディスプレイプロファイルドキュメント (存在する場合)、組織のディスプレイプロファイルドキュメント、およびグローバルなディスプレイプロファイルドキュメントとマージされます。

デスクトップディスプレイプロファイルとその他の設定データは、Sun Java System Access Manager サービス管理フレームワーク内にあるポータルデスクトップサービスのサービス属性として定義されます。組織が Sun Java System Access Manager 管理コンソールでポータルデスクトップサービスを追加する場合、組織内のすべてのユーザーはユーザープロファイルのポータルデスクトップサービス属性を継承します。この場合、ポータルデスクトップはこれらの属性を照会し、情報をどのようにポータルデスクトップに集約して表示するかを決定します。

デフォルトでは、ポリシー設定サービスは自動的に最上位の組織に追加されます。サブ組織は、親組織とは別にポリシーサービスを追加する必要があります。作成したポリシーサービスは、すべての組織に追加する必要があります。

Sun Java System Access Manager 組織のユーザーに対してポータルデスクトップサービスを設定するために必要な操作の概要は、次のとおりです。

組織のポリシーサービスを追加します。

ピアまたはサブ組織の参照ポリシーを作成します。

ピアまたはサブ組織の標準のポリシーを作成します。

デフォルトのリダイレクト先 URL を割り当てます。

デスクトップサービス属性をカスタマイズします。



注	サンプルポータルをインストールすると、インストーラはサンプルに必要なディスプレイプロファイル XML ファイルをすべてインストールします。Sun Java System Access Manager コンソール、またはコマンド行インタフェースを使用すると、プロファイルをカスタマイズできます。詳細は、第 10 章「ディスプレイプロファイルの管理」を参照してください。

デフォルトでは、ポリシー設定サービスは自動的に最上位の組織に追加されます。サブ組織は、親組織とは別にポリシーサービスを追加する必要があります。作成したポリシーサービスは、すべての組織に追加する必要があります。ポリシーを使用するための手順の概要は、次のとおりです。

組織のポリシーサービスを追加します (インストールで指定した組織に自動的に追加)。サブ組織は、親サービスを継承しないため、サブ組織のポリシーサービスを追加する必要があります。詳細については、「サブ組織のポリシーサービスを追加する」を参照してください。

ピアまたはサブ組織の参照ポリシーを作成します。組織のポリシーに関する定義と決定を別の組織に委託することができます (または、リソースのポリシー定義を別のポリシー製品に委託)。この、ポリシーの作成と評価に関するポリシー委任は、参照ポリシーによって制御されます。これは、ルールと参照自体から構成されます。リソースを必要としないアクションがポリシーサービスに含まれる場合、サブ組織の参照ポリシーを作成することはできません。詳細については、「サブ組織の参照ポリシーを作成する」を参照してください。

ピアまたはサブ組織の標準のポリシーを作成します。アクセス権の定義には標準のポリシーを使用します。標準のポリシーは、複数のルール、サブジェクト、条件から構成されます。詳細については、「サブ組織に標準のポリシーを作成する」を参照してください。

サブ組織のポリシーサービスを追加する

サブ組織は、親サービスを継承しないため、サブ組織のポリシーサービスを追加する必要があります。


注	Access Manager 管理コンソールに関する最新の詳細情報については、『Sun Java System Access Manager 2005Q1 管理ガイド』を参照してください。

Sun Java System Access Manager 管理コンソールに、管理者としてログインします。

デフォルトでは、ロケーションパネルでは「アイデンティティ管理」が選択され、ナビゲーションパネルには作成済みのすべての組織が表示されています。

デスクトップサービスを追加する組織を選択します。

ナビゲーションパネルの「表示」メニューから「サービス」を選択します。

ナビゲーションパネルで「追加」をクリックします。

使用できるサービスのリストがデータパネルに表示されます。

「Portal Server 設定」の「ポータルデスクトップ」チェックボックスにチェックマークを付けて、「了解」をクリックします。

ナビゲーションパネルが、「Portal Server 設定」に追加したデスクトップサービスで更新されます。

ナビゲーションパネルの「表示」メニューから「サービス」を選択します。

ナビゲーションパネルの「ポータルデスクトップ」の隣にあるプロパティの矢印を選択します。

このとき、データパネルのメッセージ区画に、デスクトップサービスにサービステンプレートを作成する必要があるかどうかを確認するメッセージが表示されます。メッセージ区画内の「はい」をクリックし、テンプレートを作成します。

ページを送信してテンプレートが作成されると、データパネルにデスクトップサービス属性とデフォルト値があればその一覧が表示されます。必要に応じて値を修正します。完了したら、「保存」を選択してサービステンプレートの最新の値を保存します。

新規に作成したサービステンプレートのディスプレイプロファイルは、「サービス設定」にある「ポータルデスクトップ」サービスの「ダイナミック」セクションに入力した値を取ります。それらの値が空白の場合、この新規テンプレートのディスプレイプロファイルも空白になります。



注	「競合の解決レベル」属性の値は、デフォルト値では「最も高い」に設定されています。追加したサービスに同じ優先順位でサービステンプレートを各レベル (組織、ロールなど) でセットアップすると、予想外の結果を招く可能性があります。

サブ組織の参照ポリシーを作成する

組織のポリシーに関する定義と決定を別の組織に委託することができます。この、ポリシーの作成と評価に関するポリシー委任は、参照ポリシーによって制御されます。これは、ルールと参照自体から構成されます。参照は、ルール内のリソースとして親組織を定義する必要があり、参照内の値として SubOrgReferral に組織名が含まれている必要があります。


注	Access Manager 管理コンソールに関する最新の詳細情報については、『Sun Java System Access Manager 2005Q1 管理ガイド』を参照してください。

Sun Java System Access Manager 管理コンソールに、管理者としてログインします。

ナビゲーションパネルで「アイデンティティ管理」を選択します。

「表示」メニューから「ポリシー」を選択します。

「新規」をクリックし、新しいポリシーを作成します。

ポリシーの作成ページがデータパネルに表示されます。

「名前」には、SubOrgReferral_Desktop を入力します。「ポリシータイプ」で「参照」が選択されていることを確認します。「了解」をクリックします。

「サービス」から「デスクトップ」を選択し、「次へ」をクリックします。

データパネルの「表示」メニューから「ルール」を選択し、「新規」をクリックします。「ポータルデスクトップ」が選択されていることを確認し、「次へ」をクリックします。

ルールの追加テンプレートがデータパネルに表示されます。

「ルール名」に DesktopRule と入力し、「終了」をクリックします。

データパネルの「表示」メニューから「参照」を選択し、「新規」をクリックします。

「新規参照」テンプレートがデータパネルに表示されます。

「名前」に SubOrgReferral_Desktop と入力します。

データパネルで「値」にサブ組織の名前が選択されていることを確認し、「作成」をクリックしてポリシーの設定を完了します。

データパネルで「保存」をクリックします。

データが保存されると、「ポリシープロパティが保存されました。」というメッセージが表示されます。

サブ組織に標準のポリシーを作成する

アクセス権の定義には標準のポリシーを使用します。標準のポリシーは、複数のルール、サブジェクト、条件から構成されます。


注	Access Manager 管理コンソールに関する最新の詳細情報については、『Sun Java System Access Manager 2005Q1 管理ガイド』を参照してください。

Sun Java System Access Manager 管理コンソールに、管理者としてログインします。

ポリシーを作成する組織またはサブ組織に移動します。

作成したすべての組織がナビゲーションパネルに表示されます。

「表示」メニューから「ポリシー」を選択します。

その組織のポリシーが表示されます。

ナビゲーションパネルで「新規」を選択します。「新規ポリシー」ページがデータパネルに表示されます。

「名前」に SubOrgNormal_Desktop と入力します。「ポリシータイプ」で「標準」が選択されていることを確認します。「作成」をクリックします。

データパネルの「表示」メニューから「ルール」を選択し、「新規」をクリックします。ルールの追加テンプレートがデータパネルに表示されます。

「サービス」メニューから「ポータルデスクトップ」を選択し、「次へ」をクリックします。「ルール名」に DesktopRule と入力します。「NetMail 実行権限を所有」にチェックマークが付けられていることを確認します。

「サービス」メニューから「ポータルデスクトップ」を選択し、「次へ」をクリックします。「NetMail 実行権限を所有」にチェックマークが付けられていることを確認します。

「タイプ」メニューからサブジェクトのタイプを選択し、「次へ」　をクリックしてサブジェクトの設定を完了します。

データパネルの「表示」メニューから「サブジェクト」を選択し、「新規」をクリックします。「サブジェクトを追加」ページがデータパネルに表示されます。

「作成」をクリックして、ポリシーの設定を完了します。

データが保存されると、「ポリシープロパティが保存されました」というメッセージが表示されます。

ログインユーザーをポータルデスクトップ URL に正しくリダイレクトする

ログインに成功すると、組織内のユーザーはデフォルトでデスクトップサービスの属性、および値を受け取ります。これらの値はデスクトップサーブレットによって照会され、組織内の全ユーザーのポータルデスクトップコンテンツが決定されます。ユーザーがログインに成功したあと、Sun Java System Access Manager がポータルデスクトップサーブレットを自動的に呼び出すようにするには、デフォルトのリダイレクト URL をポータルデスクトップ URL に変更します。

ポータルデスクトップ URL にリダイレクトされるように、特定の組織のデフォルトリダイレクトを設定するには、次の手順に従います。


注	Access Manager 管理コンソールに関する最新の詳細情報については、『Sun Java System Access Manager 2005Q1 管理ガイド』を参照してください。

Sun Java System Access Manager 管理コンソールに、管理者としてログインします。

ポータルデスクトップ URL を設定する組織を選択します。

「表示」メニューから「サービス」を選びます。

ナビゲーションパネルの「コア」の隣にあるプロパティの矢印を選択します。

データパネルで、「デフォルト成功ログイン」という属性を探します。

「デフォルト成功ログイン」の値をデスクトップサーブレットの URL に設定します。たとえば、/portal/dt はサンプルデスクトップの URL です。

「保存」をクリックします。

デスクトップにログインして、デフォルトのポータルリダイレクト URL を確認します。

ログインユーザーをポータルデスクトップ URL にリダイレクトする (グローバル)

グローバル属性に適用される値は、Sun Java System Access Manager 設定に適用され、また新規に作成されたすべての組織に継承されます。

デフォルトリダイレクト URL をポータルデスクトップ URL にグローバルに設定するには、次の手順に従います。


注	Access Manager 管理コンソールに関する最新の詳細情報については、『Sun Java System Access Manager 2005Q1 管理ガイド』を参照してください。

Sun Java System Access Manager 管理コンソールに、管理者としてログインします。

ロケーションパネルで「サービス設定」を選択します。

ナビゲーションパネルの「コア」の隣にあるプロパティの矢印を選択します。

データパネルで、「デフォルト成功ログイン」という属性を探します。

「デフォルト成功ログイン」の値を /portal/dt などのポータルデスクトップサーブレットの URL に設定します。

「保存」をクリックします。

ポータルデスクトップサービス属性の値を修正する

サービス属性を修正することで、ポータルデスクトップサービスをカスタマイズできます。


注	Access Manager 管理コンソールに関する最新の詳細情報については、『Sun Java System Access Manager 2005Q1 管理ガイド』を参照してください。

Sun Java System Access Manager 管理コンソールに、管理者としてログインします。

デスクトップ属性を修正する組織を選択します。

ナビゲーションパネルの「ポータルデスクトップ」の隣にあるプロパティの矢印を選択します。

ディスプレイプロファイル XML を含む、ポータルデスクトップサービス属性の一覧がデータパネルに表示されます。

サービス属性値を修正します。

デスクトップ属性についての詳細は、『Sun Java System Portal Server 2005Q1 Technical Reference Guide』を参照してください。

完了したら、「保存」を選択します。

変更は、特定のサブ組織またはロールのユーザーだけに反映されます。

ポータルデスクトップサービス属性の値を修正する (グローバル)

場合によっては、今後、デスクトップサービスに追加するすべての組織に影響する、グローバルデスクトップサービスの属性値を修正する必要があります。

グローバル属性に適用される値は、Sun Java System Access Manager 設定に適用され、また今後構成されるすべての組織に継承されます。


注	Access Manager 管理コンソールに関する最新の詳細情報については、『Sun Java System Access Manager 2005Q1 管理ガイド』を参照してください。

Sun Java System Access Manager 管理コンソールに、管理者としてログインします。

ロケーションパネルで「サービス設定」をクリックします。

ナビゲーションパネルの「ポータルデスクトップ」の隣にあるプロパティの矢印を選択します。

ディスプレイプロファイル XML を含むグローバルデスクトップサービス属性の一覧が、データパネルに表示されます。

サービス属性値を修正します。

デスクトップ属性についての詳細は、『Sun Java System Portal Server 2005Q1 Technical Reference Guide』を参照してください。

完了したら、「保存」を選択します。

この変更は、今後、デスクトップサービスに追加するすべての組織に影響します。

サンプルポータルデスクトップにアクセスする

デスクトップログを確認する

ポータルデスクトップエラーはデバッグログファイルに記録されます。デフォルトでは、これらログファイルの位置は次のとおりです。

これらのログファイルのエラーを調べます。次に、例を示します。このエラーは認証されていないユーザーがポータルデスクトップを実行しようとしたことを示します。

06/20/2002 02:36:30:600 PM PDT:Thread[Thread-177,5,main]

ERROR:DesktopServlet.handleException()

com.sun.portal.desktop.DesktopException:DesktopServlet.doGetPost():no privilige to execute desktop

at com.sun.portal.desktop.DesktopServlet.doGetPost(DesktopServlet.java:456)

at com.sun.portal.desktop.DesktopServlet.service(DesktopServlet.java:303)

at javax.servlet.http.HttpServlet.service(HttpServlet.java:853)

at com.sun.server.http.servlet.NSServletRunner.invokeServletService(NSServletRu nner.java:897)

at com.sun.server.http.servlet.WebApplication.service(WebApplication.java:1065)

at com.sun.server.http.servlet.NSServletRunner.ServiceWebApp(NSServletRunner.ja va:959)

ポートレットの管理

ポートレットの管理には、Sun Java^TM System Access Manager 管理コンソールを使用します。管理コンソールには、ポートレットからポートレットチャネルを作成するページ、およびポートレットチャネルの設定を変更するページが用意されています。pdeploy は、ポートレット Web アプリケーションを Web コンテナに配備および配備取消しするのに使用できるコマンド行ツールです (コマンド行ユーティリティの管理についての詳細は、『Sun Java System Portal Server 2005Q1 Technical Reference Guide』を参照)。

ポートレットからチャネルを作成する


注	少なくとも 1 つのセッションが有効なポートレットを含むポータルページにクライアント要求がアクセスするときは、そのポータルページのすべてのポートレットを 1 つのポートレットアプリケーションとしてパッケージ化することを強くお勧めします。パッケージしない場合、セッション作成の結果が 1 つに特定されなくなります。


注	Access Manager 管理コンソールに関する最新の詳細情報については、『Sun Java System Access Manager 2005Q1 管理ガイド』を参照してください。

Sun Java System Access Manager 管理コンソールにログインし、組織を選択します。

ナビゲーションメニューの「表示」の下で「サービス」を選択します。

「Portal Server 設定」から「ポータルデスクトップ」サービスを選択します。

「チャネルおよびコンテナを管理」リンクを選択します。

「チャネル」の下の「新規ポートレットチャネル」ボタンを選択します。

ポートレットチャネルを作成するためのページが表示されます。

「チャネルの追加」ページに次の情報を指定します。

チャネル名。

チャネル名は英数字 (a ～ z、A ～ Z、0 ～ 9) で指定する必要があり、必須フィールドです。

ポートレット。

システムに配備されているポートレットだけが表示されます。

「作成」ボタンを選択して、ポートレットチャネルを作成します。

特定コンテナのポートレットからチャネルを作成する


注	Access Manager 管理コンソールに関する最新の詳細情報については、『Sun Java System Access Manager 2005Q1 管理ガイド』を参照してください。

Sun Java System Access Manager 管理コンソールにログインし、組織を選択します。

ナビゲーションメニューの「表示」の下で「サービス」を選択します。

「Portal Server 設定」の下で「ポータルデスクトップ」サービスを選択します。

「チャネルおよびコンテナを管理」を選択します。

ポートレットチャネルを作成するコンテナのリンクを選択します。

コンテナを管理するためのページが表示されます。

「チャネル」の下の「新規ポートレットチャネル」ボタンを選択します。

ポートレットチャネルを作成、追加するためのページが表示されます。

「チャネルの追加」ページに次の情報を指定します。

チャネル名。

ポートレット (プルダウンリストから)。このリストには、システムに配備されているポートレットだけが含まれます。

適切なラジオボタンを選択し、エンドユーザーがそのチャネルを使用できるか、またはデスクトップ上で使用、表示できるかを指定します。

「了解」ボタンを選択します。

「チャネル」の下のチャネルリスト、および「チャネルおよびコンテナを管理」ページの「ポータルデスクトップで表示可能」の下にチャネルが追加されます。

コンテナにポートレットチャネルを追加する


注	Access Manager 管理コンソールに関する最新の詳細情報については、『Sun Java System Access Manager 2005Q1 管理ガイド』を参照してください。

Sun Java System Access Manager 管理コンソールにログインし、組織を選択します。

ナビゲーションパネルの「表示」の下で「サービス」を選択します。

「Portal Server 設定」から「ポータルデスクトップ」を選択します。

「チャネルおよびコンテナを管理」を選択します。

新たに作成するポートレットチャネルの追加先となるコンテナへのリンクを選択します。

コンテナを管理するためのページが表示されます。

「使用可能」リストから追加するポートレットチャネルを選択します。

「ポータルデスクトップで表示可能」の上に配置されている「追加」ボタンをクリックします。

これにより、選択しているコンテナで表示できるチャネルのリストに、選択したポートレットチャネルが追加されます。

「チャネル管理」の下の「保存」ボタンをクリックし、新しい設定を保存します。

ポートレットチャネルの設定とプロパティを編集する

ポートレットの設定は、portlet.xml ファイルに定義されます。

これは、次のディスプレイプロファイルにマッピングされます。

実行時に追加される設定を保持するために、空のコレクション __Portlet__AdditionalPreferences が作成されます。コレクション __Portlet__PreferenceProperties には、default と isReadOnly という 2 つのコレクションが含まれます。default コレクションには、portlet.xml に定義されるデフォルト値が格納されます。default コレクションと似ている isReadOnly コレクションには、Boolean 型のプロパティを使用する設定の読み取り専用フラグが格納されます。

portlet.xml に含まれる各設定は、default コレクション内に対応する String プロパティを持ちます。このプロパティの名前は、設定名です。String プロパティの値は、portlet.xml に定義されているデフォルト値で、先頭に「|」という文字が付けられ、複数の値は「|」で区切られます。次に、各設定は設定の現在値を格納する String プロパティで表わされます。このプロパティの名前は、設定名で、先頭に __Portlet__ という文字列が付けられます。プロパティの値は、現在のプロパティ値で、先頭に「|」という文字が付けられ、複数の値は「|」で区切られます。


注	Access Manager 管理コンソールに関する最新の詳細情報については、『Sun Java System Access Manager 2005Q1 管理ガイド』を参照してください。

Sun Java System Access Manager 管理コンソールにログインし、ドメインを選択します。

ナビゲーションパネルの「表示」の下で「サービス」を選択します。

「Portal Server 設定」から「ポータルデスクトップ」を選択します。

編集するポートレットチャネルの「プロパティの編集」リンクを選択します。

「チャネルの編集」ページが表示されます。チャネル編集ページには、ポートレットエンティティのポートレット設定が表示されます。

設定を変更し、「保存」を選択して変更内容を保存します。

設定のデフォルト値を変更するときは、編集する設定の「プロパティの編集」リンクをクリックします。プロパティは、「チャネルの編集」ページで編集できます。

par ファイルの管理

par ユーティリティで、Portal Server 間でプロバイダまたはチャネルを送信したり移動したりすることができます。par ユーティリティは、.par ファイルと呼ばれる特定のパッケージの仕組みを作成して、チャネル、ポートレット、プロバイダをサーバー間で送受信します。.par ファイルは .jar ファイル形式の拡張形式で、ターゲットサーバーの Portal Server ディスプレイプロファイルに統合するための配備情報と XML ドキュメントが含まれる追加のマニフェスト情報を持っています。

par コマンドラインユーティリティを使用して par ファイルを作成、修正、配備します。export サブコマンドを使用すると par ファイルを作成、または修正できます。import サブコマンドを使用すると、Portal Server でプロバイダ、チャネル、ポートレットをインポートまたは配備できます。describe サブコマンドを使用すると、par ファイルの内容の説明を参照できます。par コマンドの構文に関する詳細については、『Sun Java System Portal Server 2005Q1 Technical Reference Guide』を参照してください。

par ユーティリティを使用するには、エクスポートまたはインポートするファイルがある Portal Server に、superuser としてログインする必要があります。エクスポートする場合、チャネル、ポートレット、またはプロバイダが要求するすべてのファイルを確実にエクスポートする必要があります。たとえば、チャネルにはスタティックなコンテンツファイルを、プロバイダにはプロバイダが使用するすべてのクラスファイルをインクルードする必要があります。コマンドラインで par ファイルに含まれるすべてのデータを指定すると操作が煩雑になるので、データを示す行を持つ簡単なテキストファイルを作成し、par ユーティリティでこの「エクスポートファイル」を呼び出します。詳細は、第 8 章「ポータルデスクトップサービスの管理」を参照してください。

新規の par ファイルを作成する

新規の par ファイルを作成してから、次の手順でチャネル、ポートレット、またはプロバイダをエクスポートします。

チャネル、ポートレット、またはプロバイダのエクスポート元となる Portal Server にログインします。

スクリプトがインストールされているディレクトリに移動します。次のように指定します。

cd PortalServer-base/SUNWps/bin

コマンドラインで par export コマンドとサブコマンドを次の引数を含めて入力します。作成する par ファイル名、エクスポートするディスプレイプロファイルドキュメントに対応するディレクトリサーバー名、および任意の数の (少なくとも 1 つ) のエクスポートファイルや from 以下に指定した引数を指定します。たとえば、o=sesta.com,o=isp から mychannel.par ファイルへ mychannel チャネルをエクスポートするには、次のコマンドを入力します。

./par export mychannel.par "o=sesta.com,o=isp" from:channel mychannel

詳しい構文情報については、『Sun Java System Portal Server 2005Q1 Technical Reference Guide』を参照してください。

既存の par ファイルを修正する

既存の par ファイルを修正して、次の手順でチャネル、ポートレット、またはプロバイダをエクスポートします。

チャネル、ポートレット、またはプロバイダのエクスポート元となる Portal Server にログインします。

スクリプトがインストールされているディレクトリに移動します。次のように指定します。

cd PortalServer-base/SUNWps/bin

コマンドラインで、modify オプションを使用して par export コマンドとサブコマンドを次の引数とともに入力します。修正する par ファイル名、エクスポートするディスプレイプロファイルドキュメントに対応するディレクトリサーバー名、および任意の数の (少なくとも 1 つ) のエクスポートファイル、または from 以下に指定した引数です。たとえば、mychannel.par ファイルを修正してスタティックコンテンツファイル /mycontent.html を含めるには、次のコマンドを入力します。

./par export --modify mychannel.par "dc=sesta,dc=com" "from= file /mycontent.html"

par ファイルを配備する

Portal Server へ par ファイルをインポートし、次の手順でプロバイダまたはチャネルをシステムに配備します。

プロバイダまたはチャネルに par ファイルをコピーして Portal Server へインポートし、そこにプロバイダまたはチャネルを配備します。

チャネル、ポートレット、またはプロバイダのインポート先となる Portal Server へログインします。

スクリプトがインストールされているディレクトリに移動します。次のように指定します。

cd PortalServer-base/SUNWps/bin

コマンドラインで par import コマンドとサブコマンドを次の引数を含めて入力します。インポートする par ファイル名、エクスポートするディスプレイプロファイルドキュメントに対応するディレクトリサーバー名です。たとえば、mychannel.par ファイルをインポートするには、次のコマンドを入力します。

./par import --auto myfile.par "do=sesta,dc=com"

前へ目次索引次へ
Sun Java System Portal Server 6 2005Q1 管理ガイド