트리 구조에서 특정 행의 조상 행들(직접 부모, 그 부모, 루트까지)을 배열로 반환합니다.
배열의 첫 번째([0])는 가장 가까운 부모이고, 마지막은 최상위 루트 행입니다.
최상위 행에서 호출하면 빈 배열을 반환합니다.
array getParentRows( row );
| Name | Type | Required | Description |
|---|---|---|---|
| row | object |
필수 | 기준이 되는 데이터 로우 객체 |
array[row object] : 조상 행 배열 (직접 부모부터 루트까지). 최상위 행이면 []
트리 구조:
본부장 (L0, 루트) ← parents[2]
└─ 팀장A (L1) ← parents[1]
└─ 사원1 (L2) ← parents[0] (직접 부모)
└─ 인턴1 (L3) ← 기준 행 (getParentRows 호출 대상)
// 가장 깊은 행(인턴1)에서 getParentRows 호출
var internRow = sheet.getRowById("AR4"); // 인턴1 행
var parents = sheet.getParentRows(internRow);
// 결과 배열 — 직접 부모(가까운 순)부터 루트까지 정렬
console.log(parents.length); // 3
console.log(parents[0].Dept); // "사원1" ← 인턴1의 직접 부모
console.log(parents[1].Dept); // "팀장A" ← 그 위
console.log(parents[2].Dept); // "본부장" ← 루트 (최상위)
// 직접 부모만 필요한 경우
var directParent = parents[0];
// 루트(최상위) 부모만 필요한 경우
var rootParent = parents[parents.length - 1];
// 최상위 행(본부장)에서 호출 시 빈 배열
sheet.getParentRows(sheet.getFirstRow()); // []
| product | version | desc |
|---|---|---|
| core | 8.0.0.0 | 기능 추가 |