majiayu000 i-AUD 보고서(프로그램) 구조 가이드
1. 개요
i-AUD의 보고서(프로그램)는 하나의 폴더로 구성되며, UI 배치, 데이터소스, 서버 스크립트, 클라이언트 스크립트 등이 포함됩니다.
2. 보고서 폴더 구조
[보고서명]/
├── .aud.json # 프로그램 메타 정보
├── [ReportCode].mtsd # 화면 정의 (JSON)
├── [보고서명].script.ts # 클라이언트 스크립트 (TypeScript)
├── [보고서명].script.js # 클라이언트 스크립트 (JavaScript)
├── DataSource/ # 데이터 조회 SQL
│ ├── DataSource1.sql
│ └── DataSource2.sql
└── ServerScript/ # 서버 스크립트
├── Service1.ts # 일반 서비스
├── @CommonModule.ts # 공통 모듈 (@로 시작)
└── Service2.sql # SQL 서비스
3. .aud.json 파일
프로그램의 메타 정보를 저장하는 파일입니다.
{
"ReportCode": "DYNAMIC_SQL",
"ReportName": "DYNAMIC_SQL 샘플",
"FolderCode": "FLD72470E8B43AE41C796541322C57190D2",
"ModuleCode": "SD",
"DocumentVersion": "3.0.0.0",
"ModifyDate": "2025-06-12 17:10:04",
"Modifier": "yglee"
}
| 필드 | 설명 |
|---|---|
ReportCode |
프로그램 고유 코드 |
ReportName |
프로그램 표시명 |
FolderCode |
서버상 폴더 코드 |
ModuleCode |
모듈 코드 |
DocumentVersion |
문서 버전 |
ModifyDate |
최종 수정일시 |
Modifier |
최종 수정자 |
4. .mtsd 파일 구조
화면 UI 배치, 데이터소스, 서비스가 정의된 JSON 문서입니다.
4.1 전체 구조
{
"ReportInfo": { ... }, // 보고서 기본 정보
"DataSources": { ... }, // 데이터소스 정의
"ScriptText": "...", // 클라이언트 스크립트
"ServerScriptText": [ ... ], // 서버 스크립트 목록
"Forms": [ ... ], // 폼 및 컨트롤 정의
"MetaDataSources": { ... }, // 메타 데이터소스
"EXECUTION_PLANS": [ ... ], // 실행 계획
"Variables": [ ... ], // 변수 정의
"Modules": [ ... ], // 모듈
"ResponsiveLayout": [ ... ], // 반응형 레이아웃
"Langs": [ ... ], // 다국어
"PersonalConditions": { ... } // 개인 조건
}
4.2 ReportInfo (보고서 정보)
{
"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
}
}
4.3 DataSources (데이터소스)
{
"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 |
파라미터 목록 |
4.4 ServerScriptText (서버 스크립트)
{
"ServerScriptText": [
{
"Name": "@DATA_MASTER",
"Key": "DATA_MASTER",
"Encrypted": true,
"ScriptText": "암호화된 스크립트..."
}
]
}
| 필드 | 설명 |
|---|---|
Name |
스크립트 이름 (@로 시작하면 공통 모듈) |
Key |
스크립트 키 |
Encrypted |
암호화 여부 |
ScriptText |
스크립트 내용 |
4.5 Forms (폼 및 컨트롤)
{
"Forms": [
{
"Id": "FormC0C2A82A6DBFD5A92D650788A672B3BA",
"Name": "Form1",
"Activated": true,
"Visible": true,
"Style": { ... },
"Elements": [
{
"Type": "DataGrid",
"Id": "DataGridF116CE7C4A9D3F1E3ED369B80D0F7D69",
"Name": "DataGrid",
"Visible": true,
"Position": {
"Left": 10,
"Top": 10,
"Width": 2421,
"Height": 924,
"ZIndex": 0,
"Docking": { ... }
},
"Style": { ... },
"DataSource": "DS6CBDBEC3A3D74BC587F53426065035EF",
"AutoRefresh": true
}
]
}
]
}
컨트롤 공통 속성:
| 필드 | 설명 |
|---|---|
Type |
컨트롤 유형 (DataGrid, Button, TextBox 등) |
Id |
컨트롤 고유 ID |
Name |
컨트롤 이름 (스크립트에서 참조) |
Visible |
표시 여부 |
Position |
위치 및 크기 |
Style |
스타일 정의 |
DataSource |
바인딩된 데이터소스 ID |
5. 주요 컨트롤 유형
| 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 |
6. DataSource 폴더
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
파라미터 바인딩:
#[파라미터명]#- 문자열 파라미터##[파라미터명]##- 숫자 파라미터
7. ServerScript 폴더
ServerScript/ 폴더에는 서버 스크립트 파일들이 저장됩니다.
7.1 일반 서비스
파일명: ServerScript/[ServiceName].ts
각 파일이 하나의 서비스로 동작합니다.
7.2 공통 모듈
파일명: ServerScript/@[ModuleName].ts
@로 시작하는 파일은 공통 모듈로, 다른 스크립트에서 import하여 사용할 수 있습니다.
// 다른 스크립트에서 사용
import { QueryRepository } from "../ServerScript/@DATA_MASTER";
//<%@include file="/REPORT_CODE/DATA_MASTER.jsx"%>
8. 클라이언트 스크립트 파일
파일명: [보고서명].script.ts 또는 [보고서명].script.js
.ts파일이 우선 탐색됩니다- TypeScript로 작성 시
.ts확장자 사용
9. 파일 간 관계
┌─────────────────────────────────────────────────────────────┐
│ .mtsd (메인 문서) │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ DataSources │ │ ServerScriptText │ │
│ │ (데이터소스) │ │ (서버스크립트) │ │
│ └────────┬────────┘ └────────┬────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ DataSource/*.sql │ │ServerScript/*.ts│ │
│ └─────────────────┘ └─────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Forms (화면 정의) │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │ DataGrid │ │ Button │ │ ComboBox │ ... │ │
│ │ │(DataSource│ │(OnClick) │ │(Items) │ │ │
│ │ │ 바인딩) │ │ │ │ │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 클라이언트 스크립트 참조 │ │
│ │ [보고서명].script.ts │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
┌─────────────────┐
│ .aud.json │ ◄─── 메타 정보 (서버 동기화용)
└─────────────────┘
10. 개발 워크플로우
- i-AUD Designer에서 보고서 생성/편집
- VS Code에서
AUD: Download Report로 다운로드 - 로컬에서 스크립트 수정 (.ts 파일)
AUD: Publish Script로 스크립트만 배포AUD: Deploy Report로 전체 배포 (디자인 포함)
11. 주의사항
.mtsd 파일
- 직접 수정하지 말고 i-AUD Designer 사용
- SQL, 스크립트는 암호화되어 저장됨
- 버전 관리 시 충돌 주의
스크립트 파일
DataSource/,ServerScript/폴더의 파일은 직접 편집 가능AUD: Publish Script로 서버에 배포
.aud.json
- VS Code 확장에서 자동 관리
- 직접 수정 불필요
12. 샘플 프로그램 위치
src/reports/samples/
├── MX_GRID/ # Excel 형식 그리드 샘플
│ ├── (MX_GRID) Layout/
│ ├── (MX_GRID) Excel Import/
│ └── ...
├── OLAP/ # OLAP 피벗 그리드 샘플
│ ├── (OlapGrid) 필터 제어하기/
│ └── ...
└── ETC/ # 기타 샘플
├── AUD_Dynamic-SQL/
├── FTP Client/
└── ...