$f

// 기본 템플릿 사용 방식
$f.checkDuplicateRows(this.ds_main, "PK1,PK2", "메시지 텍스트");

// 커스텀 템플릿 방식
$f.checkDuplicateRows(
    this.ds_main,
    "PK1,PK2",
    (row1, row2) => `Lines ${row1} and ${row2} are duplicated.`,
);

// 기본 처리
// 메뉴에 등록된 일정을 가지고 검사를 수행하며, 각 일정에 대하여 다음과 같이 동작합니다.
//
// 일정 범위 내:
// 메인 타이틀바의 모든 버튼을 활성화 합니다.
//
// 일정 범위 밖:
// 메인 타이틀바의 조회, 초기화 버튼을 제외한 버튼을 모두 비활성화 합니다.
$f.fn_checkScdul(this);

// 모든 인수
$f.checkScdul(this, {
    scdulCd: "ABC1234", // 일정 코드 (기본 값: 메뉴의 일정 코드)
    sno: this.div_search.form.sch_sno.value, // 학번
    enableDefaultAction: true, // 기본 컴포넌트 활성/비활성, 화면 종료 등의 액션을 사용합니다. false시 아무런 작업도 하지 않습니다.
    targetComponent: [
        this.getMainTitle().getButton("SEARCH"), // 대상 컴포넌트를 지정하면 set_enable 함수로 동작합니다.
        (b) => formObj.getMainTitle().set_useSaveButton(b), // 일정 여부를 인수로 갖는 함수입니다. 일정 여부에 따라 다른 옵션을 지정하는데 사용합니다.
    ], // 대상 컴포넌트 및 함수
    targetComponentOverride: false, // true로 설정 시 targetComponent를 기본 대상 컴포넌트로 덮어쓰며, false로 설정 시 병합합니다.
    isCloseOutOfScdul: false, // true로 설정 시 일정 검사 후 화면을 닫습니다.
});

// 리턴값 활용 예제
// 1. 일정 범위 내인 경우만 처리
const result = await $f.checkScdul(this);
if (result.scdulYn) {
    // 일정 범위 내 처리
    this.saveData();
}

// 2. 시작/종료 일시 활용
const result = await $f.checkScdul(this);
if (result.scdulYn) {
    this.div_info.form.sta_period.set_text(
        `${result.beginDtm} ~ ${result.endDtm}`,
    );
}

// 3. 메시지 직접 처리
const result = await $f.checkScdul(this, {
    enableDefaultAction: false,
});
if (!result.scdulYn) {
    await this.pop.warn(result.scdulMsg);
}

decodeHex("48656c6c6f"); // returns "Hello"

$f.filterRowsByCondition(this.ds_main, (context) => {
    return context.row % 2;
});

$f.findAncestorComponent(this, (ptr) => ptr instanceof nexacro.Form);

// Dataset의 각 행을 순회하며 name 컬럼의 값을 콘솔에 출력
$f.forEachDataset(this.ds_user, ({ rowData }) => {
    trace(rowData["NAME"]);
});

const uuid = generateUUIDv4();
console.log(uuid); // "110ec58a-a0f2-4ac4-8393-c866d813b8d1"

// 기본 사용법
$f.getDormCmb(this).init({
    div: [this.div_search],
    grid: [this.grd_main],
});

// 특정 조직 필터링
$f.getDormCmb(this).init({
    div: this.div_search,
    orgFilter: (ctx) => ctx.rowData["UNIV_CD"] === "03130000",
});

// 콤보 모드 설정
$f.getDormCmb(this).init({
    div: this.div_search,
    orgMode: {
        // 조직 콤보 모드
        fclt: "a", // 대학/대학원: '전체' 표시
        univ: "s", // 대학: '선택' 표시
        dpmj: "n", // 학과: 빈값 없음
        majr: "n", // 전공: 빈값 없음
        detMajr: "n", // 세부전공: 빈값 없음
    },
    smrMode: "a", // 학기 콤보: '전체' 표시
});

// 문자열로 모든 모드 일괄 설정
$f.getDormCmb(this).init({
    div: this.div_search,
    orgMode: "a", // 모든 조직 콤보에 '전체' 표시
    smrMode: "a", // 학기 콤보: '전체' 표시
});

// 그리드 콤보 모드 설정
$f.getDormCmb(this).init({
    grid: this.grd_main,
    orgGridMode: {
        // 그리드 조직 콤보 모드
        fclt: "s", // 대학/대학원: '선택' 표시
        univ: "s", // 대학: '선택' 표시
        dpmj: "n", // 학과: 빈값 없음
    },
    smrGridMode: "s", // 그리드 학기 콤보: '선택' 표시
});

// 바인딩 컴포넌트 대상 변경
$f.getDormCmb(this).init({
    div: this.div_search,
    targtCompNm: {
        // 컴포넌트 명 재정의
        yyCompNm: /^spn_aplyYy$/,
        smrCompNm: /^cmb_aplySmr$/,
        fcltCompNm: /^cmb_fcltDvcd$/,
        univCompNm: /^cmb_testUnivCd$/,
        dpmjCompNm: /^cmb_hakgwaCd$/,
        majrCompNm: /^cmb_majrCd$/,
        detMajrCompNm: /^cmb_detMajrCd$/,

        // 그리드 컬럼 명 재정의
        smrColNm: ["SMR", "GRDU_SMR"],
        fcltGridColNm: "FCLT_DVCD",
        univColNm: "CUSTOM_1",
        dpmjColNm: "CUSTOM_2",
        majrColNm: "CUSTOM_3",
        detMajrColNm: "detMajrColNm",
    },
});

// 기본 사용법
$f.getHCmb(this).init({
    div: [this.div_search],
    grid: [this.grd_main],
});

// 특정 조직 필터링
$f.getHCmb(this).init({
    div: this.div_search,
    orgFilter: (ctx) => ctx.rowData["UNIV_CD"] === "03130000",
});

// 콤보 모드 설정
$f.getHCmb(this).init({
    div: this.div_search,
    orgMode: {
        // 조직 콤보 모드
        fclt: "a", // 대학/대학원: '전체' 표시
        univ: "s", // 대학: '선택' 표시
        dpmj: "n", // 학과: 빈값 없음
        majr: "n", // 전공: 빈값 없음
        detMajr: "n", // 세부전공: 빈값 없음
    },
    smrMode: "a", // 학기 콤보: '전체' 표시
});

// 문자열로 모든 모드 일괄 설정
$f.getHCmb(this).init({
    div: this.div_search,
    orgMode: "a", // 모든 조직 콤보에 '전체' 표시
    smrMode: "a", // 학기 콤보: '전체' 표시
});

// 그리드 콤보 모드 설정
$f.getHCmb(this).init({
    grid: this.grd_main,
    orgGridMode: {
        // 그리드 조직 콤보 모드
        fclt: "s", // 대학/대학원: '선택' 표시
        univ: "s", // 대학: '선택' 표시
        dpmj: "n", // 학과: 빈값 없음
    },
    smrGridMode: "s", // 그리드 학기 콤보: '선택' 표시
});

// 바인딩 컴포넌트 대상 변경
$f.getHCmb(this).init({
    div: this.div_search,
    targtCompNm: {
        // 컴포넌트 명 재정의
        yyCompNm: /^spn_aplyYy$/,
        smrCompNm: /^cmb_aplySmr$/,
        fcltCompNm: /^cmb_fcltDvcd$/,
        univCompNm: /^cmb_testUnivCd$/,
        dpmjCompNm: /^cmb_hakgwaCd$/,
        majrCompNm: /^cmb_majrCd$/,
        detMajrCompNm: /^cmb_detMajrCd$/,

        // 그리드 컬럼 명 재정의
        smrColNm: ["SMR", "GRDU_SMR"],
        fcltGridColNm: "FCLT_DVCD",
        univColNm: "CUSTOM_1",
        dpmjColNm: "CUSTOM_2",
        majrColNm: "CUSTOM_3",
        detMajrColNm: "detMajrColNm",
    },
});

// 관리학과 기준으로 데이터 조회
$f.getHCmb(this).init({
    div: this.div_search,
    useMngtDpmj: true, // 관리학과 기준으로 조직 데이터 조회
});

// 기본 사용법
const comboManager = $f.getLinkedComboManager();

// DatasetRowTracer 인스턴스 생성 예제
let rowTracer = $f.getRowTracer(
    [this.ds_main, this.ds_sub],
    [
        ["YY", "SMR", "UNIV_CD"],
        ["YY", "SMR", "USER_ID"],
    ],
    true,
);
rowTracer.save(); //save에는 데이터셋 배열의 인덱스를 전달하여 특정 데이터셋의 행 정보만 저장할 수 있습니다.

await this.fn_searchListM();
rowTracer.select(); //save()에 인자를 전달하지 않았다면, 데이터셋 배열 개수만큼 select()를 호출해야합니다.

await this.fn_searchListD();
rowTracer.select(); //save()에 매개변수를 생략했을 경우, 전달된 데이터셋 배열 개수와 select() 호출 수가 같을 때 이벤트가  일괄적으로 켜집니다.

// 인스턴스 생성 시 데이터셋이 배열이지만, 하나의 데이터셋 행만 찾아가야 한다면,
// 인스턴스 생성 시 코드(배열)를 수정할 필요 없이 save()시 배열의 인덱스를 매개변수로 전달하면 됩니다.
// ex) rowTracer.save(0); 해당 배열의 0번 -> this.ds_main만 행을 찾고, 이벤트를 관리합니다.

// onload에서 1회 초기화 — 이후 fn_searchMain 호출 시 행 추적이 자동 적용됨
$f.initRowTracer(this, [
    {
        searchFn: "fn_searchMain",
        grid: this.grd_main,
        keys: ["SEQ", "SNO, NAME"],
        children: [
            {
                searchFn: "fn_searchSub",
                grid: this.grd_sub,
                keys: ["SEQ"],
            },
        ],
    },
]);

// 기존 호출 방식 그대로 사용
this.fn_searchMain();

// 모든 사용자 ID를 배열로 추출
const userIds = $f.mapDatasetToArray(
    this.ds_user,
    ({ rowData }) => rowData["ID"],
);

const args = $f.mkArg({
    $div: this.div_search,
    LITERAL_STRING: "TEST",
    COMPONENT: this.div_search.form.cmb_combo,
    COLUMN_NAME: this.ds_list, // nexacro.Dataset (현재 rowposition에서 'COLUMN_NAME' 컬럼의 값을 가져옴)
});

parseBool(true); // returns true
parseBool(false); // returns false

parseBool("true"); // returns true
parseBool("TRUE"); // returns true
parseBool("false"); // returns false

parseBool(1); // returns true
parseBool("1"); // returns true
parseBool(0); // returns false
parseBool("0"); // returns false

this.fn_cansave = function (obj, e) {
    this.delFuncPromise = $f.prepareFileDelete({
        dataset: this.ds_main,
        target: "CSB_ANNO_MATER",
        fileKeyFn: (c) => [c("YY"), c("SEQ"), "1"],
    });
    return $mpt.confirmSave(this.ds_main, this.validatorMain);
};

this.fn_save = async function () {
    try {
        await (
            await this.delFuncPromise
        )();
        await this.fn_saveMain();
    } catch (e) {
        this.pop.alert("저장 중 오류가 발생하였습니다.");
        return;
    }

    this.fn_search();
    return $mpt.alertSaved();
};

$f.removeRowsByCondition(this.ds_main, (context) => {
    return context.row % 2;
});

// 기본 사용
$f.replaceHaksaText(this.div_main);

// 강제 변경
$f.replaceHaksaText(this.div_main, { force: true });

$f.revalidateAllRow(this.mainValidator);

// 수정된 행만 재검증
$f.revalidateAllRow(this.mainValidator, { onlyUpdateRow: true });

$f.setupBetterInputGrid(this.grd_main);

$f.setupGridMultiCellCopy(this, this.grd_main);

sha256("message");

$f.traverseComponentTreeWithCallback(this.div_search, (comp, ctx) => {
    // 모든 컴포넌트의 readonly 속성을 true로 설정
    comp.readonly = true;

    // div_exclude라는 이름을 가진 컴포넌트를 만나면
    if (comp.name === "div_exclude") {
        // 해당 컴포넌트의 하위 컴포넌트 순회를 중단
        ctx.stopChildNodeTraversal();
    }
});

// div_search 컴포넌트의 자식 컴포넌트 중 cssclass가 essential인 컴포넌트의 value가 null일 경우 에러 메시지를 반환합니다.
$f.validateEssentialComponents(this.div_search);