소스 보기

page no.

기능 설명
1. 다양한 SMTP 서버의 정보를 수용하기 위해 Server Script로 메일 발송 기능을 추가하였습니다.
  1. PORTAL에서는 비밀번호 찾기와 같은 기능에서 발급된 인증 코드를 전송하기 위해 SMTP 정보를 이용합니다.
  2. SMTP 정보는 각 사이트마다 이용하는 SMTP 서비스가 다르고 이에 따른 설정 정보가 다양한 관계로, 이를 수용할 수 있도록 Server Script로 메일 발송 기능을 지원하여 환경에 맞는 SMTP 설정을 지원합니다.

사용 방법

파일 정보
1. reports > SERVER_SCRIPT 경로에서 PORTAL 폴더 하위에 PORTAL_SEND_MAIL.jsx 파일이 존재하는지 확인합니다.
  1. 경로 : reports > SERVER_SCRIPT > PORTAL > PORTAL_SEND_MAIL.jsx
  2. 역할 : 서버 스크립트 기반 메일 발송 범용 유틸
호출 주체
1. 서버 스크립트 실행이 가능한 호출부 에서 공통으로 사용할 수 있습니다.
  1. matrix-service : 비밀번호 인증 코드 발송 로직
  2. AUD 보고서 : 클라이언트 JS에서 viewer.RunScriptEx( )로 호출부
  3. 기타 : 서버 스크립트 실행 API 가능한 모든 호출부
요청 파라미터
1. 변수 정보
  옵션 키 예시
  TO_ADDRESS
  수신자 메일 주소
  TITLE
  메일 제목
  CONTENT
  메일 본문

설정

서버 옵션

옵션 키	설명	예시
MAIL_SMTP_SERVER	SMTP 서버 주소	smtp.gmail.com
MAIL_SMTP_PORT	SMTP 포트	465 / 587
MAIL_SMTP_USER	SMTP 계정	account@gmail.com
MAIL_SMTP_PWD	SMTP 계정 비밀번호	(앱 비밀번호 등)
MAIL_SENDER_USER	발신인 이름	시스템관리자
MAIL_SENDER_ADDRESS	발신인 주소	sender@example.com

서버 스크립트 내 SMTP 보안 방식을 파라미터로 설정

옵션 키	설명	예시
평문	25	null
SSL	465	["mail.smtp.auth=true", "mail.smtp.ssl.enable=true", "mail.smtp.starttls.enable=false"]]
TLS (STARTTLS)	587	["mail.smtp.auth=true", "mail.smtp.starttls.enable=true", "mail.smtp.starttls.required=true]

(중요) 비밀번호 찾기 과정에서 PORTAL_MAIL_SERVER_SCRIPT_NAME 가 추가되어야 메일 발송 기능이 동작합니다.
1. @PORTAL_SEND_MAIL이 입력되어야 인증 코드 관련 메일이 발송됩니다.
(중요) @PORTAL_SEND_MAIL를 커스텀 할 경우, 원본 파일에 대한 사본 파일을 만들어서 SMTP 서버 정보를 커스텀 합니다.
1. 그리고 관리자 > 시스템 옵션 > PORTAL_MAIL_SERVER_SCRIPT_NAME 값을 사본 파일명으로 지정합니다. (예 - @PORTAL_SEND_MAIL_COPY)
2. 제품이 업데이트 되는 경우, 원본 파일이 업데이트 되므로 위 사본 파일에는 영향이 없으므로 운영 시에 사본 파일을 만들어서 커스텀 후 사용하시기 바랍니다.
3. 커스텀 하지 않는 경우에는, 원본 파일은 관리자에 등록된 SMTP 정보를 토대로 연결되도록 되어 있습니다.

테스트 방법

비밀번호 찾기
1. 인증 코드 발송 가능 여부 확인

AUD 보고서

JScript 내 Server Script 호출로 메일 발송 가능 여부 확인

viewer.RunScriptEx("", "@PORTAL@PORTAL_SEND_MAIL", {
    TO_ADDRESS: "target@example.com",
    TITLE: "테스트 메일",
    CONTENT: "안녕하세요, 테스트입니다."
}, function(result) {
    if (result.success) {
        console.log("발송 성공");
    } else {
        console.error("발송 실패:", result.error);
    }
});

단계별 사용 방법을 삽입 합니다.
이미지를 복사/붙여 넣기 또는 끌어다 놓기로 추가 할 수 있습니다.
소스가 필요 할 경우 코드블럭 매크로를 사용 합니다.
단계별 사용 방법은 최종 적용 결과를 표기 합니다.

기능 사용을 위해 필요한 옵션 설정이 있으면 옵션 위치를 입력 합니다.
기능 사용에 도움이 되는 팁이나 관련 추가 정보를 작성 합니다.
제약사항은 별도 작성 합니다.

제약 사항이 있으면 여기에 등록 합니다.
기존 사용자가 업데이트 시 신경 써야 할 것이 있으면 작성합니다.

변경 사항변경 사항이 있으면 변경 전.후를 아래 표에 작성 합니다. 없을 경우는 아래 표를 삭제 합니다.

변경 전	변경 후	릴리즈 번호
변경 전 이미지 또는 현상 설명을 작성 (이미지 크기는 중간 이하로 사용 합니다.)	변경 후 이미지 또는 현상 설명을 작성 (이미지 크기는 중간 이하로 사용 합니다.)	변경 릴리즈 번

기능 정보	API Open	UI Open	Read Only	Not Use	Hidden	Not Recommend	해당 없음
시작 버전 정보	해당 텍스트 버전은 iMgt 내의 '시스템 정보조회' 내의 제품명과 동일하게 기재합니다. 예) i-OLAP server : 7.0.400.52, i-AUD : 7.3.400.0-202401031119

샘플 URL : https://rnd.bimatrix.co.kr/aud7/ 또는 https://aud.bimatrix.co.kr 등 외부 접근 위치에 샘플이 있을 경우 보고서 경로를 입력합니다.
샘플 파일

BCRM 접수 제목을 번호와 함께 작성 합니다. 예 ) (BCRM#E0070) [i-AUD][조건개인화]조건 개인화 대상 컨트롤이 isReadOnly=true, isEnabled=flase 일때 최종 값이 유지되지 않으면 좋겠습니다.

추가 이슈 처리가 있을 경우 표 뒤에 행 추가 한 다음 작성 합니다.

옵션 키	예시
TO_ADDRESS	수신자 메일 주소
TITLE	메일 제목
CONTENT	메일 본문