getSaveString (method)

시트 내에 변경된 내용(입력(Added), 수정(Changed), 삭제(Deleted), 이동(Moved))을 querystring 형식의 문자열로 추출합니다.

Syntax

string getSaveString( saveMode, col, urlEncode, delim, queryMode, validRequired, prefix, showAlert, saveAttr, saveExtraAttr );

Parameters

Name Type Required Description
saveMode number 선택 상태별 데이터 추출 여부
0 : 전체데이터
1 : 전체데이터 중 Deleted 만 제외
2 : 수정된 데이터(Added,Changed,Deleted)) (default)
3 : 수정된 데이터(Added,Changed,Deleted)+이동한 데이터(Moved)
col string 선택 저장 기준 열의 열이름
특정 열을 지정하면 행의 상태(Added,Changed,Deleted)를 무시하고 지정한 열의 데이터 유무에 따라 저장됨.
urlEncode boolean 선택 조합되는 문자열의 인코딩 여부(encodeURIComponent로 문자열을 인코딩함 )
delim string 선택 queryMode값이 2인 경우에 데이터 사이 구분자 지정 (default : "|")
queryMode number 선택 서버로 전달될 데이터 구조 설정 (default:1)
1:QueryString 구조 전달
ex)
'STATUS=Added&ColName1=홍길동&ColName2=25&STATUS=Changed&ColName1=심청&ColName2=18'

2:열데이터 기준 QueryString 구조 전달
ex)
'STATUS=Added|Changed&ColName1=홍길동|심청&ColName2=25|18'
validRequired boolean 선택 데이터 필수 입력 항목(Required col 설정된 열)에 대한 검사 여부

Validation결과가 실패인 경우 규격
1. Validation 오류인 경우
- Code: IBS010, Message: RequiredError
prefix string 선택 열의 이름 앞에 설정할 문자열
여러개 시트를 한번에 서버로 보낼때 시트id_colName 형식으로 보낼 수 있음
ex) sheet_saName=홍길동&sheet_saId=839212 식으로 queryString이 만들어짐
(default : "")
showAlert boolean 선택 validRequired 검사를 통과하지 못할 시 메세지 표시 여부(default: 0(false))
테이블
경고창
saveAttr string 선택 각 셀의 속성값을 같이 추출하고자 하는 경우 Name+속성명 형식으로 설정
여러개 속성을 추출하고자 하는 경우 ","를 구분자로 작성
ex) "sNameColor,sNoCanEdit"
saveExtraAttr boolean 선택 시트에 (col)Name으로 정의하지 않은 데이터가 doSearchloadSearchData함수를 통해 로드 된 경우, 함수 호출시 해당 데이터를 같이 추출할 지 여부. (default: 0(false))
로드 데이터 첫번째 행의 keyset을 기준으로 추출됨

Return Value

querystring 형식의 string

# 정상 처리시
"sa_name=홍길동&sa_id=02712&sa_dept=031&..."

# validRequired에 의한 오류 발생시
"RequiredError|IBS010|오류발생 행 id|오류발생 열 Name"

Example

// 열이름이 CHK인 열에 체크된 데이터만 추출한다.
// 데이터를 추출하면서 AA 컬럼에 Checked 속성도 추출한다.
var saveStr = sheet.getSaveString({col:"CHK",saveAttr:"AAChecked"});
$.ajax({
    url:"sheetSaveWorx.do",
    data:saveStr,
    success:function(data){
        // 저장성공시 처리
        sheet.acceptChangedData();
    }
})

Read More

Since

product version desc
core 8.0.0.0 기능 추가
core 8.0.0.4 saveAttr 기능 추가
core 8.1.0.32 saveExtraAttr 기능 추가