이메일 알림에 메타데이터 사용 use-metadata-in-an-email-notification

CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

메타데이터를 사용하여 Forms 워크플로우 이메일 알림의 정보를 채웁니다

작업 할당 단계를 사용하여 작업을 생성하고 사용자 또는 그룹에 지정할 수 있습니다. 작업이 사용자 또는 그룹에 할당되면 정의된 사용자 또는 정의된 그룹의 각 구성원에게 전자 메일 알림이 전송됩니다. 일반적인 이메일 알림 지정된 작업의 링크 및 작업과 관련된 정보가 들어 있습니다.

이메일 템플릿에서 메타데이터를 사용하여 이메일 알림의 정보를 동적으로 채울 수 있습니다. 예를 들어, 런타임 시(이메일 알림이 생성될 때) 다음 이메일 알림의 제목, 설명, 기한 날짜, 우선순위, 워크플로우 및 마지막 날짜 값이 동적으로 선택됩니다.

기본 이메일 템플릿

메타데이터는 키-값 쌍에 저장됩니다. 이메일 템플릿에 키를 지정할 수 있으며 이 키는 런타임 시(이메일 알림이 생성될 때) 값으로 대체됩니다. 예를 들어 아래 코드 샘플에서 "$ {workitem_title} "은(는) 키입니다. 런타임 시 "Loan-Request" 값으로 대체됩니다.

subject=Task Assigned - ${workitem_title}

message=<html><body>\n\
 <table>\n\
  <tbody>\n\
   <tr>\n\
    <td>\n\
      Sample Company\n\
    </td>\n\
   </tr>\n\
   <tr>\n\
    <td>\n\
     <pre style="font-size: 13px; font-family: Helvetica, Arial, sans-serif;  font-weight: normal; color: #323232;"> Hello ${workitem_assignee},\n\
 The following task has been assigned to you:</pre>\n\
    </td>\n\
   </tr>\n\
   <tr>\n\
    <td>\n\
     <table>\n\
      <tbody>\n\
       <tr style="border-bottom: solid 2px #FFFCF9;">\n\
        <td> TITLE</td>\n\
        <td>\n\
         <p>${workitem_title}</p>\n\
        </td>\n\
       </tr>\n\
                            <tr style="border-bottom: solid 2px #FFFCF9;">\n\
        <td> DESCRIPTION</td>\n\
        <td>\n\
         <p>${workitem_description}</p>\n\
        </td>\n\
       </tr>\n\
       <tr style="border-bottom: solid 2px #FFFCF9;">\n\
        <td> DUE DATE</td>\n\
        <td>\n\
         <p>${workitem_due_date}</p>\n\
        </td>\n\
       </tr>\n\
       <tr style="border-bottom: solid 2px #FFFCF9;">\n\
        <td> PRIORITY</td>\n\
        <td>\n\
         <p>${workitem_priority}</p>\n\
        </td>\n\
       </tr>\n\
       <tr>\n\
        <td> WORKFLOW</td>\n\
        <td>\n\
         <p>${workitem_workflow}</p>\n\
        </td>\n\
       </tr>\n\
      </tbody>\n\
     </table>\n\
    </td>\n\
   </tr>\n\
   <tr style = "text-align: center; vertical-align: middle;">\n\
    <td> \n\
     <a href="${workitem_url}" target="_blank" style="background-color: #1EBBBB; font-size: 18px; line-height: 25px; font-weight: bold; color: #FFFFFF; text-decoration: none; padding: 15px 15px 15px 15px;">Open Task</a>\n\
    </td>\n\
   </tr>\n\
   <tr>\n\
    <td>\n\
     <p><span style="font-size: 12px; font-weight: normal; font-style: italic; color: #919191;">This is an automatically generated email. Please do not reply to this email.</span></p>\n\
    </td>\n\
   </tr>\n\
  </tbody>\n\
 </table>\n\
</body>\n\
</html>\n\

이메일 알림에서 시스템 생성 메타데이터 사용 using-system-generated-metadata-in-an-email-notification

AEM Forms 애플리케이션은 즉시 여러 메타데이터 변수(키-값 쌍)를 제공합니다. 이메일 템플릿에서 이러한 변수를 사용할 수 있습니다. 변수 값은 연결된 양식 애플리케이션을 기반으로 합니다. 다음 표에는 기본적으로 사용 가능한 모든 메타데이터 변수가 나와 있습니다.

설명
workitem_title
연결된 양식 응용 프로그램의 제목입니다.
workitem_url
연결된 양식 애플리케이션에 액세스할 수 있는 URL입니다.
workitem_description
연결된 양식 응용 프로그램에 대한 설명입니다.
workitem_priority
연결된 양식 응용 프로그램에 대해 지정된 우선 순위입니다.
workitem_due_date
연관된 양식 애플리케이션에 대한 마지막 날짜입니다.
workitem_workflow
Forms 응용 프로그램과 연결된 워크플로우의 이름입니다.
workitem_assign_timestamp
워크플로 항목이 현재 할당자에게 할당된 날짜 및 시간입니다.
workitem_assignee
현재 할당자의 이름입니다.
host_prefix
작성자 서버의 URL. 예: https://10.41.42.66:4502
publish_prefix
게시 서버의 URL입니다. 예: https://10.41.42.66:4503

이메일 알림에서 사용자 지정 메타데이터 사용 using-custom-metadata-in-an-email-notification

이메일 알림에서 사용자 지정 메타데이터를 사용할 수도 있습니다. 사용자 지정 메타데이터에는 시스템에서 생성한 메타데이터 외에도 정보가 포함되어 있습니다. 예를 들어 데이터베이스에서 검색한 정책 세부 정보가 있습니다. ECMAScript 또는 OSGi 번들을 사용하여 crx-repository에 사용자 지정 메타데이터를 추가할 수 있습니다.

ECMAScript를 사용하여 사용자 지정 메타데이터 추가 use-ecmascript-to-add-custom-metadata

ECMAScript 는 스크립팅 언어입니다. 클라이언트측 스크립팅 및 서버 애플리케이션에 사용됩니다. ECMAScript를 사용하여 이메일 템플릿에 대한 사용자 지정 메타데이터를 추가하려면 다음 단계를 수행하십시오.

  1. 관리 계정으로 CRX DE에 로그인합니다. URL은 https://[server]:[port]/crx/de/index.jsp

  2. /apps/fd/dashboard/scripts/metadataScripts 로 이동합니다. 확장명이 .ecma인 파일을 만듭니다. 예를 들어 usermetadata.ecma

    위에 언급된 경로가 존재하지 않으면 경로를 만듭니다.

  3. 키-값 쌍으로 사용자 지정 메타데이터를 생성하는 논리를 가진 .ecma 파일에 코드를 추가합니다. 예를 들어 다음 ECMAScript 코드는 보험 약관에 대한 사용자 지정 메타데이터를 생성합니다.

    code language-none
    function getUserMetaData()  {
        //Commented lines below provide an overview on how to set user metadata in map and return it.
        var HashMap = Packages.java.util.HashMap;
        var valuesMap = new HashMap();
        valuesMap.put("policyNumber", "2017568972695");
        valuesMap.put("policyHolder", "Adobe Systems");
    
        return valuesMap;
    }
    
  4. 모두 저장을 클릭합니다. 이제 스크립트를 AEM 워크플로우 모델에서 선택할 수 있습니다.

    assigntask-metadata

  5. (선택 사항) 스크립트의 제목을 지정합니다.

    제목을 지정하지 않으면 사용자 지정 메타데이터 필드에 ECMAScript 파일의 전체 경로가 표시됩니다. 스크립트에 의미 있는 제목을 지정하려면 다음 단계를 수행하십시오.

    1. 스크립트 노드를 확장하고 jcr:content node를 클릭하고 Mixin.

    2. Mixin 편집 대화 상자에 mix:title 을 입력하고 를 클릭합니다. +.

    3. 다음 값을 사용하여 속성을 추가합니다.

      table 0-row-2 1-row-2 2-row-2
      이름 jcr:title
      유형 문자열
      스크립트의 제목을 지정합니다. 예를 들어, 정책 보유자에 대한 사용자 지정 메타데이터입니다. 지정한 값이 작업 할당 단계에서 표시됩니다.

OSGi 번들 및 Java 인터페이스를 사용하여 사용자 지정 메타데이터를 추가합니다 use-an-osgi-bundle-and-java-interface-to-add-custom-metadata

WorkitemUserMetadataService Java 인터페이스를 사용하여 전자 메일 템플릿에 대한 사용자 지정 메타데이터를 추가할 수 있습니다. WorkitemUserMetadataService Java 인터페이스를 사용하는 OSGi 번들을 만들고 AEM Forms 서버에 배포할 수 있습니다. 메타데이터를 작업 지정 단계에서 선택할 수 있도록 합니다.

Java 인터페이스를 사용하여 OSGi 번들을 만들려면 다음을 추가합니다 AEM Forms 클라이언트 SDK jar 및 granite jar 파일은 OSGi 번들 프로젝트에 대한 외부 종속성으로, 모든 Java IDE를 사용하여 OSGi 번들을 만들 수 있습니다. 다음 절차에서는 Eclipse를 사용하여 OSGi 번들을 만드는 단계를 제공합니다.

  1. Eclipse IDE를 엽니다. 파일 > 새 프로젝트로 이동합니다.

  2. 마법사 선택 화면에서 Maven 프로젝트를 선택하고 다음을 클릭합니다.

  3. 새 Maven 프로젝트에서 기본값을 유지하고 다음을 클릭합니다. 원형 을 선택하고 다음 을 클릭합니다. 예: maven-archetype-quickstart. 프로젝트에 대한 그룹 ID, 객체 ID, 버전 및 패키지를 지정하고 완료를 누릅니다. 프로젝트가 만들어집니다.

  4. 편집할 pom.xml 파일을 열고 파일의 모든 내용을 다음과 같이 바꿉니다.

    code language-none
  5. WorkitemUserMetadataService Java 인터페이스를 사용하여 전자 메일 템플릿에 대한 사용자 지정 메타데이터를 추가하는 소스 코드를 추가합니다. 샘플 코드는 아래에 나와 있습니다.

    code language-java
    package com.aem.impl;
    
    import com.adobe.fd.workspace.service.external.WorkitemUserMetadataService;
    import org.apache.felix.scr.annotations.Component;
    import org.apache.felix.scr.annotations.Properties;
    import org.apache.felix.scr.annotations.Property;
    import org.apache.felix.scr.annotations.Service;
    import org.osgi.framework.Constants;
    
    import java.util.HashMap;
    import java.util.Map;
    
    @Component
    @Service
    @Properties({
            @Property(name = Constants.SERVICE_DESCRIPTION, value = "A sample implementation of a user metadata service."),
            @Property(name = WorkitemUserMetadataService.SERVICE_PROPERTY_LABEL, value = "Default User Metadata Service")})
    
    public class WorkitemUserMetadataServiceImpl
      implements WorkitemUserMetadataService
    {
      public WorkitemUserMetadataServiceImpl() {}
    
      public Map<String, String> getUserMetadataMap()
      {
        HashMap<String, String> metadataMap = null;
        metadataMap = new HashMap();
        metadataMap.put("test_metadata", "tested-interface implementation");
        return metadataMap;
      }
    }
    
  6. 명령 프롬프트를 열고 OSGi 번들 프로젝트가 포함된 디렉토리로 이동합니다. 다음 명령을 사용하여 OSGi 번들을 만듭니다.

    mvn clean install

  7. AEM Forms 서버에 번들을 업로드합니다. AEM 패키지 관리자를 사용하여 번들을 AEM Forms 서버로 가져올 수 있습니다.

번들을 가져온 후 작업 지정 단계에서 메타데이터를 선택하고 이메일 템플릿에 사용할 수 있습니다.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da