Global

Members

(constant) DEFAULT_SMR_CONFIGS

학기 코드와 명칭을 정의하는 인터페이스

Source: modules/academic/yy-smr-wrapper.ts, line 1

Methods

buildTracer(form, config) → {RowTracer}

Parameters:

Name	Type	Description
`form`	nexacro.Form
`config`	RowTracerConfig

Source: utils/dataset/init-dataset-row-tracer.js, line 175

Returns:

Type:: RowTracer

datasetForEach()

Deprecated: ForEachDataset을 사용하세요.
Source: utils/dataset/for-each-dataset.js, line 40
See: ForEachDataset.

encodeHex(str) → {string}

문자열을 16진수로 변환

Parameters:

Name	Type	Description
`str`	string	변환할 문자열

Source: utils/crypto/encode-hex.ts, line 3

Returns:

16진수 문자열

Type:: string

Example

encodeHex("Hello"); // "48656c6c6f"

getSafeNexacroId(id) → {string}

넥사크로 컴포넌트 ID 규칙에 부합하도록 특수문자를 제거하고 정제하는 헬퍼 함수

Parameters:

Name	Type	Description
`id`	string	입력 컴포넌트 ID

Source: utils/react-nexacro/layouts.jsx, line 362

Returns:

정제된 넥사크로 ID

Type:: string

insertModeRow(dataset, columns, mode, optionopt)

데이터셋 첫번째 행에 mode에 맞는 행을 추가합니다.

Parameters:

Name Type Attributes Description

dataset

nexacro.Dataset

대상 데이터셋

columns

Array.<string>

대상 컬럼

mode

'a' | 's' | 'n'

콤보 모드 ('a': 전체, 's': 선택, 'n': 추가 안함)

option

Object

Properties

Name	Type	Attributes	Default	Description
`insertNewRow`	boolean	<optional>	true	새 행 추가 여부

Source: utils/combo/linked-combo.js, line 796

parseKeys(keys) → {Array.<Array.<string>>}

Keys 배열을 파싱하여 우선순위별 컬럼명 그룹 배열로 반환합니다.

Parameters:

Name	Type	Description
`keys`	Array.<string>

Source: utils/dataset/init-dataset-row-tracer.js, line 27

Returns:

우선순위별 컬럼명 그룹 배열

Type:: Array.<Array.<string>>

Example

parseKeys(["SEQ", "SNO, NAME"]);
// → [["SEQ"], ["SNO", "NAME"]]

Type Definitions

CheckDuplicateRowsMessageFormatFunc(row1, row2)

Parameters:

Name	Type	Description
`row1`	number	중복 행 1.
`row2`	number	중복 행 2.

Source: utils/dataset/check-duplicate-rows.js, line 3

CheckScdulOptions

Properties

Name	Type	Attributes	Default	Description
`scdulCd`	string \| Array.<string>	<optional>		체크할 일정 코드 (기본으로 메뉴의 것을 사용) 여러 일정을 인수로 넘길 시 다음과 같이 처리합니다. 일정 중 단 하나라도 일치하는 것이 있으면 통과 모두 불일치 일 시 다음 우선순위로 일정 메시지와 정보를 반환합니다. 현재 일자보다 시작일자가 늦는 일정 현재 일자와 시작일자가 가까운 일정
`sno`	string	<optional>		학번 해당 인수의 학번을 바탕으로 일정의 대학 코드를 찾습니다. 학생의 경우 세션의 ID를 사용합니다.
`univCd`	string	<optional>		대학 코드 해당 인수를 생략 시 업무 코드를 기반 등의 조건을 거쳐 찾습니다.
`enableDefaultAction`	boolean	<optional>	true	기본 액션 실행 여부 해당 값을 false로 설정 시 일정 결과에 따른 기본 작업을 수행하지 않습니다.
`targetComponent`	Array.<nexacro.Component> \| function	<optional>		일정의 대상이 되는 컴포넌트 혹은 boolean 타입의 매개변수를 받는 함수 nexacro.Component 객체의 경우 set_enable을 실행하여 컴포넌트 활성/비활성화를 진행합니다. function 객체의 경우 일정 여부를 받는 매개변수를 받는 함수입니다.
`targetComponentOverride`	boolean	<optional>	true	일정의 대상이 되는 컴포넌트의 기본을 유지하고자 하는 경우 false.
`isCloseOutOfScdul`	boolean	<optional>	false	일정 범위가 아닐 시 화면을 닫을 지 여부 이 기능은 enableDefaultAction 값이 true여야 동작합니다. 즉시 종료하므로 리턴받은 Promise에서 후처리 동작이 불가합니다.

Source: modules/schedule/check-scdul.js, line 1

CheckSchdReturn

Properties

Name	Type	Description
`scdulYn`	boolean	일정 체크 결과
`scdulMsg`	string	일정 메시지
`chkSuccessYn`	boolean	일정 검사 수행의 성공 여부. 인수 부족, 일정 해당 없는 메뉴의 경우 true로 반환
`scdulCd`	string	일정 검사 후 해당되는 일정 코드
`beginDtm`	string	일정 시작 일시
`endDtm`	string	일정 종료 일시

Source: modules/schedule/check-scdul.js, line 32

ComboNodeConfig

Type:

Object

Properties

Name	Type	Attributes	Description
`id`	string		콤보 노드의 고유 식별자 (예: 'univ', 'dpmj')
`parentId`	string \| null	<optional>	부모 콤보 노드의 고유 식별자
`component`	nexacro.Combo	<optional>	넥사크로 콤보 컴포넌트 (컴포넌트 콤보인 경우)
`grid`	nexacro.Grid	<optional>	넥사크로 그리드 컴포넌트 (그리드 콤보인 경우)
`colNm`	string	<optional>	그리드 콤보의 바인딩 컬럼명
`adapter`	ComboAdapter	<optional>	커스텀 어댑터 인스턴스
`codeField`	string		데이터셋의 코드 컬럼명
`textField`	string		데이터셋의 표시 텍스트 컬럼명
`parentCodeField`	string \| Object	<optional>	데이터셋의 부모 코드 컬럼명 혹은 조상 노드 ID별 컬럼명 매핑 객체
`allPathField`	string	<optional>	전체 경로 표시를 위한 데이터셋 컬럼명 (예: 'ALL_PATH')
`mode`	'a' \| 's' \| 'n'	<optional>	콤보 모드. 설정 시 노드 등록 시점에 데이터셋 첫 행에 자동 삽입됩니다. 'a': 전체, 's': 선택, 'n': 빈 행(그리드 어댑터만 삽입)
`onDisplayChange`	DisplayChangeCallback	<optional>	콤보 표시 컬럼 변경 시 호출되는 콜백 함수

Source: utils/combo/linked-combo.js, line 216

DisplayChangeCallback(node, type) → {void}

콤보 표시 컬럼 변경 시 호출되는 콜백 함수입니다.

Parameters:

Name	Type	Description
`node`	ComboNode	대상 콤보 노드
`type`	'default' \| 'allPath'	변경할 표시 타입

Source: utils/combo/linked-combo.js, line 207

Returns:

Type:: void

EzFoundationConfig

EzFoundation 유틸리티 함수에 대한 전역 설정 객체

Properties

Name	Type	Attributes	Description
`hCmbYySqlId`	string	<optional>	연도 조회 쿼리 아이디
`hCmbSmrSqlId`	string	<optional>	학기 조회 쿼리 아이디
`hCmbOrgSqlId`	string	<optional>	학과 조회 쿼리 아이디
`hCmbMngtDpmjSqlId`	string	<optional>	관리학과 조회 쿼리 아이디
`hCmbSmrAlias`	Array.<HCmbSmrAliasConfig>	<optional>	학사 콤보의 커스텀 학기 타입을 정의할 수 있습니다.
`hCmbSmrType`	Array.<HCmbSmrTypeConfig>	<optional>	학사 콤보의 학기 타입 (특정 학기반 보여주는 필터링)
`hCmbTargetComponentName`	HCmbTargetComponentName	<optional>	학사콤보 대상 컴포넌트의 정규식
`hCmbSmrOffsetRule`	Array.<HCmbSmrOffsetRule>	<optional>	학사 콤보의 학기 오프셋 규칙을 정의할 수 있습니다.

Source: core/ez-foundation-config.jsdoc.js, line 1

Example

// f_config.xjs
nexacro.EzFoundation.hCmbYySqlId = hCmb.s01;
nexacro.EzFoundation.hCmbSmrSqlId = hCmb.s02;
nexacro.EzFoundation.hCmbOrgSqlId = hCmb.s03;
nexacro.EzFoundation.hCmbSmrAlias = [
    {
        id: "custom",
        aliases: [
            {
                smrCd: "12340010",
                smrNm: "전기",
            },
            {
                smrCd: "12340020",
                smrNm: "후기",
            },
        ],
        condition: (context) => {
            return true;
        },
    },
];
nexacro.EzFoundation.hCmbSmrType = [
    {
        // 정규 학기
        id: "R",
        condition: (ctx) =>
            ctx.component.id === "cmb_grduSmr" ||
            ctx.gridBindColId === "GRDU_SMR",
        filter: (ctx) => ctx.rowData["SUPLMT_INFO_3"] === "1",
    },
    {
        // 계절 학기
        id: "S",
        condition: (ctx) => false,
        filter: (ctx) => ctx.rowData["SUPLMT_INFO_4"] === "1",
    },
];
nexacro.EzFoundation.hCmbTargetComponentName = {
    yyCompNm: /^spn_(?:grdu)?[yY]y$/,
    smrCompNm: /^cmb_(?:grdu)?[sS]mr$/,
    fcltCompNm: /^cmb_fcltDvcd$/,
    univCompNm: /^cmb_univCd$/,
    dpmjCompNm: /^cmb_dpmjCd$/,
    majrCompNm: /^cmb_majrCd$/,
    detMajrCompNm: /^cmb_detMajrCd$/,
    smrColNm: ["SMR", "GRDU_SMR"],
    fcltColNm: "FCLT_DVCD",
    univColNm: "UNIV_CD",
    dpmjColNm: "DPMJ_CD",
    majrColNm: "MAJR_CD",
    detMajrColNm: "DET_MAJR_CD",
};
nexacro.EzFoundation.hCmbSmrOffsetRule = [
    {
        condition: (ctx) => true,
        offset: 1,
    },
];

FilterRowsByCondtionFunc(context) → {boolean}

Parameters:

Name	Type	Description
`context`	RemoveRowByConditionFuncContext	참조 함수 및 변수

Source: utils/dataset/remove-rows-by-condition.js, line 31

Returns:

true 값인 행만 남음

Type:: boolean

FindAncestorComponentOptions

Properties

Name	Type	Attributes	Default	Description
`maxDepth`	number	<optional>	50	최대 탐색 깊이. Default is `50`

Source: utils/ui/find-ancestor-component.js, line 1

ForEachDatasetCallback(context)

Parameters:

Name Type Description

context

Object

콜백 참조용 데이터

Properties

Name	Type	Description
`dataset`	nexacro.Dataset	넥사크로 데이터셋 객체
`row`	number	행 번호
`rowData`	Object	row 오브젝트

Source: utils/dataset/for-each-dataset.js, line 3

HCmbComboMode

콤보의 최상위 빈 값에 사용되는 명칭을 구분하는 플래그 입니다.

'a': 전체

's': 학과

'n': 추가 안함

Type:

'a' | 's' | 'n'

Source: modules/academic/h-cmb.js, line 70

HCmbOrgMode

그리드의 각 조직별 콤보 mode 값

Properties

Name	Type	Attributes	Description
`fclt`	HCmbComboMode	<optional>	대학/대학원 모드
`univ`	HCmbComboMode	<optional>	대학 모드
`dpmj`	HCmbComboMode	<optional>	학과 모드
`majr`	HCmbComboMode	<optional>	전공 모드
`detMajr`	HCmbComboMode	<optional>	전공 세부 모드

Source: modules/academic/h-cmb.js, line 82

HCmbSmrAliasConfig

학기 별칭을 지정하기 위한 설정 객체

Properties

Name	Type	Description
`id`	string	학기 타입을 구분하고자 하는 코드
`aliases`	Array.<HCmbSmrAliasItem>	학기 별칭 목록
`condition`	HCmbSmrConditionFunc	자동 선택 시 판별 함수

Source: core/ez-foundation-config.jsdoc.js, line 84

HCmbSmrAliasItem

학기 별칭 목록

Properties

Name	Type	Description
`smrCd`	string
`smrNm`	string

Source: core/ez-foundation-config.jsdoc.js, line 96

HCmbSmrConditionFunc(context) → {boolean}

학기 판별용 함수

Parameters:

Name Type Description

context

Object

판별 참조용 데이터

Properties

Name	Type	Description
`form`	nexacro.Form	학사 콤보가 호출된 폼 객체
`component`	nexacro.Component	학기 콤보 컴포넌트
`isGrid`	boolean	그리드 여부
`isCombo`	boolean	콤보 여부
`gridBindColId`	string	대상이 그리드일 경우 학기에 바인딩된 컬럼명

Source: core/ez-foundation-config.jsdoc.js, line 104

Returns:

판별 결과, true 값 일 시 해당 별칭을 사용함.

Type:: boolean

HCmbSmrFailValueFunc(context)

Parameters:

Name Type Description

context

Object

Properties

Name	Type	Description
`baseSmr`	string	기준 학기

Source: core/ez-foundation-config.jsdoc.js, line 136

HCmbSmrOffsetRule

Properties

Name	Type	Description
`condition`	HCmbSmrOffsetRuleConditionFunc	학기 오프셋 조건
`offset`	number	학기 오프셋 값

Source: core/ez-foundation-config.jsdoc.js, line 180

HCmbSmrOffsetRuleConditionFunc(context)

Parameters:

Name Type Description

context

Object

Properties

Name	Type	Description
`form`	nexacro.Form

Source: core/ez-foundation-config.jsdoc.js, line 174

HCmbSmrTypeConfig

Source: core/ez-foundation-config.jsdoc.js, line 124

HCmbSmrTypeRowConditionUseMemoHook(func, deps)

데이터 저장용 훅

Parameters:

Name	Type	Description
`func`	function
`deps`	Array.<any>	의존성 키 배열 데이터를 반환하는 함수

Source: utils/dataset/remove-rows-by-condition.js, line 7

Example

useMemo(() => {
    return "data";
}, []);

HCmbTargetComponentName

학사 콤보의 컴포넌트 판별 정규식, 해당 정규식을 만족하는 컴포넌트를 대상으로 선택한다.

Properties

Name	Type	Attributes	Default	Description
`yyCompNm`	RegExp	<optional>	/^spn_(?:grdu)?[yY]y$/	연도 컴포넌트의 명칭 정규식.
`smrCompNm`	RegExp	<optional>	/^cmb_(?:grdu)?[sS]mr$/	학기 컴포넌트의 명칭 정규식.
`fcltCompNm`	RegExp	<optional>	/^cmb_fcltDvcd$/	학부/대학원 구분 컴포넌트의 명칭 정규식.
`univCompNm`	RegExp	<optional>	/^cmb_univCd$/	대학 컴포넌트의 명칭 정규식
`dpmjCompNm`	RegExp	<optional>	/^cmb_dpmjCd$/	학과 컴포넌트의 명칭 정규식
`majrCompNm`	RegExp	<optional>	/^cmb_majrCd$/	전공 컴포넌트의 명칭 정규식
`detMajrCompNm`	RegExp	<optional>	/^cmb_detMajrCd$/	세부 전공 컬럼 명칭
`smrColNm`	string \| Array.<string>	<optional>	["SMR", "GRDU_SMR"]	학기 그리드 컬럼 명칭 정규식.
`fcltGridColNm`	string	<optional>	FCLT_DVCD	학부/대학원 구분 그리드 컬럼 명칭
`univColNm`	string	<optional>	UNIV_CD	대학 그리드 컬럼 명칭
`dpmjColNm`	string	<optional>	DPMJ_CD	학과 그리드 컬럼 명칭
`majrColNm`	string	<optional>	MAJR_CD	전공 그리드 컬럼 명칭
`detMajrColNm`	string	<optional>	DET_MAJR_CD	세부 전공 그리드 컬럼 명칭

Source: core/ez-foundation-config.jsdoc.js, line 142

NexacroInstanceResult

Type:

Object

Properties

Name	Type	Description
`comp`	nexacro.Component	생성된 컴포넌트
`form`	nexacro.Form	자식을 추가할 form.

Source: utils/react-nexacro/reconciler.js, line 79

NexacroRoot

Type:

Object

Properties

Name	Type	Description
`render`	function	React 엘리먼트를 넥사크로 컨테이너에 렌더링합니다.
`unmount`	function	렌더링된 컴포넌트를 제거하고 루트를 해제합니다.

Source: utils/react-nexacro/root.js, line 3

RemoveRowByConditionFuncContext

Properties

Name	Type	Description
`dataset`	nexacro.Dataset	대상 데이터셋
`row`	number	행
`rowData`	Object	컬럼 데이터
`useMemo`	HCmbSmrTypeRowConditionUseMemoHook	데이터 기억용

Source: utils/dataset/remove-rows-by-condition.js, line 39

RemoveRowsByCondtionFunc(context) → {boolean}

Parameters:

Name	Type	Description
`context`	RemoveRowByConditionFuncContext	참조 함수 및 변수

Source: utils/dataset/remove-rows-by-condition.js, line 23

Returns:

true 일 시 삭제

Type:: boolean

RemoveRowsByCondtionOptions

Properties

Name	Type	Attributes	Default	Description
`mutate`	boolean	<optional>	false	원본을 직접 수정할지 여부 (true면 수정)
`skipEvent`	boolean	<optional>	false	이벤트 활성화 여부, 속도 문제로 기본 값인 false 유지 권장

Source: utils/dataset/remove-rows-by-condition.js, line 1

RevalidateAllRowOptions

Type:

Object

Properties

Name	Type	Attributes	Default	Description
`onlyUpdateRow`	boolean	<optional>	false

Source: utils/ezworks/revalidate-all-row.js, line 1

RowTracerConfig

Type:

Object

Properties

Name	Type	Attributes	Description
`searchFn`	string		폼에 등록된 조회 함수의 이름. 초기화 시점에 행 추적 래퍼로 교체됩니다. 교체된 함수는 기존과 동일하게 호출할 수 있습니다.
`grid`	nexacro.Grid		조회 결과가 바인딩된 그리드 컴포넌트 (binddataset 기반)
`keys`	Array.<string>		행 식별에 사용할 컬럼명 목록. 인덱스 0부터 순서대로 시도하며 hit 되면 중단합니다. 쉼표로 구분하여 해당 단계의 복합 키를 구성할 수 있습니다. 예: ["SEQ", "SNO, NAME"] → 1순위: SEQ 단독 / fallback: SNO + NAME 복합키
`children`	Array.<RowTracerConfig>	<optional>	자식 조회 설정 목록. 부모 조회 중 자식 데이터셋의 이벤트를 차단합니다.

Source: utils/dataset/init-dataset-row-tracer.js, line 1

TraverseComponentTreeCallback(component, context)

Parameters:

Name	Type	Description
`component`	nexacro.Component	컴포넌트
`context`	TraverseComponentTreeCallbackContext	유틸성 함수

Source: utils/ui/traverse-component-tree-with-callback.js, line 1

TraverseComponentTreeCallbackContext

Properties

Name	Type	Description
`stopChildNodeTraversal`	function	트리 순회를 중단

Source: utils/ui/traverse-component-tree-with-callback.js, line 9

TxFileOption

Properties

Name	Type	Attributes	Default	Description
`sqlId`	string	<optional>		요청 SQL.
`action`	string	<optional>	basic	요청 action.
`fileNm`	string			파일명
`rowDelimiter`	string	<optional>
`colDelimiter`	string	<optional>
`param`	Object	<optional>	{}

Source: utils/ezworks/tx-file.js, line 1

VNode

Properties

Name	Type	Description
`id`	string	가상 노드 아이디
`type`	Object	넥사크로 타입
`props`	Object
`flatChildren`	VNode	컴포넌트 속성
`base`	Object	가상 노드가 마운트된 객체
`rootVNode`	VNode	최상위 노드
`rootForm`	Object	그려진 최상위 컴포넌트
`nativeId`	string	실제 컴포넌트 아이디

Source: utils/dynamic/v-node.js, line 1

ValidateEssentialComponentOptions

Source: utils/ezworks/validate-essential-components.js, line 1

hCmbOption

Properties

Name	Type	Attributes	Default	Description
`div`	nexacro.Div \| Array.<nexacro.Div> \| undefined			학사콤보를 적용할 Div 객체 혹은 그 배열입니다.
`grid`	nexacro.Grid \| Array.<nexacro.Grid>	<optional>		학사콤보를 적용할 Grid 객체 혹은 그 배열입니다.
`orgMode`	HCmbOrgMode \| Array.<HCmbOrgMode> \| HCmbComboMode \| Array.<HCmbComboMode>	<optional>		학사콤보의 콤보 모드. 문자열로 설정시 모든 모드가 동일하게 적용됩니다. (예: "a")
`orgGridMode`	HCmbOrgMode \| Array.<HCmbOrgMode> \| HCmbComboMode \| Array.<HCmbComboMode>	<optional>		그리드에서 사용하는 조직 모드. 문자열로 설정시 모든 모드가 동일하게 적용됩니다. (예: "s")
`orgFilter`	FilterRowsByCondtionFunc	<optional>		조직 콤보 필터를 위한 함수
`smrMode`	HCmbComboMode	<optional>		학사콤보의 학기 콤보 모드
`smrGridMode`	HCmbComboMode	<optional>		그리드에서 사용하는 학사콤보의 학기 콤보 모드
`smrFilter`	FilterRowsByCondtionFunc	<optional>		학기 콤보 필터를 위한 함수
`smrGridFilter`	FilterRowsByCondtionFunc	<optional>		그리드에서 사용하는 학기 콤보 필터를 위한 함수
`smrAliasId`	string \| Array.<string>	<optional>		학기 콤보의 표시 타입, 전역 설정에서 hCmbSmrAlias 설정을 통해 참조합니다.
`smrTypeId`	string \| Array.<string>	<optional>		학기 콤보의 타입, 전역 설정에서 hCmbSmrType 설정을 통해 참조합니다.
`smrGridTypeId`	string \| Array.<string>	<optional>		학기 콤보의 타입, 전역 설정에서 hCmbSmrType 설정을 통해 참조합니다.
`targtCompNm`	HCmbTargetComponentName	<optional>		학사콤보를 적용할 컴포넌트를 판별하는 정규식을 재정의 합니다.
`useMngtDpmj`	boolean	<optional>	false	@deprecated 이 함수는 추가로 사용하지 마세요. orgDetUse으로 대체되었습니다. 조직 데이터를 관리학과 기준으로 조회합니다.
`fcltGrscDstnct`	string	<optional>		학부대학원구분 (공통코드: 1715) (생략 시 메뉴관리의 데이터를 사용)
`orgDetUse`	string	<optional>		조직세부사용 (공통코드: 2002) (생략 시 메뉴관리의 데이터를 사용)
`useDataAuth`	boolean	<optional>		데이터권한여부 (생략 시 메뉴관리의 데이터를 사용)
`smrOffset`	number	<optional>		학기 설정 값을 기준 연도 학기에서 더하거나 뺄 수

Source: modules/academic/h-cmb.js, line 14

prepareFileDeleteOptions

Properties

Name	Type	Attributes	Description
`dataset`	nexacro.Dataset		삭제한 항목이 존재하는 데이터 셋
`target`	string		대상 테이블
`keyCols`	Array.<string>		Deprecated. PK 키 값
`fileKeyFn`	function		파일 키 함수
`form`	nexacro.Form	<optional>	트랜잭션 등에 사용되는 기준이 되는 form. 생략 시 dataset의 상위 form을 사용함

Source: utils/ezworks/prepare-file-delete.js, line 5

useStateSetStateOptions

Properties

Name	Type	Description
`render`	boolean

Source: utils/dynamic/render.js, line 354

vStackProps

Properties

Name	Type	Attributes	Default	Description
`direction`	'vertical' \| 'horizontal'	<optional>	vertical	방향
`gap`	number	<optional>	0	간격 픽셀

Source: utils/dynamic/component/v-stack.js, line 4