EzEmail

EzEmail

Email 발신정보 관리용 컴포넌트

Constructor

new EzEmail()

Author:
  • 정민석(whitn86@gmail.com)

Members

contents :string

Description:
  • 발신 내용

    • 발신내용 칼럼 명이 설정되어 있지 않은 경우, contents값의 내용이 모든 사용자에게 동일하게 발신됩니다.
    • 발신내용 칼럼 명이 설정되어 있을 경우, 치환기능을 사용하지 않는다면 contents값은 무시됩니다.
    • 치환기능을 사용 시, contents값이 사용자 별로 치환되어 해당 제목 칼럼 명으로 설정된 칼럼에 입력됩니다.

발신 내용

  • 발신내용 칼럼 명이 설정되어 있지 않은 경우, contents값의 내용이 모든 사용자에게 동일하게 발신됩니다.
  • 발신내용 칼럼 명이 설정되어 있을 경우, 치환기능을 사용하지 않는다면 contents값은 무시됩니다.
  • 치환기능을 사용 시, contents값이 사용자 별로 치환되어 해당 제목 칼럼 명으로 설정된 칼럼에 입력됩니다.
Type:
  • string
Example
var text = this.ezEmail.contents;
this.ezEmail.contents = "정기 결산 알림...";

contentsColumn :string

Description:
  • 내용 칼럼명

    • 내용 칼럼명을 설정할 경우 치환기능을 사용하지 않는다면 contents값은 무시됩니다.
    • 내용 칼럼명과 함께 치환기능을 사용 시 contents의 값이 치환되어 해당 칼럼에 입력됩니다.

내용 칼럼명

  • 내용 칼럼명을 설정할 경우 치환기능을 사용하지 않는다면 contents값은 무시됩니다.
  • 내용 칼럼명과 함께 치환기능을 사용 시 contents의 값이 치환되어 해당 칼럼에 입력됩니다.
Type:
  • string
Example
var colNm = this.ezEmail.contentsColumn;
this.ezEmail.contentsColumn = "CONTENTS";

encoding :String

Description:
  • 실제 Email 문자 인코딩 미설정시 기본값은 UTF-8 입니다.

실제 Email 문자 인코딩 미설정시 기본값은 UTF-8 입니다.

Type:
Example
var encoding = this.ezEmail.encoding;
this.ezEmail.encoding = "UTF-8";

fileDataset :string

Description:
  • 첨부파일 정보 데이터셋 명

    nexacro.EzFile로 관리되는 데이터셋 명칭입니다. Dataset객체를 직접 설정할 경우 setFileDataset함수를 사용하세요 Dataset객체를 가져오고자할 경우 getFileDataset함수를 사용하세요

첨부파일 정보 데이터셋 명

nexacro.EzFile로 관리되는 데이터셋 명칭입니다. Dataset객체를 직접 설정할 경우 setFileDataset함수를 사용하세요 Dataset객체를 가져오고자할 경우 getFileDataset함수를 사용하세요

Type:
  • string
Example
var dsNm = this.ezEmail.fileDataset;
this.ezEmail.fileDataset = "ds_file";

outDataset :string

Description:
  • 발신 결과 수신용 데이터셋 명칭

    발신 결과 데이터셋에는 SMTP서버로의 요청성공 여부만 기록됩니다.
    요청 후 실제 발신 성공여부는 기록되지 않습니다.

    실제 데이터셋을 직접 설정하시려면 setOutDataset함수를 사용하세요 실제 설정된 데이터셋을 가져오시려면 getOutDataset함수를 사용하세요

발신 결과 수신용 데이터셋 명칭

발신 결과 데이터셋에는 SMTP서버로의 요청성공 여부만 기록됩니다.
요청 후 실제 발신 성공여부는 기록되지 않습니다.

실제 데이터셋을 직접 설정하시려면 setOutDataset함수를 사용하세요 실제 설정된 데이터셋을 가져오시려면 getOutDataset함수를 사용하세요

Type:
  • string
Example
var dsNm = this.ezEmail.outDataset;
this.ezEmail.outDataset = "ds_out";

popupOption :string

Description:
  • 팝업 호출 정보, 양식은 여기를 참조

    문자열 대신 Object로 설정에는 setPopupOption을 사용하세요

팝업 호출 정보, 양식은 여기를 참조

문자열 대신 Object로 설정에는 setPopupOption을 사용하세요

Type:
  • string
Example
var option = this.ezEmail.popupOption;
this.ezEmail.popupOption = '{ "id": "test", "url": "FORM::COMP/test.xfdl" }';

popupParam :string

Description:
  • 팝업 호출시 arg값(추가파라미터) 문자열 대신 Object로 값 설정 시 setPopupParam을 사용하세요

팝업 호출시 arg값(추가파라미터) 문자열 대신 Object로 값 설정 시 setPopupParam을 사용하세요

Type:
  • string
Example
var param = this.ezEmail.popupParam;
this.ezEmail.popupParam = '{ "code": "0001" }';

senderEmail :string

Description:
  • 발신자 Email

발신자 Email

Type:
  • string
Example
var email = this.ezEmail.senderEmail;
this.ezEmail.senderEmail = "dltmdrkq2@gmail.com";

senderId :string

Description:
  • 발신자 ID

발신자 ID

Type:
  • string
Example
var id = this.ezEmail.ezEmailsenderId;
this.ezEmail.senderId = "cm01";

senderName :string

Description:
  • 발신자 명

발신자 명

Type:
  • string
Example
var name = this.ezEmail.senderName;
this.ezEmail.senderName = "이승갑";

substitution :boolean

Description:
  • 치환기능 사용여부

    • title, titleColumn property값이 모두 있을 경우 title의 내용을 치환해 titleColumn에 해당하는 칼럼에 입력됨
    • contents, contentsColumn property값이 모두 있을 경우 contents의 내용을 치환해 contentsColumn에 해당하는 칼럼에 입력됨

치환기능 사용여부

  • title, titleColumn property값이 모두 있을 경우 title의 내용을 치환해 titleColumn에 해당하는 칼럼에 입력됨
  • contents, contentsColumn property값이 모두 있을 경우 contents의 내용을 치환해 contentsColumn에 해당하는 칼럼에 입력됨
Type:
  • boolean
Example
var substitution = this.ezEmail.substitution;
this.ezEmail.substitution = true; 

template :string

Description:
  • 발신 탬플릿 경로값

발신 탬플릿 경로값

Type:
  • string
Example
var url = this.ezEmail.template;
this.ezEmail.template = "ezEmail/emailForm_default.vm"; 

title :string

Description:
  • 발신 제목

    • 제목 칼럼 명이 설정되어 있지 않은 경우, title값의 내용이 모든 사용자에게 동일하게 발신됩니다.
    • 제목 칼럼 명이 설정되어 있을 경우, 치환기능을 사용하지 않는다면 title값은 무시됩니다.
    • 치환기능을 사용 시, title값이 사용자 별로 치환되어 해당 제목 칼럼 명으로 설정된 칼럼에 입력됩니다.

발신 제목

  • 제목 칼럼 명이 설정되어 있지 않은 경우, title값의 내용이 모든 사용자에게 동일하게 발신됩니다.
  • 제목 칼럼 명이 설정되어 있을 경우, 치환기능을 사용하지 않는다면 title값은 무시됩니다.
  • 치환기능을 사용 시, title값이 사용자 별로 치환되어 해당 제목 칼럼 명으로 설정된 칼럼에 입력됩니다.
Type:
  • string
Example
var title = this.ezEmail.title;
this.ezEmail.title = "알려드립니다.";

(static, readonly) LOG_KEY :string

Description:
  • 로깅용 키

로깅용 키

Type:
  • string

Methods

getFileDataset() → {nexacro.Dataset}

Description:
  • 바인딩된 첨부파일 정보 데이터셋을 가져옴

Example
var ds = this.ezEmail.getFileDataset();
Returns:

첨부파일 정보 데이터셋

Type
nexacro.Dataset

getOutDataset() → {nexacro.Dataset}

Description:
  • 설정된 발신 결과 수신용 데이터셋을 가져옴

Example
var ds = this.ezEmail.getOutDataset();
Returns:

발신 결과 수신용 데이터셋

Type
nexacro.Dataset
Description:
  • 현재 설정된 정보를 이용해 Email 발신용 팝업을 호출합니다.

Example
this.ezEmail.popup({ USER_ID:"사용자ID" }, this);
Parameters:
Name Type Attributes Description
columnMap Object <optional>

치환문자 정보 JSON
치환문자리스트에서 칼럼명 대신 표시할 정보, { 칼럼명: 표시명 } 형태

form Object <optional>

팝업 호출시 this값
미입력시, EzEmail의 parent form이 사용됩니다.

push(formopt)

Description:
  • 현재 설정된 정보를 이용해 Email발신등록을 처리합니다.

Example
this.ezEmail.push(this);
Parameters:
Name Type Attributes Description
form Object <optional>

팝업 호출시 this값(미입력시, EzEmail의 parent form)

setFileDataset(ds)

Description:
  • 첨부파일 정보 데이터셋 설정

    nexacro.EzFile로 관리되는 데이터셋이어야합니다.

Example
this.ezEmail.setFileDataset(this.ds_file);
Parameters:
Name Type Description
ds nexacro.Dataset

첨부파일 정보 데이터셋

setOutDataset(ds)

Description:
  • 발신 결과 수신용 데이터셋 설정

Example
this.ezEmail.setOutDataset(this.ds_test);
Parameters:
Name Type Description
ds nexacro.Dataset

발신 결과 수신용 데이터셋

setPopupOption(popInfo)

Description:
  • 팝업 호출 정보 설정, 정보는 여기를 참조

Example
this.ezEmail.setPopupOption({
	 id: "test",
  url: "FORM::COMP/test.xfdl",
});
Parameters:
Name Type Description
popInfo Object

팝업 호출 정보

setPopupParam()

Description:
  • 팝업 호출시 파라미터 값 설정

Example
this.ezEmail.set_popupParam({
  code: "0001",
});

set_contents(contents)

Description:
  • 발신 내용 설정

    • 발신내용 칼럼 명이 설정되어 있지 않은 경우, contents값의 내용이 모든 사용자에게 동일하게 발신됩니다.
    • 발신내용 칼럼 명이 설정되어 있을 경우, 치환기능을 사용하지 않는다면 contents값은 무시됩니다.
    • 치환기능을 사용 시, contents값이 사용자 별로 치환되어 해당 제목 칼럼 명으로 설정된 칼럼에 입력됩니다.
Example
this.ezEmail.set_contents("정기 결산 알림...");
Parameters:
Name Type Description
contents string

발신 내용

set_contentsColumn(contentsColumn)

Description:
  • 내용 칼럼명 설정

    • 내용 칼럼명을 설정할 경우 치환기능을 사용하지 않는다면 contents값은 무시됩니다.
    • 내용 칼럼명과 함께 치환기능을 사용 시 contents의 값이 치환되어 해당 칼럼에 입력됩니다.
Example
this.ezEmail.set_contentsColumn("CONTENTS");
Parameters:
Name Type Description
contentsColumn string

내용 칼럼명

set_encoding(encoding)

Description:
  • 실제 Email 문자 인코딩 설정

Example
this.ezEmail.set_encoding("UTF-8");
Parameters:
Name Type Description
encoding string

실제 Email 문자 인코딩

set_popupOption(popupOption)

Description:
  • 팝업 호출 정보 설정

    문자열 대신 Object 사용시에는 setPopupOption을 사용하세요

Example
this.ezEmail.set_popupOption('{ "id": "test", "url": "FORM::COMP/test.xfdl" }');
Parameters:
Name Type Description
popupOption string

팝업 호출 정보, 양식은 여기를 참조

set_popupParam(popupParam)

Description:
  • 팝업 호출시 arg값(추가파라미터) 설정
    문자열 대신 Object 사용시에는 setPopupParam을 사용하세요

Example
this.ezEmail.set_popupParam('{ "code": "0001" }');
Parameters:
Name Type Description
popupParam string

팝업 호출시 arg값(추가파라미터)

set_senderEmail(senderEmail)

Description:
  • 발신자 Email 설정

Example
this.ezEmail.set_senderEmail("dltmdrkq2@gmail.com");
Parameters:
Name Type Description
senderEmail string

발신자 Email

set_senderId(senderId)

Description:
  • 발신자 ID 설정

Example
this.ezEmail.set_senderId("cm01");
Parameters:
Name Type Description
senderId string

발신자 ID

set_senderName(senderName)

Description:
  • 발신자 명 설정

Example
this.ezEmail.set_senderName("이승갑");
Parameters:
Name Type Description
senderName string

발신자 명

set_serverUrl(serverUrl)

Description:
  • EMail 발신 용 컨트롤러 호출 URL 설정

Example
this.ezEmail.set_serverUrl("http://loacalhost:8080/email/");
Parameters:
Name Type Description
serverUrl string

EMail 발신 용 컨트롤러 호출 URL

set_substitution(substitution)

Description:
  • 치환기능 사용여부 설정

    • title, titleColumn property값이 모두 있을 경우 title의 내용을 치환해 titleColumn에 해당하는 칼럼에 입력됨
    • contents, contentsColumn property값이 모두 있을 경우 contents의 내용을 치환해 contentsColumn에 해당하는 칼럼에 입력됨
Example
this.ezEmail.set_substitution(true); 
Parameters:
Name Type Description
substitution boolean

치환기능 사용여부

set_template(template)

Description:
  • 발신 탬플릿 경로 설정

Example
this.ezEmail.set_template("ezEmail/emailForm_default.vm"); 
Parameters:
Name Type Description
template string

발신 탬플릿 경로값

set_titleColumn()

Description:
  • 제목 칼럼명

    • 제목 칼럼명을 설정할 경우 치환기능을 사용하지 않는다면 title값은 무시됩니다.
    • 제목 칼럼명과 함께 치환기능을 사용 시 title의 값이 치환되어 해당 칼럼에 입력됩니다.
Example
this.ezEmail.set_titleColumn("TITLE");