# getSaveString (method)

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

### Syntax

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

### 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` 검사를 통과하지 못할 시 alert 메세지 표시 여부(`default: 0(false)`)
saveAttr | `string` | 선택 | 각 셀의 속성값을 같이 추출하고자 하는 경우 Name+속성명 형식으로 설정 여러개 속성을 추출하고자 하는 경우 ","를 구분자로 작성 ex) `"sNameColor,sNoCanEdit"`

### 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

- getSaveJson method
- acceptChangedData method
- Required col

### Since

product | version | desc
--- | --- | ---
core | 8.0.0.0 | 기능 추가
core | 8.0.0.4 | saveAttr 기능 추가