5.1.1 포탈 기능 활성화 하기

Zimbra의 포탈 기능이란 Zimbra 웹 클라이언트에서 홈 탭을 생성하여 포탈의 랜딩 페이지처럼 쓰일 수 있는 기능입니다. 이 포탈 페이지는 Zimlet들을 “portlet”들로써 구성할 수 있습니다.

이 포탈 기능은 zmprov 명령을 사용하여 zimbraFeaturePortalEnabled 변수를 TRUE로 설정함으로서 활성화할 수 있습니다. 그리고 포탈 이름을 설정할 수도 있습니다. 특정한 사용자에 대하여 포탈 기능을 활성하 하기 위해서는 다음을 따라 하면 됩니다.

1. 터미널을 열고 Zimbra 유저로 바꿉니다.

2. 포탈 기능과 관련한 변수를 TRUE로 설정합니다.

3. user의 포탈을 id가 “example”인 포탈로 설정합니다.

5.1.2 포탈 파일

포탈은 포탈 “id”를 구성하고 포탈에서 쓰이는 zimlet을 정의하는 manifest.xml 파일로 이루어져 있다. 또한 이 manifest.xml 파일에서는 포탈 페이지에서 보여주는 HTML 레이아웃도 포함할 수 있다. 이 manifest.xml 파일은 아래와 같이 포탈 “id”(portal-id)와 일치하는 디렉토리에 위치해 였어야 한다.

{zcs-install-dir}/jetty/webapps/zimbra/portals/{portal-id}

포탈 id가 “example”인 코드 샘플은 다음 곳에 위치해 있다.

5.1.3 포탈 레이아웃

포탈의 manifest.xml 파일은 portlet을 정의하고 portlet의 property와 함께 portlet과 연계하여 로드할 zimlet을 기술합니다. 아래 코드에서는 각각 “panel_1 – 2 – 3”으로 명명된 패널과 함께 세 개의 portlet이 보여줍니다. manifest.xml 파일에서 panel_2 portel을 다음과 같이 정의하고 있습니다.

포탈의 manifest.xml은 포탈 페일지를 위한 레이아웃을 정의합니다. 다음 레이아웃에서는, panel_1panel_2의 두 개의 portlet이 table의 첫째줄에 나타납니다. panel_3 portlet은 두번째 줄에 나타나고 두개의 셀로 되어 있습니다.

5.1.4. 포탈 Manifesto 파일

아래에서는 포탈의 manifest.xml 파일의 요소에 대해 설명합니다.

5.1.4.1 <portal>

<portal> 요소는 manifest.xml 파일에서 다른 요소들을 담고 있습니다. <portal> 요소는 다음의 속성을 가지고 있습니다.

값의 범위

속성 필수/옵션 속성값의 범위 디폴트값 설명
id 필수 유효한 포탈 id N/A id 속석은 포탈 id(또는 포탈 이름)으로 반드시 정의되어야 한다. 이 속응은 포탈의 manifest.xml 파일을 포함한 디렉토리명과 반드시 같아야 한다. 예를 들어 다음과 같다.
{zcs-install-dir}/jetty/webapps/zimbra/portals/{portal-id}/manifest.xml

다음의 테이블은 <portal> 요소 내에서 정의할 수 있는 요소들을 기술합니다.

순서 요소 필수/옵션 설명
1 portlets 필수(1번만 나와야 함) 이 요소는 포탈과 함께 쓰이는 portlet들을 기술합니다. 자세한 것은 아래 <portlets>를 참고하세요.
2 html 필수(1번만 나와야 함) 이 요소는 포탈의 레이아웃을 기술합니다. 자세한 것은 아래 <html>을 참고하세요.

예제:

5.1.4.2 <portlets>

이 요소는 포탈에서 쓰이는 portlet들을 기술합니다. 다음의 테이블은 <portlets> 요소 내에서 쓰일 수 있는 요소에 대해서 설명합니다.

순서 요소 필수/옵션 설명
1 portlet 필수(최소 1개 이상) 이 요소는 포탈과 함께 쓰이는 portlet들을 기술합니다. 자세한 것은 아래 <portlet>를 참고하세요.

예제:

5.1.4.3 <portlet>

이 요소는 포탈에서 쓰이는 zimlet, panel 그리고 property를 정의합니다. <portlet> 요소는 다음과 같은 속성을 가지고 있습니다.

속성 필수/옵션 속성값의 범위 디폴트값 설명
zimlet 필수 유효한  zimlet 이름 N/A 이 portlet에서 쓰일 zimlet의 이름

다음 테일블은 <portlet> 요소 내에서 정의할 수 있는 요소들을 설명합니다.

순서 요소 필수/옵션 설명
1 panel 필수(1번만 나와야 함) 포탈에 쓰이는 패널을 정의합니다. 자세한 것은 아래 <panel>을 참고하세요.
2 property 옵션(0개 또는 그 이상) zimlet을 위한 property를 기술합니다. 자세한 것은 아래 <property>를 참고하세요.

예제:

5.1.4.4 <panel>

이 요소는 포탈의 panel을  정의합니다. <panel> 요소는 다음의 속성을 가지고 있습니다.

속성 필수/옵션 속성값의 범위 디폴트값 설명
id 필수 유효한 id N/A  이 portlet의 panel의 id. 이 id는 포탈 페이지 내에서 지정된 HTML 레이아웃에 나타나도록 사용됩니다.

예제:

5.1.4.5 <property>

이 요소는 포탈에서 쓰이는 zimlet으로 넘겨줄 property를 정의하는데 사용됩니다. 이 요소의 내용은 파라메터 값입니다.

이 <portlet> 요소는 다음과 같은 속성을 가지고 있습니다.

속성 필수/옵션 속성값의 범위 디폴트값 설명
이름 필수 속성 이름 N/A zimlet으로 넘겨줄 property를 기술합니다.

예제:

5.1.4.6 <html>

이 요소는 포탈 페이지 레이아웃을 표현하는 HTML 코드를 감싸는데 사용됩니다.

5.1.5 포탈 Zimlet

다음의 zimlet은 포탈 페이지에서 간단한 portlet을 나타내는데 도움을 주기 위해서 제공되고 있습니다.

portlet 설명
com_zimbra_html 이 portlet은 특정 URL의 내용을 포탈 페이지내에서 로드합니다.
5.1.5.1 com_zimbra_html
Porperty 필수/옵션 디폴트값 설명
url 필수 N/A 로드할 페이지의 URL. 이 URL은 zimbra 서버 내에 위한 JSP 또는 HTML 페이지가 될 수 있고 zimbra 밖에 위치할 수도 있습니다.

노트: 만약 zimbra 외부의 페이지를 “inline” 으로 로드하려면, Proxy Servlet을 설정해야 합니다. 자세한 것은 Proxy Servlet Setup을 참고하세요.

refresh 옵션 N/A  포트릿을 새로 고침하는 간격(millisecond 단위)
type 옵션 inline,

iframe

 URL을 페이지 내에서 “inline”으로 로드할 것인지, 또는 “iframe”으로 로드할 것인지를 지정합니다. 기본값은 “inline”입니다.

댓글 남기기

이메일은 공개되지 않습니다. 필수 입력창은 * 로 표시되어 있습니다