청구 잡이 고객 템플릿을 열어 B3에 42750을 쓰고 저장한다. 그리고 압축을 푼 두 패키지를 diff 해 보면 변경 목록은 셀 하나보다 훨씬 길다. xl/theme/theme1.xml에는 고객의 청록·청회색 팔레트 대신 표준 Office 팔레트가 들어 있고, 워크시트 XML 아래의 <extLst>에서는 스파크라인 그룹과 더 새로운 조건부 서식 규칙이 사라졌으며, xl/calcChain.xml은 아예 없어졌다. Excel은 결과를 열다가 복구를 제안하고 브랜드 색은 사라져 있다. 코드가 건드린 것은 셀 하나다. 나머지가 모두 바뀐 이유는 저장이 인메모리 모델이 아는 것만으로 패키지를 다시 빌드했기 때문인데, 전형적인 템플릿의 세 부분은 스프레드시트 모델이 평소 담지 않는 것들이다
셀 하나 수정이 XLSX 패키지 전체를 다시 쓰는 이유
.xlsx 파일은 XML 파트의 ZIP이다. xl/workbook.xml, 시트마다 하나의 xl/worksheets/sheetN.xml, xl/styles.xml, xl/sharedStrings.xml, 테마, 계산 체인, 그리고 워크북이 싣고 있는 드로잉, 표, 피벗 캐시들. 값을과 수식을 객체로 읽어들인 뒤 저장 때 그 객체들로 모든 파트를 재생성하는 라이브러리에는 약점이 하나 있다. 객체 모델에 슬롯이 없는 것은 메모리에 들어 가지 못하고, 재생성된 파트에는 그것이 빠진 채 나온다. 스파크라인을 삭제하는 코드가 필요 없다. Open과 SaveAs 사이에 그것이 살 곳이 없을 뿐이다
ECMA-376은 이 일의 절반을 예견하고 있었다. SpreadsheetML은 extLst(워크북 수준 요소는 ECMA-376 Part 1 §18.2.10, 워크시트·스타일·조건부 서식에도 짝이 되는 요소가 있다)를 미래 기능의 저장 영역으로 예약해 둔다. 더 새로운 생산자는 각 기능을 uri 속성으로 기능 이름을 밝히는 <ext> 요소에 감싸고, 더 오래된 소비자는 이해하지 못하는 것을 그대로 운반하는 것이 기대된다. 오늘날 Excel이 쓰는 파일에서 스파크라인, 슬라이서 목록, 더 새로운 데이터 막대·아이콘 집합 옵션, 확장 데이터 유효성 검사는 전부 이 길로 이동한다. 알 수 없는 <ext> 블록을 버리면 포맷이 세워진 기반인 포워드 호환성 계약이 깨지는데, 피해는 고객이 파일을 Excel에서 다시 열 때에야 드러난다
테마와 계산 체인은 서로 다른 이유로 망가지므로 각자의 처치가 필요하다. 이 글의 나머지는 HotXLS가 세 가지를 각각 어떻게 다루는지, Delphi 호출자가 무엇을 관측하고 검증할 수 있는지, 그리고 그 보증이 어디서 끝나는지를 훑는다
Delphi에서 커스텀 theme1.xml 온전히 유지하기
HotXLS는 열린 패키지에서 xl/theme/theme1.xml의 원본 바이트를 쥐어 두고 SaveAs 때 그 파트를 그대로 되돌려 쓰는 방식으로 워크북의 테마를 지킨다. 테마 파트(ECMA-376 Part 1, §14.2.7)는 DrawingML이다. 열두 슬롯의 색 구성표, 폰트 구성표, 채우기·선·효과의 서식 구성표다. 셀 스타일은 <color theme="4"/> 같은 참조로 그 안을 가리키므로, 스프레드시트 엔진은 슬롯을 해석하는 것만 필요하지 그라디언트나 효과 스타일을 이해할 필요는 없다. 저장 때마다 고정된 Office 테마를 재생성하는 것이 바로 고객의 청록색을 Office 파란색으로 바꾸는 길이다. 테마 없이 처음부터 만든 워크북은 대신 내장 Office 테마를 받는다
평범한 사례에는 테마 코드가 전혀 필요 없다. 시트 인덱스에 유의하라. XLSX 엔진에서 Sheets는 1부터 시작하고, Cells[3, 2]는 3행 2열, 즉 B3다
var
Book: TXLSXWorkbook;
begin
Book := TXLSXWorkbook.Create;
try
Book.Open('branded-invoice.xlsx');
Book.Sheets[1].Cells[3, 2].Value := 42750.00; // 유일한 수정
Book.SaveAs('branded-invoice-out.xlsx');
// 출력물의 xl/theme/theme1.xml은 템플릿 자체의 테마를 싣는다
finally
Book.Free;
end;
end;
원시 바이트는 이런 파트에서 얻을 수 있는 가장 강한 충실도다. 파싱도, 재직렬화도 없으니 흐트러질 것도 없다. 저장이 트랜지셔널 방언 대신 Strict OOXML을 쓸 때는 캡처한 테마가 복사되지 않고 네임스페이스 변환기를 거친다. 바이트 복사로는 트랜지셔널 네임스페이스 URI가 Strict 패키지 안에 남기 때문이다
함정은 API 쪽에 있다. TXLSXWorkbook은 ThemeMajorFont와 ThemeMinorFont를 노출하는데, Open 후에는 템플릿의 폰트 구성표에서 파싱한 제목·본문 서체를 보고한다. 세팅하는 것이 폰트를 바꾸는 자연스러운 방법처럼 보이지만, 이 둘이 모양을 결정하는 것은 새 워크북이 받는 내장 Office 테마뿐이다. 자기 테마를 가져온 워크북에서는 캡처한 파트가 이기고 그 두 세터는 저장 파일에 아무 변화도 주지 못한다. 색은 다르게 다뤄진다. ThemeColor[Slot]는 열두 clrScheme 슬롯을 겨냥하고, 재정의는 그 슬롯의 색만 교체하는 방식으로 보존된 테마에 기록되며 폰트 구성표, 서식 구성표, 테마 확장은 하나도 건드리지 않는다
Book.Open('branded-invoice.xlsx');
// 저장 파일에는 효과 없음: 템플릿 자체의 테마가 보존된다
Book.ThemeMajorFont := 'Segoe UI Semibold';
// 파일에는 닿는다: theme1.xml 안의 accent1 슬롯만 바뀐다
Book.ThemeColor[xlsxThemeAccent1] := $FF0F7B6C; // $AARRGGBB
Book.SaveAs('rebranded.xlsx');
이 분리는 의도된 것이다. 색 재정의는 한 요소에 대한 좁고 잘 정의된 편집이라 디자이너 테마의 나머지는 원형 그대로 남을 수 있다. 폰트 구성표 재작성은 스크립트별 폰트 목록을 건드리는데, 데이터 지향 API가 그것을 표현할 좋은 방법이 없다. 템플릿에 새 서체가 필요하면 Excel에서 바꾸고 새 템플릿을 배포하라. 그래야 테마가 브랜드를 소유한 이의 손에 남는다
알 수 없는 extLst 블록은 저장 시 어떻게 처리되나?
HotXLS는 네이티브로 모델링하지 않는 워크시트 수준의 <ext> 블록을 전부 캡처해서 저장되는 워크시트의 extLst 안에서 재생한다. 모델링하는 블록은 타입화된 객체로 파싱되고 그 객체에서 다시 만들어진다. 스파크라인 그룹은 SparklineGroups로 들어 가고, x14 데이터 유효성 확장은 데이터 유효성 컬렉션으로 읽히며, 슬라이서 목록은 슬라이서 모델이 다시 내보낸다. 나머지 전부는 블록마다 XML 조각 하나로 각 TXLSXWorksheet의 읽기 전용 RawWorksheetExts 문자열 목록에 담기므로, 테스트가 앞으로 운반될 내용을 정확히 검사할 수 있다
var
Book: TXLSXWorkbook;
Sheet: TXLSXWorksheet;
i: Integer;
begin
Book := TXLSXWorkbook.Create;
try
Book.Open('from-newer-excel.xlsx');
Sheet := Book.Sheets[1];
WriteLn(Format('%d foreign ext block(s), %d sparkline group(s)',
[Sheet.RawWorksheetExts.Count, Sheet.SparklineGroups.Count]));
for i := 0 to Sheet.RawWorksheetExts.Count - 1 do
WriteLn(Copy(Sheet.RawWorksheetExts[i], 1, 100)); // 여는 태그가 uri를 보여 준다
// 조각들이 <worksheet> 루트에서 빌려 온 네임스페이스 선언
WriteLn(Sheet.RawExtNamespaceDecls);
finally
Book.Free;
end;
end;
캡처는 XML 이벤트 스트림에서 작동한다. 스트리밍 리더는 요소와 텍스트, 종료 태그를 내주지만 소스 안의 바이트 오프셋은 주지 않기 때문이다. 알 수 없는 서브트리 각각은 그 이벤트들이 지나갈 때 재빌드된다. 순진한 깊이 카운터는 여기서 깨진다. 시작 태그마다 더하고 종료 태그마다 빼는데, <x14:cfvo type="min"/> 같은 자기 닫음 자식은 빈 표시가 된 시작 이벤트 하나로 도착하고 뒤따르는 종료 태그가 없다. 그것을 열린 요소로 세면 카운터는 다시 0으로 돌아오지 않고 캡처가 워크시트의 나머지를 삼켜 버린다. HotXLS의 캡처 루프는 비어 있지 않은 시작 태그에만 깊이를 더하고, 스스로 빈 <ext/>는 한 줄짜리 조각으로 즉시 저장된다
이벤트에서 재빌드하면 눈에 보이는 부작용이 하나 있다. 속성 따옴표 방식, 요소 사이의 공백, <a></a>와 <a/>의 선택이 정규화되어 돌아오므로, 조각은 의미상 원본과 동등하지만 바이트 단위로 동일하지는 않다. Excel은 XML을 파싱하지 바이트를 비교하지 않는다. 그래도 텍스트를 비교하는 diff 도구는 변화를 표시할 것이므로, 누군가 회귀로 접수하기 전에 그 사실을 알아 두는 것이 좋다
네임스페이스는 재생된 조각이 두 번째로 흔히 삐끗하는 지점이다. Excel은 보통 필요한 접두사를 <ext> 요소 자체에 선언해서 조각을 자족적으로 만들지만, 어떤 블록은 소스 <worksheet> 루트에 한 번 선언된 x14ac나 xr 같은 접두사에 기대기도 한다. 그 조각을 선언 없는 워크시트로 재생하면 저장된 XML은 네임스페이스 관점에서 잘 형성되지 않는다. HotXLS는 캡처한 조각마다 쓰면서 선언하지 않는 접두사를 훑고, 소스에서 짝이 되는 선언을 RawExtNamespaceDecls에 기록한 뒤 저장되는 워크시트 루트에 기록한다. 조각이 평범한 문자열이므로, 워크북 안팎으로 워크시트 복제하기가 그 조각들을 새 시트로 운반할 수도 있다
Excel이 수식을 신뢰하게 만드는 calcChain.xml 작성법
HotXLS는 저장되는 워크북에 수식 셀이 하나라도 있으면 xl/calcChain.xml(Calculation Chain 파트, ECMA-376 Part 1, §12.3.1)를 콘텐츠 타입 재정의와 워크북 관계와 함께 쓴다. 항목마다 <c r="D10" i="1"/> 요소 하나다. 셀 참조에 1부터 시작하는 시트 인덱스를 더한 것으로, 스키마는 같은 시트의 연속 항목이 그 값을 생략하는 것을 허용하지만 라이터는 모든 항목에 내보낸다. 명시가 더 단순하고 똑같이 유효하다
순서는 워크북이 이미 아는 것에 달렸다. 수식 의존성 그래프가 존재하고 최신인 상태, 이르면 Recalculate 직후의 상태에서는 체인이 완전한 위상 순서를 따른다. 모든 수식이 자기가 의존하는 셀들 뒤에 오고, 순환 참조의 멤버들은 끝에 덧붙어 체인이 모든 수식 셀을 여전히 나열하게 된다. 그래프가 낡았거나 한 번도 만들어지지 않았으면 수식 셀은 시트 순서대로 문서 순서로 나열된다. 둘 다 합법이다. 포맷에 대한 Microsoft 구현 노트인 [MS-XLSX]는 체인을 Excel이 계산하면서 검증하고 재정렬하는 힌트로 기술하므로, 어떤 순서의 완전한 목록이든 깨끗하게 불러온다
Book.Open('model.xlsx');
Book.Sheets[1].Cells[10, 4].Formula := '=SUM(D2:D9)';
// 여기서 저장하면 수식 셀이 문서 순서로 나열된다. 수식을 바꾼 순간
// 의존성 그래프가 무효화되기 때문이다.
Book.Recalculate; // 그래프를 다시 만들고 캐시 값을 새로 고친다
Book.SaveAs('model-out.xlsx');
// calcChain.xml은 이제 의존성 순서를 따른다. D10은 D2:D9 뒤에 온다
SaveAs는 제발 없이 그래프를 만들지 않는다. 전체 의존성 빌드는 모든 수식의 모든 참조를 해석하는 일이고, 큰 모델에서는 파일을 쓰고 싶었을 뿐인 호출자가 요청한 적 없는 실질 비용이다. 출력에 담긴 캐시 값이 중요하다면, Excel을 열지 않고 읽는 다운스트림 시스템에게는 대개 중요하다면, 저장 전에 어차피 Recalculate를 호출하라. 의존성 순서의 체인은 덤으로 따라온다
Excel이 참고용으로 치는 파트를 굳이 내보내는 이유는 무엇인가. 없으면 눈에 띄기 때문이다. 복구 휴리스틱, 서드파티 뷰어, diff 도구는 모두 수식 워크북이 계산 체인을 싣는 것을 기대하고, 그것이 없는 패키지는 Excel 자신이 만드는 어떤 것과도 다르게 보인다. 유효한 체인을 쓰면 출력이 생태계의 나머지가 지금까지 단련되어 온 형태 안에 머무르고, 비용은 수식 셀 한 번 훑기에 지나지 않는다
무손실 라운드트립이 끝나는 지점
HotXLS는 패키지 전체를 바이트 단위로 복사하지 않으므로 출력을 그 기준으로 판정해서는 안 된다. 워크시트 XML, styles.xml, 공유 문자열, 워크북 파트는 파싱된 모델에서 재생성되므로 내용은 충실해도 입력과 이진적으로 동일하지는 않다. ZIP 로컬 헤더만으로도 새 타임스탬프를 실어 온다. 캡처한 <ext> 조각은 앞서 말했듯 정규화되어 돌아온다. ThemeMajorFont와 ThemeMinorFont는 보존된 테마 밖에 머물고, ThemeColor 재정의는 슬롯 단위로 그 안에 들어 간다
보존망에는 정해진 형태가 있다. 엔진이 네이티브로 모델링하는 기능, 이르면 스파크라인과 확장 데이터 유효성 검사는 파싱되어 다시 쓰인다. 워크시트 수준의 외부 <ext> 콘텐츠는 재생된다. 테마 파트는 캡처한 대로 운반된다. VBA 프로젝트와 외부 워크북 참조는 같은 "모델링하지 않은 것은 지켜 둔다" 방식으로 저장을 통과하는데, 이는 VBA와 외부 링크 보존에 관한 짝 글에서 다루고, docProps의 문서 속성에는 자체 읽기·쓰기 API가 있다. 모델링도 되고 확장 지점 안에도 들지 않는 특이한 애드인의 파트는 여기서 다루는 세 메커니즘 바깥에 있다
의미 있는 검증은 여러분의 파일로 한다. 기능이 풍부한 실전 템플릿을 열어 값 하나를 바꾸고 저장한 다음, 두 패키지의 압축을 풀고 파트별로 diff하라. 편집한 시트와 styles.xml, extLst 안의 속성 서식에는 차이가 있을 수 있다. 테마 파트는 입력과 일치해야 하고, <ext> 요소들은 같은 uri 값을 나열해야 하며, calcChain.xml은 모든 수식 셀을 이름 지어야 한다. 그 목록을 넘는 차이는 템플릿이 실전에 들기 전에 쫓아 볼 가치가 있다
테마 보존, 외부 extLst 재생, 계산 체인 출력은 HotXLS Delphi Excel Component의 XLSX 엔진에 들어 있는 기능이다. 제품 페이지에 Delphi와 C++Builder 프로젝트를 위해 읽고 쓰는 나머지 것들이 정리되어 있다