'알프레스코' 태그의 글 목록

Web Scripts 에서 /Share 세션 객체에 접근하기

JAVA/Alfresco / 2014. 5. 1. 14:42

2014/04/26 - [JAVA/Alfresco] - Web Scripts 에서 Request Header 조회하기

2014/04/27 - [JAVA/Alfresco] - Web Scripts 에서 모바일 기기 체크하기

2014/04/28 - [JAVA/Alfresco] - Web Scripts 에서 Cookie 에 접근하기

이번에는 세션에 접근할 수 있도록 기능을 추가하고 내부 개선작업을 진행했다.

var GlobalScriptHelper = (function() {

/**
	 * 리퀘스트 헤더
	 */
	var _p_requestHeaders = null;

/**
	 * 리퀘스트 객체를 반환한다.
	 */
	function _f_gatheringRequest() {

var _requestObject = Request.get('surfViewHttpServletRequest').getWrappedObject();
		return _requestObject;
	}

/**
	 * 리퀘스트 헤더를 반환한다.
	 */
	function _f_gatheringRequestHeaders() {

var _requestObject = _f_gatheringRequest();
		var _headerNames = _requestObject.getHeaderNames();

_p_requestHeaders = {};
		while (_headerNames.hasMoreElements()) {
			var _name = _headerNames.nextElement();
			_p_requestHeaders[_name] = _requestObject.getHeader(_name);
		}
	}

/**
	 * 리퀘스트 헤더 전체를 반환한다.
	 */
	function _f_getRequestHeaders() {

if (_p_requestHeaders == null) {
			_f_gatheringRequestHeaders()
		}

return _p_requestHeaders;
	}

/**
	 * 리퀘스트 세션을 반환한다.
	 */
	function _f_getRequestSession() {

var _requestObject = _f_gatheringRequest();
		return _requestObject.getSession(true);
	}

return {

/**
		 * 리퀘스트 헤더를 반환한다.
		 */
		getRequestHeader: function getRequestHeader(name) {

return _f_getRequestHeaders()[name.toLowerCase()];
		},

/**
		 * 모바일 기기를 반환한다.
		 */
		getMobileDevice: function getMobileDevice() {

var _userAgent = this.getRequestHeader('User-Agent');
			return _userAgent.match(/Android|webOS|iPhone|iPad|iPod|BlackBerry|Windows Phone/i);
		},

/**
		 * 모바일 기기 여부를 확인한다.
		 */
		isMobile: function isMobile() {

return this.getMobileDevice() != null;
		},

/**
		 * 쿠키를 조회한다.
		 * 
		 * @param key
		 *            {String} 쿠키 키
		 */
		getCookie: function getCookie(key) {

var _cookie = this.getRequestHeader('Cookie');
			var _keyValue = _cookie.match('(^|;) ?' + key + '=([^;]*)(;|$)');
			return _keyValue ? _keyValue[2] : null;
		},

/**
		 * 세션의 속성을 설정한다.
		 * 
		 * @param name
		 *            {String} 세션 속성 이름
		 * @param value
		 *            {Object} 세션 속성 값
		 */
		setSessionAttribute: function setSessionAttribute(name, value) {

_f_getRequestSession().setAttribute(name, value);
		},

/**
		 * 세션의 속성을 가져온다.
		 * 
		 * @param name
		 *            {String} 세션 속성 키
		 */
		getSessionAttribute: function getSessionAttribute(name) {

return _f_getRequestSession().getAttribute(name);
		},

/**
		 * 세션의 속성을 제거한다.
		 * 
		 * @param name
		 *            {String} 세션 속성 키
		 */
		removeSessionAttribute: function removeSessionAttribute(name) {

return _f_getRequestSession().removeAttribute(name);
		}
	}
})();

이번에 추가된 함수는 setSession(), getSession(), removeSession() 이다.

테스트 결과 정상적으로 동작하는 것을 확인했다.

저작자표시

Posted by 자수씨

, |

JOIN 에 대한 연구? 삽질?

JAVA/Alfresco / 2014. 2. 19. 11:45

Alfresco 는 CMIS 이다. CMIS 를 대상으로 컨텐츠 모델링을 할 때는 일반 RDB 모델링 하듯이 하면 완전 피본다는 것을 뼈저리게 느끼고 있다.

일단, JOIN 이 지원되지 않는다는 것은 타격이 크다. SOLR 은 4.0 이상 부터 JOIN 을 지원하는데, Alfresco 4.0 에서는 SOLR 1.4 버전을 사용한다. CMIS Query 에서 JOIN 을 제공해주는 예제를 확인하여 테스트를 해보았으나 커스텀 타입의 데이터 모델은 "Advanced join is not supported" 익셉션만 뱉을 뿐이다...

검색을 하다가 찾은 내용인데, 안습...

The bottom-line is that Alfresco isn't relational. You can set up associations and through the API you can ask a give node for its associations, but you cannot run queries across associations like you can when you do joins in a relational database.

Maybe you should add a location property to your content node and update its value with a behavior any time an association is created, updated, or deleted on that node. Then you'd be able to run a query by AND-ing the location with other criteria on the node.

Obviously, if you have many such properties that you need to keep in sync your behavior could start to affect performance negatively, but if you have only a handful you should be okay.

출처: http://stackoverflow.com/questions/11193275/alfresco-solr-custom-search

대충 내용은 Alfresco 는 relational 하지 않다. RDB 처럼 join 을 할 수 없다. 노드의 생성, 갱신, 삭제 시에 관련 프로퍼티를 업데이트 해주어야 한다. 이 것은 성능에 부정적인 영향을 끼친다. 얼마 안되는 정도라면 괜찮다.

결국, behaviour 를 이용하여 업데이트 하는 방법은 절대 절대 피해야 하는데 방법이 보이질 않는다...

SOLR 을 4.0 으로 올릴 수는 없을까?

저작자표시

Posted by 자수씨

, |

로그 경로 변경하기

JAVA/Alfresco / 2014. 2. 17. 14:10

[ALFRESCO_HOME]/webapps/alfresco/WEB-INF/classes/log4j.properties

###### File appender definition #######

log4j.appender.File=org.apache.log4j.DailyRollingFileAppender

log4j.appender.File.File=alfresco.log

log4j.appender.File.Append=true

log4j.appender.File.DatePattern='.'yyyy-MM-dd

log4j.appender.File.layout=org.apache.log4j.PatternLayout

log4j.appender.File.layout.ConversionPattern=%d{ABSOLUTE} %-5p [%c] %m%n

[ALFRESCO_HOME]/webapps/awe/WEB-INF/classes/log4j.properties

###### File appender definition #######

log4j.appender.File=org.apache.log4j.DailyRollingFileAppender

log4j.appender.File.File=awe.log

log4j.appender.File.Append=true

log4j.appender.File.DatePattern='.'yyyy-MM-dd

log4j.appender.File.layout=org.apache.log4j.PatternLayout

log4j.appender.File.layout.ConversionPattern=%d{ABSOLUTE} %-5p [%c] %m%n

[ALFRESCO_HOME]/webapps/solr/WEB-INF/classes/log4j.properties

###### File appender definition #######

log4j.appender.File=org.apache.log4j.DailyRollingFileAppender

log4j.appender.File.File=solr.log

log4j.appender.File.Append=true

log4j.appender.File.DatePattern='.'yyyy-MM-dd

log4j.appender.File.layout=org.apache.log4j.PatternLayout

log4j.appender.File.layout.ConversionPattern=%d{ABSOLUTE} %-5p [%c] %m%n

[ALFRESCO_HOME]/webapps/wcmqs/WEB-INF/classes/log4j.xml

</layout>

</appender>

저작자표시

Posted by 자수씨

, |

Web Scripts 에서 redirect 하기

JAVA/Alfresco / 2014. 2. 14. 17:11

UI 를 구성하는 Web Scripts 는 request 나 response 객체에 접근이 어렵기 때문에 Web Scripts 내에서 redirect 를 하려면 약간의 꼼수를 이용해야 한다.

Response Status 를 이용하는 꼼수인데, Response Status 로 핸들링하는 예제는 아래 더보기를 통해 확인할 수 있다.

출처: http://wiki.alfresco.com/wiki/Web_Scripts

Response Status

Web Scripts use HTTP response status codes to:

inform a client of an error situation (for example, item not found)
inform a client of an occurrence of an event (for example, item created)
instruct a client to perform a follow-up request (for example, authorization required)
inform a client of success

Response status codes are set in the controller script via the status root object.

We can add a status to our Hello World example indicating that we can only greet one person at a time i.e. the 'to' argument is specified only once. We can use status code 400 (Bad Request) to represent this. The controller script is extended as follows:

if (argsM.to != null && argsM.to.length > 1)
{
   status.code = 400;
   status.message = "Can only greet one person at a time.";
   status.redirect = true;
}
else
{
   model.toWho = (args.to != null) ? args.to : person.properties.userName; 
}

Redirect allows the rendering of a custom response template for the specified status code. If redirect is not set (that is, false), the response header status code is set but the relevant standard web script response template is used, as would normally apply.

If redirect is true, then an appropriate status response template is searched for. The search is performed in the following order:

Web Script specific template named <scriptid>.<method>.<format>.<code>.ftl: located in the same folder as the web script description document and used for the specified status code only, for example
/org/alfresco/sample/helloworld.get.html.400.ftl

Web Script specific template named <scriptid>.<method>.<format>.status.ftl: located in the same folder as the web script description document used for any status code, for example

/org/alfresco/sample/helloworld.get.html.status.ftl

Package level template named <format>.<code>.ftl: this template is first located in the package of the web script, but if not found, is searched for in the parent package hierarchy, up to the root package, for example
/org/alfresco/sample/html.400.ftl

Package level template named <format>.status.ftl: this template is first located in the package of the web script, but if not found, is searched for in the parent package hierarchy, up to the root package, for example
/org/alfresco/sample/html.status.ftl

Default template named <code>.ftl: located in the root package and always renders html, for example
/400.ftl

Default template named status.ftl: located in the root package (provided out-of-the-box) and always renders html, for example
/status.ftl

Status Response templates have access to the same root objects as standard Web Script response templates. The exception is that the default templates /<code>.ftl and /status.ftl only have access to the root objects 'url', 'status', 'server' and 'date'.

To provide a custom Bad Request status response for our Hello World example we create the following file in the same folder as the web script description document

helloworld.get.html.400.ftl

whose content is

<html>
  <body>
    ${status.message}
  </body>
</html>

We can also provide a meaningful response for machine-readable XML requests:

helloworld.get.atom.400.ftl

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <code>${status.code}</code>
  <codeName>${status.codeName}</codeName>
  <codeDescription>${status.codeDescription}</codeDescription>
  <message>${status.message}</message>
</response>

Remember, these templates are optional, as the search for an appropriate status template will always eventually find the default template /status.ftl.

이번 포스팅에서 사용하는 방식은 "Package level template named <format>.status.ftl" 으로 사용하는 Web Scripts 와 같은 패키지(디렉토리)에 위치시키고 js 파일에서 status 를 제어하여 redirect 를 시킬 것이다.

/alfresco/web-extension/site-webscripts/test/package/test.content.get.js

위에서 redirectCondition 이 true 이면, status.code 에 899 값을 설정하고, status.location 에는 redirect 할 url 을, status.redirect 는 true 로 설정을 하고 실행하는 함수 자체를 return 시켜서 아래 코드가 실행되지 않도록 한다.

/alfresco/web-extension/site-webscripts/test/package/html.status.ftl

html.status.ftl 은 "/alfresco/web-extension/site-webscripts/test/package/" 하위에 있는 *.html.ftl 에서 status 값이 설정되면 해당 페이지로 리다이렉트하게 된다.

잘만 이용하면 다양한 기능을 활용할 수 있을 듯 하다.

저작자표시

Posted by 자수씨

, |

[Freemarker] 날짜시간 변환//

JAVA/Alfresco / 2014. 2. 13. 18:41

파라미터로 long 형 timestamp 를 넘겨주면,

1분 이내는 방금

1시간 이내는 ~분 전

하루 이내는 ~시간 전

나머지는 날짜 출력

=ㅁ= //

저작자표시

Posted by 자수씨

, |

Data dictionary options - index

JAVA/Alfresco / 2014. 2. 11. 22:19

참고자료: http://wiki.alfresco.com/wiki/Full-Text_Search_Configuration

각 프로퍼티의 인덱싱 행위는 컨텐츠 모델에서 설정될 수 있다. 기본적으로 원자적으로 인덱싱 된다. 프로퍼티 값은 인덱스 안에 저장되지 않고, 프로퍼티는 인덱싱 될 때, 토큰화 된다.

The following example shows how indexing can be controlled.

Enabled="false"

false 이면, 인덱스에 이 프로퍼티를 위한 엔트리는 없다.

Atomic="true"

true 이면, 프로퍼티는 트랜잭션 내에서 인덱싱되며, false 이면 프로퍼티는 백그라운드에서 인덱싱 된다.

(Indexing of content that requires transformation before being indexed (e.g. PDFs) will only obey Atomic=true if the transformation takes less time than the value specified for lucene.maxAtomicTransformationTime. See #General.)

Stored="true"

true 이면, 프로퍼티 값은 인덱스 내에 저장되고, 루씬 로우 레벨 쿼리 API를 통해 얻을 수 있다.

(This can be useful while debugging systems to see exactly what is being indexed, but do not set this to true on production systems.)

Tokenised="true"

"true" 이면, 프로퍼티의 문자열 값은 인덱싱 전에 토큰화 된다.

"false" 이면, 단일 문자열로 인덱싱 된다.

"both" 이면, 두 가지 형태로 인덱에 존재하기 된다.

저작자표시

Posted by 자수씨

, |

기본 퍼미션 모델

JAVA/Alfresco / 2014. 1. 27. 18:43

마찬가지로 개인 참고용으로 정리합니다.

참고자료: https://wiki.alfresco.com/wiki/Default_Permissions_Model_Reference#Base_permissions

sys:base

기본 퍼미션

_ReadProperties: 노드의 속성 읽기에 대한 접근을 제한. 컨텐츠 접근은 개별적으로 제어됨. 모든 속성은 동일한 접근 제한을 가짐.
_ReadChildren: 자식 노드의 읽기에 대한 접근을 제한. 개별 자식 노드에 설정된 권한이 우선 적용됨. 이 권한이 부여되지 않으면 자식노드를 탐색할 수 없음.
_WriteProperties: 노드의 모든 속성에 대한 쓰기에 대한 접근을 제한. 컨텐츠 접근은 개별적으로 제어됨. 모든 속성은 동일한 접근 제한을 가짐
_ReadContent: 노드에 대한 모든 컨텐츠의 읽기에 대한 접근을 제한
_WriteContent: 노드에 대한 모든 컨텐츠의 생성과 갱신에 대한 접근을 제한
_ExecuteContent: 컨텐츠 실행에 대한 접근을 제한
_DeleteNode: 노드 삭제에 대한 접근을 제한. 현재 노드의 모든 자식 노드를 삭제할 권한을 가지거나 부모로 부터 자식 노드를 삭제할 수 있는지를 체크하지 않음.
_DeleteChildren: 자식 노드의 삭제에 대한 접근을 제한
_CreateChildren: 새로운 자식 노드 생성에 대한 접근을 제한
_LinkChildren: 이미 존재하는 노드에 보조 어소시에이션 생성에 대한 접근을 제한
_DeleteAssociations: 노드에 대한 non-child-associations 삭제에 대한 접근을 제한
_ReadAssociations: 노드에 대한 non-child-associations 읽기에 대한 접근을 제한
_CreateAssociations: 노드에 대한 non-child-associations 생성에 대한 접근을 제한
_ReadPermissions: 노드에서 읽기 권한에 대한 접근을 제한
_ChangePermissions: 노드에서 쓰기 권한에 대한 접근을 제한

기본 그룹

FullControl: 다른 모든 권한을 허용하는 권한 그룹
ReadProperties: _ReadProperties 에서 부여됨
ReadChildren: _ReadChildren 에서 부여됨
WriteProperties: _WriteProperties 에서 부여됨
ReadContent: _ReadContent 에서 부여됨
WriteContent: _WriteContent 에서 부여됨
ExecuteContent: _ExecuteContent 에서 부여됨
DeleteNode: _DeleteNode 에서 부여됨
DeleteChildren: _DeleteChildren 에서 부여됨
CreateChildren: _CreateChildren 에서 부여됨
LinkChildren: _LinkChildren 에서 부여됨
DeleteAssociations: _DeleteAssociations 에서 부여됨
ReadAssociations: _ReadAssociations 에서 부여됨
CreateAssociations: _CreateAssociations 에서 부여됨
ReadPermissions: _ReadPermissions 에서 부여됨
ChangePermissions: _ChangePermissions 에서 부여됨

복합 그룹

Read: ReadProperties, ReadChildren, ReadContent 의 조합
Write (Update in CRUD): WriteProperties 와 WriteContent 의 조합
Delete: DeleteNode 와 DeleteChildren 의 조합
AddChildren (Create in CRUD): CreateChildren 과 LinkChildren 의 조합
Execute: 그냥 ExecuteContent

cm:object

복합 그룹

Administrator: 모든 권한을 갖음. 이전 버전과의 호환성을 위해...
Coordinator: 모든 권한과 정의된 권한 그룹을 가져옴
Collaborator: Editor 와 Contributor 권한의 조합
Contributor: Consumer 권한 그룹에 AddChildren과 CheckOut 이 추가됨. 기본적으로 자신이 만든 것을 소유하고 ROLE_OWNER 권한이 있어야 함
Editor: Consumer 권한 그룹에 Write 와 CheckOut 이 추가됨
Consumer: Read 를 포함
RecordAdministrator: ReadProperties, ReadChildren, WriteProperties, ReadContent, DeleteChildren, CreateChildren, LinkChildren, DeleteAssociations, CreateAssociations 를 포함

cm:folder

복합 그룹

cm:object 와 유사. Administrator 권한 그룹만 없음

cm:ownable

기본 권한

_SetOwner: 노드에서 권한 설정을 제한. 이 권한은 _WriteProperties 도 부여해야 함.

기본 그룹

SetOwner: _SetOwner 에서 부여됨

복합 그룹

TakeOwnership: SetOwner 를 포함

cm:lockable

기본 권한

_Lock: 노드 잠금에 대한 접근을 제한
_Unlock: 노드 잠금 해제에 대한 접근을 제한

기본 그룹

Lock: _Lock 에서 부여됨
Unlock: _Unlock 에서 부여됨

복합 그룹

CheckOut: Lock 을 포함
CheckIn: Unlock 을 포함
CancelCheckOut: Unlock 을 포함

전역 권한

"FullControl" 은 "ROLE_ADMINISTRATOR" 에 부여됨: 관리자는 어떤 것도 할 수 있음
"FullControl" 은 "ROLE_OWNER" 에 부여됨: 소유자는 모든 권한이 허용됨
"Unlock" 은 "ROLE_LOCK_OWNER" 에 부여됨: 잠금의 소유자는 언제든지 잠금을 풀 수 있음
"CheckIn" 은 "ROLE_LOCK_OWNER" 에 부여됨: 잠금의 소유자는 문서를 체크인 할 수 있음
"CancelCheckOut" 은 "ROLE_LOCK_OWNER" 에 부여됨: 잠금의 소유자는 문서의 체크아웃을 취소할 수 있음

저작자표시

Posted by 자수씨

, |

Web Script's Description...

JAVA/Alfresco / 2014. 1. 22. 16:20

개인적인 정리용으로...

출처: http://wiki.alfresco.com/wiki/Web_Scripts

기본

shortname: 사람이 읽을 수 있는 Web Script 이름
description (선택적인): Web Script 설명
url (하나 혹은 여러 개): Web Script가 바인딩되는 URI 템플릿.
format (선택적인): 응답의 content-type URI를 통해 어떻게 지정할 수 있는지를 제어

argument 는 query string 파라미터로 content-type 을 지정

ex) /helloworld?to=dave&format=xml

extension 은 URI extension 으로 content-type 을 지정

ex) /hello/world.xml?to=dave

any 는 위의 둘 중 하나가 사용될 수 있음
지정되지 않으면 기본 값은 any 로 설정

authentication (선택적인): 인증 레벨이 필요할 경우 사용

none 은 인증이 필요 없음을 지정
guest 은 최소한 guest 인증을 필요로 함
user 는 최소한 지정된 사용자 인증을 필요로 함
admin 은 최소한 지정된 관리자 인증을 필요로 함

확장

transaction (선택적인): 트랜잭션 레벨을 지정

none 은 트랜잭션이 필요 없음을 지정
required 는 트랜잭션이 필요함을 지정
requiresnew 는 새로운 트랜잭션이 필요함을 지정
지정되지 않으면 기본 값은 none 으로 설정

family (선택적인): 유사하거나 관련이 있는 web scripts 들을 분류하기 위한 태그
cache (선택적인): 캐싱 레벨을 지정

never (선택적인): 캐싱을 모두 적용해야 하는지 여부를 지정

true (기본 값) 는 web script 의 응답이 캐시되지 않음을 지정
false 는 web script 의 응답이 캐시할 수 있음을 지정

public (선택적인): 인증 응답이 공개 캐시에 캐시해야 하는지 여부를 지정

true (기본 값) / false

mustrevalidate (선택적인): 캐시가 freshness 를 보장하기 위해 web scritp 응답의 버전을 재검증해야 하는지 여부를 지정

true (기본 값) / false

negotiate (0개 이상): Accept 헤더 MIME-type 과 응답의 특정 web script 형식의 연관
kind (선택적인): web script 의 종류 재정의를 위한 식별
lifecycle (선택적인): web script 의 라이프사이클을 지정

none 은 web script 가 라이프사이클의 일부가 아님을 지정
sample 은 web script 가 샘플로 만들어졌으며, 제품으로 사용하지 않음을 지정
draft 는 web script 가 실험 중이거나 변경/정지 될 수 있음을 지정
public_api 는 Alfresco 의 공개 API 이며, 안정적이고 잘 테스트되었음을 지정
draft_public_api 는 공개 API가 될 것이지만, 실험 중이거나 변경/정지 될 수 있음을 지정
deprecated 는 향후 버전에서 제거될 수 있으니 사용을 피하도록 함을 지정
internal 은 Alfresco 내부에서만 사용됨을 지정

저작자표시

Posted by 자수씨

, |

Plugin execution not covered by lifecycle configuration

JAVA/Alfresco / 2013. 11. 14. 18:00

이클립스에서 m2e 플러그인을 사용할 경우, 알프레스코 플러그인이 아래와 같이 빨간 빛을 내는 경우가 있습니다.

Plugin execution not covered by lifecycle configuration: org.alfresco.maven.plugin:alfresco-maven-plugin:1.0.2:set-version (execution: default-set-version, phase: initialize)