첨부 파일 유무에 관계 없이, POP3(Post Office Protocol 3) 또는
IMAP(Internet Message Access Protocol)을 지원하는 이메일 서버로부터 이메일을
수신할 수 있습니다.
시작하기 전에
이 주제는 메시지 플로우를 이미 작성했다고
가정합니다. 자세한 정보는 메시지 플로우 작성을 참조하십시오.
태스크 정보
IBM® App Connect Enterprise 툴 킷을 사용하여 EmailInput 노드의 속성을 구성하면, 첨부 파일이 있든 없든 이메일을 수신할 수 있습니다.
프로시저
- 메시지 플로우에 EmailInput 노드를 추가하십시오.
- 다음 EmailInput 노드 등록 정보를 편집하십시오.
- 기본 탭 에서 이메일 서버 URL 또는 이메일 서버 정책 이름을 이메일 서버 속성 값으로 추가합니다 ( EmailInput 노드에 설명된 대로). 예: pop3://myemailserver.com:12345 또는
imap://myemailserver.com:56789.
- 보안 탭에서 이메일 서버 사용자 ID및 비밀번호 쌍의 보안 ID 오브젝트 이름을 보안 ID 특성 값으로 추가하십시오.
사용자 ID및 비밀번호를 사용하여 이메일 서버에 인증하려는 경우 mqsicredentials 명령 또는 mqsisetdbparms 명령을 사용하여 보안 ID를 정의할 수 있습니다. OAuth (Open Authorization) 표준을 사용하려는 경우, 사용자 ID와 액세스 토큰을 제공하기 위해 mqsicredentials 명령어를 사용해야 합니다.
이메일 서버 보안 ID 지원에 대한 자세한 정보는 mqsicre지원 명령 또는 mqsisetdbparms 명령을 참조하십시오.
- 재시도 탭에서 다음 특성을 구성하십시오.
- 재시도 메커니즘: 재시도 메커니즘 특성은 EmailInput 노드가 메시지 플로우 실패를 핸들링하는 방법을 정의합니다. 올바른 값은 실패, 짧은 재시도
또는 짧고 긴 재시도입니다. 이 특성의
기본값은 짧고
긴 재시도이며, 이는 짧은 재시도 임계값이 충족될 때까지 이메일을 재시도한 후
긴 재시도가 발생하므로 이메일이 이메일 서버에서 삭제되지 않고
이메일을 무한정 재시도함을 나타냅니다. 이메일 메시지가
실패하고 이 특성 값이 짧고 긴 재시도로
설정되지 않으면 이메일이 이메일 서버에서 삭제됩니다.
- 재시도 임계값: 재시도 임계값 특성은
재시도 메커니즘 특성 값이
짧은 재시도로 설정되어 있을 때
메시지 플로우 트랜잭션을 다시 시도할 횟수입니다. 이 특성의 기본값은
0입니다.
- 짧은 재시도 간격(초): 짧은 재시도 간격은
재시도 임계값 특성 값이
0으로 설정되지 않은 경우 각 재시도 사이의
간격(초)입니다. 이 특성의 기본값은
0입니다. 짧은 재시도 임계값이 충족되고 이메일이 실패할 때까지 이메일이 재시도되면 이메일이 장애 터미널로 라우트되고 이메일 서버에서 이메일이 삭제됩니다.
- 긴 재시도 간격(초):
긴 재시도 간격은 재시도 메커니즘 특성 값이
짧고 긴 재시도이고
짧은 재시도 임계값이 소모된 경우 각 재시도 사이의
간격(초)입니다. 이 특성의
기본값은 300초입니다.
- 실패한 이메일에 대한 조치: 실패한 이메일에 대한 조치 특성은 이메일 컨텐츠를 처리하려는 모든 시도가 실패한 후 EmailInput 노드가 입력 데이터 소스를 사용하여 수행하는 조치를 판별합니다. 실패한 이메일에 대한 조치
특성은 이메일 삭제의 기본값으로 설정되는
읽기 전용 특성이며, 재시도 메커니즘 특성과 함께 사용됩니다. 재시도
메커니즘 특성이 짧고 긴 재시도로 설정되면
메시지 플로우는 이메일 서버에서 계속하여 이메일을 검색하려 시도합니다.
즉, 이메일이 삭제되지 않는다는 의미입니다. 재시도 메커니즘 특성이
짧고 긴 재시도로 설정되지 않은 경우에는,
실패한 이메일에 대한 조치 특성 값 이메일 삭제가 사용되고
이메일 서버에서 이메일이 삭제됩니다.
- 변경사항을 저장하십시오.
- 메시지 플로우를 BAR 파일에 추가하고 배치하십시오.
메시지가 배치된 EmailInput 노드로 전달되면 이메일 서버에서 이메일이 수신되고 이메일 메시지의 본문 및 첨부 파일이 MIME (Multipurpose Internet Mail Extensions) 도메인에서 전파됩니다. 이메일에 관련된 다른 모든 정보는
Root.EmailInputHeader MIME 논리 트리에
저장됩니다. EmailInput 노드를 사용할 때 MIME 논리 트리에서 전파되는 이메일 요소의 전체 목록은 EmailInput 노드를 참조하십시오.
첨부 파일을 포함하는 이메일이 수신되면
EmailInput 노드는 MIME 도메인에 이메일 본문의 다른 부분을 배치하여 MIME 구문 분석기와 연관시킵니다.
EmailInput 노드가 정보를 저장하기 위해 빌드하는 MIME 트리 위치는
EmailOutput 노드가 이메일을 보낼 때 이메일 데이터가 있을 것으로 예상하는 위치와 동일합니다. 첨부는
Root.MIME.Parts.Part.Data 디렉토리의
MIME 논리 트리에 저장됩니다. Content-Type은 첨부에 있는 데이터의 유형을 설명합니다.
MIME 도메인에 Root.Properties.ContentType 값이 표시되면
첨부를 구문 분석할 논리를 쓸 수 있습니다. MIME 논리 트리에 대한 자세한 정보는 MIME 구문 분석기 및 도메인을 참조하십시오.
결과
수신된 이메일은 EmailInput 노드 Failure, Out 또는 Catch 터미널에서 처리한 후 이메일이 성공적으로 전파되고 메시지 플로우가 성공적으로 실행된 경우에만 POP3 또는 IMAP을 지원하는 이메일 서버에서 삭제됩니다. 이는 글로벌 통합 트랜잭션의 부분을 형성하지 않습니다.
이메일은
다음 상황에서 이메일 서버로부터 삭제됩니다.
- failure 터미널이 연결되지 않았습니다.
- failure 터미널에서 예외가 발생합니다.
- 이메일 메시지가 실패하고 재시도 메커니즘 특성 값이
짧고 긴 재시도로 설정되지 않았습니다.
- 재시도 임계값이
0으로 설정되지 않았고 짧은 재시도 간격 특성 값이
소모되었습니다.
EmailInput 노드의 응답 처리에 대한 자세한 정보 및 롤백 처리에 대한 정보는
EmailInput 노드의 응답 처리를 참조하십시오.