メニュー
i-AUD 보고서(프로그램) 구조 가이드. .design.json, .mtsd 파일 구조와 프로그램 구성 요소를 설명합니다. "보고서 구조", "프로그램 구성", ".mtsd", ".design.json", "폴더 구조", "데이터소스", "서비스" 등을 물어볼 때 사용하세요.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/AUD-DEV-TEAM/i-AUD-Developer-Kit --skill iaud-report-structureコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
i-AUD GridHtmlView Add-in 컴포넌트 가이드. DataGrid 데이터를 HTML/CSS 템플릿으로 렌더링하는 컴포넌트입니다. "카드 리스트", "HTML 뷰어", "입력 폼", "GridHtmlView 템플릿", "그리드 HTML", "카드형 레이아웃", "마스터 디테일" 등을 요청할 때 사용하세요.
i-AUD ScheduleGrid(Gantt Chart / 스케줄 그리드) 개발 가이드. AddIn 컴포넌트로 동작하는 간트 차트 컨트롤의 초기화, 데이터 바인딩, 시간축 설정(Major/Minor Unit), 행렬 방향(TransposeType), 셀 이벤트(OnDrawCell, OnEndDrag, OnContextMenuOpenning), 셀 조작(Split/Merge/Delete/Lock), DataGrid 양방향 동기화, 엑셀/PDF 내보내기 등을 안내합니다. "ScheduleGrid", "Gantt Chart", "간트 차트", "스케줄 그리드", "ScheduleCell", "TransposeType", "시간축", "Major Unit", "Minor Unit", "셀 분할", "셀 병합", "셀 잠금", "FocusCell", "OnDrawCell", "OnEndDrag", "ContextMenu", "SplitCell", "MergeCell" 등을 물어볼 때 사용하세요.
i-AUD DataGrid, GroupGrid, TreeGrid 개발 가이드. 그리드 컨트롤의 데이터 바인딩, CRUD, 이벤트, 필터/정렬, 멀티헤더, 셀 스타일, 행 추가/삭제, 서버 데이터 전송, 자동 쿼리 생성 등을 안내합니다. "DataGrid", "GroupGrid", "TreeGrid", "그리드", "행 추가", "셀 값", "CRUD", "필터", "정렬", "멀티헤더", "셀 서식", "행 삭제", "페이징", "트리", "그룹", "소계", "병합", "고정 컬럼", "그리드 이벤트", "OnCellClick", "OnEndEdit", "GetCRUDJSON" 등을 물어볼 때 사용하세요.
SKILL.md を表示中
SOC 職業分類に基づく
| name | iaud-report-structure |
| description | i-AUD 보고서(프로그램) 구조 가이드. .design.json, .mtsd 파일 구조와 프로그램 구성 요소를 설명합니다. "보고서 구조", "프로그램 구성", ".mtsd", ".design.json", "폴더 구조", "데이터소스", "서비스" 등을 물어볼 때 사용하세요. |
i-AUD의 보고서(프로그램)는 하나의 폴더로 구성되며, UI 배치, 데이터소스, 서버 스크립트, 클라이언트 스크립트 등이 포함됩니다.
[보고서명]/
├── .design.json # 개발용 화면 정의 (스크립트/SQL은 파일 경로 참조) ★ AI는 이 파일 사용
├── [ReportCode].mtsd # 화면 정의 - 서버 원본 (인라인 콘텐츠 포함)
├── [보고서명].script.ts # 클라이언트 스크립트 (TypeScript)
├── [보고서명].script.js # 클라이언트 스크립트 (JavaScript)
├── DataSource/ # 데이터 조회 SQL
│ ├── DataSource1.sql
│ └── DataSource2.sql
└── ServerScript/ # 서버 스크립트
├── Service1.ts # 일반 서비스
├── @CommonModule.ts # 공통 모듈 (@로 시작)
└── Service2.sql # SQL 서비스
화면 UI 배치, 데이터소스, 서비스가 정의된 JSON 문서입니다.
.design.json: 간소화된(compact) 개발용 파일 — AI는 이 파일을 우선 사용합니다.
Visible: true, Enabled: true, 기본 폰트/색상 등)"./ServerScript/@XX.ts", "./DataSource/DS1.sql")로 대체됩니다expandDesignJson()으로 기본값을 자동 복원합니다.mtsd: 서버 원본 — 모든 기본값 + 인라인 콘텐츠 포함. 직접 수정하지 않습니다..design.json이 없는 기존 보고서는 save_report 또는 pull_report 실행 시 자동 생성됩니다.간소화 규칙:
.design.json을 수정할 때 기본값과 동일한 속성은 생략해도 됩니다. 예를 들어 버튼의 배경색만 변경하면Style.Background.Color만 명시하면 됩니다. 서버의expandDesignJson()이Visible,Enabled, 기본 폰트 등을 자동으로 채웁니다.
{
"ReportInfo": { ... }, // 보고서 기본 정보
"DataSources": { ... }, // 데이터소스 정의
"ScriptText": "...", // 클라이언트 스크립트
"ServerScriptText": [ ... ], // 서버 스크립트 목록
"Forms": [ ... ], // 폼 및 컨트롤 정의
"MetaDataSources": { ... }, // 메타 데이터소스
"EXECUTION_PLANS": [ ... ], // 실행 계획
"Variables": [ ... ], // 변수 정의
"Modules": [ ... ], // 모듈
"ResponsiveLayout" ...
...
...
{
"ReportInfo": {
"ReportCode": "DYNAMIC_SQL",
"FolderCode": "FLD72470E8B43AE41C796541322C57190D2",
"SavePath": "FLD.../DYNAMIC_SQL.mtsd",
"ReportName": "DYNAMIC_SQL 샘플",
"Writer": "yglee",
"WriteDate": "2025-06-12 17:10:04",
"Editor": "yglee",
"EditDate": "2025-06-12 17:10:04",
"TabPosition": 0,
"UsePersonalConditions": true,
"DocumentVersion": "3.0.0.0",
"RefreshType": 0
}
}
{
"DataSources": {
"Datas": [
{
"Id": "DS6CBDBEC3A3D74BC587F53426065035EF",
"Name": "SAMPLE",
"UseMeta": false,
"UseCache": false,
"ConnectionCode": "MTXRPTY",
"Encrypted": "True",
"DSType": 2,
"SQL": "암호화된 SQL...",
"Params": [],
"Columns": []
}
]
}
}
| 필드 | 설명 |
|---|---|
Id | 데이터소스 고유 ID |
Name | 데이터소스 이름 |
ConnectionCode | DB 연결 코드 |
DSType | 데이터소스 유형 (0: SQL, 1: 서비스, 2: 스크립트) |
SQL | 쿼리 (암호화됨) |
Params | 파라미터 목록 |
{
"ServerScriptText": [
{
"Name": "@DATA_MASTER",
"Key": "DATA_MASTER",
"Encrypted": true,
"ScriptText": "암호화된 스크립트..."
}
]
}
| 필드 | 설명 |
|---|---|
Name | 스크립트 이름 (@로 시작하면 공통 모듈) |
Key | 스크립트 키 |
Encrypted | 암호화 여부 |
ScriptText | 스크립트 내용 |
.design.json에서는 기본값이 생략된 간소화 형태로 저장됩니다:
{
"Forms": [
{
"Id": "FormC0C2A82A6DBFD5A92D650788A672B3BA",
"Name": "Form1",
"Activated": true,
"Elements": [
{
"Type": "DataGrid",
"Id": "DataGridF116CE7C4A9D3F1E3ED369B80D0F7D69",
"Name": "DataGrid",
"Position": {
"Left": 10,
"Top": 10,
"Width": 2421,
"Height": 924
},
"DataSource": "DS6CBDBEC3A3D74BC587F53426065035EF"
참고:
Visible: true,Enabled: true,TabStop: true, 기본Style,ZIndex: 0등 기본값은 생략 가능합니다. 기본값과 다른 속성만 명시하면 됩니다. 서버에서expandDesignJson()이 자동으로 복원합니다.
컨트롤 공통 속성:
| 필드 | 설명 | 기본값 |
|---|---|---|
Type | 컨트롤 유형 (DataGrid, Button, TextBox 등) | (필수) |
Id | 컨트롤 고유 ID | (필수) |
Name | 컨트롤 이름 (스크립트에서 참조) | (필수) |
Visible | 표시 여부 | true (생략 가능) |
Enabled | 활성화 여부 | true (생략 가능) |
Position | 위치 및 크기 | (필수) |
Style | 스타일 정의 | 기본 스타일 (변경 시만 명시) |
DataSource | 바인딩된 데이터소스 ID | "" (생략 가능) |
| Type | 설명 | 주요 속성 |
|---|---|---|
DataGrid | 데이터 그리드 | Columns, UsePaging, PageSize |
iGrid | Excel 형식 그리드 | WorkSheets, Formulas |
OlapGrid | OLAP 피벗 그리드 | Dimensions, Measures |
Chart | 차트 | ChartType, Series |
Button | 버튼 | Text, OnClick |
TextBox | 텍스트 입력 | Text, MaxLength |
ComboBox | 콤보박스 | Items, SelectedValue |
CheckBox | 체크박스 | Checked |
Calendar | 날짜 선택 | Value, Format |
Label | 라벨 | Text |
Image | 이미지 | Source |
Group | 그룹 컨테이너 | Elements |
Tab | 탭 컨트롤 | TabItems |
DataSource/ 폴더에는 데이터 조회용 SQL 파일들이 저장됩니다.
파일명: DataSource/[DataSourceName].sql
SELECT
T1.D1 AS 제품명,
T1.D2 AS 지점명,
SUM(T1.M1) AS 판매수량
FROM MEX_USER_FILE_DATA T1
WHERE 1=1
AND T1.META_FILE_CODE = 'RPT3048F89487B44C768239763DAC46B288'
/* #[VS_KEYWORD]# */
GROUP BY T1.D1, T1.D2
파라미터 바인딩:
#[파라미터명]# - 문자열 파라미터##[파라미터명]## - 숫자 파라미터ServerScript/ 폴더에는 서버 스크립트 파일들이 저장됩니다.
파일명: ServerScript/[ServiceName].ts
각 파일이 하나의 서비스로 동작합니다.
파일명: ServerScript/@[ModuleName].ts
@로 시작하는 파일은 공통 모듈로, 다른 스크립트에서 import하여 사용할 수 있습니다.
// 다른 스크립트에서 사용
import { QueryRepository } from "../ServerScript/@DATA_MASTER";
//<%@include file="/REPORT_CODE/DATA_MASTER.jsx"%>
파일명: [보고서명].script.ts 또는 [보고서명].script.js
.ts 파일이 우선 탐색됩니다.ts 확장자 사용┌─────────────────────────────────────────────────────────────┐
│ .design.json / .mtsd (메인 문서) │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ DataSources │ │ ServerScriptText │ │
│ │ (데이터소스) │ │ (서버스크립트) │ │
│ └────────┬────────┘ └────────┬────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ DataSource/*.sql │ │ServerScript/*.ts│ │
│ └─────────────────┘ └─────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Forms (화면 정의) │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │ DataGrid │ │ Button │ │ ComboBox │ ... │ │
│ │ │(DataSource│ │(OnClick) │ │(Items) │ │ │
│ │ │ 바인딩) │ │ │ │ │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 클라이언트 스크립트 참조 │ │
│ │ [보고서명].script.ts │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
AUD: Download Report로 다운로드pull_report 실행 (서버 최신 상태 동기화)save_report로 서버에 배포 (또는 AUD: Publish Script / AUD: Deploy Report)run_designer로 브라우저에서 테스트 (또는 AUD: Run Designer).design.json**을 우선 사용 (기본값 생략 + 파일 경로 참조).design.json 수정 시 기본값과 동일한 속성은 생략해도 됨 (서버에서 자동 복원).mtsd는 서버 원본(모든 기본값 + 인라인 콘텐츠, 암호화됨) — 직접 수정하지 않음.design.json이 없으면 save_report 또는 pull_report 실행 시 자동 생성DataSource/, ServerScript/ 폴더의 파일은 직접 편집 가능save_report로 서버에 배포 (또는 AUD: Publish Script)src/reports/samples/
├── MX_GRID/ # Excel 형식 그리드 샘플
│ ├── (MX_GRID) Layout/
│ ├── (MX_GRID) Excel Import/
│ └── ...
├── OLAP/ # OLAP 피벗 그리드 샘플
│ ├── (OlapGrid) 필터 제어하기/
│ └── ...
└── ETC/ # 기타 샘플
├── AUD_Dynamic-SQL/
├── FTP Client/
└── ...