SMART datagrid :: getModifiedRowObjects

SMART datagrid v1.4 > Classes > GridDataSet

DataLudi.GridDataSet.getModifiedRowObjects method

DataRowState가 NONE이 아닌 변경된 행을 Json 객체 배열로 리턴한다.

function getModifiedRowObjects (states: String|[String], valueCallback: Function, stateProp: String, stateNames: Object|[String], emptyValue: *): [Object];

Returns: [Object]

Parameters

states - String|[String].

DataRowState 상태 목록. 상태 하나만 지정하거나 배열로 여러 상태를 지정한다. 지정하지 않으면 NONE이 아닌 모든 상태의 행들을 리턴한다.

valueCallback - Function.

원본 필드 값을 대체할 Callback 함수.

function (ds: GridDataSet, row: Integer, rowObj: Object);

stateProp - String. 기본값은 ""row_state"".

상태값을 지정하는 속성 이름. null 이나 undefined로 지정하면 기본값 "row_state"이 사용된다. 빈문자열이면 이 속성이 추가되지 않는다.

stateNames - Object|[String].

DataRowState 상수값들 대신할 상태 이름들. DataRowState를 모두 포함한 Json 객체나, "created", "updated", "deleted", "createAndDeleted" 순서대로 이름이 포함된 배열일 수 있다. "createAndDeleted"이 설정되지 않으면 "deleted" 값으로 지정된다.

emptyValue - *.

undefined 필드 값들을 대체하는 값.
(undefined 필드가 객체 속성일 때 JSON.stringify에 포함되지 않는다.)

Code -1

    // 상태가 NONE이 아닌 모든 행들을 가져온다.
    var rows = ds.getModifiedRowObjects();
    // or
    var rows = ds.getModifiedRowObjects(null);

Code -2

    // 상태가 created인 행들을 가져온다.
    var rows = ds.getModifiedRowObjects(DataLudi.DataRowState.CREATED);

Code -3

    // 상태가 created, deleted인 행들을 가져온다.
    var rows = ds.getModifiedRowObjects([DataLudi.DataRowState.CREATED, DataLudi.DataRowState.DELETED]);

Code -4

    // 리턴되는 행들의 값을 필요에 따라 변경하거나 추가할 수 있다.
    var rows = ds.getModifiedRowObjects(null, function (ds, row, rowObject) {
        // 기존 값을 변경하거나
        rowObject["Addr"] += '_X';
        // 새 속성을 추가한다.
        rowObject["row_id"] = row + 1;
    });

Code -5

    // 상태 속성 이름을 "row_state" 대신 다른 이름으로, 상태 값들도 다르게 지정할 수 있다.
    var rows = ds.getModifiedRowObjects(null, null, '_state', ['c', 'u', 'd']);

Code -6

    // undefined인 속성 값을 다른 값으로 지정한다. undefined인 속성 값은 JSON.stringify()에서 빠진다.
    var rows = ds.getModifiedRowObjects(null, null, null, null, '');

See Also: DataRowState; getRowState; getRowObject; getRowObjects; getRow; getRows; JSON.stringify

Examples: DataRow States; GridDataSet Rows