svnno****@sourc*****
svnno****@sourc*****
2010年 10月 5日 (火) 18:49:18 JST
Revision: 112
http://sourceforge.jp/projects/jetspeed-japan/svn/view?view=rev&revision=112
Author: karma
Date: 2010-10-05 18:49:18 +0900 (Tue, 05 Oct 2010)
Log Message:
-----------
Update translate sections of Move, Permission (subsection of API section)
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-07-05 11:23:08 UTC (rev 111)
+++ jetspeed-2-trans/trunk/ja/xdocs/guides/guide-ajax-api.xml 2010-10-05 09:49:18 UTC (rev 112)
@@ -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
@@ -429,7 +430,7 @@
</tr>
</table>
</subsection>
-<subsection name='[Move] 移動'>
+<subsection name='[Move Relative] 相対位置で移動'>
<div class="original">
<table>
<tr>
@@ -555,6 +556,168 @@
</table>
</subsection>
+<subsection name='[Move] 移動'>
+<div class="original">
+<table>
+ <tr>
+ <td>API:</td>
+ <td>move</td>
+ </tr>
+ <tr>
+ <td>Component:</td>
+ <td>AjaxMovePortlet</td>
+ </tr>
+ <tr>
+ <td>Description:</td>
+ <td>Move a portlet on a page to a cartesian position (x,y,z,width,height) from request parameters.</td>
+ </tr>
+ <tr>
+ <td>Parameters:</td>
+ <table>
+ <tr>
+ <td>page</td>
+ <td>implied in the URL</td>
+ </tr>
+ <tr>
+ <td>action</td>
+ <td>move</td>
+ </tr>
+ <tr>
+ <td>id</td>
+ <td>the portlet PSML fragment id of the portlet to be moved</td>
+ </tr>
+ <tr>
+ <td>x</td>
+ <td>the portlet cartesian X position</td>
+ </tr>
+ <tr>
+ <td>y</td>
+ <td>the portlet cartesian Y position</td>
+ </tr>
+ <tr>
+ <td>z</td>
+ <td>the portlte cartesian Z position</td>
+ </tr>
+ <tr>
+ <td>width</td>
+ <td>the width of the portlet</td>
+ </tr>
+ <tr>
+ <td>height</td>
+ <td>the height cartesian Y position</td>
+ </tr>
+ </table>
+ </tr>
+ <tr>
+ <td>API example:</td>
+ <td>
+<source><![CDATA[
+http://localhost:8080/jetspeed/ajaxapi/Public/public.psml?action=move&id=ps-1003&x=100&y=250&width=200&height=300
+]]></source>
+ </td>
+ </tr>
+ <tr>
+ <td>XML Response:</td>
+ <td>
+<source><![CDATA[
+<js>
+ <status>success</status>
+ <action>move</action>
+ <id>ps-1003</id>
+ <old_position>
+ <x>50</x>
+ <y>155</row>
+ </old_position>
+ <new_position>
+ <x>100</x>
+ <y>250</y>
+ </new_position>
+</js>
+]]></source>
+ </td>
+ </tr>
+</table>
+</div>
+<table>
+ <tr>
+ <td>API:</td>
+ <td>move</td>
+ </tr>
+ <tr>
+ <td>コンポーネント:</td>
+ <td>AjaxMovePortlet</td>
+ </tr>
+ <tr>
+ <td>説明:</td>
+ <td>ページ上のポートレットの位置をリクエストパラメータで指定した直交座標系の位置 (x,y,z,幅，高さ) へ移動する．</td>
+ </tr>
+ <tr>
+ <td>パラメータ:</td>
+ <table>
+ <tr>
+ <td>page</td>
+ <td>URL に含まれます</td>
+ </tr>
+ <tr>
+ <td>action</td>
+ <td>move</td>
+ </tr>
+ <tr>
+ <td>id</td>
+ <td>移動させたいポートレット PSML フラグメント ID</td>
+ </tr>
+ <tr>
+ <td>x</td>
+ <td>ポートレットの直交座標での X 軸の位置</td>
+ </tr>
+ <tr>
+ <td>y</td>
+ <td>ポートレットの直交座標での Y 軸の位置</td>
+ </tr>
+ <tr>
+ <td>z</td>
+ <td>ポートレットの直交座標での Z 軸の位置</td>
+ </tr>
+ <tr>
+ <td>width</td>
+ <td>ポートレットの幅</td>
+ </tr>
+ <tr>
+ <td>height</td>
+ <td>ポートレットの高さ</td>
+ </tr>
+ </table>
+ </tr>
+ <tr>
+ <td>API の例:</td>
+ <td>
+<source><![CDATA[
+http://localhost:8080/jetspeed/ajaxapi/Public/public.psml?action=move&id=ps-1003&x=100&y=250&width=200&height=300
+]]></source>
+ </td>
+ </tr>
+ <tr>
+ <td>XML レスポンス:</td>
+ <td>
+<source><![CDATA[
+<js>
+ <status>success</status>
+ <action>move</action>
+ <id>ps-1003</id>
+ <old_position>
+ <x>50</x>
+ <y>155</row>
+ </old_position>
+ <new_position>
+ <x>100</x>
+ <y>250</y>
+ </new_position>
+</js>
+]]></source>
+ </td>
+ </tr>
+</table>
+</subsection>
<subsection name='[Add Portlet] ポートレットの追加'>
<div class="original">
<table>
@@ -949,6 +1112,495 @@
</tr>
</table>
</subsection>
+
+<subsection name='[Permissions] パーミッション'>
+<div class="original">
+<table>
+
+ <tr>
+ <td>API:</td>
+ <td>permissions</td>
+ </tr>
+ <tr>
+ <td>Component:</td>
+ <td>AjaxSecurityPermissions</td>
+ </tr>
+ <tr>
+ <td>Description:</td>
+ <td>Security Permissions Maintenance to add, update, and remove permissions from the Jetspeed security policy</td>
+ </tr>
+ <tr>
+ <td>Parameters:</td>
+ <table>
+ <tr>
+ <td>action</td>
+ <td>permissions</td>
+ </tr>
+ <tr>
+ <td>method</td>
+ <td>the method to execute: must be of value: add | update | remove</td>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>the type of permission being manipulated: portlet | folder | page</td>
+ </tr>
+ <tr>
+ <td>resource</td>
+ <td>the name of the portal resource being manipulated</td>
+ </tr>
+ <tr>
+ <td>roles</td>
+ <td>comma-separated list of roles, only valid for methods: add, update</td>
+ </tr>
+ <tr>
+ <td>actions</td>
+ <td>comma-separated list of actions, only valid for methods: add, update</td>
+ </tr>
+ <tr>
+ <td>oldactions</td>
+ <td>comma-separated list of previous actions, only valid for methods: update</td>
+ </tr>
+ </table>
+ </tr>
+ <tr>
+ <td>API example:</td>
+ <td>
+<source><![CDATA[
+http://localhost:8080/jetspeed/ajaxapi?action=permissions&method=add&type=portlet&resource=demo::*&roles=role1,role2,role3&actions=view,edit
+]]></source>
+ </td>
+ </tr>
+ <tr>
+ <td>XML Response:</td>
+ <td>
+<source><![CDATA[
+<js>
+ <status>success</status>
+ <action>permissions</action>
+ <resource>demo::*</resource>
+ <type>portlet</type>
+ <actions>view,edit</actions>
+ <actions>role1,role2,role3</actions>
+</js>
+]]></source>
+ </td>
+ </tr>
+</table>
+</div>
+<table>
+
+ <tr>
+ <td>API:</td>
+ <td>permissions</td>
+ </tr>
+ <tr>
+ <td>コンポーネント:</td>
+ <td>AjaxSecurityPermissions</td>
+ </tr>
+ <tr>
+ <td>説明:</td>
+ <td>Jetspeed のセキュリティポリシーからパーミッションを追加，更新，削除するためのセキュリティパーミッションのメンテナンス．</td>
+ </tr>
+ <tr>
+ <td>パラメータ:</td>
+ <table>
+ <tr>
+ <td>action</td>
+ <td>permissions</td>
+ </tr>
+ <tr>
+ <td>method</td>
+ <td>実行するメソッド: 以下のいずれかの値である必要がある: add | update | remove</td>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>操作するパーミッションのタイプ: portlet | folder | page</td>
+ </tr>
+ <tr>
+ <td>resource</td>
+ <td>操作するポータルリソースの名前</td>
+ </tr>
+ <tr>
+ <td>roles</td>
+ <td>カンマ区切りのロールのリスト．以下のメソッドのみ有効: add, update</td>
+ </tr>
+ <tr>
+ <td>actions</td>
+ <td>カンマ区切りのアクションのリスト．以下のメソッドのみ有効: add, update</td>
+ </tr>
+ <tr>
+ <td>oldactions</td>
+ <td>カンマ区切りの前回のアクションのリスト．以下のメソッドのみ有効: update</td>
+ </tr>
+ </table>
+ </tr>
+ <tr>
+ <td>API の例:</td>
+ <td>
+<source><![CDATA[
+http://localhost:8080/jetspeed/ajaxapi?action=permissions&method=add&type=portlet&resource=demo::*&roles=role1,role2,role3&actions=view,edit
+]]></source>
+ </td>
+ </tr>
+ <tr>
+ <td>XML レスポンス:</td>
+ <td>
+<source><![CDATA[
+<js>
+ <status>success</status>
+ <action>permissions</action>
+ <resource>demo::*</resource>
+ <type>portlet</type>
+ <actions>view,edit</actions>
+ <actions>role1,role2,role3</actions>
+</js>
+]]></source>
+ </td>
+ </tr>
+</table>
+</subsection>
+
+<subsection name='getmenus'>
+<table>
+
+ <tr>
+ <td>API:</td>
+ <td>getmenus</td>
+ </tr>
+ <tr>
+ <td>Component:</td>
+ <td>AjaxGetMenus</td>
+ </tr>
+ <tr>
+ <td>Description:</td>
+ <td>Retrieves all menus for the current page (implied in URL)</td>
+ </tr>
+ <tr>
+ <td>Parameters:</td>
+ <table>
+ <tr>
+ <td>action</td>
+ <td>getmenus</td>
+ </tr>
+ <tr>
+ <td>page</td>
+ <td>(implied in URL)</td>
+ </tr>
+ </table>
+ </tr>
+ <tr>
+ <td>API example:</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'>
+<table>
+
+ <tr>
+ <td>API:</td>
+ <td>getmenu</td>
+ </tr>
+ <tr>
+ <td>Component:</td>
+ <td>AjaxGetMenu</td>
+ </tr>
+ <tr>
+ <td>Description:</td>
+ <td>Retrieves the menu definition for a given menu</td>
+ </tr>
+ <tr>
+ <td>Parameters:</td>
+ <table>
+ <tr>
+ <td>action</td>
+ <td>getmenu</td>
+ </tr>
+ <tr>
+ <td>menu</td>
+ <td>name of the menu to retrieve (menu definition may change per page)</td>
+ </tr>
+ </table>
+ </tr>
+ <tr>
+ <td>API example:</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'>
+<table>
+
+ <tr>
+ <td>API:</td>
+ <td>getmenus</td>
+ </tr>
+ <tr>
+ <td>Component:</td>
+ <td>AjaxChangeWindow</td>
+ </tr>
+ <tr>
+ <td>Description:</td>
+ <td>Changes a portlet window's Window State or Portlet Mode</td>
+ </tr>
+ <tr>
+ <td>Parameters:</td>
+ <table>
+ <tr>
+ <td>action</td>
+ <td>window</td>
+ </tr>
+ <tr>
+ <td>id</td>
+ <td>window id of the portlet to be modified</td>
+ </tr>
+ <tr>
+ <td>state</td>
+ <td>A portlet api valid window state or extended window state (normal | maximized | minimized)</td>
+ </tr>
+ <tr>
+ <td>mode</td>
+ <td>A portlet api valid portlet mode or extended portlet mode (view | edit | help | print)</td>
+ </tr>
+ <tr>
+ <td>page</td>
+ <td>Implied in URL</td>
+ </tr>
+ </table>
+ </tr>
+ <tr>
+ <td>API example:</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'>
+<table>
+
+ <tr>
+ <td>API:</td>
+ <td>getuseinfo</td>
+ </tr>
+ <tr>
+ <td>Component:</td>
+ <td>AjaxGetUserInformation</td>
+ </tr>
+ <tr>
+ <td>Description:</td>
+ <td>Returns information about the currently logged in user. Can be used for example in AJAX based portlets to retrieve the userinfo in a more robust way. Will return success only if a user is currenly logged in, otherwise will return false.</td>
+ </tr>
+ <tr>
+ <td>Parameters:</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'>
+<table>
+
+ <tr>
+ <td>API:</td>
+ <td>getuseinfo</td>
+ </tr>
+ <tr>
+ <td>Component:</td>
+ <td>AjaxGetUserList</td>
+ </tr>
+ <tr>
+ <td>Description:</td>
+ <td>Provides basic information (username, ip-address, number of sessions and status) about currently logged in users in xml-format. Optionally it can also provide more detailed userinformation, number of guest sessions and include offline users as well.</td>
+ </tr>
+ <tr>
+ <td>Parameters:</td>
+ <table>
+ <tr>
+ <td>action</td>
+ <td>getuserinfo</td>
+ </tr>
+ <tr>
+ <td>userinfo</td>
+ <td>Whether we should include also userinfo (true | false [default])</td>
+ </tr>
+ <tr>
+ <td>offline</td>
+ <td>Whether we should include offline users (true | false [default])</td>
+ </tr>
+ <tr>
+ <td>guest</td>
+ <td>Whether we should return also the guest sessions (true | false [default])</td>
+ </tr>
+ <tr>
+ <td>all</td>
+ <td>If set to true, will return every bits and piece there is (true | false [default])</td>
+ </tr>
+ </table>
+ </tr>
+ <tr>
+ <td>
+ <p>
+ By default the private information (emails, etc..) is protected with
+ RolesSecurityBehavior security, but can be changed in <a href="http://svn.apache.org/viewvc/portals/jetspeed-2/trunk/src/webapp/WEB-INF/assembly/ajax-layout.xml?view=markup">AJAX configuration</a>
+ by altering the protectionScope constructor value to either "all" to protect
+ even the basic information or to "none" when everything will be shown for everyone (not wise on production).
+ The default value "private" will show just the basic information of online/offline users and number of guest sessions,
+ as the "private-offline" will not show even the offline users. Possible protectionScope values are "all",
+ "private-offline", "private" and "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>
<section name='[Spring Assembly] Spring アセンブリ'>