이메일 알림 구성

AEM은 다음과 같은 사용자에게 이메일 알림을 전송합니다.

  • 페이지 이벤트(예: 수정 또는 복제)에 가입했습니다. 알림 받은 편지함 섹션에서는 이러한 이벤트에 가입하는 방법을 설명합니다.

  • 포럼 이벤트에 가입했습니다.

  • 워크플로우에서 단계를 수행해야 합니다. 참가자 단계 섹션에서는 워크플로우에서 이메일 알림을 트리거하는 방법을 설명합니다.

전제 조건:

  • 사용자는 자신의 프로필에 유효한 이메일 주소를 정의해야 합니다.
  • 일 CQ 메일 서비스​를 올바르게 구성해야 합니다.

사용자가 알림을 받으면 프로필에 정의된 언어로 된 이메일을 받습니다. 각 언어에는 사용자 지정할 수 있는 자체 템플릿이 있습니다. 새 언어의 이메일 템플릿을 추가할 수 있습니다.

노트

AEM으로 작업할 때 이러한 서비스에 대한 구성 설정을 관리하는 방법에는 여러 가지가 있습니다.자세한 내용 및 권장 방법은 OSGi 구성을 참조하십시오.

메일 서비스구성

AEM에서 이메일을 보낼 수 있으려면 일 CQ 메일 서비스​를 올바르게 구성해야 합니다. 웹 콘솔에서 구성을 볼 수 있습니다. AEM으로 작업할 때 이러한 서비스에 대한 구성 설정을 관리하는 방법에는 여러 가지가 있습니다.자세한 내용 및 권장 방법은 OSGi 구성을 참조하십시오.

다음 제한 사항이 적용됩니다.

  • SMTP 서버 포트​은 25 이상이어야 합니다.

  • SMTP 서버 호스트 이름​은 비워둘 수 없습니다.

  • "보낸 사람" 주소​은 비워둘 수 없습니다.

일 CQ 메일 서비스​에 대한 문제를 디버깅하는 데 도움이 되도록 서비스 로그를 볼 수 있습니다.

com.day.cq.mailer.DefaultMailService

구성은 웹 콘솔에서 다음과 같이 표시됩니다.

chlimage_1-276

이메일 알림 채널구성

페이지나 포럼 이벤트 알림에 가입하면 보낸 사람 이메일 주소는 기본적으로 no-reply@acme.com으로 설정됩니다. 웹 콘솔에서 알림 이메일 채널 서비스를 구성하여 이 값을 변경할 수 있습니다.

전자 메일 주소를 구성하려면 sling:OsgiConfig 노드를 저장소에 추가합니다. CRXDE Lite을 사용하여 노드를 직접 추가하려면 다음 절차를 따르십시오.

  1. CRXDE Lite에서 응용 프로그램 폴더 아래에 config 폴더를 추가합니다.

  2. 구성 폴더에 다음 이름의 노드를 추가합니다.

    com.day.cq.wcm.notification.email.impl.EmailChannel 유형 sling:OsgiConfig

  3. String 속성을 email.from 노드에 추가합니다. 값에 사용할 이메일 주소를 지정합니다.

  4. 모두 저장​을 클릭합니다.

다음 절차를 사용하여 컨텐츠 패키지 소스 폴더의 노드를 정의합니다.

  1. jcr_root/apps/*app_name*/config folder에서 com.day.cq.wcm.notification.email.impl.EmailChannel.xml 파일을 만듭니다.

  2. 노드를 나타내기 위해 다음 XML을 추가합니다.

    <?xml version="1.0" encoding="UTF-8"?> <jcr:root xmlns:sling="https://sling.apache.org/jcr/sling/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0" jcr:primaryType="sling:OsgiConfig" email.from="name@server.com"/>

  3. email.from 속성( name@server.com)의 값을 이메일 주소로 바꿉니다.

  4. 파일을 저장합니다.

워크플로 이메일 알림 서비스 구성

워크플로우 이메일 알림을 받으면 보낸 사람 이메일 주소와 호스트 URL 접두어가 모두 기본값으로 설정됩니다. 웹 콘솔에서 Day CQ Workflow 이메일 알림 서비스​를 구성하여 이 값을 변경할 수 있습니다. 그렇게 하는 경우 저장소의 변경 사항을 유지하는 것이 좋습니다.

기본 구성은 웹 콘솔에서 다음과 같이 표시됩니다.

chlimage_1-277

페이지 알림의 이메일 템플릿

페이지 알림용 이메일 템플릿은 아래에 있습니다.

/etc/notification/email/default/com.day.cq.wcm.core.page

기본 영어 템플릿( en.txt)은 다음과 같이 정의됩니다.

subject=[CQ Page Event Notification]: Page Event

header=-------------------------------------------------------------------------------------\n \
Time: ${time}\n \
User: ${userFullName} (${userId})\n \
-------------------------------------------------------------------------------------\n\n

message=The following pages were affected by the event: \n \
 \n \
${modifications} \n \
 \n\n
footer=\n \
-------------------------------------------------------------------------------------\n \
This is an automatically generated message. Please do not reply.

페이지 알림에 대한 이메일 템플릿 사용자 지정

페이지 알림에 대한 영어 이메일 템플릿을 사용자 정의하려면:

  1. CRXDE에서 파일을 엽니다.

    /etc/notification/email/default/com.day.cq.wcm.core.page/en.txt

  2. 필요에 따라 파일을 수정합니다.

  3. 변경 사항을 저장합니다.

템플릿에는 다음 형식이 있어야 합니다.

 subject=<text_1>
 header=<text_2>
 message=<text_3>
 footer=<text_4>

여기서 <text_x>은(는) 정적 텍스트와 동적 문자열 변수의 혼합일 수 있습니다. 페이지 알림에 대한 이메일 템플릿 내에서 다음 변수를 사용할 수 있습니다.

  • ${time}, 이벤트 날짜 및 시간.

  • ${userFullName}를 채우는 것이 좋습니다.

  • ${userId}, 이벤트를 트리거한 사용자의 ID.

  • ${modifications}에서는 페이지 이벤트의 유형과 페이지 경로를 다음과 같은 형식으로 설명합니다.

    <page event="" type=""> => <page path="">

    예:

    PageModified => /content/geometrixx/en/products

포럼 알림용 이메일 템플릿

포럼 알림용 이메일 템플릿은 다음 위치에 있습니다.

/etc/notification/email/default/com.day.cq.collab.forum

기본 영어 템플릿( en.txt)은 다음과 같이 정의됩니다.

subject=[CQ Forum Notification]

header=-------------------------------------------------------------------------------------\n \
Time: Time: ${time}\n \
Forum Page Path: ${forum.path}\n \
-------------------------------------------------------------------------------------\n\n

message=Page: ${host.prefix}${forum.path}.html\n

footer=\n \
-------------------------------------------------------------------------------------\n \
This is an automatically generated message. Please do not reply.

포럼 알림에 대한 이메일 템플릿 사용자 지정

포럼 알림에 대한 영어 이메일 템플릿을 사용자 정의하려면:

  1. CRXDE에서 파일을 엽니다.

    /etc/notification/email/default/com.day.cq.collab.forum/en.txt

  2. 필요에 따라 파일을 수정합니다.

  3. 변경 사항을 저장합니다.

템플릿에는 다음 형식이 있어야 합니다.

 subject=<text_1>
 header=<text_2>
 message=<text_3>
 footer=<text_4>

여기서 <text_x>은(는) 정적 텍스트와 동적 문자열 변수의 혼합일 수 있습니다.

포럼 알림에 대해 이메일 템플릿 내에서 다음 변수를 사용할 수 있습니다.

  • ${time}, 이벤트 날짜 및 시간.

  • ${forum.path}를 채우는 것이 좋습니다.

워크플로 알림의 이메일 템플릿

워크플로우 알림에 대한 이메일 템플릿(영어)은 다음 위치에 있습니다.

/etc/workflow/notification/email/default/en.txt

다음과 같이 정의됩니다.

subject=Workflow notification: ${event.EventType}

header=-------------------------------------------------------------------------------------\n \
Time: ${event.TimeStamp}\n \
Step: ${item.node.title}\n \
User: ${participant.name} (${participant.id})\n \
Workflow: ${model.title}\n \
-------------------------------------------------------------------------------------\n\n

message=Content: ${host.prefix}${payload.path.open}\n

footer=\n \
-------------------------------------------------------------------------------------\n \
View the overview in your ${host.prefix}/aem/inbox\n \
-------------------------------------------------------------------------------------\n \
This is an automatically generated message. Please do not reply.

워크플로 알림에 대한 이메일 템플릿 사용자 지정

워크플로우 이벤트 알림을 위해 영어 이메일 템플릿을 사용자 정의하려면 다음을 수행합니다.

  1. CRXDE에서 파일을 엽니다.

    /etc/workflow/notification/email/default/en.txt

  2. 필요에 따라 파일을 수정합니다.

  3. 변경 사항을 저장합니다.

템플릿에는 다음 형식이 있어야 합니다.

subject=<text_1>
 header=<text_2>
 message=<text_3>
 footer=<text_4>
노트

여기서 <text_x>은(는) 정적 텍스트와 동적 문자열 변수의 혼합일 수 있습니다. 마지막 인스턴스를 제외하고, 백슬래시가 없는 경우 <text_x> 문자열 변수의 끝을 나타내는 경우 <text_x> 항목의 각 행은 백슬래시( \)로 끝나야 합니다.

템플릿 형식에 대한 자세한 내용은 Properties.load()](https://docs.oracle.com/javase/8/docs/api/java/util/Properties.html#load-java.io.InputStream-) 메서드의 [javadocs에서 확인할 수 있습니다.

${payload.path.open} 메서드는 작업 항목의 페이로드 경로를 표시합니다. 예를 들어 사이트의 페이지에 대해 payload.path.open/bin/wcmcommand?cmd=open&path=…과 비슷합니다.;서버 이름이 없는 경우이기 때문에 템플릿이 ${host.prefix}과(와) 함께 이 값을 접두어로 사용하는 것입니다.

이메일 템플릿 내에서 다음 변수를 사용할 수 있습니다.

  • ${event.EventType}, 이벤트의 유형

  • ${event.TimeStamp}, 이벤트 날짜 및 시간

  • ${event.User}, 이벤트를 트리거한 사용자

  • ${initiator.home}, 이니시에이터 노드 경로

  • ${initiator.name}, 이니시에이터 이름

  • ${initiator.email}, 개시자의 이메일 주소

  • ${item.id}, 작업 항목의 id

  • ${item.node.id}, 이 작업 항목과 연관된 워크플로우 모델의 노드 id

  • ${item.node.title}, 작업 항목의 제목

  • ${participant.email}, 참가자의 이메일 주소

  • ${participant.name}, 참가자 이름

  • ${participant.familyName}, 참가자의 가족 이름

  • ${participant.id}, 참가자 id

  • ${participant.language}, 참가자 언어

  • ${instance.id}, 워크플로 id

  • ${instance.state}, 워크플로 상태

  • ${model.title}, 워크플로우 모델의 제목

  • ${model.id}, 워크플로우 모델의 id

  • ${model.version}, 워크플로우 모델의 버전

  • ${payload.data}, 페이로드

  • ${payload.type}, 페이로드 유형

  • ${payload.path}, 페이로드 경로

  • ${host.prefix}, 호스트 접두사, 예:http://localhost:4502

새 언어용 이메일 템플릿 추가

새 언어의 템플릿을 추가하려면:

  1. CRXDE에서 아래 <language-code>.txt 파일을 추가합니다.

    • /etc/notification/email/default/com.day.cq.wcm.core.page :페이지 알림용
    • /etc/notification/email/default/com.day.cq.collab.forum :포럼 알림용
    • /etc/workflow/notification/email/default :워크플로우 알림용
  2. 파일을 언어에 맞게 변경합니다.

  3. 변경 사항을 저장합니다.

노트

이메일 템플릿의 파일 이름으로 사용되는 <language-code>은 AEM에서 인식되는 2자 소문자 언어 코드여야 합니다. 언어 코드의 경우 AEM은 ISO-639-1을 사용합니다.

AEM Assets 이메일 알림 구성

AEM Assets의 컬렉션이 공유되거나 공유되지 않으면 사용자는 AEM로부터 이메일 알림을 받을 수 있습니다. 이메일 알림을 구성하려면 다음 단계를 따르십시오.

  1. 메일 서비스 구성에 설명된 대로 이메일 서비스를 구성합니다.
  2. AEM에 관리자로 로그인합니다. 도구 > 작업 > 웹 콘솔​을 클릭하여 웹 콘솔 구성을 엽니다.
  3. 일 CQ DAM 리소스 컬렉션 서블릿​을 편집합니다. 이메일​을 선택합니다. 저장​을 클릭합니다.

이 페이지에서는