Formula (col)

엑셀 수식과 유사한 기능입니다.
컬럼에 수식을 설정하면 다른 셀 값이나 함수를 활용해 모든 행의 셀 값을 자동 계산합니다.
조회 시, 관련 컬럼 값 편집 시, calculate 호출 시 재계산됩니다.
Formula를 설정한 컬럼은 자동으로 편집 불가 상태가 됩니다.
Formula 안에서 자기 자신의 컬럼 값을 참조하면 무한루프에 빠질 수 있으므로 권장하지 않습니다.
셀 속성(편집 제어, 색상 등)을 수식으로 설정하려면 attribute+Formula (col), attribute+Formula (row)를 참고하세요.
CanFormula가 1로 설정되어야 동작하며, 컬럼 간 의존 순서가 있거나 attribute+Formula와 함께 사용할 때는 CalcOrder를 정의해야 합니다.

Type

mixed( function | string )

Options

Parameters

function 형식 — 함수 인자 fr의 속성

string 형식 — 식 내 예약어

외부 함수 호출 (function 형식): Formula: 함수명 (첫 번째 인자로 fr 객체 자동 전달).
외부 함수 호출 (string 형식): Formula: "함수명(Sheet, Row, Col, Value)"처럼 사용자가 호출 식을 직접 작성 (괄호 안 인자는 예약어, 컬럼명에서 자유롭게 선택).

주의 사항

• CanFormula를 설정하지 않으면 Formula가 동작하지 않습니다.
• 컬럼 간 의존 순서가 있거나 attribute+Formula와 함께 사용할 때 CalcOrder가 없으면 동작하지 않거나 잘못된 값이 반환될 수 있습니다.
• CalcOrder 항목 사이에 공백이 들어가면 인식되지 않습니다. "a, b, c"가 아니라 "a,b,c".
• IB_Preset.TreeSumFormula 등 ibsheet-common.js가 제공하는 함수도 Formula 기능이므로 CanFormula와 CalcOrder가 동일하게 필요합니다.
• 조회 데이터에 빈 문자열(""), null, undefined가 섞여 있는 경우 function 형식 Formula는 NaN이나 문자열 결합이 발생할 수 있습니다.

Example

options.Def.Row = {CanFormula: 1, CalcOrder: "yearSum,total,result"};
options.Cols = [
    {Type: "Int",   Name: "qt1"},
    {Type: "Int",   Name: "qt2"},

    // string 형식 — 식에 컬럼명을 그대로 사용
    {Type: "Int",   Name: "yearSum", Formula: "qt1 + qt2"},

    {Type: "Float", Name: "rate"},

    // function 형식 — fr 인자로 행/시트 정보 접근
    {Type: "Float", Name: "total",
        Formula: function(fr) {
            return fr.Row["yearSum"] * fr.Row["rate"];
        }
    },

    // Type에 맞는 값을 return — 여기서는 Text Type이므로 문자열 반환
    {Type: "Text", Name: "result",
        Formula: function(fr) {
            return fr.Row["total"] >= 100 ? "달성" : "미달";
        }
    }
];

// X — 자기 자신을 참조하면 무한루프
{Type: "Int", Name: "yearSum",
    Formula: function(fr) {
        return fr.Row["yearSum"] + fr.Row["qt2"]; // yearSum이 바뀌면 다시 Formula 실행 → 무한루프
    }
}

Tree Example

트리 구조 시트에서는 ibsheet-common.js가 제공하는 IB_Preset.*Formula 프리셋(TreeSumFormula, TreeAvgFormula, TreeCountFormula, TreeMaxFormula, TreeMinFormula)이나 커스텀 함수로 부모 행에 자식 행 집계 결과를 표시할 수 있습니다.
IB_Preset.*Formula도 Formula 기능이므로 Def.Row.CanFormula:1 설정이 동일하게 필요하며, 트리 시트로 동작하려면 Cfg.MainCol 설정도 필요합니다 (Read More 참고).

{Header:"합계", Type:"Int", Name:"sum", Formula: IB_Preset.TreeSumFormula}

상태가 삭제(Row.Deleted)인 행을 제외하고 자식 행 합계를 계산해야 할 때는 커스텀 함수로 처리합니다.
트리의 leaf 행(자식이 없는 말단 행)은 사용자가 직접 값을 입력해야 하므로 자기 자신의 CanEdit을 켜줍니다.

{Type: "Int", Name: "sumEx",
    Formula: function(fr) {
        if (fr.Row.childNodes.length) {                              // 자식이 있으면 부모 행
            var sum = 0;
            for (var r = fr.Row.firstChild; r; r = r.nextSibling) {  // 직계 자식 순회
                if (!r.Deleted) sum += (r[fr.Col] || 0);             // 삭제 상태인 행 제외
            }
            return sum;
        } else {                                                      // leaf 행
            fr.Row[fr.Col + "CanEdit"] = 1;
            return fr.Row[fr.Col];
        }
    }
}

// 더 다양한 패턴은 아래 Try it 데모 참고

Try it

• Demo of Formula
• Demo of Tree Formula (부서별 실적 집계)

Read More

• CanFormula row
• CalcOrder row
• attribute+Formula col
• attribute+Formula row
• MainCol cfg
• calculate method
• recalculate method
• recalculateRows method

Since