전자 메일 끝점 구성 configuring-email-endpoints

전자 메일 종단점은 사용자가 하나 이상의 문서(전자 메일 첨부 파일)를 지정된 전자 메일 계정에 전송하여 서비스를 호출할 수 있도록 합니다. 전자 메일 받은 편지함은 첨부 파일에 대한 수집 지점 역할을 합니다. 서비스는 받은 편지함을 모니터링하고 첨부 파일을 처리합니다. 변환 결과는 끝점에 정의된 사용자에게 전달됩니다.

이메일 끝점의 경우, 권한이 있는 사용자는 파일을 해당 계정에 이메일로 보내어 프로세스를 호출할 수 있습니다. 결과는 제출 사용자(기본적으로) 또는 끝점 설정에 정의된 사용자에게 반환됩니다.

전자 메일 끝점을 구성하기 전에 끝점에서 사용할 POP3 또는 IMAP 전자 메일 계정을 만듭니다. 각 전환 유형에 대해 별도의 계정을 설정합니다. 예를 들어 수신 파일 첨부 파일에서 표준 PDF 문서를 생성하도록 한 계정을 구성할 수 있으며 다른 계정을 구성하여 보안 PDF 문서를 생성할 수 있습니다.

모든 전자 메일 끝점은 서비스를 호출할 때 필요한 전자 메일 받은 편지함의 인증된 사용자 이름과 암호로 구성됩니다. 전자 메일 계정이 구성된 메일 서버 시스템에 의해 보호됩니다.

사용자가 파일 및 변환 경로 이름에 서유럽어 문자가 있는 문서를 보낼 경우 필요한 인코딩 유형(Latin1)을 지원하는 이메일 애플리케이션을 사용해야 합니다 [ISO-8859-1], 서유럽 [Windows]또는 UTF-8)입니다. 자세한 내용은 AEM Forms 설치 및 배포 애플리케이션 서버에 대한 문서입니다.

이메일 종단점을 구성하기 전에 이메일 서비스를 구성하십시오. (자세한 내용은 기본 전자 메일 끝점 설정 구성) 이메일 서비스의 구성 매개 변수에는 두 가지 목적이 있습니다.

이메일 종단점에 대한 SSL 구성 configure-ssl-for-an-email-endpoint

전자 메일 끝점에 SSL(Secure Sockets Layer)을 사용하도록 POP3, IMAP 또는 SMTP를 구성할 수 있습니다.

기본 전자 메일 끝점 설정 구성 configure-default-email-endpoint-settings

서비스 관리 페이지에서 모든 전자 메일 종단점에 공통인 특성을 구성하고 모든 전자 메일 종단점에 대한 기본값을 제공할 수 있습니다.

Forms 워크플로우가 사용자로부터 들어오는 전자 메일 메시지를 받고 처리하려면 전체 작업 서비스를 위한 전자 메일 끝점을 만들어야 합니다. 이 전자 메일 엔드포인트에는 다음에 설명된 대로 추가 설정이 필요합니다. 전체 작업 서비스에 대한 전자 메일 끝점 만들기.

전자 메일 끝점의 기본값 변경 change-the-default-values-for-email-endpoints

기본 전자 메일 끝점 설정 default-email-endpoint-settings

크론 식: quartz에서 입력 디렉토리의 폴링을 예약하기 위해 사용하는 크론 표현식입니다.

반복 간격: 디렉터리 폴링이 반복되는 횟수입니다. 끝점 구성에 이 값이 지정되지 않은 경우 기본 반복 간격은 초 단위입니다. 기본값은 10입니다. 이 값은 10보다 작을 수 없습니다.

반복 횟수: 입력 디렉터리를 폴링한 횟수입니다. 끝점 구성에 이 값이 지정되지 않은 경우 사용할 기본 반복 카운트입니다. -1이라는 값은 디렉터리를 무기한 스캔함을 나타냅니다. 기본값은 -1입니다.

작업 시작 지연: 작업이 엔드포인트 스캔을 시작하기 전 지연에 대한 기본값(초)입니다. 기본값은 0입니다.

배치 크기: 수신자가 최적의 성능을 위해 스캔당 처리하는 이메일 수입니다. -1 값은 모든 이메일을 나타냅니다. 기본값은 2입니다.

비동기: 호출 유형을 비동기 또는 동기식으로 식별합니다. 임시 및 동기 프로세스는 동기식으로 호출할 수만 있습니다. 기본값은 비동기적입니다.

도메인 패턴: 들어오는 전자 메일을 필터링하는 데 사용되는 도메인 이름 패턴입니다. 예를 들어 adobe.com을 사용하는 경우 adobe.com의 이메일만 처리됩니다. 다른 도메인의 이메일은 무시됩니다.

파일 패턴: 공급자가 허용하는 들어오는 파일 첨부 패턴입니다. 여기에는 특정 확장명(*.dat, *.xml)과 특정 이름(데이터) 및 이름과 확장명(.)의 복합 표현식이 있는 파일이 포함됩니다.[dD][a][Tt]). 기본값은 *입니다.ast;(&A)

성공한 작업 수신자: 성공적인 작업을 나타내기 위해 이메일을 전송하는 데 사용되는 하나 이상의 이메일 주소입니다. 기본적으로 성공적인 작업 메시지는 항상 초기 작업의 발신자에게 전송됩니다. 최대 100명의 수신자가 지원됩니다. 이 설정을 끄려면 이 필드를 비워 둡니다.

실패한 작업 수신자: 실패한 작업을 나타내는 이메일을 보내는 데 사용되는 하나 이상의 이메일 주소입니다. 기본적으로 실패한 작업 메시지는 항상 초기 작업을 보낸 발신자에게 전송됩니다. 최대 100명의 수신자가 지원됩니다. 이 설정을 끄려면 이 필드를 비워 둡니다.

받은 편지함 호스트: 전자 메일 공급자가 검색할 받은 편지함 호스트 이름 또는 IP 주소입니다.

받은 편지함 포트: 전자 메일 공급자가 검색할 받은 편지함 포트 번호입니다. 값이 0이면 기본 IMAP 또는 POP3 포트가 사용됩니다.

받은 편지함 프로토콜: 받은 편지함을 검사하는 데 사용할 전자 메일 끝점에 대한 전자 메일 프로토콜입니다. IMAP 또는 POP3를 선택할 수 있습니다. 받은 편지함 호스트 메일 서버는 이러한 프로토콜을 지원해야 합니다.

받은 편지함 시간 초과: 받은 편지함에 연결하려고 할 때 끝점을 취소하기 전에 대기하는 시간을 지정합니다. 시간 초과 값에 도달하기 전에 연결을 가져오지 않으면 받은 편지함은 폴링되지 않습니다.

받은 편지함 사용자: 이메일 계정에 로그인하는 데 필요한 사용자 이름입니다. 이메일 서버 및 구성에 따라 이 이름은 이메일의 사용자 이름 부분일 수도 있고 전체 이메일 주소일 수도 있습니다.

받은 편지함 암호: 받은 편지함 사용자의 암호입니다.

POP3/IMAP SSL 사용: 이 옵션을 선택하면 SSL을 활성화합니다.

SMTP 호스트: 이메일 공급자가 결과 및 오류 메시지를 보내는 데 사용하는 메일 서버의 호스트 이름입니다. 예를 들어 mail.example.com입니다.

SMTP 포트: 메일 서버에 연결하는 데 사용되는 포트입니다. 기본값은 25입니다.

SMTP 사용자: 이메일 공급자가 결과 및 오류에 대한 이메일을 보낼 때 사용할 사용자 계정입니다.

SMTP 암호: SMTP 계정의 암호입니다. 일부 메일 서버에는 SMTP 암호가 필요하지 않습니다.

전송 위치: 결과 및 오류에 대한 이메일 알림을 전송하는 데 사용되는 이메일 주소(예: user@company.com). 보낸 사람 값을 지정하지 않으면 전자 메일 서버는 SMTP 사용자 설정에 지정된 값을 전자 메일 서버에 구성된 기본 도메인과 결합하여 전자 메일 주소를 결정합니다. 이메일 서버에 기본 도메인이 없고 보낸 사람 값을 지정하지 않으면 오류가 발생할 수 있습니다. 이메일 메시지에 정확한 보낸 사람 주소가 있는지 확인하려면 보낸 사람 보내기 설정에 대한 값을 지정합니다.

SMTP SSL 사용: 이 옵션을 선택하면 SMTP를 통해 SSL을 활성화합니다.

원본 전자 메일 본문을 첨부 파일로 포함합니다. 기본적으로 Forms 서버에 이메일을 보낼 때 메시지의 원래 텍스트가 메시지 본문에 포함됩니다. 대신 텍스트를 첨부 파일로 포함하려면 이 옵션을 선택합니다.

결과 이메일에 원래 제목 줄 사용: 기본적으로 Forms 서버는 결과 이메일 메시지를 보낼 때 성공 이메일 제목 및 오류 이메일 제목 설정에 지정된 값을 제목 줄로 사용합니다. 대신 서버에 보낸 원본 이메일과 동일한 제목 줄을 사용하려면 이 옵션을 선택합니다.

성공 이메일 제목: 프로세스를 시작하거나 계속하기 위해 이메일 종단점에 이메일을 보내면 AEM Forms 서버에서 반환 이메일 메시지를 받게 됩니다. 이메일이 성공하면 성공 이메일을 받게 됩니다. 이메일에 실패하면 실패 이유를 알리는 실패 이메일을 받게 됩니다. 이 설정을 사용하여 이 종단점에 대해 전송된 성공 이메일 메시지의 제목 줄을 지정할 수 있습니다.

성공 이메일 본문: 이 종단점에 대해 전송된 성공 전자 메일 메시지의 본문 텍스트를 지정할 수 있습니다.

오류 전자 메일 제목 접두사: 이 종단점에 대해 전송된 실패 이메일 메시지의 제목 줄 시작 부분에 사용되는 텍스트를 지정할 수 있습니다.

오류 이메일 제목: 이 종단점에 대해 전송된 실패 이메일 메시지의 제목 줄을 지정할 수 있습니다. 이 텍스트는 오류 이메일 제목 접두사 뒤에 표시됩니다.

오류 이메일 본문: 이 종단점에 대해 전송된 실패 이메일 메시지의 본문 텍스트에 첫 번째 줄을 지정할 수 있습니다.

전자 메일 요약 정보: 각 성공 또는 실패 메시지에는 Forms 서버에 보낸 원본 이메일 텍스트가 포함된 섹션이 포함되어 있습니다. 이 설정은 해당 섹션 위에 표시되는 텍스트를 지정합니다.

이 끝점을 만들거나 업데이트하기 전에 받은 편지함의 유효성 검사: 이 옵션을 선택하면 Forms 서버에서 끝점을 만들기 전에 SMTP/POP3 설정이 올바른지 확인합니다. 추가를 클릭하면 받은 편지함 계정이 유효한지 여부를 나타내는 메시지가 표시됩니다. 이 옵션을 선택하지 않으면 AEM Forms 서버에서 받은 편지함의 유효성을 검사하지 않고 끝점을 만듭니다.

문자 집합 인코딩: 전자 메일 메시지에 사용할 인코딩 형식입니다. 기본값은 UTF-8이며, 이 값은 일본 외부의 대부분의 사용자가 사용합니다. 일본어 환경의 사용자는 ISO2022-JP 를 선택할 수 있습니다.

실패한 전자 메일 전송 폴더: SMTP 메일 서버가 작동하지 않을 경우 결과를 저장할 디렉터리를 지정합니다.

전자 메일 끝점 설정 email-endpoint-settings

전자 메일 끝점을 구성하려면 다음 설정을 사용하십시오.

이름: 끝점을 식별하는 필수 설정입니다. 작업 공간에 표시되는 이름이 잘리기 때문에 < 문자를 포함하지 마십시오. URL을 끝점의 이름으로 입력하는 경우 RFC1738에 지정된 구문 규칙을 따르는지 확인하십시오.

설명: 끝점에 대한 설명입니다. 작업 공간에 표시되는 설명이 잘리기 때문에 < 문자를 포함하지 마십시오.

크론 식: 크론 표현식을 사용하여 이메일을 예약해야 하는 경우 크론 표현식을 입력합니다.

반복 횟수: 전자 메일 끝점이 폴더 또는 디렉터리를 검색하는 횟수입니다. 값이 -1이면 무제한 검색을 나타냅니다. 기본값은 -1입니다.

반복 간격: 받는 메일을 확인하는 데 받는 사람이 사용하는 검색 비율입니다.

작업 시작 지연: 스케줄러가 시작된 후 스캔을 기다리는 시간입니다.

배치 크기: 수신자가 최적의 성능을 위해 스캔당 처리하는 이메일 수입니다. -1 값은 모든 이메일을 나타냅니다. 기본값은 2입니다.

사용자 이름: 이메일에서 대상 서비스를 호출할 때 사용되는 사용자 이름인 필수 설정입니다. 기본값은 SuperAdmin입니다.

도메인 이름: 사용자의 도메인인 필수 설정입니다. 기본값은 DefaultDom입니다.

도메인 패턴: 공급자가 허용하는 수신 전자 메일의 도메인 패턴을 지정합니다. 예를 들어 adobe.com을 사용하는 경우 adobe.com의 이메일만 처리됩니다. 다른 도메인의 이메일은 무시됩니다.

파일 패턴: 공급자가 허용하는 들어오는 파일 첨부 패턴을 지정합니다. 여기에는 이름 및 확장(*.dat, *.xml)에 특정 확장명(*.dat), 특정 이름(데이터) 또는 복합 표현식이 있는 파일이 포함됩니다.[dD][a][Tt]).

성공한 작업 수신자: 성공적인 작업을 나타내기 위해 메시지가 전송되는 이메일 주소입니다. 기본적으로 성공적인 작업 메시지는 항상 발신자에게 전송됩니다. 발신자를 입력하면 발신자에게 이메일 결과가 전송됩니다. 최대 100명의 수신자가 지원됩니다. 쉼표(,)로 구분하여 이메일 주소를 사용하는 추가 수신자를 지정합니다.

이 설정을 끄려면 설정을 비워 둡니다. 경우에 따라 프로세스를 트리거하고 결과에 대한 이메일 알림을 원하지 않습니다.

실패한 작업 수신자: 실패한 작업을 나타내기 위해 메시지가 전송되는 이메일 주소입니다. 기본적으로 실패한 작업 메시지는 항상 발신자에게 전송됩니다. 발신자를 입력하면 발신자에게 이메일 결과가 전송됩니다. 최대 100명의 수신자가 지원됩니다. 쉼표(,)로 구분하여 이메일 주소를 사용하는 추가 수신자를 지정합니다.

이 설정을 끄려면 설정을 비워 둡니다. 경우에 따라 프로세스를 트리거하고 결과에 대한 이메일 알림을 원하지 않습니다.

받은 편지함 호스트: 전자 메일 공급자가 검색할 받은 편지함 호스트 이름 또는 IP 주소입니다.

받은 편지함 포트: 전자 메일 서버가 사용하는 포트입니다. POP3의 기본값은 110이고, IMAP의 기본값은 143입니다. SSL을 사용하는 경우 POP3의 기본값은 995이고 IMAP의 기본값은 993입니다.

받은 편지함 프로토콜: 받은 편지함을 검사하는 데 사용할 전자 메일 끝점에 대한 전자 메일 프로토콜입니다. 값은 IMAP 또는 POP3입니다. 받은 편지함 호스트 메일 서버는 이러한 프로토콜을 지원해야 합니다.

받은 편지함 시간 초과: 이메일 공급자가 받은 편지함 응답을 기다리는 시간 초과(초)입니다.

받은 편지함 사용자: 이메일 계정에 로그인하는 데 필요한 사용자 이름입니다. 이메일 서버 및 구성에 따라 이 값은 이메일의 사용자 이름 부분일 수도 있고 전체 이메일 주소일 수도 있습니다.

받은 편지함 암호: 받은 편지함 사용자의 암호입니다.

POP3/IMAP SSL 사용: 이메일 공급자가 SSL을 사용하여 받은 편지함을 강제로 스캔하도록 하려면 이 설정을 선택합니다. 메일 서버가 SSL을 지원하는지 확인합니다.

SMTP 호스트: 이메일 공급자가 결과 및 오류 메시지를 보내는 데 사용하는 메일 서버의 호스트 이름입니다.

SMTP 포트: SMTP 포트의 기본값은 25입니다.

SMTP 사용자: 이메일 공급자가 결과 및 오류에 대한 이메일 알림을 전송할 때 사용할 사용자 계정입니다.

SMTP 암호: SMTP 계정의 암호입니다. 일부 메일 서버에는 SMTP 암호가 필요하지 않습니다.

전송 위치: 결과 및 오류에 대한 이메일 알림을 전송하는 데 사용되는 이메일 주소(예: user@company.com). 보낸 사람 값을 지정하지 않으면 전자 메일 서버는 SMTP 사용자 설정에 지정된 값을 전자 메일 서버에 구성된 기본 도메인과 결합하여 전자 메일 주소를 결정합니다. 이메일 서버에 기본 도메인이 없고 보낸 사람 값을 지정하지 않으면 오류가 발생할 수 있습니다. 이메일 메시지에 정확한 보낸 사람 주소가 있는지 확인하려면 보낸 사람 보내기 설정에 대한 값을 지정합니다.

SMTP SSL 사용: 이메일 공급자가 SSL을 사용하여 받은 편지함을 강제로 스캔하도록 하려면 이 설정을 선택합니다. 메일 서버가 SSL을 지원하는지 확인합니다.

실패한 전자 메일 전송 폴더: SMTP 메일 서버가 작동하지 않을 경우 결과를 저장할 디렉터리를 지정합니다.

비동기: 동기식으로 설정하면 모든 입력 문서가 처리되고 단일 응답이 반환됩니다. 비동기식으로 설정하면 처리되는 각 문서에 대해 응답이 전송됩니다.

예를 들어, 단일 Word 문서를 사용하고 해당 문서를 PDF 파일로 반환하는 서비스에 대해 전자 메일 끝점이 만들어집니다. 여러 (3) Word 문서가 포함된 끝점의 받은 편지함으로 이메일을 보낼 수 있습니다. 세 개의 문서가 모두 처리되면 종단점이 동기식으로 구성된 경우 세 개의 문서가 모두 첨부된 단일 응답 전자 메일이 전송됩니다. 종단점이 비동기인 경우 각 Word 문서가 PDF으로 변환된 후 응답 전자 메일이 전송됩니다. 그 결과 세 개의 이메일이 있고 각각 하나의 PDF 첨부 파일이 있습니다.

기본값은 비동기적입니다.

원본 전자 메일 본문을 첨부 파일로 포함합니다. 기본적으로 Forms 서버에 이메일을 보낼 때 메시지의 원래 텍스트가 메시지 본문에 포함됩니다. 대신 텍스트를 첨부 파일로 포함하려면 이 옵션을 선택합니다.

결과 이메일에 원래 제목 줄을 사용합니다. 기본적으로 Forms 서버는 결과 이메일 메시지를 보낼 때 성공 이메일 제목 및 오류 이메일 제목 설정에 지정된 값을 제목 줄로 사용합니다. 대신 서버에 보낸 원본 이메일과 동일한 제목 줄을 사용하려면 이 옵션을 선택합니다.

성공 이메일 제목: 프로세스를 시작하거나 계속하기 위해 이메일 종단점에 이메일을 보내면 AEM Forms 서버에서 반환 이메일 메시지를 받게 됩니다. 이메일이 성공하면 성공 이메일을 받게 됩니다. 이메일에 실패하면 실패 이유를 알리는 실패 이메일을 받게 됩니다. 이 설정을 사용하여 이 종단점에 대해 전송된 성공 이메일 메시지의 제목 줄을 지정할 수 있습니다.

성공 이메일 본문: 이 종단점에 대해 전송된 성공 전자 메일 메시지의 본문 텍스트를 지정할 수 있습니다.

오류 전자 메일 제목 접두사: 이 종단점에 대해 전송된 실패 이메일 메시지의 제목 줄 시작 부분에 사용되는 텍스트를 지정할 수 있습니다.

오류 이메일 제목: 이 종단점에 대해 전송된 실패 이메일 메시지의 제목 줄을 지정할 수 있습니다. 이 텍스트는 오류 이메일 제목 접두사 뒤에 표시됩니다.

오류 이메일 본문: 이 종단점에 대해 전송된 실패 이메일 메시지의 본문 텍스트에 첫 번째 줄을 지정할 수 있습니다.

전자 메일 요약 정보: 각 성공 또는 실패 메시지에는 Forms 서버에 보낸 원본 이메일 텍스트가 포함된 섹션이 포함되어 있습니다. 이 설정은 해당 섹션 위에 표시되는 텍스트를 지정합니다.

이 끝점을 만들거나 업데이트하기 전에 받은 편지함의 유효성 검사: 이 옵션을 선택하면 Forms 서버에서 끝점을 만들기 전에 SMTP/POP3 설정이 올바른지 확인합니다. 추가를 클릭하면 받은 편지함 계정이 유효한지 여부를 나타내는 메시지가 표시됩니다. 이 옵션을 선택하지 않으면 AEM Forms 서버에서 받은 편지함의 유효성을 검사하지 않고 끝점을 만듭니다.

작업 이름: 이 설정은 필수입니다. 전자 메일 끝점에 지정할 수 있는 작업 목록입니다. 여기서 선택하는 작업은 입력 매개변수 매핑 및 출력 매개변수 매핑 섹션에 표시되는 필드를 결정합니다.

입력 매개 변수 매핑: 서비스 및 작업을 처리하는 데 필요한 입력을 구성하는 데 사용됩니다. 두 가지 유형의 입력은 리터럴 및 변수입니다.

리터럴: 전자 메일은 표시되는 필드에 입력한 값을 사용합니다.

변수: 이메일 제목, 본문, 헤더 또는 발신자의 이메일 주소에서 문자열을 매핑할 수 있습니다. 이렇게 하려면 다음 키워드 중 하나를 사용합니다. %SUBJECT%, %BODY%, %HEADER% 또는 %SENDER%. 예를 들어 %SUBJECT%를 사용하는 경우 전자 메일 제목 콘텐츠는 입력 매개 변수로 사용됩니다. 첨부 파일을 선택하려면 전자 메일 끝점이 첨부 문서를 선택하는 데 사용할 수 있는 파일 패턴을 입력합니다. 예를 들어 *.pdf를 입력하면 확장명이 .pdf인 첨부된 문서가 선택됩니다. 마지막 입력(&A) 첨부 문서를 선택합니다. example.pdf를 입력하면 example.pdf라는 첨부 문서가 선택됩니다.

출력 매개 변수 매핑: 서비스 및 작업의 출력을 구성하는 데 사용됩니다. 출력 매개 변수 매핑 값의 다음 문자가 첨부 파일 이름에서 확장됩니다.

%F 소스 파일의 파일 이름을 나타냅니다(확장명을 포함하지 않음).

%E 소스 파일의 확장자를 나타냅니다.

모든 백슬래시()가 %%로 대체됩니다.

참고​: 서비스 요청 메시지에 여러 첨부 파일이 포함된 경우 끝점의 출력 매개 변수 매핑 속성에 %F 및 %E 매개 변수를 사용할 수 없습니다. 서비스 응답이 여러 첨부 파일을 반환하는 경우 두 개 이상의 첨부 파일에 동일한 파일 이름을 지정할 수 없습니다. 이러한 권장 사항을 따르지 않는 경우 호출된 서비스는 반환된 파일의 이름을 만들며 이름을 예측할 수 없습니다.

다음 값을 사용할 수 있습니다.

단일 개체: 전자 메일 공급자에 소스 폴더 대상이 없습니다. 결과는 첨부 파일로 반환됩니다. 패턴은 Result/%F.ps이며 파일 이름 첨부 파일로 Result%%sourcefilename.ps를 반환합니다.

목록: 패턴은 Result/%F/ 이고 Result%%sourcefilename%%file1을 파일 이름 첨부 파일로 반환합니다.

맵: 패턴은 Result/%F/ 이고 원본 대상은 Result%%sourcefilename%%file1 및 Result%%sourcefilename%%file2입니다. 맵에 둘 이상의 개체가 있고 패턴이 Result/%F.ps인 경우 응답 파일 첨부 파일은 Result%%sourcefilename1.ps(출력 1) 및 Result%%sourcefilename2.ps(출력 2)입니다.

전체 작업 서비스에 대한 전자 메일 끝점 만들기 create-an-email-endpoint-for-the-complete-task-service

Forms 워크플로우가 사용자로부터 들어오는 전자 메일 메시지를 받고 처리하려면 전체 작업 서비스를 위한 전자 메일 끝점을 만들어야 합니다.