Skip to content

Commit 4b76bf7

Browse files
happysoft2018happysoft2018
committed
document update (v1.2.3)
1 parent 1396fbe commit 4b76bf7

6 files changed

Lines changed: 369 additions & 0 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,86 @@
11
# SQL2Excel Version History
22

3+
## v1.2.3 - Parameter Override Feature Addition (2025-08-29)
4+
5+
### ✨ New Features
6+
- **⚙️ Parameter Override Feature**: Override query definition parameters for each sheet
7+
- **🔄 Enhanced Query Reuse**: Use the same query definition across multiple sheets with different parameters
8+
- **📊 Priority System**: Process in order: sheet-specific parameters > global variables > default values
9+
- **🎯 Multiple Data Type Support**: Support for string, number, array, boolean, and date parameter types
10+
- **📝 Detailed Logging**: Comprehensive logging output for parameter override process
11+
12+
### 📊 Parameter Override System
13+
14+
#### Parameter Override in XML
15+
```xml
16+
<queryDefs>
17+
<queryDef id="customer_base" description="Base customer query">
18+
<![CDATA[
19+
SELECT CustomerID, CustomerName, Email, Phone, Region
20+
FROM Customers
21+
WHERE IsActive = 1
22+
AND Region IN (${regionList})
23+
AND CreatedDate >= '${startDate}'
24+
]]>
25+
</queryDef>
26+
</queryDefs>
27+
28+
<sheets>
29+
<!-- Seoul customers -->
30+
<sheet name="SeoulCustomers" use="true" queryRef="customer_base">
31+
<params>
32+
<param name="regionList">["Seoul"]</param>
33+
<param name="startDate">2024-01-01</param>
34+
</params>
35+
</sheet>
36+
37+
<!-- Busan customers -->
38+
<sheet name="BusanCustomers" use="true" queryRef="customer_base">
39+
<params>
40+
<param name="regionList">["Busan"]</param>
41+
<param name="startDate">2024-03-01</param>
42+
</params>
43+
</sheet>
44+
</sheets>
45+
```
46+
47+
#### Parameter Override in JSON
48+
```json
49+
{
50+
"queryDefs": {
51+
"customer_base": {
52+
"name": "customer_base",
53+
"description": "Base customer query",
54+
"query": "SELECT CustomerID, CustomerName, Email, Phone, Region FROM Customers WHERE IsActive = 1 AND Region IN (${regionList}) AND CreatedDate >= '${startDate}'"
55+
}
56+
},
57+
"sheets": [
58+
{
59+
"name": "SeoulCustomers",
60+
"use": true,
61+
"queryRef": "customer_base",
62+
"params": {
63+
"regionList": ["Seoul"],
64+
"startDate": "2024-01-01"
65+
}
66+
}
67+
]
68+
}
69+
```
70+
71+
### 🔧 Improvements
72+
- **Enhanced Variable Processing Logic**: Added sheet-specific parameter support to `substituteVars` method
73+
- **Parser Improvements**: Parameter override functionality supported in both XML and JSON parsers
74+
- **Type Safety**: Safe parsing and processing for various data types
75+
- **Logging System**: Detailed logging output for parameter override process to support debugging
76+
77+
### 📚 Documentation
78+
- **User Manual Update**: Added detailed parameter override feature description
79+
- **Example File Updates**: Added parameter override examples
80+
- **README Update**: Added parameter override to main feature list
81+
82+
---
83+
384
## v1.2.2 - Dynamic Variables System Enhancement (2025-08-20)
485

586
### ✨ New Features

‎CHANGELOG_KR.md‎

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,86 @@
11
# SQL2Excel 버전 히스토리
22

3+
## v1.2.3 - 파라미터 재설정 기능 추가 (2025-08-29)
4+
5+
### ✨ 새로운 기능
6+
- **⚙️ 파라미터 재설정 기능**: 시트별로 쿼리 정의의 파라미터 값을 재설정
7+
- **🔄 쿼리 재사용 강화**: 동일한 쿼리 정의를 여러 시트에서 다른 파라미터로 사용
8+
- **📊 우선순위 시스템**: 시트별 파라미터 > 전역 변수 > 기본값 순서로 처리
9+
- **🎯 다중 데이터 타입 지원**: 문자열, 숫자, 배열, 불린, 날짜 타입 파라미터 지원
10+
- **📝 상세 로깅**: 파라미터 재설정 과정의 상세한 로그 출력
11+
12+
### 📊 파라미터 재설정 시스템
13+
14+
#### XML에서 파라미터 재설정
15+
```xml
16+
<queryDefs>
17+
<queryDef id="customer_base" description="기본 고객 쿼리">
18+
<![CDATA[
19+
SELECT CustomerID, CustomerName, Email, Phone, Region
20+
FROM Customers
21+
WHERE IsActive = 1
22+
AND Region IN (${regionList})
23+
AND CreatedDate >= '${startDate}'
24+
]]>
25+
</queryDef>
26+
</queryDefs>
27+
28+
<sheets>
29+
<!-- 서울 지역 고객 -->
30+
<sheet name="서울고객목록" use="true" queryRef="customer_base">
31+
<params>
32+
<param name="regionList">["서울"]</param>
33+
<param name="startDate">2024-01-01</param>
34+
</params>
35+
</sheet>
36+
37+
<!-- 부산 지역 고객 -->
38+
<sheet name="부산고객목록" use="true" queryRef="customer_base">
39+
<params>
40+
<param name="regionList">["부산"]</param>
41+
<param name="startDate">2024-03-01</param>
42+
</params>
43+
</sheet>
44+
</sheets>
45+
```
46+
47+
#### JSON에서 파라미터 재설정
48+
```json
49+
{
50+
"queryDefs": {
51+
"customer_base": {
52+
"name": "customer_base",
53+
"description": "기본 고객 쿼리",
54+
"query": "SELECT CustomerID, CustomerName, Email, Phone, Region FROM Customers WHERE IsActive = 1 AND Region IN (${regionList}) AND CreatedDate >= '${startDate}'"
55+
}
56+
},
57+
"sheets": [
58+
{
59+
"name": "서울고객목록",
60+
"use": true,
61+
"queryRef": "customer_base",
62+
"params": {
63+
"regionList": ["서울"],
64+
"startDate": "2024-01-01"
65+
}
66+
}
67+
]
68+
}
69+
```
70+
71+
### 🔧 개선사항
72+
- **변수 처리 로직 강화**: `substituteVars` 메서드에 시트별 파라미터 지원 추가
73+
- **파서 개선**: XML과 JSON 파서 모두에서 파라미터 재설정 기능 지원
74+
- **타입 안전성**: 다양한 데이터 타입에 대한 안전한 파싱 및 처리
75+
- **로깅 시스템**: 파라미터 재설정 과정의 상세한 로그 출력으로 디버깅 지원
76+
77+
### 📚 문서화
78+
- **사용자 매뉴얼 업데이트**: 파라미터 재설정 기능 상세 설명 추가
79+
- **예제 파일 업데이트**: 파라미터 재설정 예제 추가
80+
- **README 업데이트**: 주요 기능 목록에 파라미터 재설정 추가
81+
82+
---
83+
384
## v1.2.2 - 동적 변수 시스템 추가 (2025-08-20)
485

586
### ✨ 새로운 기능
@@ -272,6 +353,8 @@ resources/
272353

273354
| 버전 | 주요 기능 | 릴리즈 일자 |
274355
|------|-----------|-------------|
356+
| **v1.2.3** | 파라미터 재설정 기능, 쿼리 재사용 강화 | 2025-08-29 |
357+
| **v1.2.2** | 동적 변수 시스템, 실시간 데이터 조회 | 2025-08-20 |
275358
| **v1.2.1** | 문서화 개선, 사용자 매뉴얼 추가 | 2025-08-11 |
276359
| **v1.2.0** | 쿼리 재사용, CLI 개선, 윈도우 배치 파일 | 2025-08-07 |
277360
| **v1.1.0** | 자동 목차, 집계 기능, 다중 DB, 조회 제한 | 2025-07-22 |

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ A Node.js-based tool for generating Excel files from SQL query results.
1010
- 📝 **Variable System**: Use variables in queries for dynamic query generation
1111
- 🔄 **Dynamic Variables**: Extract values from database in real-time for dynamic query generation
1212
- 🔄 **Query Reuse**: Define common queries and reuse them across multiple sheets
13+
- ⚙️ **Parameter Override**: Override query definition parameters for each sheet
1314
- 📋 **Auto Table of Contents**: Automatically generate table of contents sheet with hyperlinks
1415
- 📊 **Aggregation Features**: Automatic aggregation and display of counts by specified column values
1516
- 🚦 **Query Limits**: Row count limiting for large data processing

‎README_KR.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ SQL 쿼리 결과를 엑셀 파일로 생성하는 Node.js 기반 도구입니
1010
- 📝 **변수 시스템**: 쿼리 내 변수 사용으로 동적 쿼리 생성
1111
- 🔄 **동적 변수**: 데이터베이스에서 실시간으로 값을 조회하여 동적 쿼리 생성
1212
- 🔄 **쿼리 재사용**: 공통 쿼리 정의 후 여러 시트에서 재사용
13+
- ⚙️ **파라미터 재설정**: 시트별로 쿼리 정의의 파라미터 값을 재설정
1314
- 📋 **자동 목차**: 목차 시트 자동 생성 및 하이퍼링크 제공
1415
- 📊 **집계 기능**: 지정 컬럼의 값별 건수 자동 집계 및 표시
1516
- 🚦 **조회 제한**: 대용량 데이터 처리를 위한 건수 제한 기능

‎USER_MANUAL.md‎

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ SQL2Excel is a Node.js-based tool for generating Excel files from SQL query resu
2222
- 📝 **Variable System**: Use variables in queries for dynamic query generation
2323
- 🔄 **Enhanced Dynamic Variables**: Extract values from database in real-time with advanced processing
2424
- 🔄 **Query Reuse**: Define common queries and reuse them across multiple sheets
25+
- ⚙️ **Parameter Override**: Override query definition parameters for each sheet
2526
- 📋 **Auto Table of Contents**: Automatically generate table of contents sheet with hyperlinks
2627
- 📋 **Separate TOC Generation**: Generate standalone table of contents Excel file
2728
- 📊 **Aggregation Features**: Automatic aggregation and display of counts by specified column values
@@ -413,6 +414,8 @@ WHERE CustomerID IN (${customerData.CustomerID})
413414
```
414415

415416
### 2. Query Reuse
417+
418+
#### Basic Query Reuse
416419
```xml
417420
<queryDefs>
418421
<queryDef id="customer_base" description="Base customer query">
@@ -430,6 +433,105 @@ WHERE CustomerID IN (${customerData.CustomerID})
430433
</sheets>
431434
```
432435

436+
#### Parameter Override Feature
437+
438+
You can use the same query definition across multiple sheets while applying different parameter values for each.
439+
440+
##### Parameter Override in XML
441+
```xml
442+
<queryDefs>
443+
<queryDef id="customer_base" description="Base customer query">
444+
<![CDATA[
445+
SELECT CustomerID, CustomerName, Email, Phone, Region
446+
FROM Customers
447+
WHERE IsActive = 1
448+
AND Region IN (${regionList})
449+
AND CreatedDate >= '${startDate}'
450+
]]>
451+
</queryDef>
452+
</queryDefs>
453+
454+
<sheets>
455+
<!-- Seoul customers -->
456+
<sheet name="SeoulCustomers" use="true" queryRef="customer_base">
457+
<params>
458+
<param name="regionList">["Seoul"]</param>
459+
<param name="startDate">2024-01-01</param>
460+
</params>
461+
</sheet>
462+
463+
<!-- Busan customers -->
464+
<sheet name="BusanCustomers" use="true" queryRef="customer_base">
465+
<params>
466+
<param name="regionList">["Busan"]</param>
467+
<param name="startDate">2024-03-01</param>
468+
</params>
469+
</sheet>
470+
471+
<!-- All regions customers -->
472+
<sheet name="AllCustomers" use="true" queryRef="customer_base">
473+
<params>
474+
<param name="regionList">["Seoul", "Busan", "Daegu", "Incheon"]</param>
475+
<param name="startDate">2024-01-01</param>
476+
</params>
477+
</sheet>
478+
</sheets>
479+
```
480+
481+
##### Parameter Override in JSON
482+
```json
483+
{
484+
"queryDefs": {
485+
"customer_base": {
486+
"name": "customer_base",
487+
"description": "Base customer query",
488+
"query": "SELECT CustomerID, CustomerName, Email, Phone, Region FROM Customers WHERE IsActive = 1 AND Region IN (${regionList}) AND CreatedDate >= '${startDate}'"
489+
}
490+
},
491+
"sheets": [
492+
{
493+
"name": "SeoulCustomers",
494+
"use": true,
495+
"queryRef": "customer_base",
496+
"params": {
497+
"regionList": ["Seoul"],
498+
"startDate": "2024-01-01"
499+
}
500+
},
501+
{
502+
"name": "BusanCustomers",
503+
"use": true,
504+
"queryRef": "customer_base",
505+
"params": {
506+
"regionList": ["Busan"],
507+
"startDate": "2024-03-01"
508+
}
509+
}
510+
]
511+
}
512+
```
513+
514+
##### Parameter Priority
515+
1. **Sheet-specific parameters** (highest priority)
516+
2. **Global variables** (vars section)
517+
3. **Default values** (hardcoded in query definition)
518+
519+
##### Supported Parameter Types
520+
- **String**: `"Seoul"`
521+
- **Number**: `1000`
522+
- **Array**: `["Seoul", "Busan"]`
523+
- **Boolean**: `true`, `false`
524+
- **Date**: `"2024-01-01"`
525+
526+
##### Log Output Example
527+
```
528+
[쿼리 참조] 시트 "SeoulCustomers"이(가) 쿼리 정의 "customer_base"을(를) 참조합니다.
529+
[파라미터 재설정] 시트 "SeoulCustomers"에서 파라미터 재설정: {
530+
regionList: [ 'Seoul' ],
531+
startDate: '2024-01-01'
532+
}
533+
```
534+
433535
### 3. Separate Table of Contents
434536

435537
Generate a standalone TOC file:

0 commit comments

Comments
 (0)