テンプレートの構文とセマンティクス

個々のテンプレートは、XML 形式の 1 つ以上のロールテンプレート (member.xml 、owner.xml、visitor.xml、 deleted.xml、disabled.xml) で構成されます。テンプレートディレクトリには、そのテンプレートで提供するロールに対応した XML ファイルが含まれます。たとえば、コミュニティーのメンバーには member.xml が、所有者には owner.xml が、ビジターには visitor.xml がそれぞれ対応します。

個々のロールテンプレートは、そのロールを持つコミュニティーユーザーに対するディスプレイプロファイルドキュメントです。ファイルはディスプレイプロファイル DTD に基づいている必要があります。

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">
<DisplayProfile version="1.0" priority="%COMMUNITY_DP_PRIORITY%">
	<Properties/>
	<Channels>
		<Container name="%COMMUNITY_CONTAINER%" provider="JSPTableContainerProvider">
			<Properties>
				<String name="title" value="%COMMUNITY_NAME%"/>
				<String name="description" value="%COMMUNITY_DESCRIPTION%"/>
				<Boolean name="compileToRealPath" value="true"/>
			</Properties>
			<Available>...</Available>
			<Selected>...</Selected>
			<Channels>...</Channels>
	</channels>
	<Providers/>
</DisplayProfile>

次に示すのは、ディスプレイプロファイル内の (% で囲まれた) トークンの説明です。これらはコミュニティーの作成時に、テンプレートエンジンによって実際の値に動的に置き換えられます。

%COMMUNITY_NAME%

コミュニティーに付ける (ユーザーにわかりやすい) 名前を指定します。例: tourists

%COMMUNITY_ID%

コミュニティーを識別する一意の文字列を指定します。この名前はあくまで内部表現であり、ユーザーインタフェースに表示されることはありません。例: jdo__tourists

%COMMUNITY_DESCRIPTION%

コミュニティーの説明です。

%COMMUNITY_CONTAINER%

コミュニティーの最上位コンテナを指定します。例: jdo__touristsContainer

%COMMUNITY_DP_PRIORITY%

結果のコミュニティーディスプレイプロファイルに付与される、ディスプレイプロファイルのマージ優先順位を指定します。付与される値はロールごとに異なります。デフォルトでは、visitor ロールには 1000、member ロールには 1005、owner ロールには 1010 が付与されます。

%COMMUNITY_SEARCH_URL%

コミュニティーの検索サーバー URL を指定します。

%COMMUNITY_CONTENTS_SEARCH_DB%

コミュニティーコンテンツの検索データベースを指定します。

%COMMUNITY_DISCUSSIONS_SEARCH_DB%

ディスカッションデータベースを指定します。

%PORTAL_ID%

ポータルの ID を指定します。例: portal1