AEM 포털 및 포틀릿 aem-portals-and-portlets

이 문서에서는 다음 사항에 대해 설명합니다.

AEM 포털 아키텍처 aem-portal-architecture

AEM 포털 아키텍처에는 포털 및 포틀릿에 대한 정의가 포함되어 있습니다.

포털이란? what-is-a-portal

포털은 개인화, SSO(Single Sign-On), 다양한 소스의 컨텐츠 통합을 제공하고 정보 시스템의 프레젠테이션 계층을 호스팅하는 웹 애플리케이션입니다.

AEM에서 JSR 286 호환 포틀릿을 실행할 수 있습니다. 포틀릿 구성 요소를 사용하여 페이지에 포틀릿을 포함할 수 있습니다. AEM Content Portlet 관리를 참조하십시오.

포틀릿이란? what-is-a-portlet

포틀릿은 다이내믹 콘텐츠를 생성하는 컨테이너 내에 배포된 웹 구성 요소입니다. 포틀릿 인터페이스는 포틀릿 컨테이너 내에 .war 파일로 패키지되어 배포됩니다. AEM을 포털로 실행하는 경우 포틀릿을 실행하려면 포틀릿의 .war 파일이 필요합니다.

포털에 표시할 AEM 콘텐츠를 구성하려면 포틀릿에 AEM 설치, 구성 및 사용을 참조하십시오.

AEM 포털 Director aem-portal-director

AEM 컨텐트 포틀릿 관리 administering-the-aem-content-portlet

AEM 컨텐츠 포틀릿을 사용하면 포털에 AEM 컨텐츠를 표시할 수 있습니다. 포틀릿은 /crx-quickstart/opt/portal에서 사용할 수 있으며 다양한 방법으로 사용자 지정할 수 있습니다. 예를 들어, AEM에 필요한 인증 정보를 생성하여 기본 동작을 덮어쓰는 자체 인증 서비스를 배포하여 SSO/인증 처리를 사용자 지정할 수 있습니다. 플러그인은 API에 대해 플러그인을 빌드하여 고유한 기능을 추가할 수 있도록 하는 정의된 API를 사용합니다. 플러그인은 실행 중인 포틀릿에 배포할 수 있습니다. 제대로 작동하려면 시작 시 표시할 콘텐츠 경로와 함께 AEM 작성자 및 게시 인스턴스의 구성이 필요합니다.

일부 구성은 포틀릿 기본 설정을 통해 변경할 수 있으며 다른 구성은 OSGi 서비스 구성을 통해 변경할 수 있습니다. config 파일 또는 OSGi 웹 콘솔을 사용하여 이러한 구성을 변경합니다.

포틀릿 기본 설정 portlet-preferences

포틀릿 웹 응용 프로그램을 배포하기 전에 포털 서버에서 배포 시 또는 WEB-INF/portlet.xml 파일을 편집하여 Porlet 기본 설정을 구성할 수 있습니다. portlet.xml 파일은 기본적으로 다음과 같이 나타납니다.

<?xml version="1.0" encoding="UTF-8"?>
<portlet-app xmlns="https://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd"
             xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="https://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd /opt/SUNWps/dtd/portlet.xsd"
             version="1.0">
   <portlet>
      <portlet-name>RSSWeatherPortlet</portlet-name>
      <portlet-class>org.jboss.portlet.weather.WeatherPortlet</portlet-class>
      <init-param>
         <name>default_zipcode</name>
         <value>05673</value>
      </init-param>
      <init-param>
         <name>RSS_XSL</name>
         <value>/WEB-INF/Rss.xsl</value>
      </init-param>
      <init-param>
         <name>base_url</name>
         <value>https://xml.weather.yahoo.com/forecastrss?p=</value>
      </init-param>
      <expiration-cache>180</expiration-cache>
      <supports>
         <mime-type>text/html</mime-type>
         <portlet-mode>VIEW</portlet-mode>
         <portlet-mode>EDIT</portlet-mode>
      </supports>
      <portlet-info>
         <title>Weather Portlet</title>
      </portlet-info>
      <portlet-preferences>
         <preference>
            <name>expires</name>
            <value>180</value>
         </preference>
         <preference>
            <name>RssXml</name>
            <value>https://xml.weather.yahoo.com/forecastrss?p=33145</value>
            <read-only>false</read-only>
         </preference>
      </portlet-preferences>
   </portlet>
</portlet-app>

포틀릿은 다음과 같은 기본 설정으로 구성할 수 있습니다.

OSGi 웹 콘솔 osgi-web-console

포털 서버가 localhost, port 8080 호스트에서 실행되고 AEM 포틀릿 웹 응용 프로그램이 웹 응용 프로그램 컨텍스트 cqportlet ​에 마운트되어 있다고 가정할 때 웹 콘솔의 URL은 https://localhost:8080/cqportlet/cqbridge/system/console입니다. 기본 사용자 및 암호는 admin ​입니다.

구성 탭을 열고 포털 디렉터리 CQ 서버 구성 ​을 선택합니다. 여기에서는 작성자 및 게시 인스턴스에 대한 기본 URL을 지정합니다. 이 절차는 포틀릿 구성에 설명되어 있습니다.

구성 제공 providing-configurations

AEM Content Portlet에는 자동 배포 및 구성 프로비저닝을 지원하기 위해 포틀릿 애플리케이션에 제공된 클래스 경로에서 구성을 읽는 기본 구성 지원이 있습니다.

시작 시 시스템 속성 com.day.cq.portet.config ​을(를) 읽어서 현재 환경을 감지합니다. 일반적으로 이 속성의 값은 dev, prod, test 등과 같습니다. 환경이 설정되지 않은 경우 구성을 읽지 않습니다.

환경이 설정되면 구성 파일이 *com/day/cq/portlet/{env}.config ​의 클래스 경로에서 검색됩니다. 여기서 env ​은(는) 환경의 실제 값으로 대체됩니다. 이 파일은 이 환경에 대한 모든 구성 파일을 나열해야 합니다. 이러한 파일은 구성 파일의 위치를 기준으로 검색됩니다. 예를 들어 파일에 줄 my.service.xml,이(가) 포함된 경우 이 파일은 com/day/cq/portlet/my.service.config.의 클래스 경로에서 읽혀집니다. 파일 이름은 서비스의 지속성 ID 다음에 .config ​가 옵니다. 이전 예제에서는 지속성 ID가 my.service ​입니다. 구성 파일의 형식은 Apache Sling OSGi 설치 관리자에서 사용하는 형식입니다.

즉, 각 환경에 대해 해당 구성 파일을 추가해야 합니다. 모든 환경에 적용해야 하는 구성은 이러한 모든 파일에 입력되어야 합니다. 단일 환경에 대한 구성일 경우 해당 파일에 입력됩니다. 이 메커니즘은 어느 환경에서 어떤 구성을 읽는지에 대한 완전한 제어를 보장합니다.

다른 시스템 속성을 사용하여 환경을 감지할 수 있습니다. com.day.cq.portet.config 대신 사용할 시스템 속성의 이름을 포함하는 시스템 속성 com.day.cq.portet.configproperty ​을(를) 지정하십시오.

캐싱 및 캐싱 무효화 caching-and-caching-invalidation

포틀릿은 기본 구성에서 AEM WCM으로부터 받은 응답을 사용자별 캐시에 저장합니다. 게시 인스턴스의 콘텐츠가 변경되면 캐시를 무효화해야 합니다. 이를 위해 AEM WCM에서는 작성자 인스턴스에 복제 에이전트를 구성해야 합니다. 캐시를 수동으로 플러시할 수도 있습니다. 이 섹션에서는 이러한 두 절차에 대해 설명합니다.

포틀릿은 자체 캐시로 구성할 수 있으므로 AEM에 액세스하지 않고도 포틀릿의 컨텐트를 표시할 수 있습니다. 포털은 /libs/portal/director에서 콘텐츠로 사용할 수 있습니다. 콘텐츠에 액세스하려면 AEM 인스턴스를 시작하고 해당 위치에서 CRXDE Lite 또는 Webdav를 사용하여 파일을 다운로드합니다.

이 번들을 런타임에 배포하거나 배포 전에 WEB-INF/lib/resources/bundles에서 포틀릿 웹 응용 프로그램에 추가할 수 있습니다.

캐시가 배포되면 포틀릿은 게시 인스턴스의 내용을 캐시에 저장합니다. 포틀릿 캐시는 AEM의 Dispatcher 플러시로 무효화할 수 있습니다. 포틀릿에서 자체 캐시를 사용하도록 구성하려면 다음을 수행합니다.

복제 에이전트를 통해 캐시 플러시 flushing-the-cache-via-replication-agent

일반 Dispatcher 무효화와 마찬가지로 복제 에이전트는 포털의 AEM 포틀릿 캐시를 타겟팅하도록 구성할 수 있습니다. 복제 에이전트를 구성하면 모든 일반 페이지 활성화가 포털 캐시를 플러시합니다.

AEM 포틀릿을 실행하는 여러 포털 노드를 운영하는 경우 이 절차에 설명된 대로 각 노드에 대해 에이전트를 생성해야 합니다.

포털에 대한 복제 에이전트를 구성하려면 다음을 수행합니다.

포틀릿 캐시 수동 플러시 manually-flushing-the-portlet-cache

복제 에이전트에 대해 구성된 동일한 URL에 액세스하여 포틀릿 캐시를 수동으로 플러시할 수 있습니다. URL 형식은 캐시 플러시를 참조하십시오. 또한 플러시할 항목을 나타내려면 URL 매개 변수 Path=<path>로 URL을 확장해야 합니다.

예:

https://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=*이(가) 전체 캐시를 플러시합니다. https://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=/content/mypage/xyz이(가) 캐시에서 /content/mypage/xyz을(를) 플러시합니다.

포털 보안 portal-security

포털은 운전 인증 메커니즘입니다. 기술 사용자, 포털 사용자, 그룹 등을 사용하여 AEM에 로그인할 수 있습니다. 포틀릿에는 포털에 있는 사용자의 암호에 대한 액세스 권한이 없으므로 포틀릿이 사용자에 성공적으로 로그인할 수 있는 모든 자격 증명을 모를 경우 SSO 솔루션을 사용해야 합니다. 이 경우 AEM 포틀릿은 모든 필수 정보를 AEM에 전달하며, 이 정보는 기본 AEM 저장소에 전달됩니다. 이 동작은 플러그할 수 있으며 사용자 정의할 수 있습니다.

Publish 인증 authentication-on-publish

이 섹션에서는 포틀릿이 기본 AEM WCM 인스턴스와 통신하는 데 사용할 수 있는 인증 모드에 대해 설명합니다.

기본적으로 AEM의 게시 인스턴스에는 사용자 정보가 전송되지 않습니다. 콘텐츠는 항상 익명 사용자로 표시됩니다. AEM에서 사용자 특정 정보를 전달해야 하거나 게시를 위한 사용자 인증이 필요한 경우 이 기능을 켜야 합니다.

포틀릿의 인증 구성 액세스 accessing-the-portlet-s-authentication-configuration

포틀릿이 AEM WCM 인스턴스에서 사용하는 인증 구성 옵션은 웹 콘솔(OSGi 구성)에서 사용할 수 있습니다.

포틀릿의 인증 구성에 액세스하려면 다음을 수행합니다.

기술 사용자 모드 technical-user-mode

기본 모드에서 AEM WCM 작성자 인스턴스에 대해 포틀릿에서 발급한 모든 요청은 현재 포털 사용자에 관계없이 동일한 기술 사용자를 사용하여 인증됩니다. 기술 사용자 모드는 기본적으로 활성화되어 있습니다. OSGi 관리 콘솔의 각 구성 화면에서 이 모드를 활성화/비활성화합니다.

Publish에서 인증 ​이 활성화된 경우 지정된 기술 사용자가 AEM WCM 작성자 인스턴스와 게시 인스턴스에 있어야 합니다. 작성 작업에 충분한 액세스 권한을 사용자에게 부여해야 합니다.

SSO sso

포틀릿은 AEM에서 즉시 사용할 수 있도록 SSO를 지원합니다. 인증자 서비스는 SSO를 사용하여 기본 형식의 현재 포털 사용자를 cqpsso(이)라는 쿠키로 AEM에 전송하도록 구성할 수 있습니다. AEM은 경로 /에 대한 SSO 인증 핸들러를 사용하도록 구성해야 합니다. 여기서도 쿠키 이름을 구성해야 합니다.

AEM 리포지토리용 crx-quickstart/repository/repository.xml을(를) 그에 따라 구성해야 합니다.

<LoginModule class="com.day.crx.security.authentication.CRXLoginModule">
  ...
  <param name="trust_credentials_attribute" value="TrustedInfo"/>
  <param name="anonymous_principal" value="anonymous"/>
</LoginModule>

SSO 인증 모드 sso-authentication-mode

포틀릿은 SSO(Single Sign-On) 체계를 사용하여 AEM WCM을 인증할 수 있습니다. 이 모드에서는 현재 포털에 로그인한 사용자가 SSO 쿠키 형태로 AEM WCM으로 전달됩니다. SSO 모드를 사용하는 경우 AEM 포틀릿에 대한 액세스 권한이 있는 모든 포털 사용자를 기본 AEM WCM 인스턴스에 알려주어야 합니다. 가장 일반적으로 LDAP에 연결되는 AEM WCM 형식이거나 미리 사용자를 수동으로 만들어 두어야 합니다. 또한 포틀릿에서 SSO를 활성화하기 전에 기본 AEM WCM 작성자 인스턴스(Publish에서 인증 ​이 활성화된 경우 게시 인스턴스)를 SSO 기반 요청을 수락하도록 구성해야 합니다.

SSO 인증 모드를 사용하도록 포틀릿을 구성하려면 다음 단계를 완료하십시오(다음 섹션에 자세히 설명됨).

AEM WCM의 저장소에서 신뢰할 수 있는 자격 증명을 수락하도록 활성화 enabling-aem-wcm-s-repository-to-accept-trusted-credentials

AEM WCM에 대해 SSO를 활성화하려면 AEM WCM에서 제공한 신뢰할 수 있는 자격 증명을 수락하도록 기본 저장소를 구성해야 합니다. 이렇게 하려면 AEM의 repository.xml을 구성합니다.

AEM WCM에서 SSO 인증 활성화 enabling-sso-authentication-in-the-aem-wcm

AEM WCM에서 SSO를 활성화하려면 AEM WCM의 Apache Felix 웹 관리 콘솔(OSGi)에서 관련 구성 항목에 액세스합니다.

AEM WCM이 받는 모든 요청에 대해 먼저 SSO 기반 인증이 시도됩니다. 실패 시 일반적인 기본 인증 체계로의 폴백이 수행됩니다. 따라서 SSO가 없는 AEM WCM에 대한 일반 연결이 가능합니다.

AEM 포틀릿에서 SSO 인증 활성화 enabling-sso-authentication-in-a-aem-portlet

기본 AEM WCM 인스턴스가 SSO 요청을 수락하려면 포틀릿의 인증 모드를 기술 ​에서 SSO(으)로 전환해야 합니다.

AEM 포틀릿에서 SSO 인증을 활성화하려면 다음을 수행합니다.

이 절차를 수행하면 요청은 SSO를 사용하여 인증됩니다. HTTP 통신의 일반적인 코드 조각은 다음 SSO 및 포틀릿 관련 헤더의 존재를 나타냅니다.

C-12-#001898 -> [GET /mynet/en/_jcr_content/par/textimage/image.img.png HTTP/1.1 ]
C-12-#001963 -> [cq5:locale: en ]
C-12-#001979 -> [cq5:used-locale: en ]
C-12-#002000 -> [cq5:locales: en,en_US ]
C-12-#002023 -> [cqp:user: wpadmin ]
C-12-#002042 -> [cqp:portal: IBM WebSphere Portal/6.1 ]
C-12-#002080 -> [cqp:windowid: 7_CGAH47L000CE302V2KFNOG0084 ]
C-12-#002124 -> [cqp:windowstate: normal ]
C-12-#002149 -> [cqp:portletmode: view ]
C-12-#002172 -> [User-Agent: Jakarta Commons-HttpClient/3.1 ]
C-12-#002216 -> [Host: 10.0.0.68:4502 ]
C-12-#002238 -> [Cookie: $Version=0; cqpsso=Basic+d3BhZG1pbg%3D%3D ]
C-12-#002289 -> [ ]

PIN 인증 사용 enabling-pin-authentication

AEM 컨텐츠 포틀릿의 기본 인라인 편집 기능을 사용하지 않지만 AEM 작성자 인스턴스에서 직접 포털 외부의 포틀릿에 작성 및 관리 부분을 사용하려는 경우 PIN 인증을 활성화해야 합니다. 또한 관리 버튼의 구성을 변경해야 합니다.

웹 사이트 관리 페이지를 열거나 포틀릿에서 페이지를 편집하려면 AEM 컨텐트 포틀릿에서 새 고정 인증을 사용합니다. 기본적으로 핀 인증이 비활성화되어 있으므로 AEM에서 다음 구성을 변경해야 합니다.

권한 privileges

포틀릿의 일부 기능은 권한으로 보호됩니다. 현재 사용자가 이 기능에 액세스하려면 이 권한이 있어야 합니다. 다음과 같은 권한이 미리 정의되어 있습니다.

권한을 관리하는 가장 좋은 방법은 포털 역할을 사용하고 이러한 권한에 역할을 할당하는 것입니다. 이 작업은 OSGi 구성을 통해 수행할 수 있습니다. 일별 포털 Director 권한 관리자 는 각 권한에 대한 역할 세트로 구성할 수 있습니다. 사용자에게 롤 중 하나가 있는 경우 해당 권한이 있습니다.

또한 포틀릿 인스턴스 기반별로 액세스 권한을 기반으로 이 역할을 정의할 수 있습니다. 포틀릿의 기본 설정 대화 상자에는 위의 각 권한에 대한 입력 필드가 포함되어 있습니다. 각 권한에 대해 쉼표로 구분된 포틀릿 롤 목록을 구성할 수 있습니다. 값이 구성된 경우 "Day Portal Director 권한 관리자" 서비스의 전역 구성이 재정의되며 역할이 병합되지 않으므로 이 전역 설정에서 동일한 역할을 추가해야 할 수 있습니다. 값을 지정하지 않으면 전역 구성이 사용됩니다.

AEM 포틀릿 응용 프로그램 사용자 정의 customizing-the-aem-portlet-application

제공된 AEM 포틀릿 애플리케이션은 AEM에서와 마찬가지로 웹 애플리케이션 내에서 OSGi 컨테이너를 시작합니다. 이 아키텍처를 사용하면 OSGi의 모든 이점을 사용할 수 있습니다.

도구 모음 단추 toolbar-buttons

도구 모음 및 해당 단추를 구성할 수 있으며 사용자 지정할 수 있습니다. 도구 모음에 사용자 지정 단추를 추가하거나 표시되는 단추를 정의할 수 있습니다. 각 버튼은 OSGi 구성을 통해 구성할 수 있는 OSGi 서비스입니다.

OSGi 웹 콘솔에는 구성 탭의 모든 단추 구성이 나열됩니다. 각 단추에 대해 이 단추가 표시되는 모드를 정의할 수 있습니다. 예를 들어 모든 모드를 제거하여 단추를 비활성화할 수 있습니다.

기본적으로 AEM 컨텐츠 포틀릿은 인라인 편집 기능을 사용합니다. 그러나 편집할 AEM 작성자 인스턴스로 전환하려면 SiteAdmin 단추 및 ContentFinder 단추 ​을(를) 활성화하되 편집 단추 ​는 비활성화합니다. 이 경우 AEM에서 PIN 인증을 올바르게 구성해야 합니다.

미리 정의된 위치에 사용자 정의 CSS/HTML이 포함된 포틀릿의 Felix 웹 콘솔을 통해 번들을 설치하여 포틀릿의 도구 모음 레이아웃을 사용자 정의할 수 있습니다.

번들 구조 bundle-structure

다음은 번들 구조의 예입니다.

$ jar tvf target/toolbarlayout-0.0.1-SNAPSHOT.jar | awk '{print $8}'
META-INF/
META-INF/MANIFEST.MF
/com/day/cq/portlet/toolbar/layout/
/com/day/cq/portlet/toolbar/layout/author.gif
/com/day/cq/portlet/toolbar/layout/back.gif
/com/day/cq/portlet/toolbar/layout/button.html
/com/day/cq/portlet/toolbar/layout/edit.gif
/com/day/cq/portlet/toolbar/layout/manage.html
/com/day/cq/portlet/toolbar/layout/publish.html
/com/day/cq/portlet/toolbar/layout/refresh.gif
/com/day/cq/portlet/toolbar/layout/siteadmin.gif
/com/day/cq/portlet/toolbar/layout/toolbar.css

META-INF 폴더에는 OSGi가 번들로 식별하는 데 필요한 MANIFEST.MF 파일이 포함되어 있습니다. 다음과 같이 표시됩니다.

Manifest-Version: 1.0
Built-By: djaeggi
Created-By: Apache Maven Bundle Plugin
Import-Package: com.day.cq.portlet.toolbar.layout
Bnd-LastModified: 1234178347159
Export-Package: com.day.cq.portlet.toolbar.layout
Bundle-Version: 0.0.1.SNAPSHOT
Bundle-Name: Company CQ5 Portal Director Portlet Toolbar Layout
Bundle-Description: This bundle provides a custom layout for the CQ5 P
 ortal Director Portlet Toolbar.
Build-Jdk: 1.5.0_16
Bundle-ManifestVersion: 2
Bundle-SymbolicName: com.day.cq.portlet.company.toolbarlayout
Tool: Bnd-0.0.255

HTML/CSS/이미지가 /com/day/cq/portlet/toolbar/layout 폴더에 있다는 사실은 포틀릿에서 지정한 것이므로 변경할 수 없습니다. 같은 행에서 MANIFEST.MF의 Import-Package 및 Export-Package 헤더도 /com/day/cq/portlet/toolbar/layout으로 호출해야 합니다. Bundle-SymbolicName은 고유하고 정규화된 패키지 이름이어야 합니다.

Maven과 같은 도구를 사용하거나 이 섹션에 표시된 대로 관련 헤더가 설정된 jar 파일을 수동으로 생성할 수 있습니다.

포틀릿 도구 모음 보기 portlet-toolbar-views

포틀릿의 도구 모음에는 기본적으로 두 개의 보기 상태가 있습니다. 각 보기 및 관련 버튼을 각 HTML 파일로 사용자 정의할 수 있습니다.

Publish 보기 publish-view

게시 보기에는 도구 모음을 관리 보기로 전환하는 버튼이 한 개만 있습니다. 게시 보기는 이전 번들의 publish.html 파일로 표시됩니다. HTML에서 다음 자리 표시자를 사용할 수 있습니다. 이 자리 표시자는 렌더링될 때 해당 내용을 포함하는 포틀릿으로 교체됩니다.

Publish 보기 자리 표시자 publish-view-placeholders

보기 관리 manage-view

관리 보기에는 [편집], [웹 사이트] 탭, [새로 고침] 및 [뒤로]의 네 가지 단추가 있습니다. 관리 보기는 이전 번들의 manage.html 파일로 표시됩니다. HTML에서 다음 자리 표시자를 사용할 수 있습니다. 이 자리 표시자는 렌더링될 때 해당 내용을 포함하는 포틀릿으로 교체됩니다.

보기 자리 표시자 관리 manage-view-placeholders

버튼 buttons

단추는 표시되는 보기에서 button.html에 정의된 동일한 공통 HTML을 사용합니다.

HTML에서 다음 자리 표시자를 사용할 수 있습니다. 이 자리 표시자는 렌더링될 때 해당 내용을 포함하는 포틀릿으로 교체됩니다.

관리 및 Publish 보기 단추 manage-and-publish-view-buttons

button.html 파일의 예:

<div class="cqp_button">

 <a href="#" onclick="{onclick}">

 <img src="/wps/PA_CQ5_Portlet/cqbridge/static/{id}.gif" alt="{text}"
title="{text}"/>

 </a>
</div>

사용자 지정 레이아웃 설치 installing-a-custom-layout

사용자 지정 레이아웃을 설치하려면 포틀릿의 OSGI 웹 콘솔​ 번들 ​섹션에 액세스하고 번들을 업로드합니다.

패키지 packages

설치를 위해 패키지를 업로드하거나 만들어야 하는 경우 자세한 지침은 AEM 설명서의 패키지 관리자 를 참조하십시오.

링크 처리 link-handling

모든 링크는 포털 컨텍스트 내에서 작동하도록 다시 작성됩니다. 기본적으로 렌더링 매개 변수가 있는 링크가 사용됩니다. 대신 작업 링크를 사용하도록 포털 Director HTML 재작성기를 구성할 수 있습니다.

또한 표시되는 콘텐츠 경로에 대해 쿼리할 추가 요청 매개 변수를 정의할 수 있습니다. 이 기능은 외부에서 특정 컨텐츠로 연결되는 링크가 있는 경우 등에 유용합니다.

또한, 포털 Director HTML 재작성기는 링크 재작성을 위해 제외하도록 정의된 정규 표현식 목록으로 구성할 수 있습니다. 예를 들어 외부 시스템에 대한 상대 링크가 있는 경우 이 제외 목록에 추가해야 합니다.

현지화 localization

AEM 컨텐츠 포틀릿에는 AEM 컨텐츠가 올바른 언어로 되어 있는지 확인하는 현지화 기능이 내장되어 있습니다.

이 작업은 다음 두 단계로 수행됩니다.

Portal Director 로케일 핸들러는 로케일 정보를 확인하는 경로로 구성할 수 있습니다. 일반적으로 여기에는 /content의 모든 항목과 경로에서 로케일 정보의 위치가 포함됩니다. 기본적으로 로케일 핸들러는 AEM 내의 다국어 사이트를 구조화하는 권장 사항을 따릅니다.

사이트에 경로 내의 로케일 정보를 처리하는 엄격한 규칙이 없는 경우 로케일 핸들러를 자체 구현으로 바꿀 수 있습니다.

옵션 OSGi 서비스 optional-osgi-services

포틀릿의 다양한 부분을 사용자 정의하기 위해 선택적 OSGi 서비스를 구현할 수 있습니다. 각 서비스는 Java 인터페이스에 해당합니다. 이 인터페이스는 번들을 통해 포틀릿에 구현하고 배포할 수 있습니다.

기본 서비스 바꾸기 replacing-default-services

다음 서비스는 콘텐츠 포틀릿(해당 Java 인터페이스 포함)에 기본 구현이 있습니다. 사용자 정의하려면 새 서비스 구현이 포함된 번들을 포틀릿 애플리케이션에 배포해야 합니다.

이러한 서비스를 구현할 때는 서비스의 service.ranking 속성을 양수 값으로 설정해야 합니다. 기본 구현에서는 등급 ​ 0 ​을 사용하고 포틀릿에서는 순위가 가장 높은 서비스를 사용합니다.

포틀릿 이벤트 portlet-events

포틀릿 API(JSR-286)는 포틀릿 이벤트를 지정합니다. AEM 컨텐트 포틀릿에는 통합 브리지가 있어 AEM 포틀릿에 대한 포틀릿 이벤트를 OSGi 이벤트로 분산합니다. 이렇게 하면 포틀릿 이벤트를 처리할 수 있습니다.

특정 이벤트를 처리하려면 이 이벤트를 배포 설명자에서 수신 이벤트로 선언하거나 포털 서버를 통해 구성하고 EventHandler 인터페이스를 선언하는 OSGi 서비스를 구현합니다(OSGi EventAdmin 사양 참조).

포틀릿 이벤트가 발생할 때마다 핸들러를 호출하여 특정 OSGi 이벤트가 전송됩니다. 처리기는 모든 컨텍스트 정보를 가져오고 이에 따라 포틀릿의 상태를 업데이트하거나 새 이벤트를 보낼 수 있습니다. 기본적으로 handle 메서드 내에서 포틀릿 이벤트 단계의 모든 기능을 사용할 수 있습니다.

AEM을 포털로 사용 using-aem-as-a-portal

포틀릿 구성 요소를 사용하여 AEM 페이지에 포틀릿 창을 추가합니다. 응용 프로그램 서버에 설치하는 공유 라이브러리를 사용하면 포틀릿 구성 요소가 배치된 포틀릿 응용 프로그램을 감지할 수 있습니다.

AEM을 포털로 사용하려면 다음 작업을 수행하십시오.

포틀릿 구성 요소 설치 installing-the-portlet-component

AEM Quickstart JAR 파일에는 포틀릿 구성 요소 파일이 포함되어 있습니다. 파일(cq-portlet-components.zip)을 가져오려면 빠른 시작을 실행하거나 내용을 추출할 수 있습니다.

Sidekick에 포틀릿 구성 요소 추가 adding-the-portlet-component-to-sidekick

작성자가 사용할 수 있도록 포틀릿 구성 요소를 단락 시스템에 추가합니다.

포틀릿 응용 프로그램 구성 및 배포 configuring-and-deploying-your-portlet-applications

포털 구성 요소에서 사용할 수 있도록 포틀릿을 애플리케이션 서버 웹 컨테이너에 배포합니다. 포틀릿 응용 프로그램을 배포하기 전에 AEM 포털 컨테이너 서블릿을 로드하도록 응용 프로그램을 구성해야 합니다. 이 구성을 통해 포틀릿 구성 요소가 포틀릿에 액세스할 수 있습니다.

AEM 페이지에 포틀릿 추가 adding-portlets-to-your-aem-page

포털 구성 요소를 사용하여 웹 페이지에 포틀릿 창을 추가합니다. 구성 요소 등록 정보를 사용하여 표시할 포틀릿을 지정합니다.

포틀릿에서 AEM 설치, 구성 및 사용 installing-configuring-and-using-aem-in-a-portlet

AEM WCM에서 제공하는 컨텐츠에 액세스하려면 AEM Portal Director 포틀릿에 포털 서버를 설치해야 합니다. 이 섹션에 제공된 단계를 사용하여 포틀릿을 설치, 구성 및 포털 페이지에 추가하면 됩니다.

기본적으로 포틀릿은 localhost:4503에 있는 게시 인스턴스와 localhost:4502에 있는 작성자 인스턴스에 연결됩니다. 이러한 값은 포틀릿을 배포하는 동안 변경할 수 있습니다. 포털 디렉터는 /libs/portal/directory 아래에 있는 저장소에서 콘텐츠로 사용할 수 있습니다. 사용하기 전에 애플리케이션 war 파일을 다운로드하십시오.

war 파일 다운로드 downloading-the-war-file

포틀릿 설치 installing-the-portlet

포틀릿을 설치하려면 다음을 수행합니다.

포틀릿 구성 configuring-the-portlet

포틀릿을 설치한 후에는 기본 AEM 인스턴스(작성자 및 게시)의 URL을 알 수 있도록 포틀릿을 구성해야 합니다. 다른 옵션을 구성할 수도 있습니다.

포틀릿을 구성하려면 다음을 수행합니다.

컨텐츠 URL content-urls

AEM에서 컨텐츠를 요청하면 포틀릿은 현재 표시 모드(게시 또는 작성자)와 현재 경로를 사용하여 전체 URL을 취합합니다. 기본값을 사용하는 경우 첫 번째 URL은 https://localhost:4503/content/geometrixx/en.portlet.html입니다. htmlSelector 값은 확장 전 URL에 자동으로 추가됩니다.

포틀릿이 도움말 모드로 전환되고 appendHelpViewModeAsSelector을(를) 선택하면 help 선택기도 추가됩니다(예: https://localhost:4503/content/geometrixx/en.portlet.html.help). 포틀릿 창을 최대화하고 appendMaxWindowStateAsSelector을(를) 선택하면 선택기도 추가됩니다(예: https://localhost:4503/content/geometrixx/en.portlet.max.help).

선택기는 AEM에서 평가될 수 있으며, 다른 선택기에 대해 다른 템플릿을 사용할 수 있습니다.

AEM에서 컨텐츠 Url 맵 사용 using-a-content-url-map-in-aem

일반적으로 시작 경로는 AEM의 콘텐츠를 직접 가리킵니다. 그러나 포틀릿 환경 설정이 아닌 AEM에서 시작 경로를 유지하려면 /var/portlets과(와) 같은 AEM의 콘텐츠 맵에 대한 시작 경로를 지정할 수 있습니다. 이 경우 AEM에서 실행되는 스크립트는 포틀릿에서 제출된 정보를 사용하여 시작 URL을 결정할 수 있습니다. 올바른 URL로 리디렉션을 발행해야 합니다.

포털 페이지에 포틀릿 추가 adding-the-portlet-to-the-portal-page

포털 페이지에 포틀릿을 추가하려면 다음을 수행합니다.

포틀릿 사용 using-the-portlet

포틀릿에 추가한 페이지에 액세스하려면 다음을 수행합니다.