아카이브 유입 검사는 단 한 가지 이유로 스프레드시트를 반려한다. xl/workbook.xml의 루트 엘리먼트가 http://schemas.openxmlformats.org/spreadsheetml/2006/main 네임스페이스에 놓여 있다는 것. Excel은 똑같은 파일을 아무 말 없이 열어 준다. 두 결과 모두 올바르다. ISO/IEC 29500은 Part 1에서 Strict SpreadsheetML을 정의하고 레거시 호환 기능을 갖춘 Transitional 형태는 Part 4에 두는데, 검사기가 지목한 URI는 Transitional 쪽에 속한다. ISO 29500 Strict를 명시하는 입찰 조건이나 기록 보관 정책은 패키지의 모든 파트에서 purl.oclc.org 어휘를 기대하므로, Excel은 만족시키면서도 그 검사는 완전히 빗나갈 수 있다
Strict와 Transitional 사이에서는 무엇이 바뀌는가?
눈에 보이는 변화는 어휘다. Strict 워크북 파트는 http://purl.oclc.org/ooxml/spreadsheetml/main을 루트 네임스페이스로, http://purl.oclc.org/ooxml/officeDocument/relationships를 r:id 참조의 네임스페이스로 선언한다. DrawingML, 차트, 그림, 스프레드시트 드로잉 네임스페이스도 같은 방식으로 옮겨 가고, 문서 속성 파트도 마찬가지다. 릴레이션십 타입도 함께 바뀐다. 루트 릴레이션십 파트는 http://purl.oclc.org/ooxml/officeDocument/relationships/officeDocument를 가리키고, extended properties와 custom properties 타입은 extendedProperties, customProperties처럼 camelCase로 표기된다. Transitional에서는 하이픈으로 써 두었던 것들이다
덜 눈에 띄는 변화는 범위다. Strict는 레거시 바이너리 동작을 담기 위해서만 존재하던 Transitional 스키마의 영역을 빼버렸고, Office가 나중에 추가한 확장에는 어휘가 아예 없다. 이 빈틈은 문자열 치환으로 메울 수 없다. 일부 기능은 Strict 표기 자체가 없기 때문이다. 패키지 변환은 따라서 두 가지 작업이 된다. Strict 동등물이 있는 것은 전부 이름을 바꾸고, 없는 것은 어떻게 처리할지 결정하는 것
Delphi 내보내기를 StrictOOXML로 전환하기
HotXLS에서 이 전환은 TXLSXWorkbook의 불리언 속성 StrictOOXML 하나로 끝난다. 기본값은 False다. 작성 코드는 그대로다. 시트와 셀, 수식을 평소처럼 구성하고 속성을 설정한 뒤 저장하면 된다. SaveAs는 성공 시 1을 반환하며, 다른 값이 나오면 패키지가 기록되지 않았다는 뜻이고 이유는 Diagnostics에 담긴다
var
Wb: TXLSXWorkbook;
Sh: TXLSXWorksheet;
I: Integer;
begin
Wb := TXLSXWorkbook.Create;
try
Sh := Wb.Sheets.Add('Data');
Sh.Cells[1, 1].Value := 'Product';
Sh.Cells[1, 2].Value := 'Amount';
Sh.Cells[2, 1].Value := 'Widget';
Sh.Cells[2, 2].Value := 17;
Sh.Cells[3, 1].Value := 'Gadget';
Sh.Cells[3, 2].Value := 25;
Sh.Cells[4, 2].Formula := '=SUM(B2:B3)';
Wb.StrictOOXML := True; // ISO/IEC 29500 Strict 어휘
if Wb.SaveAs('archive-copy.xlsx') <> 1 then
begin
for I := 0 to Wb.Diagnostics.Count - 1 do
WriteLn(Wb.Diagnostics[I].Message);
raise Exception.Create('Strict save was refused');
end;
finally
Wb.Free;
end;
end;
이 속성은 저장이 시작될 때마다 읽히고 writer들이 참조하는 저장별 스위치를 구동한다. 덕분에 중간에 실패한 저장이 strict 변환을 켜 둔 채로 다음 저장에 넘겨 버리는 일은 없다. 워크북 객체 하나가 여러 내보내기 요청을 처리하는 서버에서는 호출 사이에 StrictOOXML을 바꿀 수 있고, 각 저장은 자신이 요청한 어휘를 정확히 받는다
미리 알아 둘 만한 경계선이 두 가지 있다. Strict 출력은 Open XML 형식에 적용된다. 워크북, 템플릿, 매크로 사용 템플릿이 그 대상이다. .xlsb를 요청하는 일은 StrictOOXML이 True인 상태에서는 거부되고, 속성을 끄라는 진단이 남는다. 바이너리 형식에는 Strict 변형이 없기 때문이다. 또한 Excel이 "Strict Open XML Spreadsheet"로 저장한 파일을 연다고 해서 속성이 자동으로 켜지지는 않는다. 그런 파일을 불러온 뒤 StrictOOXML을 건드리지 않고 저장하면 Transitional 패키지가 나온다
strict 저장은 왜 실행을 거부하는가?
워크북이 ISO 29500 Strict로 표현할 수 없는 콘텐츠를 담고 있으면 strict 저장은 실행을 거부한다. HotXLS가 검사하는 계열은 VBA 프로젝트, ctrlProps 파트를 동반하는 폼 컨트롤, 스레드형 댓글(클래식 노트가 아니라 사람과 스레드를 다루는 최신 모델), 슬라이서, 동적 배열 메타데이터, 단색 채우기·막대 음수 색·사용자 지정 축 같은 기능을 위해 2009년 확장 블록에 의존하는 데이터 막대, 그리고 변환 정책이 선택되지 않은 상태의 Timeline이다
여기서 거부가 맞는 기본 동작이다. 대안은 매크로 프로젝트나 슬라이서를 조용히 빼버리고 결과에 Strict 도장을 찍는 것인데, 그러면 깔끔하게 열리지만 내보냈던 것과 다르게 동작하는 워크북을 누군가에게 건네는 셈이 된다. Excel은 그런 차이를 알려 주지 않는다. 거부는 코드가 아직 어떤 보고서를 만들고 있었는지 기억하는 시점에 기능 이름을 알려 준다. 대부분의 거부는 SaveAs가 -1을 반환하면서 StrictOOXML: Strict output cannot embed VBA 같은 진단을 남기는 모습으로 나타난다. 동적 배열 저장은 패키지가 기록되는 도중에 결정되므로, 이 세션에서 할당한 수식이 메타데이터를 지목하는 예외로 저장을 멈추게 할 수도 있다. 그래서 Strict SaveAs는 결과 확인에 더해 try..except로 감싸야 한다. 워크북에 매크로가 꼭 필요하다면 VBA 프로젝트와 외부 링크 보존에서 다루는 Transitional .xlsm 경로가 맞다
저장을 해 봐야 알 수 있는 것은 아니다. GetConversionReport는 워크북을 재계산하지 않고 검사해서 기능 이름, fidelity 수준, 시트 인덱스, 메시지를 항목에 담은 TXLSConversionReport를 돌려준다. StrictOOXML 상태에서는 막는 항목이 xlsConversionUnsupported로 돌아온다. Timeline 사례는 콘텐츠를 준수와 일부러 맞바꿀 수 있는 유일한 지점도 보여 준다. StrictTimelineOutputPolicy를 xlsxStrictTimelineDateCriteria로 설정하면 지원되는 Timeline 선택이 표준 피벗 date criteria로 변환되고 Timeline UI와 그 캐시 파트, 릴레이션십, 정의된 이름은 빠진다. 보고서는 이를 xlsConversionDropped로 기록하며 메모리의 원본 워크북은 그대로 유지된다
function StrictBlockers(Wb: TXLSXWorkbook; Log: TStrings): Boolean;
var
Report: TXLSConversionReport;
I: Integer;
begin
Wb.StrictOOXML := True;
// 문서화된 Timeline 트레이드 수용: date criteria는 남고 Timeline UI는 사라진다
Wb.StrictTimelineOutputPolicy := xlsxStrictTimelineDateCriteria;
Report := Wb.GetConversionReport(xlsConversionOpenXmlWorkbook);
try
Result := False;
for I := 0 to Report.Count - 1 do
if Report[I].Fidelity in [xlsConversionUnsupported, xlsConversionDropped] then
begin
Log.Add(Format('%s (sheet %d): %s',
[Report[I].Feature, Report[I].SheetIndex, Report[I].Message]));
if Report[I].Fidelity = xlsConversionUnsupported then
Result := True;
end;
finally
Report.Free;
end;
end;
내보내기 전에 이 함수를 돌리고 반환되는 모든 줄을 로그로 남긴다. 시트 인덱스 -1은 VBA 프로젝트 같은 워크북 수준 항목을 뜻하고, 워크시트 항목은 1부터 시작하는 시트 번호와 시트 이름을 담는다. Sheets 인덱싱과 같은 방식이다. 보고서는 불러온 워크북이 이미 가지고 있던 동적 배열 메타데이터도 본다. 코드에서 할당한 수식은 다음 절의 스칼라 재작성에 맡기면 된다
조용히 동적 배열로 변해버리는 수식
사람들이 허투루 당하는 거부는 FILTER나 SEQUENCE를 한 번도 쓴 적 없는 워크북의 동적 배열 메타데이터다. Excel 365는 여러 셀 범위에 적용된 연산자를 배열로 평가하는데 reducer 안에서도 마찬가지라서, =SUM(B2:B4*C2:C4)는 Excel의 눈에는 배열 수식이다. 이 텍스트를 Formula에 할당하면 HotXLS는 Excel과 같은 방식으로 셀을 저장한다. cm 참조를 xl/metadata.xml에 두는 단일 셀 동적 배열로 저장하는 것이다. 그렇게 하지 않으면 Excel이 불러올 때 암시적 교차를 적용해 #VALUE!를 표시한다. 배경은 배열 연산자 수식과 암시적 교차에 정리되어 있다. Strict에는 이 메타데이터 파트의 어휘가 없으므로 저장은 멈춘다
// 배열 저장: 두 범위의 곱은 배열로 평가된다
Sh.Cells[5, 2].Formula := '=SUM(B2:B4*C2:C4)'; // Strict 저장을 막는다
// 스칼라 저장: 단순 범위 인수, 합계는 동일
Sh.Cells[5, 2].Formula := '=SUMPRODUCT(B2:B4,C2:C4)';
Strict 내보내기에는 스칼라 형태로 쓴다. 단순 범위 인수를 받는 SUMPRODUCT는 같은 합계를 내면서, 나중에 파일을 읽는 무엇이든 동적 배열 지원을 요구하지 않고 셀을 메타데이터 파트에서 완전히 벗어나게 한다. 조건부 개수 세기에도 같은 재작성이 통한다. SUMPRODUCT((A2:A4="x")*1)은 여전히 배열을 곱하므로 여기서는 COUNTIF(A2:A4,"x")를 택하는 편이 낫다. 보고서가 확산된 결과를 정말로 필요로 한다면 Transitional 출력이 필요하다는 뜻이기도 하다
보존 파트는 복사 대신 재구축된다
워크시트 XML은 strict 출력의 쉬운 부분이다. 어려운 부분은 빠른 writer가 그대로 복사하고 싶어 하는 나머지 전부다. HotXLS는 기존 패키지를 열 때 원본 테마, connections, 외부 링크, 차트, 피벗 파트를 유지하고, 모델이 바뀌지 않았다면 Transitional 저장에서 그 압축 바이트를 그대로 통과시킨다. fidelity에는 옳은 판단이지만 Strict에는 그르다. 그 바이트에는 여전히 Transitional 네임스페이스가 남아 있기 때문이다
StrictOOXML이 켜지면 이 모든 파트에서 바이트 복사 경로는 우회된다. connections와 외부 링크, 차트는 모델에서 다시 구축하고, 테마와 캡처해 둔 피벗 테이블·캐시 정의·캐시 레코드 XML은 네임스페이스 번역기를 거쳐 재생한다. 이 번역기는 시작 태그마다 파싱하면서 딱 두 가지만 고친다. 네임스페이스 선언과 Type 속성인데, 이 속성은 Relationship 엘리먼트에 붙고 그 엘리먼트는 .rels 파트 안에 있다. 셀 텍스트와 그 외 속성 값, 주석, CDATA 섹션은 바이트 그대로 통과하므로 우연히 http://schemas.openxmlformats.org/...를 담고 있는 shared string도 건드리지 않는다. schemas.openxmlformats.org 바깥의 네임스페이스 URI, 예컨대 extLst 블록 안의 Microsoft 확장 네임스페이스는 그대로 둔다. 검사기가 Transitional 네임스페이스뿐 아니라 확장 콘텐츠까지 거부한다면 내보내기 전에 해당 기능을 원본 워크북에서 제거하면 된다
스트리밍되는 워크시트에도 같은 규칙이 적용된다. 다만 한 가지 다른 점이 있다. writer는 워크시트 스켈레톤을 먼저 만들고 번역한 다음에야 <sheetData>에서 분할해 사이의 행들을 스트리밍한다. 행 블록에는 어휘 URI가 없으므로 큰 시트도 Strict 출력에 추가로 내는 비용이 없다. shared string과 피벗 캐시 레코드도 같은 방식이다. 헤더 엘리먼트만 번역된다. 보존 쪽 자세한 내용은 테마, 확장 목록, calcChain의 무손실 왕복에 있다
Strict 파일 읽기와 작성 결과 검증
Excel이 Strict로 저장한 파일도 다른 워크북과 똑같이 열린다. HotXLS는 릴레이션십 파트를 파싱하는 모든 지점에서, 즉 패키지 루트와 워크시트, 드로잉, 외부 링크, 피벗 테이블에서 Strict 릴레이션십 타입을 Transitional 대응물로 사상하고, 리더는 접두어가 아니라 네임스페이스 URI로 엘리먼트 이름을 판별한다. 서드파티 생성기는 접두어를 자유롭게 붙이므로 같은 장치가 평범한 파일도 처리한다. 이는 XLSX 패키지의 OPC 릴레이션십 판별에서 설명한다. 그런 파일을 Transitional로 저장할 때는 루트가 여전히 Strict 네임스페이스를 쓰는 보존 XML 파트를 내보내는 길에 되돌려 변환한다. 결과가 절반은 이 어휘, 절반은 저 어휘인 꼴이 되지 않도록 하기 위해서다
Strict 출력은 패키지를 놓고 검증해야지 Excel을 놓고 하면 안 된다. Excel은 두 형태 모두 환영적으로 열어 준다. 결과의 압축을 풀고 세 가지를 확인한다. xl/workbook.xml이 http://purl.oclc.org/ooxml/spreadsheetml/main을 선언하는지, 어떤 파트에도 schemas.openxmlformats.org/spreadsheetml 문자열이 없는지, 그리고 Type 값이 _rels/.rels와 xl/_rels/workbook.xml.rels에서 http://purl.oclc.org/ooxml/로 시작하는지다. 압축 푼 폴더에서 findstr /s /m "schemas.openxmlformats.org/spreadsheetml" *.xml을 한 번 돌려 아무것도 나오지 않으면 합격이다
이어서 파일을 TXLSXWorkbook.Open으로 다시 열어 값, 수식, 표시 형식, 하이퍼링크를 원본 워크북과 비교한다. 이 읽기 검증은 리더 쪽 매핑을 함께 점검해 준다. 워크북에 차트나 피벗 테이블이 있으면 비교 대상에 넣는다. StrictOOXML 상태에서는 둘 다 바이트 복사에서 재구축 또는 재생 경로로 바뀌기 때문이다
Strict 출력과 Strict 인지 읽기, Transitional 패키지의 무손실 왕복은 Delphi와 C++Builder용 HotXLS에서 하나의 OOXML 엔진을 공유한다. HotXLS Delphi 스프레드시트 컴포넌트 페이지에 이 엔진이 다루는 형식과 기능이 정리되어 있다