# UseExtraObjectData (cfg)

> 조회 된 데이터에 시트에 설정한 열이 아닌 추가적인 `object` 형태의 정보가 있을 때 행 객체에 `object` 형태 그대로 저장합니다.

> object의 `key`가 시트의 설정된 열의 Name과 동일한 경우에는 적용되지 않습니다.

> 따라서 시트에 표시하고자 하는 데이터에서는 적용되지 않습니다.

### Type

`boolean`

### Options

Value | Description
--- | ---
`0(false)` | `object` 형태의 데이터가 열이름+속성명 형태로 행객체에 저장됩니다. (`default`)
`1(true)` | `object` 형태의 데이터가 형태를 유지한 채 행객체에 저장합니다.

### Example

    options = {
        Cfg: {
            UseExtraObjectData: true,
            // ...
        },
        Cols: [
            {
                Header: '문자열(Text)',
                Type: 'Text',
                Name: 'TextData',
                Width: 100,
                Align: 'Center',
                CanEdit: 1
            },
            {
                Header: '줄넘김문자열(Lines)',
                Type: 'Lines',
                Name: 'LinesData',
                MinWidth: 250,
                Align: 'Center',
                CanEdit: 1,
                RelWidth: 1
            }
        ]
    }

    // 조회 데이터
    var data = [{
      TextData: '장순연',
      LinesData: '전국이 대체로 흐리거나 구름많은 가운데 대기불안정으로 중부내륙은 아침과 오후 한때, 남부내륙은 오후 한때 소나기가 오는 곳이 있겠습니다.',
      ExtraInfo: { // 시트의 열로 설정되지 않은 추가적인 데이터
        AddedDate: '2022-01-24',
        ChagedDate: '2024-06-17'
      }
    }];

    var row = sheet.getFirstRow();
    var info = sheet.getRowValue({row: row, saveExtraAttr: 1}).ExtraInfo;
    // {AddedDate: '2022-01-24', ChagedDate: '2024-06-17'}

    var newInfo = {
      DeletedDate: '2024-09-13'
    };
    sheet.setValue(row, 'ExtraInfo', newInfo);

    sheet.getValue(row, 'ExtraInfo');
    // {DeletedDate: '2024-09-13'}

### Read More

- getRowValue method
- getValue method
- setValue method

### Since

product | version | desc
--- | --- | ---
core | 8.2.0.0 | 기능 추가