Update document for v1.3.3

Author: mrjung72

CHANGELOG.md

@@ -2,10 +2,22 @@
 
 ## v1.3.3 - Docs Sync & Version Bump (2025-10-31)
 
-### 📝 Documentation
+### ✨ New/Changed
+- Added `exceptColumns` attribute to exclude specific columns from sheet output
+  - XML: `<sheet name="..." exceptColumns="ColA, ColB">` (comma-separated)
+  - JSON: supports `"exceptColumns": ["ColA", "ColB"]` or legacy `"except_columns": ["ColA", "ColB"]`
+  - Case-insensitive key detection; backward compatible with `except_columns`
+- Behavior: specified columns are removed from the recordset before writing files (Excel/CSV/TXT), so they are not included in outputs
 - Synchronized KR/EN documents (README, USER_MANUAL, CHANGELOG)
 - Updated package version to 1.3.3
 
+### 🔧 Code Changes
+- `src/query-parser.js`: Parse `exceptColumns` (and `except_columns`) from XML/JSON and normalize to array
+- `src/index.js`: When a sheet defines `exceptColumns`, remove those columns from result rows prior to export
+
+### 📝 Documentation
+- README/README_KR, USER_MANUAL/USER_MANUAL_KR, CHANGELOG/CHANGELOG_KR updated accordingly
+
 ## v1.3.2 - CSV/TXT Formatting & Directory Naming (2025-10-31)
 
 ### ✨ New/Changed

CHANGELOG_KR.md

@@ -2,34 +2,26 @@
 
 ## v1.3.3 - 문서 동기화 및 버전 올림 (2025-10-31)
 
-### 📝 문서
-- KR/EN 문서(README, USER_MANUAL, CHANGELOG) 동기화
-- 패키지 버전을 1.3.3으로 업데이트
-
-## v1.3.2 - CSV/TXT 포맷팅 및 디렉토리 명명 변경 (2025-10-31)
-
 ### ✨ 변경 사항
-- 시트별 내보내기 디렉토리 명명 단순화
-  - 디렉토리가 이제 `<출력파일베이스>`로 생성됩니다 (확장자 접미사 제거)
-  - 예: `output="d:/temp/report.csv"` → 디렉토리 `d:/temp/report/`
-- CSV/TXT 필드 포맷팅 변경
-  - CSV 인용/이스케이프 규칙은 출력 확장자가 `.csv`일 때만 적용
-  - 비-CSV(예: `.txt`, `.sql` 등)는 인용 없이 값 그대로 출력
-  - 필드 내부 줄바꿈(\r/\n)은 CSV/TXT 모두 공백으로 정규화
-  - 레코드 구분 개행은 CRLF 유지, 헤더는 계속 포함
-  - 날짜 값은 CSV/TXT 및 SQL 리터럴에서 `yyyy-MM-dd HH:mm:ss`(24시간) 형식으로 직렬화
+- 시트에서 특정 컬럼을 결과에서 제외하는 `exceptColumns` 속성 추가
+  - XML: `<sheet name="..." exceptColumns="ColA, ColB">`와 같이 쉼표로 구분해 지정
+  - JSON: `"exceptColumns": ["ColA", "ColB"]` 또는 `"except_columns": ["ColA", "ColB"]` 지원
+  - 대소문자 구분 없이 키 탐색, 하위 호환으로 `except_columns`도 인식
+- 동작: 내보내기 전에 지정된 컬럼을 레코드셋에서 제거하여 파일(Excel/CSV/TXT)에 포함되지 않도록 처리
+- 예시:
+  ```sql
+  <sheet name="사용자 목록" exceptColumns="password, email">
+    SELECT * FROM users
+  </sheet>
+  ```
 
 ### 🔧 코드 변경
-- `src/excel-generator.js`
-  - `isCsv` 플래그 추가 및 포맷별 값 포매터 분기
-  - `escapeCsv()`에서 인용 전 내부 줄바꿈 정규화
-  - 비-CSV용 `toPlain()`에 내부 줄바꿈 정규화 추가
-  - 시트별 대상 디렉토리 `<base>_<ext>` → `<base>`로 변경
+- `src/query-parser.js`: XML/JSON에서 `exceptColumns`(및 `except_columns`) 파싱하여 배열로 표준화
+- `src/index.js`: 시트 정의의 `exceptColumns`가 있으면 해당 컬럼들을 결과에서 제거하는 전처리 적용
 
 ### 📝 문서
-- README/README_KR: 시트별 디렉토리 규칙 및 CSV/TXT 줄바꿈 정규화, 인용 적용 범위 반영
-- USER_MANUAL/USER_MANUAL_KR: 시트별 내보내기 섹션에 디렉토리 명명 및 포맷팅 규칙 업데이트
-- CHANGELOG/CHANGELOG_KR: v1.3.2 항목 추가
+- KR/EN 문서(README, USER_MANUAL, CHANGELOG) 동기화
+- 패키지 버전을 1.3.3으로 업데이트
 
 ## v1.3.1 - 파일명 변수 및 DATE 개선 (2025-10-30)
 

USER_MANUAL.md

@@ -21,6 +21,7 @@ SQL2Excel is a powerful Node.js-based tool for generating Excel files from SQL q
 
 ### What's New (v1.3.3)
 
+- Added `exceptColumns` sheet option (XML/JSON) to exclude specific columns from outputs
 - Documentation synchronization across KR/EN
 - Package version updated to 1.3.3
 
@@ -142,6 +143,22 @@ Create `config/dbinfo.json` file:
   - CSV/TXT formatting: `.csv` applies CSV quoting/escaping; non-CSV writes plain values; internal newlines (\r/\n) normalized to spaces for both
   - Dates: `yyyy-MM-dd HH:mm:ss` (24-hour)
 
+### Sheet option: exceptColumns (v1.3.3)
+  
+- Purpose: Exclude specific columns from the final files (Excel/CSV/TXT) for a sheet
+- XML: `<sheet name="..." exceptColumns="ColA, ColB">` (comma-separated)
+- JSON: supports `"exceptColumns": ["ColA", "ColB"]` and legacy `"except_columns": ["ColA", "ColB"]`
+- Case-insensitive key detection
+- Behavior: columns listed are removed from the recordset just before export, so they never appear in outputs
+- Example:
+    ```xml
+    <sheet name="UserList" use="true" exceptColumns="password, email">
+      <![CDATA[
+        SELECT * FROM users
+      ]]>
+    </sheet>
+    ```
+
 ## 🚀 Basic Usage
 
 ### Language Settings

USER_MANUAL_KR.md

@@ -21,8 +21,7 @@ SQL2Excel은 고급 스타일링, 템플릿 지원, 독립 실행 파일 배포
 
 ### v1.3.3 주요 변경
 
-- KR/EN 문서 동기화 및 소규모 정리
-- 패키지 버전을 1.3.3으로 업데이트
+- 시트에서 특정 컬럼 제외를 위한 `exceptColumns` 속성 추가 (XML/JSON)
 
 ### 주요 기능
 - 📊 **다중 시트 지원**: 하나의 엑셀 파일 내에서 여러 SQL 쿼리 결과를 별도의 시트에 저장
@@ -131,6 +130,34 @@ npm run build
 }
 ```
 
+### 시트별 내보내기 (CSV/TXT)
+
+- Routing by `excel.output` extension
+  - `.xlsx`/`.xls` → Single Excel workbook
+  - `.csv` → Per-sheet CSV
+  - Others → Per-sheet TXT (tab-delimited)
+- Output directory and filenames
+  - Files are written under `<output_basename>` (updated in v1.3.2)
+  - Each file name is the sheet `originalName` (sanitized, max 100 chars). No 31-char limit (Excel-only)
+  - CSV/TXT formatting: `.csv` applies CSV quoting/escaping; non-CSV writes plain values; internal newlines (\r/\n) normalized to spaces for both
+  - Dates: `yyyy-MM-dd HH:mm:ss` (24-hour)
+
+### Sheet 옵션: exceptColumns (v1.3.3)
+
+- 목적: 시트 쿼리 결과에서 특정 컬럼을 최종 파일(Excel/CSV/TXT)에 포함하지 않도록 제외
+- XML: `<sheet name="..." exceptColumns="ColA, ColB">`  (쉼표로 구분)
+- JSON: `"exceptColumns": ["ColA", "ColB"]` 또는 하위호환 `"except_columns": ["ColA", "ColB"]`
+- 키 대소문자 구분 없이 탐색 (case-insensitive)
+- 동작: 내보내기 직전에 지정 컬럼을 레코드셋에서 제거하여 모든 출력 포맷에서 배제
+- 예시:
+  ```xml
+  <sheet name="UserList" use="true" exceptColumns="password, email">
+    <![CDATA[
+      SELECT * FROM users
+    ]]>
+  </sheet>
+```
+
 ## 🚀 기본 사용법
 
 ### 언어 설정