svnno****@sourc*****
svnno****@sourc*****
2007年 10月 19日 (金) 20:03:29 JST
Revision: 13
http://svn.sourceforge.jp/cgi-bin/viewcvs.cgi?root=jetspeed-japan&view=rev&rev=13
Author: karma
Date: 2007-10-19 20:03:28 +0900 (Fri, 19 Oct 2007)
Log Message:
-----------
initial revision
Modified Paths:
--------------
jetspeed-2-trans/trunk/ja/xdocs/guides/guide-profiler.xml
-------------- next part --------------
Modified: jetspeed-2-trans/trunk/ja/xdocs/guides/guide-profiler.xml
===================================================================
--- jetspeed-2-trans/trunk/ja/xdocs/guides/guide-profiler.xml 2007-10-19 07:47:32 UTC (rev 12)
+++ jetspeed-2-trans/trunk/ja/xdocs/guides/guide-profiler.xml 2007-10-19 11:03:28 UTC (rev 13)
@@ -1,11 +1,12 @@
<?xml version="1.0"?>
<!--
-Copyright 2004 The Apache Software Foundation
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
@@ -20,7 +21,7 @@
<subtitle>[Documentation for Jetspeed-2 Profiler] Jetspeed 2 のプロファイラに関する文書</subtitle>
<authors>
<person name="David Sean Taylor" email="taylo****@apach*****"/>
- </authors>
+ </authors>
<translators>
<person name="加藤泰文" email="karma****@prog*****" />
</translators>
@@ -30,298 +31,1217 @@
<div class="original">
<p>
The Jetspeed Profiler is a portal resource location rule-based engine.
-As of Jetspeed version 2.0, the profiler locates the following kinds of portal resources:
+The profiler locates the following kinds of portal resources:
+</p>
+</div>
+<p>
+Jetspeed のプロファイラは、ポータルのリソースの場所に関するルールベースのエンジンです。プロファイラは，以下のようなポータルリソースを決定します．
+</p>
+<div class="original">
<ul>
<li>PSML pages</li>
<li>Folders</li>
<li>Menus</li>
+ <li>Links</li>
</ul>
-When a request is received by the portal, the profiler will map the request to a resource
-based on a normalized set of runtime parameters and state such as request parameters, HTTP headers,
-and session attributes. The Profiler is invoked during the Jetspeed request processing pipeline in
-the profiler valve. This valve requires that the request context is already populated with
-the portal request and response, capabilities, language and user information.
-The runtime parameters make up the profile criterion which the profiler uses to locate
-portal resources.
-</p>
</div>
-<p>
-Jetspeed のプロファイラは、ポータルのリソースの場所に関するルールベースのエンジンです。Jetspeed のバージョン 2.0 では、プロファイラは以下のような種類のポータルリソースの場所を決定します。
<ul>
<li>PSML ページ</li>
<li>フォルダ</li>
<li>メニュー</li>
+ <li>リンク</li>
</ul>
-リクエストがポータルで受信されたとき、プロファイラは、実行時パラメータや状態 (リクエストパラメータ、HTTP ヘッダ、セッションの属性など) の正規化された値に基づき、リクエストをリソースと結びつけます。プロファイラはプロファイラバルブ内の Jetspeed のリクエスト処理パイプラインの中で呼び出されます。このバルブは、リクエストコンテキストが、既にポータルのリクエストやレスポンス、機能、言語、ユーザ情報と関連づけられている必要があります。実行時のパラメータは、プロファイラがポータルのリソースを位置を決定するのに使われる判断規準を作ります。
+
+<div class="original">
+<p>
+When a request is received by the portal, the profiler will compute a normalized instruction set, known
+as a profile locator. The locator is then added to the request context, from which subsequent components on the
+Jetspeed pipeline, most notably the Page Manager and Portal Site components, can take the profile locator
+and use it to find a requested resource. For example, the Page Manager uses the locator to find a page or folder.
+The Portal Site component uses the locator build the options on a menu.
</p>
+</div>
+<p>
+ポータルがリクエストを受信すると，プロファイラは，プロファイルロケータとして知られる，正規化した命令のセットを計算します．そして，ロケータは，リクエストコンテキストを追加します．Jetspeed パイプラインの後に続くコンポーネント，特にページマネージャとポータルサイトコンポーネントは，リクエストコンテキストからプロファイルロケータを取得し，リクエストされたリソースを見つけるために，それを使うことが出来ます．例えば，ページマネージャは，ページやフォルダを見つけるためにロケータを使います．ポータルサイトコンポーネントは，メニューの要素を追加するためにロケータを使います．
+</p>
<div class="original">
+<p>
+The profile locator is the output from the profiler. The input is a normalized set of runtime parameters and state.
+The profiler input is defined in profiling rules, and can be made of any Java class available on the pipeline.
+Jetspeed comes with quite a few predefined rules for taking criteria from request parameters, HTTP headers,
+security information, language and session attributes. The profiler is invoked during the Jetspeed request
+processing pipeline in the profiler valve.
+<img src="images/profiler/profiler-pipeline.jpg" border="1"/>
+</p>
+</div>
<p>
-The profiler works hand in hand with the Site and Page Manager components.
-The profiler takes runtime information as input, generalized that information
-into
+プロファイルロケータは，プロファイラの出力です．入力は，実行時のパラメータと状態の正規化されたセットです．プロファイラの入力は，プロファイリングルールで定義されます．そして，パイプラインの任意の Java クラスで利用可能なように作られます．Jetspeed は，リクエストパラメータ，HTTP ヘッダ，セキュリティ，言語，セッションの属性の情報から判断規準を得るための，いくつかのあらかじめ定義されたルールを持っています．プロファイラは，プロファイラバルブ内の，Jetspeed のリクエスト処理パイプラインの処理中に呼び出されます．
+<img src="images/profiler/profiler-pipeline.jpg" border="1"/>
</p>
+
+<div class="original">
+<p>
+All of these runtime parameters are called the <i>profile criterion</i>, which the profiler uses to locate
+portal resources.
+</p>
</div>
<p>
-プロファイラはサイトマネージャとページマネージャコンポーネントと協調して動作します。プロファイラは実行時情報を入力として受け取り、その情報を一般化・・・(原文が文の途中で終わっています。原文作者によると、ここで力尽きた、とのことです)。
+これらの実行時パラメータの全ては，<i>プロファイル規準</i>と呼ばれます．プロファイル規準は，プロファイラがポータルリソースを探索するのに使います．
</p>
+
</section>
-<section name="[Profiling Rules]プロファイリングルール">
+
+<section name="[Located Portal Resources: Pages] 配置されたポータルリソース: ページ">
+
<div class="original">
<p>
-
+The Profiler searches over a directory tree of PSML pages trying to locate a
+PSML page to be displayed. By default, this directory structure is found under WEB-INF/pages.
+The pages directory can also be stored in the database. This directory structure, comprised of
+portal resources (pages, folders, menus, links), is a <i>physical</i> representation of the portal site.
+The Jetspeed team plans to also support <i>logical</i> views of the portal site in future releases.
+</p>
+</div>
+<p>
+プロファイラは，表示するための PSML ページを探しながら，PSML ページのディレクトリツリーを検索します．デフォルトでは，このディレクトリツリーは，WEB-INF/pages 以下です．ページディレクトリは，データベース上にも保存することが出来ます．ポータルリソース (ページ，フォルダ，メニュー，リンク) から構成されるディレクトリ構造は，ポータルサイトの物理的表現です．Jetspeed チームは，将来のリリースで，ポータルサイトの論理ビューもサポートする予定にしています．
+</p>
+
+<div class="original">
+<p>
+Analogous to a file system, there is one physical root to the portal site. However, using the concept of <i>subsites</i>,
+the Jetspeed site can support entire subsites that are not visible to other subsites, or the main site.
+There are several reserved (system) directories standardized by the profiler:
+</p>
+</div>
+
+<p>
+ファイルシステムに類似して，ポータルサイトには，一つ，物理的なルートが存在します．しかし，サブサイトの概念を使うと，Jetspeed サイトは，メインのサイトや，他のサブサイトから見えない，サブサイトもサポートすることが可能です．プロファイラによって標準化された，予約 (システム) ディレクトリがいくつか存在します．
+</p>
+
+<div class="original">
+<table>
+ <tr>
+ <th>Reserved Folder</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>_user</td>
+ <td>holds all user-specific folders and pages</td>
+ </tr>
+ <tr>
+ <td>_role</td>
+ <td>holds all role-organized folders and pages</td>
+ </tr>
+ <tr>
+ <td>_group</td>
+ <td>holds all group-organized folders and pages</td>
+ </tr>
+ <tr>
+ <td>_subsite-root</td>
+ <td>contains complete subsite trees, exactly like root tree</td>
+ </tr>
+</table>
+</div>
+
+<table>
+ <tr>
+ <th>予約フォルダ名</th>
+ <th>説明</th>
+ </tr>
+ <tr>
+ <td>_user</td>
+ <td>全ユーザ固有のフォルダやページを保持します．</td>
+ </tr>
+ <tr>
+ <td>_role</td>
+ <td>ロール毎のフォルダやページを保持します．</td>
+ </tr>
+ <tr>
+ <td>_group</td>
+ <td>グループ毎のフォルダやページを保持します．</td>
+ </tr>
+ <tr>
+ <td>_subsite-root</td>
+ <td>まさにツリーのルートのような，全サブツリーを含みます．</td>
+ </tr>
+</table>
+
+<div class="original">
+<p>
+<img src="images/profiler/pages.jpg" border="1"/>
+</p>
+</div>
+
+<p>
+<img src="images/profiler/pages.jpg" border="1"/>
+</p>
+
+<div class="original">
+<p>By applying profiling rules, the profiler locates pages in the portal site directory.</p>
+</div>
+
+<p>
+プロファイリングルールを適用することにより，プロファイラはポータルサイトディレクトリ内のページを決定します．
+</p>
+
+</section>
+
+<section name="[Profiling Rules] プロファイリングルール">
+
+<div class="original">
+<p>
+
A ProfilingRule defines a list of criteria used when evaluating a request
to determine the location of a specific resource. Profiling rules are
-used by the profiler to generically locate portal resources
+used by the profiler to locate portal resources
based on the decoupled criteria for known portlet request data.
A rule consists of an ordered list of criteria which should be applied
in a given order. Following this rule's order, the profiling engine applies
-each criteria of the rulusing a less-specific algorithm until the least
+each criteria of the rule using a less-specific algorithm until the least
specific resource criterion is considered. When all criteria are exhausted,
the rule will fail and a fallback resource will be required.
</p>
</div>
+
<p>
-プロファイリングルールは、特定のリソースの場所を解決するリクエストを評価するときに使われる判断規準のリストを定義します。プロファイリングルールはプロファイラが使用します。これは、既知のポートレットリクエストデータ用の、細分化した判断規準によるポータルリソースの位置を決定するためです。ルールは与えられた順序に適用される判断規準の順序つきのリストから構成されます。このルールの順序に従って、プロファイリングエンジンは、最少のリソースの判断規準とみなせるまで、少ない記述の設定によるアルゴリズムで、それぞれのルールの判断規準を適用します。全ての条件が適用されつくした場合、ルールは失敗となりフォールバックリソースが要求されます。
+プロファイリングルールは，特定のリソースの場所を決定するための，リクエストを評価する時に使われる，判断規準のリストを定義します．プロファイリングルールはプロファイラが使用します。これは、既知のポートレットリクエストデータ用の、細分化した判断規準によるポータルリソースの位置を決定するためです。ルールは，与えられた順序に適用される，判断規準の順序つきのリストから構成されます。このルールの順序に従って、プロファイリングエンジンは，最少のリソースの判断規準とみなせるまで，少ない記述の設定によるアルゴリズムで，それぞれのルールの判断規準を適用します．全ての条件が適用されつくした場合、ルールは失敗となりフォールバックリソースが要求されます。
</p>
-<subsection name='[Rule Criterion] ルール規準'>
+
+<subsection name='[Rule Criteria] ルール規準'>
+
<div class="original">
<p>
-RuleCriteria are templates for locating profile properties.
-The default implementation has a profiling policy defined in this proposal based on resource-specific URLs, Mime-Types and language preferences. More complex implementations will need to use other inputs in mapping to resources such as Cookies, IP Address Ranges, Statistical Resource Usage Analysis, Business Rules inside of servlets or EJBs,...
+A Rule Criterion specifies one criterion in a list of profiling rule criteria.
+The rule is used to build a normalized profiling locator and then
+locate a portal resource based on the current user request.
+Rule Criteria are templates for locating profile properties.
+Criteria consist of:
</p>
</div>
+
<p>
-ルール規準はプロファイルのプロパティの場所を示すためのテンプレートです。デフォルトの実装では、リソースを特定する URL、Mimeタイプ、言語の設定に基づく案で定義されたプロファイリングポリシを持っています。もっと複雑な実装を行うには、Cookie や IP アドレスの範囲や統計的なリソースの利用解析やサーブレットや EJB 内部のビジネスのルールのような、リソースとマッピングされる他の入力が必要となるでしょう。
+ルール規準は，プロファイリングルールの規準のリストの中の 1 つの規準を特定します．ルールは，正規化されたプロファイリングロケータを構築するために使われます．それから，現在のユーザリクエストに基づいたポータルリソースを決定するのにも使われます．ルール規準は，プロファイルのプロパティの場所を示すためのテンプレートです．規準は以下から成ります．
</p>
+
+<div class="original">
+<table>
+ <tr><td>Type</td>
+ <td>The type of criterion. Types are configured in the profiler spring configuraiton.
+ Each type maps to a <i>rule criterion resolver</i>. A resolver is a Java class which maps request input
+ to a normalized location instruction. Valid resolvers are provided in the table below.
+ </td>
+ </tr>
+ <tr>
+ <td>Fallback Order</td>
+ <td>The sequential in which to apply this criterion within the profiling rule.</td>
+ </tr>
+ <tr>
+ <td>Fallback Type</td>
+ <td>After evaluation this criterion, the rule can either continue processing the remaining
+ criteria, or stop processing. The fallback type determines how to continue processing.
+ Valid values are:
+ <table>
+ <tr>
+ <td>FALLBACK_CONTINUE</td>
+ <td>evaluate this criterion and if it fails continue to the next criterion</td>
+ </tr>
+ <tr>
+ <td>FALLBACK_STOP</td>
+ <td>evaluate this criterion and if it fails stop evaluation criteria for this rule</td>
+ </tr>
+ <tr>
+ <td>FALLBACK_LOOP</td>
+ <td>evaluate this criterion and if it fails continue evaluating</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>Name</td>
+ <td>The unique name (per rule) of this criterion. Upon matches, the name is mapped to the profile locator property name.</td>
+ </tr>
+ <tr>
+ <td>Value</td>
+ <td>The default value (not required) to use for this criterion when resolution fails.</td>
+ </tr>
+</table>
+</div>
+
+<table>
+ <tr><td>タイプ</td>
+ <td>
+ 規準のタイプ．タイプはプロファイラの spring の設定内で設定されます．それぞれのタイプは，<i>ルール規準のリゾルバ</i>と結びつけられます．リゾルバは Java のクラスで，正規化された場所の命令にリクエストの入力をマッピングします．有効なリゾルバは，後に出てくる表のようなものが用意されています．
+ </td>
+ </tr>
+ <tr>
+ <td>フォールバック順序</td>
+ <td>
+ プロファイリングルール内でこの規準が適用される順序．
+ </td>
+ </tr>
+ <tr>
+ <td>フォールバックタイプ</td>
+ <td>この規準が評価された後，ルールは残りの規準の処理を続けることも出来るし，処理を止めることも出来ます．fallback type は，処理を続けるかどうかを定義します．有効な値は以下の通り．
+ <table>
+ <tr>
+ <td>FALLBACK_CONTINUE</td>
+ <td>
+ この規準を評価し，もし fail であれば，次の規準を評価する．</td>
+ </tr>
+ <tr>
+ <td>FALLBACK_STOP</td>
+ <td>この規準を評価し，もし fail であれば，このルールに対する規準の評価を止める．</td>
+ </tr>
+ <tr>
+ <td>FALLBACK_LOOP</td>
+ <td>この規準を評価し，もし fail でも評価を続ける．</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>名前</td>
+ <td>この規準の(ルールごとの)ユニークな名前．一致と同時に，名前はプロファイルロケータのプロパティ名にマップされる．</td>
+ </tr>
+ <tr>
+ <td>値</td>
+ <td>解決が失敗したとき，この規準に対して使うデフォルト値(必須ではない)．</td>
+ </tr>
+</table>
+
+<div class="original">
+<p>
+More complex implementations will need to use other inputs in mapping to resources such as Cookies, IP Address Ranges, Statistical Resource Usage Analysis, or Business Rules.
+</p>
+</div>
+
+<p>
+より複雑な実装には，クッキー，IPアドレスの幅，解析に使う統計のリソースやビジネスルールのようなリソースとのマッピングのような，他の入力が必要とされるでしょう．
+</p>
+
</subsection>
-<subsection name='[Rule Criterion Resolvers] ルール規準のリゾルバ'>
+
+<subsection name='[Rule Criterion Resolvers] ルール基準のリゾルバ'>
+
+<div class="original">
<p>
+The table below displays all default rule criterion resolvers available with Jetspeed out of the box.
+Resolvers are Java classes, implementing the interface from the Jetspeed API <i>org.apache.jetspeed.profiler.rules.RuleCriterionResolver</i>.
+You may use this default set of resolvers to build your own profiling rules. Rules are currently stored in the
+Jetspeed database. Portal administrators may edit the rules using an administrative portlet. In the demo system,
+login as the user "admin" to see an example of the Jetspeed Profiler Administration portlet.
+</p>
+</div>
+<p>
+以下に記述した表は，Jetspeed で何もせずに使える，全てのデフォルトのルール規準リゾルバの一覧です．リゾルバは Java のクラスであり，Jetspeed API のorg.apache.jetspeed.profiler.rules.RuleCriterionResolver インターフェースの実装です．独自のプロファイリングルールを作成する際にも，このデフォルトのリゾルバのセットが使えるでしょう．ルールは，現在は Jetspeed のデータベースに保存されています．ポータルの管理者は，管理ポートレットを使って，ルールを編集出来るでしょう．デモシステムでは，Jetspeed の管理ポートレットの例を見るには，"admin" ユーザとしてログインします．
+</p>
+
<div class="original">
+<p>Additionally, you may add your own resolvers to Jetspeed. You will need to create a jar file
+ holding your custom resolvers, and then drop them into the Jetspeed webapp's class path. Resolvers
+ will need to be given a unique name. This is done by modifying the profiler.xml in the Spring assembly.
+ See the section below on configuration to see where to add a resolver to the Spring configuration.
+</p>
+</div>
+
+<p>
+加えて，独自のリゾルバを Jetspeed に加えることも可能です．カスタムリゾルバが入った jar ファイルを作成する必要があります．そして，それを jetspeed の webapp クラスパスの中に置きます．リゾルバはユニークな名前を付ける必要があります．これは，spring の profiler.xml ファイルを変更して行います．リゾルバを追加するには，Spring の設定のどこで行うのかは，後のセクションを見てください．
+</p>
+
+<div class="original">
<table>
<tr>
<th>Resolver</th>
<th>Description</th>
- <th>Example</th>
</tr>
<tr>
<td>request</td>
- <td>resolve by matching to a request parameter name</td>
- <td></td>
+ <td>resolve by matching a request parameter by name, returning the request parameter value for a locator property taking the name of the criterion</td>
</tr>
<tr>
<td>session</td>
- <td>resolve by matching to a session attribute name</td>
- <td></td>
- </tr>
+ <td>resolve by matching a session attribute by name, returning the session attribute value for a locator property taking the name of the criterion</td>
+ </tr>
<tr>
<td>request.session</td>
- <td>resolve by matching to a request attribute name first, then matching to a session attribute name</td>
- <td></td>
+ <td>resolve by first matching a request parameter by name. If not matched, try matching a session attribute name, returning the request parameter or session attribute value for a locator property taking the name of the criterion</td>
</tr>
<tr>
- <td>hard.coded</td>
- <td>resolve with a hard.coded value</td>
- <td></td>
+ <td>path</td>
+ <td>resolve by matching the PSML page <i>path</i> value of the current request. The path is typically the path and name of a page, such as <i>default-page</i> for a locator property named <quote>path</quote></td>
</tr>
<tr>
- <td>group.role.user</td>
- <td>fallback controller: search for resource under folders of the current users group, then role, then users own folder</td>
- <td></td>
+ <td>path.session</td>
+ <td>resolve by matching the PSML page <i>path</i> value of the current request. The path is typically the path and name of a page, such as <i>default-page</i>. If fails to find a valid path in the request, will then look in the session for the page value. The locator property will be named <quote>path</quote></td>
+ </tr>
+ <tr>
+ <td>hard.coded</td>
+ <td>resolve to a hard.coded default value, for example, set a locator property named page to <quote>/my-account.psml</quote></td>
</tr>
<tr>
<td>user</td>
- <td>match resources in the current user directory</td>
- <td></td>
+ <td>resolve by matching the name of the current authenticated user. The username is mapped to a locator property named <quote>user</quote></td>
</tr>
<tr>
- <td>group</td>
- <td></td>
- <td></td>
- </tr>
- <tr>
<td>role</td>
- <td></td>
- <td></td>
+ <td>resolve by matching all of the security roles of the current authenticated user (in the JAAS Subject of the request context) and putting them in a comma-separated list. The locator property should be named <quote>role</quote>. The role criterion is often used in combination with path criteria, to create a role-fallback rule that searches over all security roles for a given user.</td>
</tr>
<tr>
- <td>mediatype</td>
- <td>match media type in the request context</td>
- <td></td>
- </tr>
+ <td>group</td>
+ <td>resolve by matching all of the groups of the current authenticated user (in the JAAS Subject of the request context) and putting them in a comma-separated list. The locator property should be named <quote>group</quote>. The group criteion is often used in combination with path criteria, to create a group-fallback rule that searches over all security groups for a given user.</td>
+ </tr>
<tr>
- <td>country</td>
- <td></td>
- <td></td>
+ <td>rolecombo</td>
+ <td>resolve by matching all of the security roles of the current authenticated user (in the JAAS Subject of the request context) and putting them in a dash-separated string, for example: (role1-role2-role3). The locator property should be named <quote>role</quote>. The role criterion is often used in combination with path criteria, to create a role-fallback rule that searches over all security roles for a given user.</td>
</tr>
<tr>
- <td>user.agent</td>
- <td></td>
- <td></td>
+ <td>mediatype</td>
+ <td>resolve by matching the media type (HTML,XHTML,WML...) from the request context. Sets a locator property named <quote>mediatype</quote></td>
</tr>
<tr>
<td>language</td>
- <td></td>
- <td></td>
- </tr>
+ <td>resolve by matching the browser's language from the request context locale (originating from the HTML headers). Sets a locator property named <quote>language</quote></td>
+ </tr>
<tr>
- <td>roles</td>
- <td>Role Fallback</td>
- <td></td>
+ <td>country</td>
+ <td>resolve by matching the browser's country code from the request context locale (originating from the HTML headers). Sets a locator property named <quote>country</quote></td>
</tr>
<tr>
- <td>path</td>
- <td></td>
- <td></td>
- </tr>
+ <td>group.role.user</td>
+ <td>resolve by first matching on a request parameter named <quote>group</quote>. If that fails, resolve on a request parameter named <quote>role</quote>. If that fails, resolve by matching the name of the current authenticated user. The username is mapped to a locator property named <quote>user</quote></td>
+ </tr>
<tr>
- <td>page</td>
- <td></td>
- <td></td>
- </tr>
+ <td>user.attribute</td>
+ <td>resolve by matching a Portlet API User Attribute by name, returning the user attribute value for a locator property taking the name of the criterion</td>
+ </tr>
<tr>
- <td>path.session</td>
- <td></td>
- <td></td>
+ <td>user.agent</td>
+ <td>resolve by matching the browser's (client) user agent from the request context device capabilities (originating from the HTML headers)</td>
</tr>
<tr>
- <td>user.attribute</td>
- <td></td>
- <td></td>
- </tr>
+ <td>hostname</td>
+ <td>resolve by matching the host name from the server name in the request, returning the host name</td>
+ </tr>
<tr>
+ <td>domain</td>
+ <td>resolve by matching the domain from the server name in the request, returning the domain</td>
+ </tr>
+ <tr>
<td>navigation</td>
- <td>change the current navigation path</td>
- <td></td>
- </tr>
-
-</table>
+ <td>A directive to changes the current navigation path during a profile location resolution performed by the page manager. The value can be the location of a folder, for example <quote>/pages/freecontent</quote></td>
+ </tr>
+</table>
</div>
+
<table>
<tr>
<th>リゾルバ</th>
<th>説明</th>
- <th>例</th>
</tr>
<tr>
<td>request</td>
- <td>リクエストパラメータ名とのマッチングによる解決</td>
- <td></td>
+ <td>名前でリクエストパラメータとマッチさせて解決します．ロケータプロパティが規準の名前を取得するために，リクエストパラメータの値を返します．</td>
</tr>
<tr>
<td>session</td>
- <td>セッションの属性名とのマッチングによる解決</td>
- <td></td>
- </tr>
+ <td>名前でセッション属性とマッチさせて解決します．ロケータプロパティが規準の名前を取得するために，セッション属性の値を返します．</td>
+ </tr>
<tr>
<td>request.session</td>
- <td>最初にリクエストの属性名とのマッチングを行ってから、セッションの属性名とのマッチングを行って解決する</td>
- <td></td>
+ <td>最初に名前でリクエストパラメータとマッチさせます．もしマッチしなければ，セッション属性名とマッチさせるようと試みます．ロケータプロパティが規準の名前を取得するために，リクエストパラメータか，セッション属性の値を返します．</td>
</tr>
<tr>
- <td>hard.coded</td>
- <td>ハードコードされた値による解決</td>
- <td></td>
+ <td>path</td>
+ <td>現在のリクエストの PSML ページの <i>パス</i> の値とマッチさせて解決します．このパスは，一般的にはパスとページ名です．<quote>パス</quote>という名前のロケータプロパティのための <quote>default-page</quote> のようなものです．</td>
</tr>
<tr>
- <td>group.role.user</td>
- <td>フォールバックコントローラ: 現在のユーザグループ、次にロール、次にユーザの所有するフォルダ以下のリソースを探す</td>
- <td></td>
+ <td>path.session</td>
+ <td>現在のリクエストの PSML ページのパスの値とマッチさせて解決します．このパスは，一般的には，default-page のようなページの，パスとページ名です．もし，リクエスト中に有効なパスを見つけられなかった場合，ページの値を取得するために，セッションを探します．ロケータプロパティはパスという名前となるでしょう．</td>
+ </tr>
+ <tr>
+ <td>hard.coded</td>
+ <td>ハードコードされたデフォルト値を解決します．例えば，ページ名を "/my-account.psml" とするロケータプロパティを設定します．</td>
</tr>
<tr>
<td>user</td>
- <td>現在のユーザのディレクトリ内のリソースとマッチさせる</td>
- <td></td>
+ <td>現在の認証されたユーザ名でマッチさせて解決します．ユーザ名は<quote>user</quote>という名前のロケータプロパティにマップされます．
+</td>
</tr>
<tr>
- <td>group</td>
- <td></td>
- <td></td>
+ <td>role</td>
+ <td>(リクエストコンテキストのJAASサブジェクト内の)現在の認証されたユーザのセキュリティロールの全てとマッチさせ，それらをコンマ区切りのリストとすることにより解決します．ロケータプロパティは<quote>role</quote>と名付けられるべきです．ロールの規準は，しばしばパス規準と一緒に使われます．与えられたユーザに対するセキュリティロールを検索する，role-fallbackルールを作成するためです．</td>
</tr>
<tr>
- <td>role</td>
- <td></td>
- <td></td>
+ <td>group</td>
+ <td>(リクエストコンテキストのJAASサブジェクト内の)現在の認証されたユーザのグループの全てとマッチさせ，それらをコンマ区切りのリストとすることにより解決します．ロケータプロパティは<quote>group</quote>と名付けられるべきです．グループの規準は，しばしばパス規準と一緒に使われます．与えられたユーザに対するセキュリティグループを検索する，role-fallbackルールを作成するためです．</td>
+ </tr>
+ <tr>
+ <td>rolecombo</td>
+ <td>(リクエストコンテキストのJAASサブジェクト内の)現在の認証されたユーザのセキュリティロールの全てとマッチさせ，それらをダッシュ(-)で繋いだ文字列とすることにより解決します．例えば (role1-role2-role3) です．ロケータプロパティは<quote>role</quote>と名付けられるべきです．ロールの規準は，しばしばパス規準と一緒に使われます．与えられたユーザに対するセキュリティロールを検索する，role-fallbackルールを作成するためです．</td>
</tr>
<tr>
<td>mediatype</td>
- <td>リクエストコンテキスト内のメディアタイプとマッチさせる</td>
- <td></td>
+ <td>リクエストコンテキストのメディアタイプ(HTML,XHTML,WML...)とマッチさせて解決します．<quote>mediatype</quote>という名前のロケータプロパティにセットされます．</td>
</tr>
<tr>
+ <td>language</td>
+ <td>リクエストコンテキストのブラウザの言語(元の出所は HTML ヘッダ)とマッチさせて解決します．<quote>language</quote> という名前のロケータプロパティにセットされます．</td>
+ </tr>
+ <tr>
<td>country</td>
- <td></td>
- <td></td>
+ <td>リクエストコンテキストのロケールのブラウザのカントリーコード(元の出所はHTMLヘッダ)とマッチさせて解決します．<quote>country</quote>という名前のロケータプロパティにセットされます．</td>
</tr>
<tr>
+ <td>group.role.user</td>
+ <td>最初に <quote>group</quote> という名前のリクエストパラメータとマッチさせて解決します．失敗したら，<quote>role</quote>という名前のリクエストパラメータで解決します．さらに失敗したら，現在の認証されたユーザ名とマッチさせて買うけつします．<quote>user</quote>という名前のロケータプロパティにマップされます．</td>
+ </tr>
+ <tr>
+ <td>user.attribute</td>
+ <td>ポートレットAPIのユーザ属性と名前をマッチさせて解決します．ロケータプロパティが規準名を取得するために，ユーザ属性の値を返します．</td>
+ </tr>
+ <tr>
<td>user.agent</td>
- <td></td>
- <td></td>
+ <td>リクエストコンテキストのデバイスの機能(元の出所はHTMLヘッダ)の(クライアントの)ブラウザのユーザエージェントとマッチさせて解決します．</td>
</tr>
<tr>
- <td>language</td>
- <td></td>
- <td></td>
- </tr>
+ <td>hostname</td>
+ <td>リクエスト中のサーバ名からホスト名とマッチさせて解決します．ホスト名を返します．</td>
+ </tr>
<tr>
- <td>roles</td>
- <td>ロールのフォールバック</td>
- <td></td>
- </tr>
+ <td>domain</td>
+ <td>リクエスト中のサーバ名からドメインをマッチさせて解決します．ドメインを返します．</td>
+ </tr>
<tr>
- <td>path</td>
- <td></td>
- <td></td>
- </tr>
+ <td>navigation</td>
+ <td>ページマネージャが実行するプロファイルロケーションの解決の間，現在のナビゲーションパスを変えるためのディレクティブです．この値は，例えば <quote>/pages/freecontent</quote> というような，フォルダの場所である可能性があります．</td>
+ </tr>
+</table>
+
+<div class="original">
+<p>
+<i>Note that all criteria will fall back to the default value when no match is made. Locator property expects a criterion named <quote>navigation</quote></i>
+</p>
+</div>
+
+<p><i>
+全ての規準は，マッチするものがない場合は，デフォルト値になります(フォールバックします)．ロケータプロパティは，navigationという名前の規準を期待します．</i>
+</p>
+
+</subsection>
+
+<subsection name='[Default Rules] デフォルトルール'>
+
+<div class="original">
+<p>
+Several rules are provided by default with the Jetspeed system.
+The rules in the table below display the criterion in a most-specific to least-specific ordering.
+</p>
+</div>
+
+<p>
+Jetspeed では，デフォルトでいくつかのルールが準備されています．以下の表のルールは，最小一致の命令に対して，最も一致する規準を表示します．
+</p>
+
+<div class="original">
+<table>
<tr>
- <td>page</td>
- <td></td>
- <td></td>
+ <th>Rule</th>
+ <th>Description</th>
</tr>
<tr>
- <td>path.session</td>
- <td></td>
- <td></td>
- </tr>
+ <td>j1</td>
+ <td>
+ <p>Implements the Jetspeed-1 hard-coded profiler fallback algorithm, resolving in a most-specific to least-specific algorithm:</p>
+ <table>
+ <tr>
+ <th>criterion</th>
+ <th>name</th>
+ <th>value</th>
+ <th>fallback</th>
+ </tr>
+ <tr>
+ <td>country</td>
+ <td>country</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>language</td>
+ <td>language</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>mediatype</td>
+ <td>mediatype</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>group.role.user</td>
+ <td>user|group|role</td>
+ <td></td>
+ <td>stop</td>
+ </tr>
+ <tr>
+ <td>path.session</td>
+ <td>page</td>
+ <td>default-page</td>
+ <td>stop</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>role-fallback</td>
+ <td>
+ <p>A role based fallback algorithm, trying to find the most-specific resource by searching over all security roles for the current authenticated user.</p>
+ <table>
+ <tr>
+ <th>criterion</th>
+ <th>name</th>
+ <th>value</th>
+ <th>fallback</th>
+ </tr>
+ <tr>
+ <td>path.session</td>
+ <td>page</td>
+ <td>default-page</td>
+ <td>stop</td>
+ </tr>
+ <tr>
+ <td>role</td>
+ <td>role</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>group-fallback</td>
+ <td>
+ <p>A group based fallback algorithm, trying to find the most-specific resource by searching over all security groups for the current authenticated user.</p>
+ <table>
+ <tr>
+ <th>criterion</th>
+ <th>name</th>
+ <th>value</th>
+ <th>fallback</th>
+ </tr>
+ <tr>
+ <td>path.session</td>
+ <td>page</td>
+ <td>default-page</td>
+ <td>stop</td>
+ </tr>
+ <tr>
+ <td>group</td>
+ <td>group</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>j2</td>
+ <td>
+ <p>The default profiling rule for users and mediatype minus language and country.</p>
+ <table>
+ <tr>
+ <th>criterion</th>
+ <th>name</th>
+ <th>value</th>
+ <th>fallback</th>
+ </tr>
+ <tr>
+ <td>mediatype</td>
+ <td>mediatype</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>group.role.user</td>
+ <td>user|group|role</td>
+ <td></td>
+ <td>stop</td>
+ </tr>
+ <tr>
+ <td>path.session</td>
+ <td>page</td>
+ <td>default-page</td>
+ <td>stop</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>security</td>
+ <td>
+ <p>The security profiling rule needed to force credential change requirements.</p>
+ <table>
+ <tr>
+ <th>criterion</th>
+ <th>name</th>
+ <th>value</th>
+ <th>fallback</th>
+ </tr>
+ <tr>
+ <td>hard.coded</td>
+ <td>page</td>
+ <td>/my-account.psml</td>
+ <td>stop</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>path</td>
+ <td>
+ <p>Only criterion applied is the path portion of the portal URL.</p>
+ <table>
+ <tr>
+ <th>criterion</th>
+ <th>name</th>
+ <th>value</th>
+ <th>fallback</th>
+ </tr>
+ <tr>
+ <td>path</td>
+ <td>page</td>
+ <td>/</td>
+ <td>stop</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>user-role-fallback</td>
+ <td>
+ <p>Rule will first look for the resource in the user's home folder. If not found there, a role based fallback algorithm is applied, trying to find the most-specific resource by searching over all security roles for the current authenticated user.</p>
+ <table>
+ <tr>
+ <th>criterion</th>
+ <th>name</th>
+ <th>value</th>
+ <th>fallback</th>
+ </tr>
+ <tr>
+ <td>path.session</td>
+ <td>page</td>
+ <td>default-page</td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>role</td>
+ <td>role</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>navigation</td>
+ <td>navigation</td>
+ <td>/</td>
+ <td>loop</td>
+ </tr>
+ <tr>
+ <td>user</td>
+ <td>user</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>user-rolecombo-fallback</td>
+ <td>
+ <p>Rule will first look for the resource in the user's home folder. If not found there, a role based fallback algorithm is applied, trying to find the most-specific resource by searching over all security roles for the current authenticated user. Creates a locater property named <quote>role</quote> that is the concatenation of all roles into one string, such as <i>role1-role2-role3</i>. This combined string is used as the role name in the locator.</p>
+ <table>
+ <tr>
+ <th>criterion</th>
+ <th>name</th>
+ <th>value</th>
+ <th>fallback</th>
+ </tr>
+ <tr>
+ <td>path.session</td>
+ <td>page</td>
+ <td>default-page</td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>rolecombo</td>
+ <td>role</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>navigation</td>
+ <td>navigation</td>
+ <td>/</td>
+ <td>loop</td>
+ </tr>
+ <tr>
+ <td>user</td>
+ <td>user</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>subsite-role-fallback-home</td>
+ <td>
+ <p>A rule based on role fallback algorithm with specified subsite and home page</p>
+ <table>
+ <tr>
+ <th>criterion</th>
+ <th>name</th>
+ <th>value</th>
+ <th>fallback</th>
+ </tr>
+ <tr>
+ <td>path</td>
+ <td>path</td>
+ <td>subsite-default-page</td>
+ <td>stop</td>
+ </tr>
+ <tr>
+ <td>role</td>
+ <td>role</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>navigation</td>
+ <td>navigation</td>
+ <td>subsite-root</td>
+ <td>loop</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+
+ </table>
+</div>
+
+<table>
<tr>
- <td>user.attribute</td>
- <td></td>
- <td></td>
+ <th>ルール</th>
+ <th>説明</th>
</tr>
<tr>
- <td>navigation</td>
- <td>現在のナビゲーションパスを変える</td>
- <td></td>
- </tr>
+ <td>j1</td>
+ <td>
+ <p>Jetspeed-1 のハードコードされたプロファイラのフォールバックアルゴリズムを実装します．最少一致のアルゴリズムで最も一致するものに解決します．</p>
+ <table>
+ <tr>
+ <th>規準</th>
+ <th>名前</th>
+ <th>値</th>
+ <th>フォールバック</th>
+ </tr>
+ <tr>
+ <td>country</td>
+ <td>country</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>language</td>
+ <td>language</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>mediatype</td>
+ <td>mediatype</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>group.role.user</td>
+ <td>user|group|role</td>
+ <td></td>
+ <td>stop</td>
+ </tr>
+ <tr>
+ <td>path.session</td>
+ <td>page</td>
+ <td>default-page</td>
+ <td>stop</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>role-fallback</td>
+ <td>
+ <p>ロールベースのフォールバックアルゴリズムです．現在の認証されたユーザのためのセキュリティロールを全て検索することにより，最も一致するリソースを見つけようとします．</p>
+ <table>
+ <tr>
+ <th>規準</th>
+ <th>名前</th>
+ <th>値</th>
+ <th>フォールバック</th>
+ </tr>
+ <tr>
+ <td>path.session</td>
+ <td>page</td>
+ <td>default-page</td>
+ <td>stop</td>
+ </tr>
+ <tr>
+ <td>role</td>
+ <td>role</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>group-fallback</td>
+ <td>
+ <p>グループベースのフォールバックアルゴリズムです．現在の認証されたユーザに対するセキュリティグループを全て検索し，最も一致するリソースを見つけようとします．</p>
+ <table>
+ <tr>
+ <th>規準</th>
+ <th>名前</th>
+ <th>値</th>
+ <th>フォールバック</th>
+ </tr>
+ <tr>
+ <td>path.session</td>
+ <td>page</td>
+ <td>default-page</td>
+ <td>stop</td>
+ </tr>
+ <tr>
+ <td>group</td>
+ <td>group</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>j2</td>
+ <td>
+ <p>ユーザとメディアタイプから言語と国を引いたデフォルトのプロファイリングルールです．</p>
+ <table>
+ <tr>
+ <th>規準</th>
+ <th>名前</th>
+ <th>値</th>
+ <th>フォールバック</th>
+ </tr>
+ <tr>
+ <td>mediatype</td>
+ <td>mediatype</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>group.role.user</td>
+ <td>user|group|role</td>
+ <td></td>
+ <td>stop</td>
+ </tr>
+ <tr>
+ <td>path.session</td>
+ <td>page</td>
+ <td>default-page</td>
+ <td>stop</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>security</td>
+ <td>
+ <p>security プロファイリングルールは，資格を強制的に変える必要がある時に必要です．</p>
+ <table>
+ <tr>
+ <th>規準</th>
+ <th>名前</th>
+ <th>値</th>
+ <th>フォールバック</th>
+ </tr>
+ <tr>
+ <td>hard.coded</td>
+ <td>page</td>
+ <td>/my-account.psml</td>
+ <td>stop</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>path</td>
+ <td>
+ <p>ポータルURLのパスの部分のみが適用される規準です．</p>
+ <table>
+ <tr>
+ <th>規準</th>
+ <th>名前</th>
+ <th>値</th>
+ <th>フォールバック</th>
+ </tr>
+ <tr>
+ <td>path</td>
+ <td>page</td>
+ <td>/</td>
+ <td>stop</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>user-role-fallback</td>
+ <td>
+ <p>最初にユーザのホームフォルダのリソースを探します．もし見付からなければ，ロールベースのフォールバックアルゴリズムが適用されます．現在の認証ユーザに対する全てのセキュリティロールを検索して，最も一致するリソースを見つけようとします．</p>
+ <table>
+ <tr>
+ <th>規準</th>
+ <th>名前</th>
+ <th>値</th>
+ <th>フォールバック</th>
+ </tr>
+ <tr>
+ <td>path.session</td>
+ <td>page</td>
+ <td>default-page</td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>role</td>
+ <td>role</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>navigation</td>
+ <td>navigation</td>
+ <td>/</td>
+ <td>loop</td>
+ </tr>
+ <tr>
+ <td>user</td>
+ <td>user</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>user-rolecombo-fallback</td>
+ <td>
+ <p>最初にユーザのホームフォルダのリソースを探します．もし，見つからない場合，ロールベースのフォールバックアルゴリズムが適用されます．現在の認証されたユーザに対する全てのセキュリティロールを検索し，最も一致するリソースを見つけようとします．<i>role1-role2-role3</i> というような，全てのロールを一つの文字列に連結した<quote>role</quote>という名前のロケータプロパティを作成します．この連結された文字列は，ロケータ内のロール名として使われます．</p>
+ <table>
+ <tr>
+ <th>規準</th>
+ <th>名前</th>
+ <th>値</th>
+ <th>フォールバック</th>
+ </tr>
+ <tr>
+ <td>path.session</td>
+ <td>page</td>
+ <td>default-page</td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>rolecombo</td>
+ <td>role</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>navigation</td>
+ <td>navigation</td>
+ <td>/</td>
+ <td>loop</td>
+ </tr>
+ <tr>
+ <td>user</td>
+ <td>user</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+
+ </table>
+ </td>
+ </tr>
+ <tr>
+ <td>subsite-role-fallback-home</td>
+ <td>
+ <p>特定のサブサイトとホームページでのロールフォールバックアルゴリズムベースのルールです．</p>
+ <table>
+ <tr>
+ <th>規準</th>
+ <th>名前</th>
+ <th>値</th>
+ <th>フォールバック</th>
+ </tr>
+ <tr>
+ <td>path</td>
+ <td>path</td>
+ <td>subsite-default-page</td>
+ <td>stop</td>
+ </tr>
+ <tr>
+ <td>role</td>
+ <td>role</td>
+ <td></td>
+ <td>continue</td>
+ </tr>
+ <tr>
+ <td>navigation</td>
+ <td>navigation</td>
+ <td>subsite-root</td>
+ <td>loop</td>
+ </tr>
+ </table>
+ </td>
+ </tr>
-</table>
-
-</p>
-</subsection>
-<subsection name='[Principal Rules] プリンシパルルール'>
-</subsection>
-</section>
+ </table>
+
+</subsection>
+</section>
+
<section name="[Profile Locators] プロファイルロケータ">
+
<div class="original">
<p>
Profile Locators are used to locate profiled portal resources such as
-pages, documents, and fragments. A locator contains properties describing
-the actually resource to be located. Since the locator is based on properties
-that are usually related to a user or other subject's profile, it is referred
-to as a profile locator.
+pages, folders, menus and links. A locator contains a collection of properties
+(name value pairs) describing the actual resource to be located.
+<img src="images/profiler/parameter-resolution.jpg" border="1"/>
</p>
</div>
+
<p>
-プロファイルロケータはポータルリソースの位置を決めるのに使われます。ポータルリソースとはページやドキュメントやフラグメントのようなもののことです。ロケータには位置が決められた実際のリソースについて記述されたプロパティが含まれます。ロケータは普通はユーザや他の対象のプロファイルに関係するプロパティに基づいているので、プロファイルロケータとして参照されます。
+プロファイルロケータは，ページやフォルダやメニューやリンクのような，プロファイリングされたポータルリソースの位置を決定するために使われます．ロケータは，設置された実際のリソースに関する記述を行うプロパティ(名前と値の対)のコレクションを含みます．
+<img src="images/profiler/parameter-resolution.jpg" border="1"/>
</p>
-<subsection name='[Profile Locator Paths] プロファイルロケータパス'>
+
+<div class="original">
<p>
+The profiler takes runtime information as input, generalized into
+generalized profile locators that are passed on to the page manager to locate a page or menu.
+The profile locators are normalized and not coupled to the profiler or page manager implementation.
+<img src="images/profiler/parameter-resolution-2.jpg" border="1"/>
+</p>
+</div>
+
+<p>
+プロファイラは入力として実行時の情報を取得します．その入力は，ページやメニューを設置するためのページマネージャに伝達するための汎用的なプロファイルロケータ内に汎用化されます．
+<img src="images/profiler/parameter-resolution-2.jpg" border="1"/>
</p>
-</subsection>
+
</section>
+
+<section name='[Principal Rules] 主体のルール'>
+
+<div class="original">
+<p>Each user principal can be mapped to specific profiling rule. This association is stored in the Jetspeed database.
+The association is three-way, combining the PRINCIPAL + PROFILING RULE + LOCATOR, where the locator values
+currently supported are <quote>menu</quote> or <quote>page</quote>. Thus we can have two different profiling rules
+applied for locating resources per user: locate pages and locate menus. When the profiler attempts to locate a page
+for the current user, it will apply the profiling rule for the given user. The Jetspeed User Administration portlet
+has a tab for editing user profile information:
+</p>
+</div>
+
+<p>
+それぞれのユーザ主体(principal)は，特定のプロファイリングルールにマップされます．この関係は，Jetspeed データベースに保存されます．この関係は三者間，PRINCIPAL(主体) + PROFILING RULE(プロファイリングルール) + LOCATOR(ロケータ) を合わせた物です．そのロケータの値として，現在サポートされるのは，メニューとページです．故に，ユーザ毎のリソースを決定するために適用するプロファイリングルールを二つ持つことが出来ます．それはページの決定とメニューの決定です．プロファイラが，現在のユーザのページを決定しようとしたとき，プロファイラは，与えられたユーザに対するプロファイリングルールを適用します．Jetspeed ユーザ管理ポートレットには，ユーザのプロファイル情報を編集するためのタブがあります．
+</p>
+
+<div class="original">
+<p>
+<img src="images/profiler/user-profile-locator.jpg" border="1"/>
+</p>
+</div>
+
+<p>
+<img src="images/profiler/user-profile-locator.jpg" border="1"/>
+</p>
+
+<div class="original">
+<p>
+Often, profiling rules are determined and then associated by portal-specific logic during user registration (or self-registration).
+A Jetspeed-specific self-registration portlet could handle the registration process of adding a user to the system, granting roles,
+setting user attributes, and assigning the profiling rule for the user.
+</p>
+</div>
+
+<p>
+プロファイリングルールは，定義され，ユーザ登録の間，ポータル特有のロジックによって関連づけられます．Jetspeed 特有の自身を登録するポートレットは，ユーザをシステムへ追加する，ロールを与える，ユーザ属性を設定する，ユーザに対してプロファイリングルールを与えるといったプロセスの登録を扱うことが出来ます．
+</p>
+
+</section>
<section name="[Component Configuration] コンポーネントの設定">
+
+<div class="original">
<p>
+The profiler.xml Spring configuration file configures the profiler component.
</p>
+</div>
+<p>
+Spring の設定の profiler.xml ファイルは，プロファイラコンポーネントの設定を行います．
+</p>
+
+<div class="original">
+<table>
+ <tr>
+ <th>Constructor Argument</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>(0) JETSPEED-INF/ojb/profiler_repository.xml</td>
+ <td>Holds the OJB database to POJO mapper for marshalling profile information to and from the persistent store.</td>
+ </tr>
+ <tr>
+ <td>(1) j1</td>
+ <td>The default profiling rule. If a user does not have a profiling rule defined in the association table, this profiling rule is used.</td>
+ </tr>
+ <tr>
+ <td>(2) ProfileResolvers (ref bean)</td>
+ <td>The map of profiler resolver names to implementing resolver classes. New resolvers should be added to the ProfileResolver table.</td>
+ </tr>
+</table>
+</div>
+
+<table>
+ <tr>
+ <th>コンストラクタの引数</th>
+ <th>説明</th>
+ </tr>
+ <tr>
+ <td>(0) JETSPEED-INF/ojb/profiler_repository.xml</td>
+ <td>持続的ストアからと，持続的ストアへのプロファイル情報を整列させるための POJO マッパとしての OJB データベースを保持します．</td>
+ </tr>
+ <tr>
+ <td>(1) j1</td>
+ <td>デフォルトプロファイリングルール．もし，ユーザが関係するテーブル内に定義されたプロファイリングルールを持たない場合，このプロファイリングルールが使われます．</td>
+ </tr>
+ <tr>
+ <td>(2) ProfileResolvers (ref bean)</td>
+ <td>プロファイラのリゾルバ名と，実装しているリゾルバクラスのマッピング．新しいリゾルバは，プロファイルリゾルバテーブルに追加してください．</td>
+ </tr>
+</table>
+
</section>
</body>