attribute+Formula (col)

컬럼에 설정해 셀별로 배경색(Color), 편집 가능 여부(CanEdit), 텍스트 색(TextColor) 등의 속성을 조건에 따라 다르게 적용할 때 이용합니다.
CanFormula가 1로 설정되어야 동작하며, CalcOrder에 열이름+속성명 형식으로 정의해야 합니다.
컬럼에 설정하지만 셀 단위로 실행되므로, 도움말 properties → Cell 카테고리에 정의된 셀 단위 속성만 속성명Formula 형식으로 사용할 수 있습니다.

Type

mixed( function | string )

Options

Parameters

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

string 형식 — 식 내 예약어

주의 사항

• CanFormula를 설정하지 않으면 Formula가 동작하지 않습니다.
• 속성(attribute+Formula)는 CalcOrder가 항상 필요합니다.
• CalcOrder에 열이름이 빠지면 인식되지 않습니다. "Color,CanEdit"처럼 속성명만 적지 말고 "yearSumColor,rateCanEdit"처럼 열이름+속성명으로 적어야 합니다.
• CalcOrder 항목 사이에 공백이 들어가도 인식되지 않습니다. "yearSumColor, rateCanEdit"가 아니라 "yearSumColor,rateCanEdit".
• TypeFormula로 Type을 전환할 때는 새 Type이 요구하는 형식 속성(Format, EditFormat, DataFormat 등)과 원본 데이터 값도 함께 변환해야 합니다.

Example

options.Def.Row = {
    CanFormula: 1,
    // col attr+Formula의 CalcOrder는 "열이름+속성명" 형식, 항목 사이에 공백 없이
    CalcOrder: "yearSumColor,rateCanEdit"
};

options.Cols = [
    {Type: "Bool", Name: "CHK"},

    // string 형식 — Value 예약어로 자신의 셀 값 참조
    {Type: "Int", Name: "yearSum",
        ColorFormula: "Value > 100 ? '#FF0000' : '#FFFFAA'"
    },

    // function 형식 — fr 인자로 행 데이터 접근
    {Type: "Float", Name: "rate",
        CanEditFormula: function(fr) {
            return fr.Row["CHK"] == 1 && fr.Row["yearSum"] > 150;
        }
    }
];

TypeFormula — 셀별로 Type 동적 전환

TypeFormula는 셀 값에 따라 컬럼의 Type을 셀 단위로 바꿉니다. CalcOrder에는 열이름+Type 형식(예: "AmountType")으로 등록하며, Type을 바꿀 때는 그 Type이 필요로 하는 형식 속성(Format/Enum/DataFormat 등)과 값도 함께 지정해야 합니다.

// (1) 값에 따라 Int/Float 로 전환 (숫자 Type + Format 지정)
{Header: "금액", Type: "Text", Name: "Amount",
  TypeFormula: function (fr) {
    if (fr.Row["Currency"] === "KRW") { fr.Row["AmountFormat"] = "₩ #,##0";    return "Int"; }
    if (fr.Row["Currency"] === "USD") { fr.Row["AmountFormat"] = "$ #,##0.00"; return "Float"; }
  }
}

// (2) Enum 으로 전환 (Enum/EnumKeys 속성을 함께 지정)
{Header: "결과", Type: "Text", Name: "Result",
  TypeFormula: function (fr) {
    if (fr.Row["ExamItem"] === "COL") {
      fr.Row["ResultEnum"]     = "|정상|적록색맹|청황색맹";
      fr.Row["ResultEnumKeys"] = "|N|RG|BY";
      return "Enum";
    }
    return "Text";
  }
}

// (3) Date 로 전환 (Format 3종 지정 + 값을 timestamp 로 변환)
{Header: "결과", Type: "Text", Name: "ResultData",
  TypeFormula: function (fr) {
    if (fr.Row["fieldName"] !== "날짜") return "Text";
    var s = fr.Row["ResultData"] + "";
    if (s.length === 8) fr.Row["ResultData"] = IBSheet.stringToDate(s, "yyyyMMdd").getTime();
    fr.Row["ResultDataFormat"]     = "yyyy/MM/dd";
    fr.Row["ResultDataEditFormat"] = "yyyyMMdd";
    fr.Row["ResultDataDataFormat"] = "yyyyMMdd";
    return "Date";
  }
}

// (4) Bool 을 Text 로 전환 (1/0 값을 표시용 라벨로)
{Header: "상태", Type: "Bool", Name: "ActiveFlag",
  TypeFormula: function (fr) {
    fr.Row[fr.Col] = fr.Row[fr.Col] ? "활성" : "비활성";
    return "Text";
  }
}

각 컬럼의 CalcOrder는 Def.Row.CalcOrder에 "AmountType", "ResultType"처럼 열이름+Type으로 등록합니다.

Try it

• Demo of attribute+Formula (기본 — 셀별 색상, 편집 가능 여부 적용)
• Demo of attribute+Formula (TypeFormula — 셀별 숫자 포맷 변경)
• Demo of attribute+Formula (TypeFormula — 셀별 enum 항목 적용)
• Demo of attribute+Formula (TypeFormula — 셀별 날짜 적용)
• Demo of attribute+Formula (TypeFormula — 셀별 체크박스를 텍스트로 변환)

Read More

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

Since