svnno****@sourc*****
svnno****@sourc*****
2010年 10月 7日 (木) 17:06:29 JST
Revision: 114 http://sourceforge.jp/projects/jetspeed-japan/svn/view?view=rev&revision=114 Author: karma Date: 2010-10-07 17:06:29 +0900 (Thu, 07 Oct 2010) Log Message: ----------- Complete guide-ajax-api.xml translation. Modified Paths: -------------- jetspeed-2-trans/trunk/ja/xdocs/guides/guide-ajax-api.xml -------------- next part -------------- Modified: jetspeed-2-trans/trunk/ja/xdocs/guides/guide-ajax-api.xml =================================================================== --- jetspeed-2-trans/trunk/ja/xdocs/guides/guide-ajax-api.xml 2010-10-05 09:51:26 UTC (rev 113) +++ jetspeed-2-trans/trunk/ja/xdocs/guides/guide-ajax-api.xml 2010-10-07 08:06:29 UTC (rev 114) @@ -1260,7 +1260,8 @@ </table> </subsection> -<subsection name='getmenus'> +<subsection name='[getmenus] 複数のメニューの取得'> +<div class="original"> <table> <tr> @@ -1317,9 +1318,69 @@ </td> </tr> </table> +</div> + +<table> + + <tr> + <td>API:</td> + <td>getmenus</td> + </tr> + <tr> + <td>コンポーネント:</td> + <td>AjaxGetMenus</td> + </tr> + <tr> + <td>説明:</td> + <td>(URL によって示される) 現在のページの全てのメニューの取得.</td> + </tr> + <tr> + <td>パラメータ:</td> + <table> + <tr> + <td>action</td> + <td>getmenus</td> + </tr> + <tr> + <td>page</td> + <td>(URLによって示される)</td> + </tr> + </table> + </tr> + <tr> + <td>API の例:</td> + <td> +<source><![CDATA[ +http://localhost:8080/jetspeed/ajaxapi/default-page.psml?action=getmenus +]]></source> + </td> + </tr> + <tr> + <td>XML Response:</td> + <td> +<source><![CDATA[ +<js> + <status>success</status> + <action>getmenus</action> + <menus> + <menu type="standard">navigations</menu> + <menu type="standard">back</menu> + <menu type="standard">pages</menu> + <menu type="standard">breadcrumbs</menu> + <menu type="custom">site-navigations</menu> + <menu type="custom">additional-links</menu> + <menu type="custom">page-navigations</menu> + </menus> +</js> +]]></source> + </td> + </tr> +</table> </subsection> -<subsection name='getmenu'> +<subsection name='[getmenu] メニューの取得'> + +<div class="original"> <table> <tr> @@ -1394,9 +1455,87 @@ </td> </tr> </table> +</div> + +<table> + + <tr> + <td>API:</td> + <td>getmenu</td> + </tr> + <tr> + <td>コンポーネント:</td> + <td>AjaxGetMenu</td> + </tr> + <tr> + <td>説明:</td> + <td>指定したメニューに対するメニュー定義を取得します.</td> + </tr> + <tr> + <td>パラメータ:</td> + <table> + <tr> + <td>action</td> + <td>getmenu</td> + </tr> + <tr> + <td>menu</td> + <td>取得するメニューの名前.(メニュー定義はページ毎に変化する可能性があります)</td> + </tr> + </table> + </tr> + <tr> + <td>API の例:</td> + <td> +<source><![CDATA[ +http://localhost:8080/jetspeed/ajaxapi?action=getmenu&name=breadcrumbs +]]></source> + </td> + </tr> + <tr> + <td>XML Response:</td> + <td> +<source><![CDATA[ +<js> +<status>success</status> +<action>getmenu</action> +<menu> + <name>breadcrumbs</name> + <title>You are here:</title> + <short-title>You are here:</short-title> + <skin>breadcrumbs</skin> + <url>/default-page.psml</url> + <hidden>false</hidden> + <selected>true</selected> + <option> + <type>folder</type> + <title>Root Folder</title> + <short-title>Root Folder</short-title> + <skin>breadcrumbs</skin> + <url>/</url> + <hidden>false</hidden> + <selected>true</selected> + </option> + <option> + <type>page</type> + <title>Welcome to Jetspeed 2</title> + <short-title>Welcome to Jetspeed 2</short-title> + <skin>blue</skin> + <url>/default-page.psml</url> + <hidden>false</hidden> + <selected>true</selected> + </option> +</menu> +</js> +]]></source> + </td> + </tr> +</table> + </subsection> -<subsection name='window'> +<subsection name='[window] ウィンドウ'> +<div class="original"> <table> <tr> @@ -1459,9 +1598,76 @@ </td> </tr> </table> +</div> + +<table> + + <tr> + <td>API:</td> + <td>getmenus</td> + </tr> + <tr> + <td>コンポーネント:</td> + <td>AjaxChangeWindow</td> + </tr> + <tr> + <td>説明:</td> + <td>ウィンドウの状態もしくはポートレットモードを変更します.</td> + </tr> + <tr> + <td>パラメータ:</td> + <table> + <tr> + <td>action</td> + <td>window</td> + </tr> + <tr> + <td>id</td> + <td>変更するポートレットのウィンドウの id</td> + </tr> + <tr> + <td>state</td> + <td>ポートレット API で有効なウィンドウの状態もしくは拡張されたウィンドウの状態 (normal | maximized | minimized)</td> + </tr> + <tr> + <td>mode</td> + <td>ポートレット API で有効なポートレットの状態もしくは拡張されたポートレットの状態 (view | edit | help | print)</td> + </tr> + <tr> + <td>page</td> + <td>URL によって示される</td> + </tr> + </table> + </tr> + <tr> + <td>API の例:</td> + <td> +<source><![CDATA[ +http://localhost:8080/jetspeed/ajaxapi?action=window&state=maximized&mode=edit&id=um-2 +]]></source> + </td> + </tr> + <tr> + <td>XML Response:</td> + <td> +<source><![CDATA[ +<js> + <status>success</status> + <action>window</action> + <id>um-2</id> + <state>maximized</state> + <mode>edit</mode> +</js> +]]></source> + </td> + </tr> +</table> + </subsection> -<subsection name='getuseinfo'> +<subsection name='[getuseinfo] ユーザ情報の取得'> + +<div class="original"> <table> <tr> @@ -1511,9 +1717,63 @@ </td> </tr> </table> +</div> + +<table> + + <tr> + <td>API:</td> + <td>getuseinfo</td> + </tr> + <tr> + <td>コンポーネント:</td> + <td>AjaxGetUserInformation</td> + </tr> + <tr> + <td>説明:</td> + <td>現在ログインしているユーザの情報を返します.例えば,より確実な方法でのユーザ情報の取得のために AJAX ベースのポートレット内で使用可能です.ユーザが現在ログインしている時のみ,成功を返し,そうでなければ失敗を返します.</td> + </tr> + <tr> + <td>パラメータ:</td> + <table> + <tr> + <td>action</td> + <td>getuserinfo</td> + </tr> + </table> + </tr> + <tr> + <td>API example:</td> + <td> +<source><![CDATA[ +http://localhost:8080/jetspeed/ajaxapi?action=getuserinfo +]]></source> + </td> + </tr> + <tr> + <td>XML Response:</td> + <td> +<source><![CDATA[ +<js> + <status>success</status> + <action>userinformation</action> + <username>admin</username> + <type>org.apache.jetspeed.security.impl.UserPrincipalImpl</type> + <userinfo> + <user.name.given>Test Dude</user.name.given> + <user.name.family>Dudley</user.name.family> + </userinfo> +</js> +]]></source> + </td> + </tr> +</table> + </subsection> <subsection name='getuserlist'> + +<div class="original"> <table> <tr> @@ -1599,6 +1859,88 @@ </td> </tr> </table> +</div> + +<table> + + <tr> + <td>API:</td> + <td>getuseinfo</td> + </tr> + <tr> + <td>コンポーネント:</td> + <td>AjaxGetUserList</td> + </tr> + <tr> + <td>説明:</td> + <td>現在ログインしているユーザの基本的な情報 (ユーザ名,IP アドレス,セッション数,ステータス) を XML フォーマットで提供します.オプションで,もっと詳細なユーザ情報であるゲストのセッション数やオフラインのユーザ数を提供することも可能です.</td> + </tr> + <tr> + <td>パラメータ:</td> + <table> + <tr> + <td>action</td> + <td>getuserinfo</td> + </tr> + <tr> + <td>userinfo</td> + <td>userinfo も含めるべきかどうか. (true | false [default])</td> + </tr> + <tr> + <td>offline</td> + <td>オフラインユーザも含めるべきかどうか. (true | false [default])</td> + </tr> + <tr> + <td>guest</td> + <td>ゲストユーザのセッション数も返すべきかどうか. (true | false [default])</td> + </tr> + <tr> + <td>all</td> + <td>true に設定された場合,存在する色々な情報を全て返します. (true | false [default])</td> + </tr> + </table> + </tr> + <tr> + <td> + <p> + デフォルトでは,プライベート情報 (メールアドレスなど) は RolesSecurityBehavior によるセキュリティによって守られていますが,これは,protectionScope のコンストラクタの値を基本情報すら保護する "all" と設定するか,誰でも全てを見ることができる "none" に変更することにより <a href="http://svn.apache.org/viewvc/portals/jetspeed-2/trunk/src/webapp/WEB-INF/assembly/ajax-layout.xml?view=markup">AJAX の設定</a> で変更することが可能です.デフォルトの "private" という値は,オンライン/オフラインユーザの基本情報とゲストセッション数だけが見えます."private-offline" はオフラインユーザの情報が見えなくなります.protectionScope の値は "all", "private-offline", "private", "none" の値を取ることが可能です. + </p> + </td> + </tr> + <tr> + <td>API example:</td> + <td> +<source><![CDATA[ +http://localhost:8080/jetspeed/ajaxapi?action=getuserlist&userinfo=true&guest=true +]]></source> + </td> + </tr> + <tr> + <td>XML Response:</td> + <td> +<source><![CDATA[ +<js> + <status>success</status> + <action>getuserlist</action> + <users> + <user> + <username>admin</username> + <sessions>1</sessions> + <status>online</status> + <ipaddress>127.0.0.1</ipaddress> + <userinfo> + <user.name.given>Test Dude</user.name.given> + <user.name.family>Dudley</user.name.family> + </userinfo> + </user> + <guests>0</guests> + </users> +</js> +]]></source> + </td> + </tr> +</table> + </subsection> </section> @@ -1619,6 +1961,9 @@ <bean id="AjaxRequestService" class="org.apache.jetspeed.ajax.AjaxRequestServiceImpl"> <constructor-arg index="0"> <map> + <entry key="move"> + <ref bean="AjaxMove"/> + </entry> <entry key="moveabs"> <ref bean="AjaxMovePortletAbsolute"/> </entry> @@ -1646,6 +1991,57 @@ <entry key="getpage"> <ref bean="AjaxGetPage"/> </entry> + <entry key="getpages"> + <ref bean="AjaxGetPages"/> + </entry> + <entry key="getfolder"> + <ref bean="AjaxGetFolder"/> + </entry> + <entry key="getlink"> + <ref bean="AjaxGetLink"/> + </entry> + <entry key="getfolderlist"> + <ref bean="AjaxGetFolderList"/> + </entry> + <entry key="getfolders"> + <ref bean="AjaxGetFoldersList"/> + </entry> + <entry key="getthemes"> + <ref bean="AjaxGetThemes"/> + </entry> + <entry key="getactions"> + <ref bean="AjaxGetActions"/> + </entry> + <entry key="window"> + <ref bean="AjaxChangeWindow"/> + </entry> + <entry key="getmenus"> + <ref bean="AjaxGetMenus"/> + </entry> + <entry key="getmenu"> + <ref bean="AjaxGetMenu"/> + </entry> + <entry key="permissions"> + <ref bean="AjaxSecurityPermissions"/> + </entry> + <entry key="constraints"> + <ref bean="AjaxSecurityConstraints"/> + </entry> + <entry key="updatefolder"> + <ref bean="AjaxUpdateFolder"/> + </entry> + <entry key="updatepage"> + <ref bean="AjaxUpdatePage"/> + </entry> + <entry key="updatelink"> + <ref bean="AjaxUpdateLink"/> + </entry> + <entry key="getuserinfo"> + <ref bean="AjaxGetUserInformation"/> + </entry> + <entry key="getuserlist"> + <ref bean="AjaxGetUserList"/> + </entry> </map> </constructor-arg> <constructor-arg index="1"> @@ -1658,6 +2054,9 @@ <bean id="AjaxRequestService" class="org.apache.jetspeed.ajax.AjaxRequestServiceImpl"> <constructor-arg index="0"> <map> + <entry key="move"> + <ref bean="AjaxMove"/> + </entry> <entry key="moveabs"> <ref bean="AjaxMovePortletAbsolute"/> </entry> @@ -1685,6 +2084,57 @@ <entry key="getpage"> <ref bean="AjaxGetPage"/> </entry> + <entry key="getpages"> + <ref bean="AjaxGetPages"/> + </entry> + <entry key="getfolder"> + <ref bean="AjaxGetFolder"/> + </entry> + <entry key="getlink"> + <ref bean="AjaxGetLink"/> + </entry> + <entry key="getfolderlist"> + <ref bean="AjaxGetFolderList"/> + </entry> + <entry key="getfolders"> + <ref bean="AjaxGetFoldersList"/> + </entry> + <entry key="getthemes"> + <ref bean="AjaxGetThemes"/> + </entry> + <entry key="getactions"> + <ref bean="AjaxGetActions"/> + </entry> + <entry key="window"> + <ref bean="AjaxChangeWindow"/> + </entry> + <entry key="getmenus"> + <ref bean="AjaxGetMenus"/> + </entry> + <entry key="getmenu"> + <ref bean="AjaxGetMenu"/> + </entry> + <entry key="permissions"> + <ref bean="AjaxSecurityPermissions"/> + </entry> + <entry key="constraints"> + <ref bean="AjaxSecurityConstraints"/> + </entry> + <entry key="updatefolder"> + <ref bean="AjaxUpdateFolder"/> + </entry> + <entry key="updatepage"> + <ref bean="AjaxUpdatePage"/> + </entry> + <entry key="updatelink"> + <ref bean="AjaxUpdateLink"/> + </entry> + <entry key="getuserinfo"> + <ref bean="AjaxGetUserInformation"/> + </entry> + <entry key="getuserlist"> + <ref bean="AjaxGetUserList"/> + </entry> </map> </constructor-arg> <constructor-arg index="1">