殆どのポートレットの共通設定

共通の要素

• portlet-entry
• meta-info
• classname
• parameter
• url
• security
• media-type

レジストリエントリのサンプル

ポートレット定義

属性名	説明
name	ポートレット名。一意でなければなりません。
type	portlet-entryのタイプ 取りうる値 abstract 直接作成できないポートレットとなります。ポートレットのテンプレートとして働き、 関連したポートレットのグループの共通プロパティを定義するのに有効です。 instance 基本エントリのポートレットです。ポートレット生成に必要な全ての情報（少なくともクラス名）を与えておく必要があります。 ref 既に存在する<portlet-entry>（いかなるタイプでも可能：他のrefエントリでもOK）をベースにしたポートレットです。 Jetspeedエンジンは、抽象型あるいはインスタンスのエントリを見つけるまで、全てのrefエントリを追っていきます。 そして、抽象型あるいはインスタンスの定義で見つかる全てのパラメタを上書きし、纏めた定義を使ってポートレットを生成します。
hidden	取りうる値 false true
application	ポートレットが全画面表示されます。すなわち、ポートレットのみが表示されます。 取りうる値 false true

項目（ポートレット、パラメタ等）を表現する典型的なオプション情報。 Meta-info は、Jetspeedのカスタマイザで使われます。 この情報は、ポートレットタイプのうちのいくつかでも利用可能です。

要素: title

項目（ポートレット、パラメタ等）のタイトル 親要素 デフォルト portlet-entry portlet-entryのname属性値 parameter パラメタのname属性値

要素: description

項目（ポートレット、パラメタ等）の説明。descriptionのデフォルト値はありません。

要素: icon

アイコンのパス及びファイル名（<jetspeed_home>の相対パス）

コンテンツを生成するのに使うJavaクラス

hidden属性は、カスタマイザがパラメタを表示するかどうかを制御します。

この要素はオプションです。

属性名	説明
name	ポートレットやパラメタ等の名前
value	デフォルト値／初期値
type	データタイプの値。この属性が何もなければ、いかなるキャラクタ文字列も受け付けます。 取りうる値 boolean このパラメタ値として許されるのはtrueあるいはfalseのみです
hidden	取りうる値 false true

パラメタ名	説明
_display	ポートレットの初期表示状態。 このパラメタは、PSMLでのみセットされます。 何もなければ、デフォルトは：normal Value 説明 closed ポートレットは閉じていて見えません minimized ポートレットは最小化されており、タイトルのみが表示されます normal ポートレットとコンテンツが表示されます
_showtitlebar	タイトルバーを表示するかどうかです。タイトルバーには、 ポートレットタイトルとアクションボタン（最小化・最大化・カスタマイズ・閉じる）が含まれています。 タイトルバーが表示されない場合、すなわち値がfalseである場合には、ユーザは （権限があれば）ポートレットやカスタマイザの追加・削除が出来るのみです。 このパラメタはPSMLか.xregファイルでセットされます。 このパラメタは、バージョン1.3a3で追加されました。 何も無ければ、デフォルトは：true 値 説明 true ポートレットのタイトルバーが表示されます false ポートレットのタイトルバーは表示されません
_TimeToLive	How long, in milliseconds, should the portlet remain idle in cache. This parameter is used to override the default value. Example: _TimeToLive = 300000 which is 5 minutes (5 * 60 * 1000) and the portlet cached expires every 3 minutes. Time Activity 1:00 Portlet created 1:00 User Joe displayed the portlet content 1:03 Portlet marked as expired, the portlet's refresh() is called, the portlet is no longer expired 1:05 User Sam displayed the portlet content 1:06 Portlet marked as expired, the portlet's refresh() is called, the portlet is no longer expired 1:09 Portlet marked as expired, the portlet's refresh() is called, the portlet is no longer expired 1:12 Portlet marked as expired. Since the portlet has been idle for 7 minutes, the portlet will be removed from cache. This parameter can be set in PSML or in the .xreg files. このパラメタは、バージョン1.3a3で追加されました。

Since the configuration file is an XML file, some character must be represented using XML entities.

文字	XMLエンティティ
&	&
<	&lt;
>	&gt;

取りうるプロトコル	説明
http://	標準HTTPプロトコルがファイルやデータ取得に使われます
	ファイルはローカルにあり、パスは<jetspeed_home>の相対パスです

Good URLs:

<url>http://jakata.apache.org/jetspeed</url>

Basic URL

<url>http://search.yahoo.com/bin/search?p=jetspeed</url>

1 Parameter passed

<url>http://search.yahoo.com/search?p=jetspeed&amp;n=100</url>

2 Parameter passed

Bad URLs:

<url>index.html</url>

No protocol, http:// or hostname

<url>http://search.yahoo.com/search?p=jetspeed&n=100</url>

Contains & instead of &amp;.

このアイテム（ポートレット、パラメタ等）へのアクセスを制限するカスタマイザによって使われます。

属性名	説明
role	この項目を選択する為にユーザに必要なロール

ポータルを表示し設定可能なメディアタイプ

メディアタイプは、<jetspeed_home>/WEB-INF/conf/media.xreg 内で定義されます。

属性名	説明
ref	メディアタイプ

抽象型ポータルエントリ

	<portlet-entry name="RSS" hidden="false" type="abstract" application="false"> <meta-info> <title></title> <description></description> </meta-info> <classname>org.apache.jetspeed.portal.portlets.NewRSSPortlet</classname> <parameter name="stylesheet" value="/WEB-INF/xsl/rss.xsl" hidden="false"> <meta-info> <title></title> <description></description> </meta-info> <security role="admin"/> </parameter> <media-type ref="html"/> <media-type ref="wml"/> </portlet-entry>

参照型ポータルエントリ

	<portlet-entry name="RSS" hidden="false" type="ref" application="false"> <meta-info> <title></title> <description></description> </meta-info> <parameter name="" value="" hidden="false"> <meta-info> <title></title> <description></description> </meta-info> <security role=""/> </parameter> </portlet-entry>