iaud-mxgrid-guide

name	iaud-mxgrid-guide
description	i-AUD MX-GRID 개발 가이드. 엑셀 기반 MX-GRID 보고서의 서버 스크립트(WorkBook/WorkSheet API), 클라이언트 스크립트(iGrid API), 예약어(이름 정의), 전용 함수(AUD_xxx), .ds 파일 구조를 안내합니다. "MX-GRID", "엑셀 그리드", "WorkBook", "WorkSheet", "iGrid", "셀 조작", "데이터 바인딩", "CRUD", "PDF 내보내기", "엑셀 내보내기", "예약어", "이름 정의" 등을 물어볼 때 사용하세요.

i-AUD MX-GRID 개발 가이드

1. 개요

MX-GRID는 엑셀 문서를 웹에서 표현하는 i-AUD 컨트롤입니다.

아키텍처 흐름:

[엑셀 파일(.xlsx)]
     │  (서버 변환)
[템플릿 모델(.json2)] ─── 스타일, 셀, 수식, 차트, 이미지, 조건부서식
     │  (서버 WorkBook)
[서버 WorkBook 객체] ◄── [데이터셋(.ds)] ── SQL → 셀 영역에 바인딩
     │  (수식 계산 후 직렬화)
[클라이언트 JSON 모델] → 브라우저에서 iGrid 컨트롤로 렌더링

보고서 폴더 구조:

보고서명/
├── 보고서명.mtsd              # UI 정의
├── 보고서명.script.ts         # 클라이언트 스크립트
├── MX_GRID/
│   ├── {코드}.xlsx            # 원본 엑셀 (디자이너용)
│   ├── {코드}.json2           # 엑셀 → JSON 변환 템플릿
│   └── {코드}.ds              # 데이터셋 바인딩 정의
├── DataSource/
│   └── *.sql                  # SQL 쿼리
└── ServerScript/
    └── *.ts                   # 서버 스크립트

3파일 셋트:

• .xlsx — 원본 엑셀 파일 (i-AUD Designer 또는 Excel에서 편집)
• .json2 — 엑셀 구조의 JSON 변환 (서버가 자동 생성, AI 부분 수정 가능)
• .ds — 데이터 바인딩 정의 (SQL 결과를 어느 셀 영역에 출력할지 지정)

AI가 할 수 있는 작업:

• 서버 스크립트(WorkBook API), 클라이언트 스크립트(iGrid API), SQL, .ds 수정
• .json2 부분 수정(셀 값, 스타일, 조건부서식)

AI가 할 수 없는 작업:

• .json2 전체 신규 생성, .xlsx 파일 생성/편집

---

2. 서버 스크립트 API — WorkBook

서버 스크립트에서 MX-GRID를 조작하는 핵심 API입니다.

2.1 WorkBook 획득 방법

// 방법 1: 현재 실행 중인 MX-GRID의 WorkBook (OnExecute 이벤트에서 사용)
var wb = .();


 wb = .(req.(), );


 wb = .(req.(), , );


 path = fso.([, req.(), ]) + ;
 wb = .(path);