getSaveString (method)

시트 내에 변경된 내용(입력(Added), 수정(Changed), 삭제(Deleted), 이동(Moved))을 querystring 형식의 문자열로 추출합니다.
추출한 데이터는 서버로 전송 후, 결과를 acceptChangedData 또는 applySaveResult를 이용해 직접 시트에 반영해야 합니다.
서버 응답 구조와 관련된 상세 내용은 저장 응답 규격을 참고하세요.
JSON 형식 결과는 getSaveJson, ajax 통신과 결과 반영을 자동 처리하려면 doSave를 사용하세요.

Syntax

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

Parameters

정상적으로 데이터를 추출하지 못한 경우 다음 표와 같은 결과가 반환됩니다.

Return Value

String

// 정상적인 처리시(querystring 형태)
"sa_name=홍길동&sa_id=02712&sa_dept=031&..."

// 저장(Added, Changed, Deleted) 대상이 없는 경우
""

// validRequired 설정 시 Validation 오류인 경우  
"RequiredError|IBS010|오류발생 행 id|오류발생 열 Name"

Example

// 수정 데이터 추출 + 유효성 검사
// showAlert:1 → 검사 실패 시 메시지 표시 + 오류 셀 자동 포커스
var saveStr = sheet.getSaveString({
    validRequired: 1,
    validSize: 1,
    validEditMask: 1,
    showAlert: 1
});

// 빈 문자열 → 저장 대상 없음 (showAlert 무관, 사용자에게 별도 안내 필요)
if (saveStr === "") {
    alert("변경사항이 없습니다.");
    return;
}

// 검증 실패 → "Error|IBS...." 형식 (showAlert:1이라 메시지/포커스는 IBSheet가 자동 처리)
if (saveStr.indexOf("Error|") > -1) return;

$.ajax({
    type: 'post',
    url: "sheetSaveWorx.do",
    data: saveStr,
    success: function(data) {
        // applySaveResult가 IO.Result에 따라 분기 처리 (성공 시 상태 클리어, 실패 시 메시지)
        sheet.applySaveResult(data.IO.Result, data.IO.Message);
    },
    error: function(data, status, err) {
        alert('서버와의 통신이 실패했습니다.');
    }
});

// showAlert 미사용 — 검증 실패 시 결과 문자열을 직접 파싱하는 패턴
var saveStr = sheet.getSaveString({
    validRequired: 1,
    validSize: 1,
    validEditMask: 1
    // showAlert 생략 (default 0) → 사용자가 직접 처리
});

if (saveStr === "") {
    alert("변경사항이 없습니다.");
    return;
}

// "Message|Code|행id|열명" 형식 파싱
if (saveStr.indexOf("Error|") > -1) {
    var parts = saveStr.split("|");
    var message = parts[0];   // 예: "RequiredError"
    var rowId   = parts[2];   // 예: "AR3"
    var colName = parts[3];   // 예: "sa_name"

    alert(message);                                // 또는 커스텀 메시지/UI
    sheet.focus(sheet.getRowById(rowId), colName);
    return;
}

$.ajax({ /* ... */ });

Read More

• 저장 응답 규격
• Required col
• FormatFix col
• acceptChangedData method
• applySaveResult method
• doSave method
• getSaveJson method
• getChangedData method
• onValidation event
• SuppressMessage cfg
• ValidCheck cfg
• ValidateMessage cfg

Since