getSaveJson (method)

시트 내에 변경된 내용(입력(Added), 수정(Changed), 삭제(Deleted), 이동(Moved))을 JSON 형식의 객체로 추출합니다.
추출한 데이터는 서버로 전송 후, 결과를 acceptChangedData 또는 applySaveResult를 이용해 직접 시트에 반영해야 합니다.
서버 응답(JSON) 구조와 관련된 상세 내용은 dataStructure를 참고하세요.

Syntax

object getSaveJson( saveMode, col, validRequired, showAlert, saveAttr, useLevel, formData, saveExtraAttr, rows, validSize, validEditMask, validResultMask );

Parameters

getSaveJson 호출 시 validRequired, rows, validSize, validEditMask, validResultMask 속성을 설정한 경우
해당 옵션에 대한 유효성 검사(Validation)가 수행되며, 검사 결과에 따라 다음과 같은 코드(Code)와 메시지(Message)가 반환됩니다.

Return Value

json 형식의 object

// 정상적인 처리시
{
    "data":[
        {"id":"AR1","ColName1":"12345","ColName2":"ABCDE" ...},
        {"id":"AR4","ColName1":"76411","ColName2":"HIJKL" ...},
        ...
    ]
}

// validRequired 오류시
{
    "Message":"RequiredError",
    "Code":"IB010",
    "row":오류 발생 행 객체,
    "col":오류 발생 열 Name,
    "data":[]
}

// rows에 입력한 행 객체가 유효하지 않을 경우 
{
    "Message":"InvalidRows",
    "Code":"IB020",
    "data":[]
}

Example

// 각 컬럼에 수정된 데이터와 DESC 컬럼의 Color 속성값을 추출한다.
var saveJson = sheet.getSaveJson({saveMode:2, saveAttr:"DESCColor"});
$.ajax({
        type: 'post'
        ,async: true
        ,dataType: 'json'
        ,headers: {"X-Requested-With":"XMLHttpRequest"}
        ,contentType: "application/json; charset=utf-8"
        ,url: "/xgs/manage/sys/sawonTelSave.do"
        ,data: JSON.stringify(saveJson)
        , success: function(data) {
            // 저장 결과 반영
            sheet.acceptChangedData();
        }
        , error: function(data, status, err) {
            alert('서버와의 통신이 실패했습니다.');
        }
});

Read More

• acceptChangedData method
• applySaveResult method
• doSave method
• getSaveString method
• Required col
• ValidateMessage cfg
• ValidCheck cfg

Since