데이터 규격 (data structure)

조회 작업 시 서버에서 반환되는 조회 응답 규격의 형식을 정의합니다.

시트 생성시 데이터 형식

//IBSheet.create()에 data 속성을 통해 생성시 데이터 구조
IBSheet.create({
    id:"sheet", // 생성할 시트의 id
    el:"sheetDiv", // 시트를 생성할 Dom 객체 및 id
    options: options, // 생성될 시트의 속성
    // 생성될 시트의 데이터
    data: [
            {"sa_name":"홍길동","sa_no":"940154","sa_dept":"A021"},
            {"sa_name":"김지수","sa_no":"950757","sa_dept":"B022"}
        ]
});

기본 데이터 규격

• doSearch 함수 또는 loadSearchData 함수에서 데이터 바인딩 시 사용되는 데이터 구조입니다.
• 서버 응답 데이터는 Data 속성을 최상위로 가지고 있으며, Data 속성 안에는 각각의 항목이 객체 형태로 들어 있는 배열이 포함되어 있습니다.

// Data 속성안에 배열형태로 데이터 구성
{"Data":
    [
        {"sa_name":"홍길동","sa_no":"940154","sa_dept":"A021"},
        {"sa_name":"김지수","sa_no":"950757","sa_dept":"B022"}
    ]
}

조회 데이터 내에 Row property,Cell property 적용(중요)

• 각 데이터 행(Row)에 편집 가능 여부, 색상 등 속성을 지정할 수 있으며, 이 속성을 기준으로 원하는 데이터를 조회할 수 있습니다.
• 데이터 행(Row)에 적용할 수 있는 속성값은 도움말의 Properties >> Row 에서 확인할 수 있습니다.

// 조회 데이터 안에 Row property에 해당하는 내용을 데이터와 함께 적용
{"Data":
    [
        //1행의 색상을 붉은색으로 표시
        {"sa_name":"홍길동","sa_no":"940154",...      , Color:"#FF8888"},
        //2행을 편집 불가로 설정
        {"sa_name":"김지수","sa_no":"950757",...      , CanEdit:0}
    ]
}

• 각 데이터 셀(Cell)에 편집 가능 여부, 색상 등 속성을 지정할 수 있으며, 이 속성을 기준으로 원하는 데이터를 조회할 수 있습니다.
• 셀(Cell)에 적용할 수 있는 속성값은 도움말의 Properties >> Cell 에서 확인할 수 있습니다.

// 조회 데이터 안에 "컬럼명+Cell Property" 형식으로 설정시 Cell 기능 부여
{"Data":
    [
        //1행의  sn_id cell에 글자색 설정
        {"sn_id":"209321","lot":"k0923123",  sn_idTextColor:"#FF0000"},
        //2행의 lot cell에 편집 불가
        {"sn_id":"209327","lot":"r2019283",   lotCanEdit:0},
        //3행의  pos 컬럼(Enum타입)에 item을 해당 셀만 다르게 설정
        {"pos":"A02", posEnum: "|성남시|부천시|광명시|화성시", posEnumKeys: "|A00|A01|A02|A03"}
    ]
}

조회 데이터 내에 JSON Event 적용

• 각 데이터 셀(Cell)에 이벤트를 설정할 수 있으며, 이 속성을 기준으로 원하는 데이터를 조회할 수 있습니다.
• 셀(Cell)에 적용할 수 있는 이벤트는 도움말의 Properties >> Event 에서 확인할 수 있습니다.

// 조회 데이터에 JSON 이벤트를 포함할수 있습니다.
{"Data":
    [
        //1행의 sa_name컬럼의 값 수정시 sawonPop() 함수 호출
        {"sa_name":"홍길동",sa_nameOnChange:"sawonPop"},
        //2행은 이벤트 없음
        {"sa_name":"홍길동"}
    ],
}

서버에서 반환된 조회 데이터는 onReceiveData, onBeforeDataLoad, onDataLoad 이벤트를 통해 확인할 수 있습니다.

데이터와 결과 규격

• 서버 응답에 IO 속성이 포함된 경우, 조회 처리 과정에서 onBeforeDataLoad와 onDataLoad이벤트의 파라미터로 result와 message가 전달됩니다.
• Result 값은 조회 성공/실패 여부를 판단하는 기준으로 사용되며, 0 이상의 값은 정상 조회, 0보다 작은 음수 값은 조회 중 오류로 처리됩니다.
• Message 값은 Result에 대한 설명 메시지입니다.
• 조회 결과가 정상(Result >= 0)인 경우, 기본적으로 화면에는 표시되지 않습니다.
  정상 조회 시 메시지를 표시하고 싶으면 onDataLoad이벤트 등에서 직접 처리할 수 있습니다.
• 조회 결과가 에러(Result < 0)인 경우, IBSheet에서 자동으로 에러 메시지를 표시합니다.

// Data 속성안에 배열형태로 데이터 구성
{"Data":
    [
        {"sa_name":"홍길동","sa_no":"940154","sa_dept":"A021"},
        {"sa_name":"김지수","sa_no":"950757","sa_dept":"B022"}
    ],
  "IO": {"Result": 0, "Message": "조회 성공"}
}

Read More

• doSearch method
• loadSearchData method
• getChangedData method
• onReceiveData
• onBeforeDataLoad
• onDataLoad

Since