ポータルコンテンツ管理

表8-1 Bulk Loader のスイッチ設定

スイッチ設定	解説
-verbose	詳細なメッセージを表示する。
+verbose	実行時にメッセージを表示しない（デフォルト）。
-recurse	ディレクトリ内を再帰的に処理する（デフォルト）。
+recurse	ディレクトリ内を再帰的に処理しない。
-delete	データベースからドキュメントを削除する。
+delete	データベースにドキュメントを挿入する（デフォルト）。
-metaparse	HTML ファイルの <meta> タグを解析する（デフォルト）。
+metaparse	HTML ファイルの <meta> タグを解析しない。
-cleanup	指定された場合、-d 引数をドキュメントベースとして、テーブルのクリーンアップだけを実行する（すべてのファイルはそのディレクトリ下に存在しなければならない）。
+cleanup	テーブルのクリーンアップを実行せずに、ドキュメントをロードする（デフォルト）。
-hidden	隠しファイルおよび隠しディレクトリを無視するよう指定する（デフォルト）。
+hidden	隠しファイルおよび隠しディレクトリも処理の対象に含めるよう指定する。
-inheritProps	再帰処理時にメタデータプロパティを継承するよう指定する（デフォルト）。
+inheritProps	再帰処理時にメタデータプロパティを継承しないよう指定する。
-truncate	データ値がデータベースにとって大きすぎる（loader.properties で指定）場合、値の切り捨てを試みる。
+truncate	データ値の切り捨てを試みない（デフォルト）。
-ignoreErrors	ドキュメントのロード中は、エラーをすべて無視する（エラーの報告は行われる）。
+ignoreErrors	エラー発生時には処理を停止する（デフォルト）。
-htmlPat <pattern>	<meta> タグの解析を行うかどうかを判断する際にどのファイルが HTML ファイルなのかを判断するためのパターンを指定する。これは何度でも指定可能。何も指定されない場合には、.htm と .html が使用される。
-properties <name>	connectionPool が定義されている loaddocs.properties ファイルの位置を指定する。このファイルには、-columnMap 引数と同様の jdbc.column.<columnName>=<propname> という形式のエントリを記述してもよい。
-conPool <name>	BulkLoader による接続情報の取得先となるプロパティファイルに記述されている connectionPool 名を指定する。
-schema <name>	BulkLoader によって生成されるスキーマファイルのパスを指定する（デフォルトは document-schema.xml）。
+schema	指定された場合、スキーマファイルは作成されない。
-schemaName <name>	BulkLoader によって生成されるスキーマの名前を指定する。デフォルトは「LoadedData」。
-encoding <name>	使用するファイルエンコーディングを指定する。デフォルトは、システムのデフォルトエンコーディング（有効なエンコーディング名については JDK マニュアルを参照）。
-commitAfter <num>	この数のドキュメントがロードされたあとに JDBC トランザクションをコミットする。デフォルトでは、すべてをロードしたあとでのみコミットする。
-match <pattern>	BulkLoader の処理の対象となるファイルパターンを指定する。これは何度でも指定可能。何も指定されない場合には、すべてのファイルとディレクトリが対象となる。
-ignore <pattern>	BulkLoader の処理の対象とならないファイルパターンを指定する。これは何度でも指定可能。
-d <dir>	相対パスの基準となる docBase を指定する。指定されない場合には、「.」（カレントディレクトリ）が使用される。
-mdext <ext>	メタデータプロパティファイルのファイル名拡張子を指定する。必ず「.」で始まる値を指定する（デフォルトは .md.properties）。
-filter <filter class>	ファイルを処理する際に用いる LoaderFilter のクラス名を指定する。これを複数回指定すれば、LoaderFilte のリストに追加することができる。
+filters	LoaderFilter の現在のリストをクリアする（デフォルトフィルタもクリアされる）。
--	後続のものがすべてファイルまたはディレクトリとみなされる。
-columnMap <file.properties>	DOCUMENT テーブルの追加カラム（-column を参照）のリスト（各エントリは jdbc.column.<columnName>=<propname,...> の形式）が記載されているプロパティファイルを指定する。これは、標準カラムの動作をオーバーライドするために使用することはできない。
-column <columnName>=<propName,...>	DOCUMENT テーブルの追加カラムと、そのカラムにマップされるプロパティ名を指定する。これは、標準カラムの動作をオーバーライドするために使用することはできない。
+columns	コンフィグレーション済みの追加カラムをすべてクリアする。

属性	画面上の表示名/コントロールタイプ	解説
DocumentConnectionPoolName	[ドキュメント接続プール名] テキストボックス	DocumentManager で使用する DocumentConnectionPool MBean の名前を指定する。
PropertyCase	[プロパティの大文字/小文字の区別] ドロップダウンリスト	入力されるプロパティ名が DocumentManager によってどう変更されるかを指定する。この属性が lower の場合には、すべてのプロパティ名は小文字に変換される。この属性が upper の場合には、すべてのプロパティ名は大文字に変換される。この属性が上記以外のものか未指定の場合には、プロパティ名は変更されない。 lower と upper のどちらにするかは、使用するドキュメント接続プール実装によって決まる。ドキュメント参照実装の場合には、PropertyCase を指定してはいけない。
MetadataCaching	[メタデータキャッシングが有効か] チェックボックス	検索の結果得られる Document メタデータを DocumentManager でキャッシュするか否かを指定する。 true の場合、DocumentManager では、MetadataCacheName で指定される com.bea.p13n.cache.Cache に検索結果がキャッシュされる。キャッシュしない場合には、false を指定する。デフォルトは true。
MetadataCacheName	[メタデータキャッシュ名] テキストボックス	MetadataCaching が true に設定されている場合に使用する com.bea.p13n.cache.Cache の名前を指定する。デフォルトは documentMetadataCache。
UserIdInCacheKey	[ユーザ ID がキャッシュキーに含まれているか] チェックボックス	ドキュメントのメタデータまたはコンテンツをキャッシュする際にユーザの識別子をキーの一部として使用するか否かを指定する。デフォルトは true。 WebLogic Portal の参照実装ドキュメント管理システムを使用する場合には、false に設定する。
ContentCaching	[コンテンツキャッシングが有効か] チェックボックス	DocumentManager でドキュメントコンテンツ（すなわち、ドキュメントのバイトデータ）をキャッシュするか否かを指定する。 DocumentManager にドキュメントコンテンツのバイトデータをキャッシュさせる場合には true に設定し、そうでなければ false に設定する。デフォルトは true。
ContentCacheName	[コンテンツキャッシュ名] テキストボックス	ContentCaching が true に設定されている場合に使用する com.bea.p13n.cache.Cache の名前を指定する。デフォルトは documentContentCache。
MaxCachedContent Size	[キャッシュされるコンテンツの最大サイズ] テキストボックス	ContentCaching が true の場合に DocumentManager でキャッシュされるドキュメントコンテンツの最大バイト数を指定する。デフォルトは 32768 (32K) バイト。
JNDIName	該当せず	この MBean に接続される DocumentManager EJB の JNDI ホーム名を指定する。その値では ${APPNAME} 構文要素を使用することができ、それは現在の J2EE アプリケーション名に置き換えられる。これは、com.bea.p13n.content.PropertySet RepositoryImpl において、ドキュメントプロパティセット情報を PropertySetManager に結び付けるために使用される。

属性

画面上の表示名/コントロールタイプ

解説

DocumentConnectionPoolName

[ドキュメント接続プール名]

テキストボックス

DocumentManager で使用する DocumentConnectionPool MBean の名前を指定する。

PropertyCase

[プロパティの大文字/小文字の区別]

ドロップダウンリスト

入力されるプロパティ名が DocumentManager によってどう変更されるかを指定する。

この属性が lower の場合には、すべてのプロパティ名は小文字に変換される。

この属性が upper の場合には、すべてのプロパティ名は大文字に変換される。

この属性が上記以外のものか未指定の場合には、プロパティ名は変更されない。

lower と upper のどちらにするかは、使用するドキュメント接続プール実装によって決まる。ドキュメント参照実装の場合には、PropertyCase を指定してはいけない。

MetadataCaching

[メタデータキャッシングが有効か]

チェックボックス

検索の結果得られる Document メタデータを DocumentManager でキャッシュするか否かを指定する。 true の場合、DocumentManager では、MetadataCacheName で指定される com.bea.p13n.cache.Cache に検索結果がキャッシュされる。キャッシュしない場合には、false を指定する。デフォルトは true。

MetadataCacheName

[メタデータキャッシュ名]

テキストボックス

MetadataCaching が true に設定されている場合に使用する com.bea.p13n.cache.Cache の名前を指定する。デフォルトは documentMetadataCache。

UserIdInCacheKey

[ユーザ ID がキャッシュキーに含まれているか]

チェックボックス

ドキュメントのメタデータまたはコンテンツをキャッシュする際にユーザの識別子をキーの一部として使用するか否かを指定する。デフォルトは true。 WebLogic Portal の参照実装ドキュメント管理システムを使用する場合には、false に設定する。

ContentCaching

[コンテンツキャッシングが有効か]

チェックボックス

DocumentManager でドキュメントコンテンツ（すなわち、ドキュメントのバイトデータ）をキャッシュするか否かを指定する。 DocumentManager にドキュメントコンテンツのバイトデータをキャッシュさせる場合には true に設定し、そうでなければ false に設定する。デフォルトは true。

ContentCacheName

[コンテンツキャッシュ名]

テキストボックス

ContentCaching が true に設定されている場合に使用する com.bea.p13n.cache.Cache の名前を指定する。デフォルトは documentContentCache。

MaxCachedContent
Size

[キャッシュされるコンテンツの最大サイズ]

テキストボックス

ContentCaching が true の場合に DocumentManager でキャッシュされるドキュメントコンテンツの最大バイト数を指定する。デフォルトは 32768 (32K) バイト。

JNDIName

該当せず

この MBean に接続される DocumentManager EJB の JNDI ホーム名を指定する。その値では ${APPNAME} 構文要素を使用することができ、それは現在の J2EE アプリケーション名に置き換えられる。これは、com.bea.p13n.content.PropertySet RepositoryImpl において、ドキュメントプロパティセット情報を PropertySetManager に結び付けるために使用される。

<DocumentConnectionPool

Name="default"DriverName="com.bea.p13n.content.document. jdbc.Driver"URL="jdbc:beasys:docmgmt:com.bea.p13n.content
document.ref.RefDocumentProvider"
Properties="jdbc.dataSource=weblogic.jdbc.pool.commercePool;
schemaXML=D:/bea/user_projects/myNEWdomain/dmsBase/
doc-schemas;docBase=D:/bea/user_projects/myNEWdomain/dmsBase"
InitialCapacity="20"
MaxCapacity="20"
CapacityIncrement="0"

属性	画面上のラベル/ コントロールタイプ	解説
DriverName	[ドライバ名] テキストボックス	使用する JDBC ドライバクラス名を指定する。これは、com.bea.p13n.content.document.jdbc.Driver に設定しなければならない。
URL	[ JDBC URL] テキストボックス	使用する JDBC URL を指定する。 WebLogic Portal の参照実装ドキュメント管理システムの場合には、以下のとおりに設定。 jdbc:beasys:docmgmt:com.bea.p13n.content.document.ref.RefDocumentProvider それとは別の Document Provider の場合には、以下を使用。 jdbc:beasys:docmgmt:<classname> ここで、<classname> は com.bea.p13n.content. document.spi.DocumentProvider の実装の完全修飾クラス名。
Properties	[JDBC プロパティ] テキストボックス	プロパティの「名前=値」ペアをセミコロンで区切って並べたリストで、URL に指定された DocumentProvider にこれが渡される。参照実装で認識されるプロパティの一覧については、表8-4 を参照のこと。
InitialCapacity	[プールの初期容量] テキストボックス	ドキュメント接続プールの起動時に作成される接続の初期数を指定する。
MaxCapcity	[プールの最大容量] テキストボックス	このプールで作成および維持管理される接続の最大数を指定する。
CapacityIncrement	[容量増分] テキストボックス	利用可能な接続を作成することが必要になるたびにプールで作成される接続の数を指定する。
LoginTimeout	該当せず	接続を待つ時間（この時間が過ぎたら、例外が送出される）を指定する。プールにタイムアウトさせない場合には、0 以下を使用する（これがデフォルト）。
ClassPath	該当せず	接続プールで Driver クラスと DocumentProvider クラスのロード時に使用すべき追加のディレクトリや JAR をセミコロンで区切って並べたリスト。指定されるパスはすべて、アプリケーションディレクトリからの相対パスとみなされる。

属性

画面上のラベル/
コントロールタイプ

解説

DriverName

[ドライバ名]

テキストボックス

使用する JDBC ドライバクラス名を指定する。これは、com.bea.p13n.content.document.jdbc.Driver に設定しなければならない。

URL

[ JDBC URL]

テキストボックス

使用する JDBC URL を指定する。

WebLogic Portal の参照実装ドキュメント管理システムの場合には、以下のとおりに設定。

jdbc:beasys:docmgmt:com.bea.p13n.content.document.ref.RefDocumentProvider

それとは別の Document Provider の場合には、以下を使用。

jdbc:beasys:docmgmt:<classname>
ここで、<classname> は com.bea.p13n.content. document.spi.DocumentProvider の実装の完全修飾クラス名。

Properties

[JDBC プロパティ]

テキストボックス

プロパティの「名前=値」ペアをセミコロンで区切って並べたリストで、URL に指定された DocumentProvider にこれが渡される。参照実装で認識されるプロパティの一覧については、表8-4 を参照のこと。

InitialCapacity

[プールの初期容量]

テキストボックス

ドキュメント接続プールの起動時に作成される接続の初期数を指定する。

MaxCapcity

[プールの最大容量]

テキストボックス

このプールで作成および維持管理される接続の最大数を指定する。

CapacityIncrement

[容量増分]

テキストボックス

利用可能な接続を作成することが必要になるたびにプールで作成される接続の数を指定する。

LoginTimeout

該当せず

接続を待つ時間（この時間が過ぎたら、例外が送出される）を指定する。プールにタイムアウトさせない場合には、0 以下を使用する（これがデフォルト）。

ClassPath

該当せず

接続プールで Driver クラスと DocumentProvider クラスのロード時に使用すべき追加のディレクトリや JAR をセミコロンで区切って並べたリスト。指定されるパスはすべて、アプリケーションディレクトリからの相対パスとみなされる。

プロパティ	解説
jdbc.dataSource	データベース接続の取得に使用する javax.sql.DataSource の JNDI 名を指定する。このデータソースは、 DOCUMENT テーブルと DOCUMENT_METADATA テーブルの入ったデータベースに接続しなければならない。
jdbc.url	接続先の JDBC URL を指定する。 jdbc.dataSource が指定されている場合には、これは無視される。
jdbc.driver	ロードすべき JDBC ドライバクラスを指定する。 jdbc.dataSource が指定されている場合には、これは無視される。
jdbc.isPooled	true の場合、jdbc.url が jdbc:weblogic:pool または jdbc:weblogic:jts で始まる場合、あるいは、jdbc.dataSource が指定されている場合には、接続はプールされておりキャッシュされないと仮定される。それ以外の場合には、接続はプールされておらず 1 つの接続のみを維持すると仮定される。
jdbc.supportsLikeEscape Clause	基礎となるデータベースで SQL の LIKE ESCAPE 句がサポートされているか否かを指定する。これが指定されない場合には、接続はクエリされる。
jdbc.docBase	ドキュメントがどのベースディレクトリ下に格納されているかを指定する。データベースに格納されているパスはすべて、ここに指定したディレクトリからの相対パスとみなされる。
jdbc.schemaXML	プロパティセット情報が記述された XML ファイル（ドキュメントスキーマ DTD に準拠）の格納先ディレクトリのパスを指定する。システムはこのディレクトリ内を再帰的に調べて、.xml で終わるファイルをすべてロードする。
jdbc.isolationLevel	データベース接続に設定するトランザクションアイソレーションレベルをコンフィグレーションする。指定可能な値は以下のいずれか。 READ_COMMITTED READ_UNCOMMITTED SERIALIZABLE REPEATABLE_READ NONE 未指定の場合には、デフォルトで SERIALIZABLE とみなされる。詳細については、『Javadoc API マニュアル』内の java.sql.Connection を参照のこと。
jdbc.column.<colName>	DOCUMENT テーブルの追加カラムを指定する。値は、そのカラムにマップされるプロパティ名をカンマで区切って並べたリスト。これは何度でも指定可能。 BulkLoader の -columnMap 引数と -column 引数の両方あるいはいずれか一方と一緒に使用しなければならない。同じプロパティが複数のカラムにマップされる場合には、結果がどうなるかはわからない。

プロパティ

解説

jdbc.dataSource

データベース接続の取得に使用する javax.sql.DataSource の JNDI 名を指定する。このデータソースは、 DOCUMENT テーブルと DOCUMENT_METADATA テーブルの入ったデータベースに接続しなければならない。

jdbc.url

接続先の JDBC URL を指定する。 jdbc.dataSource が指定されている場合には、これは無視される。

jdbc.driver

ロードすべき JDBC ドライバクラスを指定する。 jdbc.dataSource が指定されている場合には、これは無視される。

jdbc.isPooled

true の場合、jdbc.url が jdbc:weblogic:pool または jdbc:weblogic:jts で始まる場合、あるいは、jdbc.dataSource が指定されている場合には、接続はプールされておりキャッシュされないと仮定される。それ以外の場合には、接続はプールされておらず 1 つの接続のみを維持すると仮定される。

jdbc.supportsLikeEscape   Clause

基礎となるデータベースで SQL の LIKE ESCAPE 句がサポートされているか否かを指定する。これが指定されない場合には、接続はクエリされる。

jdbc.docBase

ドキュメントがどのベースディレクトリ下に格納されているかを指定する。データベースに格納されているパスはすべて、ここに指定したディレクトリからの相対パスとみなされる。

jdbc.schemaXML

プロパティセット情報が記述された XML ファイル（ドキュメントスキーマ DTD に準拠）の格納先ディレクトリのパスを指定する。システムはこのディレクトリ内を再帰的に調べて、.xml で終わるファイルをすべてロードする。

jdbc.isolationLevel

データベース接続に設定するトランザクションアイソレーションレベルをコンフィグレーションする。指定可能な値は以下のいずれか。

READ_COMMITTED

READ_UNCOMMITTED

SERIALIZABLE

REPEATABLE_READ

NONE

未指定の場合には、デフォルトで SERIALIZABLE とみなされる。

詳細については、『Javadoc API マニュアル』内の java.sql.Connection を参照のこと。

jdbc.column.<colName>

DOCUMENT テーブルの追加カラムを指定する。値は、そのカラムにマップされるプロパティ名をカンマで区切って並べたリスト。これは何度でも指定可能。 BulkLoader の -columnMap 引数と -column 引数の両方あるいはいずれか一方と一緒に使用しなければならない。同じプロパティが複数のカラムにマップされる場合には、結果がどうなるかはわからない。

属性	解説
id	配列の名前を指定する。この属性は必須。たとえば、<pz:contentSelector id="docs" .../> と指定すると、docs という名前の配列にドキュメントが格納される。
max	コンテンツセレクタ用の配列に格納されるドキュメントの数の上限を指定する。たとえば、<pz:contentSelector max="10" .../> と指定すると、配列にドキュメントが 10 個格納された時点で、コンテンツセレクタはドキュメントの取得を止める。この属性は省略可能で、デフォルト値は -1（上限なし）。
sortBy	配列内のドキュメントのソートに用いるドキュメント属性を任意の数だけ指定する。 sortBy 属性の指定には、SQL の order by 句の構文を用いる。この属性は省略可能。この属性を指定しない場合、コンテンツセレクタは、コンテンツ管理システムから返された順にクエリ結果を返す。たとえば、<pz:contentSelector sortBy="creationDate" .../> と指定すると、ドキュメントは作成日の早い順に配列に格納される。また、<pz:contentSelector sortBy="creationDate ASC, title DESC" .../> というタグでは、ドキュメントは作成日の早い順に配列に格納され、同じ日に作成されたドキュメントが複数あれば、それらはタイトルの逆アルファベット順にソートされる。

属性

解説

配列の名前を指定する。この属性は必須。

たとえば、<pz:contentSelector id="docs" .../> と指定すると、docs という名前の配列にドキュメントが格納される。

max

コンテンツセレクタ用の配列に格納されるドキュメントの数の上限を指定する。

たとえば、<pz:contentSelector max="10" .../> と指定すると、配列にドキュメントが 10 個格納された時点で、コンテンツセレクタはドキュメントの取得を止める。

この属性は省略可能で、デフォルト値は -1（上限なし）。

sortBy

配列内のドキュメントのソートに用いるドキュメント属性を任意の数だけ指定する。 sortBy 属性の指定には、SQL の order by 句の構文を用いる。

この属性は省略可能。この属性を指定しない場合、コンテンツセレクタは、コンテンツ管理システムから返された順にクエリ結果を返す。

たとえば、<pz:contentSelector sortBy="creationDate" .../> と指定すると、ドキュメントは作成日の早い順に配列に格納される。

また、<pz:contentSelector sortBy="creationDate ASC, title DESC" .../> というタグでは、ドキュメントは作成日の早い順に配列に格納され、同じ日に作成されたドキュメントが複数あれば、それらはタイトルの逆アルファベット順にソートされる。

属性	解説
useCache	コンテンツセレクタ用の配列をキャッシュに格納するかどうかを指定する。キャッシュを有効にするには、この属性を true に設定する。たとえば、<pz:contentSelector cache="true" ...> と指定する。キャッシュを無効にするには、この属性を false に設定するか、この属性をタグに付けない。たとえば、以下の指定は機能的に等価。 <pz:contentSelector cache="false" .../> <pz:contentSelector ...>
cacheId	キャッシュの名前を指定する。この属性を指定しない場合、キャッシュ名には配列の名前（id 属性で指定する必要がある）が使用される。配列を作成した JSP またはユーザセッション以外からキャッシュにアクセスする場合には、cacheId を指定する必要がある。
cacheTimeout	WebLogic Portal でキャッシュが保持される時間をミリ秒単位で指定する。コンテンツセレクタは、指定された時間が経過するまでクエリを再実行しない。たとえば、次のようにタグを記述するとしよう。 <pz:contentSelector cache="true" cacheTimeout="300000" .../> 顧客がこのコンテンツセレクタタグを含むページを要求する。顧客はいったん別のページに移動し、2 分（120000 ミリ秒）後に再びこのページを要求する。このとき、コンテンツセレクタでキャッシュのタイムアウト条件が評価されるが、コンテンツセレクタがキャッシュを作成してから 120000 ミリ秒しか経過していないため、クエリは再実行されない。その代わり、キャッシュ内のドキュメントが表示される。
cacheScope	キャッシュへのアクセスを許可する範囲を指定する。この属性に指定できる値は以下のとおり。 application : 任意の顧客が要求する、Web アプリケーション内の任意の JSP ページからキャッシュにアクセスできる。 session（デフォルト）: 現在の顧客が要求する、Web アプリケーション内の任意の JSP からキャッシュにアクセスできる。 page : 任意の顧客が要求する現在の JSP からしかキャッシュにアクセスできない。 request : 現在のユーザリクエストからしかキャッシュにアクセスできない。顧客がページを再び要求した場合、コンテンツセレクタはクエリを再実行し、キャッシュを作成し直す。

属性

解説

useCache

コンテンツセレクタ用の配列をキャッシュに格納するかどうかを指定する。キャッシュを有効にするには、この属性を true に設定する。たとえば、<pz:contentSelector cache="true" ...> と指定する。

キャッシュを無効にするには、この属性を false に設定するか、この属性をタグに付けない。たとえば、以下の指定は機能的に等価。

<pz:contentSelector cache="false" .../>

<pz:contentSelector ...>

cacheId

キャッシュの名前を指定する。この属性を指定しない場合、キャッシュ名には配列の名前（id 属性で指定する必要がある）が使用される。配列を作成した JSP またはユーザセッション以外からキャッシュにアクセスする場合には、cacheId を指定する必要がある。

cacheTimeout

WebLogic Portal でキャッシュが保持される時間をミリ秒単位で指定する。コンテンツセレクタは、指定された時間が経過するまでクエリを再実行しない。

たとえば、次のようにタグを記述するとしよう。

<pz:contentSelector cache="true" cacheTimeout="300000" .../>

顧客がこのコンテンツセレクタタグを含むページを要求する。顧客はいったん別のページに移動し、2 分（120000 ミリ秒）後に再びこのページを要求する。このとき、コンテンツセレクタでキャッシュのタイムアウト条件が評価されるが、コンテンツセレクタがキャッシュを作成してから 120000 ミリ秒しか経過していないため、クエリは再実行されない。その代わり、キャッシュ内のドキュメントが表示される。

cacheScope

キャッシュへのアクセスを許可する範囲を指定する。この属性に指定できる値は以下のとおり。

application : 任意の顧客が要求する、Web アプリケーション内の任意の JSP ページからキャッシュにアクセスできる。

session（デフォルト）: 現在の顧客が要求する、Web アプリケーション内の任意の JSP からキャッシュにアクセスできる。

page : 任意の顧客が要求する現在の JSP からしかキャッシュにアクセスできない。

request : 現在のユーザリクエストからしかキャッシュにアクセスできない。顧客がページを再び要求した場合、コンテンツセレクタはクエリを再実行し、キャッシュを作成し直す。

タグ	解説
<um:getProfile>	現在ページを閲覧している顧客のプロファイルを取得する。コンテンツセレクタでは、その顧客プロファイルを用いて、顧客プロパティに絡む条件を評価する。たとえば、「Gold Customer」という顧客セグメントに属するあらゆる顧客用のクエリを実行するコンテンツセレクタを作成する場合、そのコンテンツセレクタでは、顧客プロファイルにアクセスして、プロファイルがこの顧客セグメントに合致するかどうかを判定する必要がある。コンテンツセレクタでの条件評価に顧客プロファイルを現在使用していない場合でも、JSP に <um:getProfile> タグを組み込んでおくことを推奨する。このタグがパフォーマンスに及ぼす影響はごくわずかであり、またこのタグがあれば、開発者に JSP の修正を依頼しなくても、顧客プロファイルに関わる条件をコンテンツセレクタに追加できる。このタグは、コンテンツセレクタタグの近くではなく、JSP の冒頭付近に記載する必要がある。
<es:forEachInArray>	コンテンツセレクタでのクエリの結果を格納する配列内のデータを順に処理する。このタグを用いれば、配列内の各ドキュメントに対して以下の処理を実行できる。 System.out.println メソッドを使って、配列内の各要素を出力する。 <cm:getProperty> タグを使って、配列内の各ドキュメントの属性を任意の数だけ取得する。これらの属性を用いて、ブラウザでのドキュメントの表示に必要な HTML を作成できる。たとえば、<cm:getProperty> タグを用いて、ドキュメントの MIME-type 属性の値を決定するとしよう。配列内のドキュメントの MIME タイプが画像である場合には、適切な属性値を付けて HTML の <img> タグを出力する。 <pz:contentSelector> タグの属性（sortBy など）を用いて、配列内のドキュメントの属性を操作することもできる。 <cm:printProperty> タグを用いて、配列内の各ドキュメントの属性を任意の数だけ出力する。たとえば、このタグを使用すれば、コンテンツセレクタで取得されたドキュメントのタイトル一覧を出力することができる。

タグ

解説

<um:getProfile>

現在ページを閲覧している顧客のプロファイルを取得する。コンテンツセレクタでは、その顧客プロファイルを用いて、顧客プロパティに絡む条件を評価する。

たとえば、「Gold Customer」という顧客セグメントに属するあらゆる顧客用のクエリを実行するコンテンツセレクタを作成する場合、そのコンテンツセレクタでは、顧客プロファイルにアクセスして、プロファイルがこの顧客セグメントに合致するかどうかを判定する必要がある。

コンテンツセレクタでの条件評価に顧客プロファイルを現在使用していない場合でも、JSP に <um:getProfile> タグを組み込んでおくことを推奨する。このタグがパフォーマンスに及ぼす影響はごくわずかであり、またこのタグがあれば、開発者に JSP の修正を依頼しなくても、顧客プロファイルに関わる条件をコンテンツセレクタに追加できる。

このタグは、コンテンツセレクタタグの近くではなく、JSP の冒頭付近に記載する必要がある。

<es:forEachInArray>

コンテンツセレクタでのクエリの結果を格納する配列内のデータを順に処理する。このタグを用いれば、配列内の各ドキュメントに対して以下の処理を実行できる。

System.out.println メソッドを使って、配列内の各要素を出力する。

<cm:getProperty> タグを使って、配列内の各ドキュメントの属性を任意の数だけ取得する。これらの属性を用いて、ブラウザでのドキュメントの表示に必要な HTML を作成できる。たとえば、<cm:getProperty> タグを用いて、ドキュメントの MIME-type 属性の値を決定するとしよう。配列内のドキュメントの MIME タイプが画像である場合には、適切な属性値を付けて HTML の <img> タグを出力する。

<pz:contentSelector> タグの属性（sortBy など）を用いて、配列内のドキュメントの属性を操作することもできる。

<cm:printProperty> タグを用いて、配列内の各ドキュメントの属性を任意の数だけ出力する。たとえば、このタグを使用すれば、コンテンツセレクタで取得されたドキュメントのタイトル一覧を出力することができる。

<pz:contentSelector rule="SpringSailing"
contentHome="<%=ContentHelper.DEF_DOCUMENT_MANAGER_HOME %>"
id="docs"
useCache="true" cacheId="SpringSailingDocs" cacheTimeout="120000"
cacheScope="application" />

要件	解説
ユニークなドキュメント ID	ドキュメントをシステム内の他のすべてのドキュメントから一意に識別する単一のキーが存在しなければならず、そのキーは String として表現できなければならない。たとえば、コンテンツ管理システムの中には、ドキュメントにオブジェクト ID を割り当てるものもあれば、相対パスを用いるものもある（参照実装はこちらのほう）。
ドキュメントメタデータ	ドキュメントに関するメタデータをすべて取得する手段が存在しなければならない。メタデータは、WebLogic Portal の標準データ型（Boolean、Integer、Float、DateTime、String、多値）で構成されているか、あるいはそれらのタイプに変換できなければならない。このメタデータには、少なくともドキュメントのサイズ（バイト単位）と MIME タイプ（MIME 1.0 に準拠）が含まれていなければならない。
ドキュメントコンテンツの取得	ドキュメントの未処理のバイトデータを取得する何らかの手段が存在しなければならない。
検索	CMS には、ドキュメントメタデータに対するクエリに基づいてドキュメントを検索する何らかのメカニズムが用意されていなければならない（WebLogic Portal では全文検索は必須ではない）。
スキーマ	CMS には、ドキュメントメタデータスキーマをエクスポーズするメカニズムが用意されていなければならない。スキーマには、メタデータ属性およびそれらのデータ型とドキュメントタイプとの関連付けが記述されている。ルールエディタはこのスキーマ情報を用いて、パーソナライゼーションを実現するコンテンツセレクタルールの作成を可能にする（通常のドキュメント検索方法ではスキーマ情報は使用されないため、パーソナライズされていないドキュメントの取得はスキーマがなくても可能）。
Java からのアクセス	CMS では、Java コードからドキュメントにアクセスするのに利用できる何らかのメカニズムがサポートされていなければならない。これに該当すると思われるものには、Java クラスライブラリ、JNI からアクセスできるネイティブ共有ライブラリ、ソケットベースのアクセス（HTTP、DCOM、クライアント/サーバなど）、DBMS レベルのアクセス、ファイルベースのアクセス、eLink 対応のアクセスなどがある（ただし、これらに限定されない）。なお、WebLogic Portal に用意されている参照実装内にパブリッシュする場合には、Java からのアクセスは必須ではない。

要件

解説

ユニークなドキュメント ID

ドキュメントをシステム内の他のすべてのドキュメントから一意に識別する単一のキーが存在しなければならず、そのキーは String として表現できなければならない。たとえば、コンテンツ管理システムの中には、ドキュメントにオブジェクト ID を割り当てるものもあれば、相対パスを用いるものもある（参照実装はこちらのほう）。

ドキュメントメタデータ

ドキュメントに関するメタデータをすべて取得する手段が存在しなければならない。メタデータは、WebLogic Portal の標準データ型（Boolean、Integer、Float、DateTime、String、多値）で構成されているか、あるいはそれらのタイプに変換できなければならない。このメタデータには、少なくともドキュメントのサイズ（バイト単位）と MIME タイプ（MIME 1.0 に準拠）が含まれていなければならない。

ドキュメントコンテンツの取得

ドキュメントの未処理のバイトデータを取得する何らかの手段が存在しなければならない。

検索

CMS には、ドキュメントメタデータに対するクエリに基づいてドキュメントを検索する何らかのメカニズムが用意されていなければならない（WebLogic Portal では全文検索は必須ではない）。

スキーマ

CMS には、ドキュメントメタデータスキーマをエクスポーズするメカニズムが用意されていなければならない。スキーマには、メタデータ属性およびそれらのデータ型とドキュメントタイプとの関連付けが記述されている。ルールエディタはこのスキーマ情報を用いて、パーソナライゼーションを実現するコンテンツセレクタルールの作成を可能にする（通常のドキュメント検索方法ではスキーマ情報は使用されないため、パーソナライズされていないドキュメントの取得はスキーマがなくても可能）。

Java からのアクセス

CMS では、Java コードからドキュメントにアクセスするのに利用できる何らかのメカニズムがサポートされていなければならない。これに該当すると思われるものには、Java クラスライブラリ、JNI からアクセスできるネイティブ共有ライブラリ、ソケットベースのアクセス（HTTP、DCOM、クライアント/サーバなど）、DBMS レベルのアクセス、ファイルベースのアクセス、eLink 対応のアクセスなどがある（ただし、これらに限定されない）。なお、WebLogic Portal に用意されている参照実装内にパブリッシュする場合には、Java からのアクセスは必須ではない。

インタフェース	解説
DocumentIterator	DocumentIterator インタフェースは、close() メソッドを追加して java.util.Iterator インタフェースを拡張したもの。この close() メソッドは、DocumentIterator がもう使用されなくなったときに呼び出され、DocumentIterator に結び付けられているリソースをすべてクリアする。このインタフェースによって呼び出されるメソッドは null を返してはいけない。それらのメソッドは、例外が必要な場合には DocumentException を送出しなければならない。結果セットが空の場合には、空の DocumentIterator を返さなければならない。
DocumentMetadataDef	DocumentMetadataDef インタフェースは、ドキュメントのメタデータ属性を表す。このインタフェースには、明示的メタデータを取得するメソッドと暗黙的（CMS 定義）メタデータを取得するメソッドが両方とも含まれている。 getProperty(String name) メソッドは暗黙的メタデータを取得するためのもので、明示的属性名（identifier、size、version、author、creationDate、lockedBy、modifiedDate、modifiedBy、description、comments、および mimeType）の入力に対してデータを返してはいけない。明示的プロパティを取得する際には、対応するメソッドがインフラストラクチャによって個別に呼び出される。
DocumentDef	DocumentDef インタフェースは、ドキュメントコンテンツの未処理のバイトデータを表す。このインタフェースでは 2 つのメソッドを実装する必要があるが、主に呼び出されるのは openStream() メソッドである。 openStream() から返される InputStream では、skip() メソッドと available() メソッドを効率的な方法でサポートすることをお勧めする。 skip() メソッドは、コンテンツのひとまとまりのバイトデータを WebLogic Portal に返す際に用いられる。また、available() メソッドは、ストリームから入手できるバイトデータの残量を決定するのに用いられる。
DocumentSchemaDef	DocumentSchemaDef は、基礎となる CMS で利用可能な単一のスキーマを表す。このインタフェースには、属性の名前、データ型、取り得る値、および概要を問い合わせるためのメソッドが含まれている。

インタフェース

解説

DocumentIterator

DocumentIterator インタフェースは、close() メソッドを追加して java.util.Iterator インタフェースを拡張したもの。この close() メソッドは、DocumentIterator がもう使用されなくなったときに呼び出され、DocumentIterator に結び付けられているリソースをすべてクリアする。このインタフェースによって呼び出されるメソッドは null を返してはいけない。それらのメソッドは、例外が必要な場合には DocumentException を送出しなければならない。結果セットが空の場合には、空の DocumentIterator を返さなければならない。

DocumentMetadataDef

DocumentMetadataDef インタフェースは、ドキュメントのメタデータ属性を表す。このインタフェースには、明示的メタデータを取得するメソッドと暗黙的（CMS 定義）メタデータを取得するメソッドが両方とも含まれている。 getProperty(String name) メソッドは暗黙的メタデータを取得するためのもので、明示的属性名（identifier、size、version、author、creationDate、lockedBy、modifiedDate、modifiedBy、description、comments、および mimeType）の入力に対してデータを返してはいけない。明示的プロパティを取得する際には、対応するメソッドがインフラストラクチャによって個別に呼び出される。

DocumentDef

DocumentDef インタフェースは、ドキュメントコンテンツの未処理のバイトデータを表す。このインタフェースでは 2 つのメソッドを実装する必要があるが、主に呼び出されるのは openStream() メソッドである。 openStream() から返される InputStream では、skip() メソッドと available() メソッドを効率的な方法でサポートすることをお勧めする。 skip() メソッドは、コンテンツのひとまとまりのバイトデータを WebLogic Portal に返す際に用いられる。また、available() メソッドは、ストリームから入手できるバイトデータの残量を決定するのに用いられる。

DocumentSchemaDef

DocumentSchemaDef は、基礎となる CMS で利用可能な単一のスキーマを表す。このインタフェースには、属性の名前、データ型、取り得る値、および概要を問い合わせるためのメソッドが含まれている。

<session>
<ejb-name>NewsletterDocumentManager</ejb-name>
<home>com.bea.p13n.content.document.DocumentManagerHome</home>
<remote>com.bea.p13n.content.document.DocumentManager</remote>
<ejb-class>com.bea.p13n.content.document.internal.
SPIFastDocumentManagerImpl</ejb-class>
<session-type>Stateless</session-type>

<env-entry>
<env-entry-name>DocumentManagerMBeanName</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>newsletter</env-entry-value>
</env-entry>
</session>

<assembly-descriptor>
<container-transaction>
<method>
<ejb-name>NewsletterDocumentManager</ejb-name>
<method-name>*</method-name>
</method>
<trans-attribute>Required</trans-attribute>
</container-transaction>
.
.
.
</assembly-descriptor>

<weblogic-ejb-jar>
<weblogic-enterprise-bean>
<ejb-name>NewsletterDocumentManager</ejb-name>
<entity-descriptor>
<persistence>
<persistence-type>
<type-identifier>WebLogic_CMP_RDBMS
</type-identifier>
<type-version>7.0</type-version>
<type-storage>META-INF/weblogic-cmp-rdbms-jar.xml
</type-storage>
</persistence-type>
<persistence-use>
<type-identifier>WebLogic_CMP_RDBMS
</type-identifier>
<type-version>6.0</type-version>
</persistence-use>
</persistence>
</entity-descriptor>

演算子の種類	特徴
ブール (==, !=)	ブール属性では、Boolean.TRUE または Boolean.FALSE に対して一致するかどうかのチェックが可能。
数値 (==, !=, >, <, >=, <=)	数値 (Numeric) 属性では、java.lang.Number に対して、標準的な大小比較 (等しい、大きい、小さい) が可能。
テキスト (==, !=, >, <, >=, <=, like)	テキスト文字列では、標準的な同等性チェック (大文字/小文字の区別あり) に加え、辞書順での大小比較が可能。さらに、文字列では、ワイルドカードパターンマッチング (すなわち、like 演算子) を用いた比較も可能。SQL の「LIKE」演算子や DOS プロンプトのファイル名照合と同様。この場合、任意の文字列と照合するにはアスタリスク () を、任意の 1 文字と照合するには疑問符 (?) を用いる。間欠的な照合 (例えば [] を使うもの) はサポートされていない。「」や「?」そのものと照合するには、バックスラッシュ (¥) をエスケープ文字として使用する。
日時 (==, !=, >, <, >=, <=)	日時属性では、java.sql.Timestamp に対して、標準的な大小比較 (等しい、大きい、小さい) が可能。
多値の比較演算子 (contains, containsall)	多値属性では、contains 演算子がサポートされる。この演算子は、その属性のサブタイプのオブジェクトを 1 つ取り、それが属性値の中に含まれているかどうかをチェックする。さらに、多値属性では、containsall 演算子もサポートする。これは、属性のサブタイプのオブジェクトのコレクションを取り、それらのすべてが属性値の中に含まれているかどうかをチェックするものである。多値属性に適用された単値の演算子は、属性の値のコレクション全体に適用されることになる。なんらかの値が演算子およびオペランドと一致すれば、true が返される。たとえば、多値のテキスト属性 keywords が、値として、BEA、Computer および WebLogic を持ち、オペランドが BEA の場合、< 演算子は true を返し (BEA はComputer よりも小さい)、> 演算子は false を返し (BEA よりも小さな値はない)、== 演算子は true を返す (BEA は BEA と等しい)。
ユーザ定義の比較演算子	現在、ユーザ定義の属性に適用できる演算子はない。

演算子の種類

特徴

ブール (==, !=)

ブール属性では、Boolean.TRUE または Boolean.FALSE に対して一致するかどうかのチェックが可能。

数値 (==, !=, >, <, >=, <=)

数値 (Numeric) 属性では、java.lang.Number に対して、標準的な大小比較 (等しい、大きい、小さい) が可能。

テキスト (==, !=, >, <, >=, <=, like)

テキスト文字列では、標準的な同等性チェック (大文字/小文字の区別あり) に加え、辞書順での大小比較が可能。さらに、文字列では、ワイルドカードパターンマッチング (すなわち、like 演算子) を用いた比較も可能。SQL の「LIKE」演算子や DOS プロンプトのファイル名照合と同様。この場合、任意の文字列と照合するにはアスタリスク (*) を、任意の 1 文字と照合するには疑問符 (?) を用いる。間欠的な照合 (例えば [] を使うもの) はサポートされていない。「*」や「?」そのものと照合するには、バックスラッシュ (¥) をエスケープ文字として使用する。

日時 (==, !=, >, <, >=, <=)

日時属性では、java.sql.Timestamp に対して、標準的な大小比較 (等しい、大きい、小さい) が可能。

多値の比較演算子 (contains, containsall)

多値属性では、contains 演算子がサポートされる。この演算子は、その属性のサブタイプのオブジェクトを 1 つ取り、それが属性値の中に含まれているかどうかをチェックする。さらに、多値属性では、containsall 演算子もサポートする。これは、属性のサブタイプのオブジェクトのコレクションを取り、それらのすべてが属性値の中に含まれているかどうかをチェックするものである。

多値属性に適用された単値の演算子は、属性の値のコレクション全体に適用されることになる。なんらかの値が演算子およびオペランドと一致すれば、true が返される。たとえば、多値のテキスト属性 keywords が、値として、BEA、Computer および WebLogic を持ち、オペランドが BEA の場合、< 演算子は true を返し (BEA はComputer よりも小さい)、> 演算子は false を返し (BEA よりも小さな値はない)、== 演算子は true を返す (BEA は BEA と等しい)。

ユーザ定義の比較演算子

現在、ユーザ定義の属性に適用できる演算子はない。

com.bea.p13n.expression.operator.logical.LogicalAnd、com.bea.p13n.expression.operator.logical.LogicalOr、com.bea.p13n.expression.operator.logical.LogicalMulitAnd、または com.bea.p13n.expression.operator.logical.LogicalMultiOr。

リクエストパラメータ	必須	解説
contentHome	場合による	contentHome 初期化パラメータが指定されない場合は、必須で、DocumentHome の JNDI 名として使用される。 contentHome 初期化パラメータが指定されている場合は、これは無視される。
contentId	いいえ	取り出すための Document の文字列識別子。指定されない場合、サーブレットは PATH_INFO 内を探す。
blockSize	いいえ	読み出すデータブロックのサイズ。デフォルトは 8K。 1 回の操作でブロック全体を読み出すには、0 以下を指定する。

リクエストパラメータ

必須

解説

contentHome

場合による

contentHome 初期化パラメータが指定されない場合は、必須で、DocumentHome の JNDI 名として使用される。 contentHome 初期化パラメータが指定されている場合は、これは無視される。

contentId

いいえ

取り出すための Document の文字列識別子。指定されない場合、サーブレットは PATH_INFO 内を探す。

blockSize

いいえ

読み出すデータブロックのサイズ。デフォルトは 8K。 1 回の操作でブロック全体を読み出すには、0 以下を指定する。