Artykuł techniczny

Zapis plików XLSX w wariancie ISO 29500 Strict z Delphi

Archiwalna kontrola przyjęcia odrzuca arkusz kalkulacyjny z jednym zarzutem: element korzenia xl/workbook.xml siedzi w przestrzeni nazw http://schemas.openxmlformats.org/spreadsheetml/2006/main. Excel otwiera dokładnie ten sam plik bez mrugnięcia. Oba wyniki są poprawne. ISO/IEC 29500 definiuje Strict SpreadsheetML w części 1 i pozostawia postać przejściową, z jej dziedziczonymi funkcjami zgodności, w części 4, a URI przytoczony przez walidator należy do wariantu przejściowego. Przetarg albo polityka przechowywania dokumentów wymieniająca ISO 29500 Strict oczekuje słownictwa purl.oclc.org w każdej części pakietu, i plik może zadowolić Excela, a kompletnie oblać ten test

Czym właściwie różnią się Strict i Transitional?

Widoczna zmiana dotyczy słownictwa. Ścisła część skoroszytu deklaruje http://purl.oclc.org/ooxml/spreadsheetml/main jako główną przestrzeń nazw i http://purl.oclc.org/ooxml/officeDocument/relationships dla odwołań r:id. Przestrzenie nazw DrawingML, wykresów, obrazów i rysunków arkusza przesuwają się tak samo, podobnie jak części właściwości dokumentu. Razem z nimi zmieniają się typy relacji: główna część relacji wskazuje http://purl.oclc.org/ooxml/officeDocument/relationships/officeDocument, a typy właściwości rozszerzonych i własnych przybierają zapis camelCase jako extendedProperties i customProperties, podczas gdy wariant przejściowy pisze je z łącznikami

Mniej widoczna zmiana dotyczy zakresu. Strict pomija te części schematu przejściowego, które istniały wyłącznie po to, by nieść dziedziczone zachowania plików binarnych, i nie ma w ogóle słownictwa na rozszerzenia dodane później przez Office. Wyszukanie i zamiana na ciągach znaków nie załata tej luki, bo niektóre funkcje po prostu nie mają ścisłego zapisu. Konwersja pakietu oznacza więc dwie roboty: przemianować wszystko, co ma ścisły odpowiednik, i zdecydować, co zrobić z tym, który go nie ma

Przełączenie słownictwa StrictOOXML HotXLS w pakiecie XLSX: części skoroszytu, relacji i rozszerzonych właściwości przepisane z przestrzeni nazw przejściowych openxmlformats na ścisłe przestrzenie nazw purl.oclc.org
Każda część zmienia słownictwo naraz — od przestrzeni nazw korzenia przez typy relacji po typ extendedProperties zapisany camelCase; żadna przestrzeń nazw transitional nie może przeżyć gdziekolwiek w pakiecie

Przełączanie eksportu z Delphi na StrictOOXML

W HotXLS przełącznik to jedna wartość Boolean na TXLSXWorkbook, StrictOOXML, domyślnie ustawiona na False. Kod tworzący dokument zostaje dokładnie taki, jak był. Arkusze, komórki i formuły budujesz po staremu, ustawiasz właściwość i zapisujesz. SaveAs zwraca 1 przy sukcesie; cokolwiek innego znaczy, że pakiet nie został zapisany, a powód leży w 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;            // słownictwo 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;

Właściwość jest odczytywana na początku każdego zapisu i steruje przełącznikiem dla pojedynczego zapisu, z którego korzystają moduły zapisujące, więc zapis przerwany w połowie nie może zostawić włączonego tłumaczenia strict dla kolejnego. Na serwerze, gdzie jeden obiekt skoroszytu obsługuje kilka żądań eksportu, możesz przełączać StrictOOXML między wywołaniami, a każdy zapis dostaje dokładnie to słownictwo, o które prosił

Dwie granice warto znać z góry. Wyjście strict dotyczy formatów Open XML: skoroszytu, szablonu i szablonu z makrami. Żądanie .xlsb przy StrictOOXML ustawionym na True zostaje odrzucone diagnostyką, która każe wyłączyć tę właściwość, bo format binarny nie ma wariantu strict. A otwarcie pliku zapisanego przez Excela jako „Strict Open XML Spreadsheet” nie ustawia tej właściwości za ciebie. Wczytaj taki plik i zapisz go bez dotykania StrictOOXML, a odzyskasz pakiet przejściowy

Dlaczego zapis strict może odmówić wykonania?

Zapis strict odmawia wykonania, gdy skoroszyt zawiera treść, której ISO 29500 Strict nie potrafi wyrazić. Rodziny sprawdzane przez HotXLS to projekty VBA, kontrolki formularzy z ich częściami ctrlProps, komentarze nitkowane (współczesny model persons-and-threads, nie klasyczne notatki), slicery, metadane tablic dynamicznych, paski danych polegające na bloku rozszerzeń z 2009 roku dla funkcji takich jak pełne wypełnienie, kolory ujemnych pasków albo własna oś, oraz Timelines, gdy nie wybrano żadnej polityki konwersji

Ścisła bramka zapisu HotXLS w Delphi: SaveAs z StrictOOXML odmawia projektów VBA, kontrolek formularzy, komentarzy nitkowanych, slicerów i metadanych tablic dynamicznych, a kończy się tylko wtedy, gdy żadna zakazana funkcja nie jest obecna
Zapis strict sprawdza skoroszyt pod kątem tego, co ISO 29500 Strict potrafi wyrazić, i nazywa każdą blokującą funkcję, zamiast zapisać pakiet, który tylko twierdzi, że jest zgodny

Odmowa to tutaj właściwy domyślny wybór. Alternatywą jest porzucenie projektu makr albo slicerów i wciśnięcie wynikowi etykiety strict, co wręcza komuś skoroszyt, który otwiera się bez zarzutu, a zachowuje się inaczej niż ten wyeksportowany. Excel nigdy tego nie odnotuje. Odmowa nazywa funkcję, dopóki twój kod wciąż wie, który raport produkował. Większość odmów przychodzi jako SaveAs zwracający -1 z diagnostyką w stylu StrictOOXML: Strict output cannot embed VBA. Magazyn tablicy dynamicznej jest rozstrzygany w trakcie zapisu pakietu, więc formuła przypisana w tej samej sesji potrafi jeszcze zatrzymać zapis wyjątkiem wymieniającym metadane; owiń ścisły SaveAs w try..except, zamiast tylko sprawdzać jego wynik. Jeśli skoroszyt potrzebuje swoich makr, domem dla nich jest przejściowa ścieżka .xlsm opisana w zachowywaniu projektów VBA i łączy zewnętrznych

Nie musisz dowiadywać się o tym przy zapisie. GetConversionReport przegląda skoroszyt bez jego przeliczania i zwraca TXLSConversionReport, którego pozycje niosą nazwę funkcji, poziom wierności, indeks arkusza i komunikat. Pod StrictOOXML pozycje blokujące wracają jako xlsConversionUnsupported. Przypadek Timeline pokazuje też jedyne miejsce, gdzie możesz świadomie wymienić treść na zgodność: ustawienie StrictTimelineOutputPolicy na xlsxStrictTimelineDateCriteria zamienia obsługiwane zaznaczenia Timeline na standardowe kryteria dat tabeli przestawnej i pomija interfejs Timeline, jego części pamięci podręcznej, relacje i zdefiniowane nazwy. Raport odnotowuje to jako xlsConversionDropped, a źródłowy skoroszyt w pamięci pozostaje niezmieniony

function StrictBlockers(Wb: TXLSXWorkbook; Log: TStrings): Boolean;
var
  Report: TXLSConversionReport;
  I: Integer;
begin
  Wb.StrictOOXML := True;
  // Akceptuj udokumentowany kompromis Timeline: kryteria dat zostają, interfejs Timeline znika
  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;

Uruchom to przed eksportem i loguj każdą zwróconą linię. Indeks arkusza -1 oznacza pozycję na poziomie skoroszytu, jak projekt VBA; pozycje arkuszy niosą numer arkusza liczony od jedynki i nazwę arkusza, zgodnie z indeksowaniem kolekcji Sheets. Raport widzi metadane tablic dynamicznych, które wczytany skoroszyt już przytarga; dla formuł przypisanych w kodzie opieraj się na skalarnej przeróbce z następnej sekcji

Formuła, która po cichu staje się tablicą dynamiczną

Odmowa, która łapie ludzi nieprzygotowanych, to metadane tablicy dynamicznej w skoroszycie, który nigdy nie używał FILTER ani SEQUENCE. Excel 365 ewaluuje operator zastosowany do zakresu wielokomórkowego jako tablicę, nawet wewnątrz reduktora, więc =SUM(B2:B4*C2:C4) jest w oczach Excela formułą tablicową. Gdy przypiszesz ten tekst do Formula, HotXLS przechowa komórkę tak, jak zrobiłby to Excel: jako jednokomórkową tablicę dynamiczną z odwołaniem cm do xl/metadata.xml; inaczej Excel zastosowałby przy wczytaniu przecięcie niejawne i pokazał #VALUE!. Tło opisano w formułach z operatorem tablicowym i przecięciu niejawnym. Strict nie ma słownictwa na tę część metadanych, więc zapis się zatrzymuje

// Magazyn tablicowy: iloczyn dwóch zakresów jest wyliczany jako tablica
Sh.Cells[5, 2].Formula := '=SUM(B2:B4*C2:C4)';    // blokuje zapis strict

// Magazyn skalarny: zwykłe argumenty zakresowe, ta sama suma
Sh.Cells[5, 2].Formula := '=SUMPRODUCT(B2:B4,C2:C4)';

Dla eksportów strict pisz postać skalarną. SUMPRODUCT ze zwykłymi argumentami zakresowymi daje tę samą sumę, nie wymaga obsługi tablic dynamicznych w niczym, co później wczyta plik, i trzyma komórkę kompletnie poza częścią metadanych. Ta sama przeróbka działa dla zliczeń warunkowych: SUMPRODUCT((A2:A4="x")*1) nadal mnoży tablice, więc tam wybieraj COUNTIF(A2:A4,"x"). Jeśli raport naprawdę potrzebuje rozlanych wyników, to potrzebuje wyjścia przejściowego

Zachowywane części są przebudowywane, a nie kopiowane

XML arkusza to łatwa strona wyjścia strict. Trudną stroną jest wszystko to, co szybki moduł zapisu wolałby skopiować dosłownie. Gdy HotXLS otwiera istniejący pakiet, zachowuje oryginalny motyw, połączenia, łącza zewnętrzne, wykresy i części tabel przestawnych, a przy zapisie przejściowym przepuszcza ich skompresowane bajty wprost, dopóki model się nie zmienił. To właściwy ruch dla wierności i zły dla strict, bo te bajty wciąż niosą przejściowe przestrzenie nazw

Przy włączonym StrictOOXML ścieżka kopiowania bajtów jest omijana dla wszystkich tych części. Połączenia, łącza zewnętrzne i wykresy są przebudowywane z modelu; motyw oraz przechwycony XML tabeli przestawnej, definicji pamięci podręcznej i rekordów pamięci podręcznej jest odtwarzany przez tłumacz przestrzeni nazw. Ten tłumacz parsuje każdy znacznik otwierający i przepisuje tylko dwie rzeczy: deklaracje przestrzeni nazw oraz atrybut Type elementów Relationship w częściach .rels. Tekst komórek, inne wartości atrybutów, komentarze i sekcje CDATA przechodzą bajt po bajcie, więc wspólny ciąg znaków, który zdarzy się zawierać http://schemas.openxmlformats.org/..., nigdy nie zostanie tknięty. URI przestrzeni nazw spoza schemas.openxmlformats.org, jak przestrzenie nazw rozszerzeń Microsoftu wewnątrz bloków extLst, zostają takie, jakie są; jeśli twój walidator odrzuca także treść rozszerzeń, a nie tylko przejściowe przestrzenie nazw, usuń te funkcje ze skoroszytu źródłowego przed eksportem

Ścisła ścieżka wyjścia HotXLS dla zachowanych części XLSX: motyw, połączenia, łącza zewnętrzne, wykresy i pamięci podręczne przestawne przełączają się z dosłownego kopiowania bajtów na przebudowę albo tłumaczone odtworzenie, które przepisuje tylko deklaracje przestrzeni nazw i typy relacji
Skopiowane skompresowane bajty przemyciłyby przejściowe przestrzenie nazw do pakietu strict, więc zachowywane ścieżki omijają szybką drogę; tłumaczenie przepisuje wyłącznie deklaracje przestrzeni nazw i typy relacji, a strumieniowy szkielet arkusza jest tłumaczony, zanim zostanie rozcięty na sheetData

Arkusze strumieniowe trzymają się tej samej reguły z jednym twistem. Moduł zapisu najpierw buduje szkielet arkusza, tłumaczy go i dopiero potem rozcina na <sheetData>, by strumieniować wiersze pomiędzy. Bloki wierszy nie zawierają żadnych URI słownictwa, więc duże arkusze nie płacą za wyjście strict niczego ekstra. Wspólne ciągi znaków i rekordy pamięci podręcznej przestawnej działają tak samo: tłumaczony jest tylko element nagłówka. Więcej o stronie zachowywania w bezstratnym odtwarzaniu motywów, list rozszerzeń i calcChain

Odczyt plików strict i sprawdzenie własnego zapisu

Pliki zapisane przez Excela jako strict otwierają się jak każdy inny skoroszyt. HotXLS mapuje ścisłe typy relacji na ich przejściowe odpowiedniki wszędzie tam, gdzie parsowana jest część relacji: w korzeniu pakietu, arkuszach, rysunkach, łączach zewnętrznych i tabelach przestawnych, a czytnik rozwiązuje nazwy elementów po URI przestrzeni nazw, nie po prefiksie. Generatory zewnętrznych producentów wiążą prefiksy dowolnie, więc ta sama machineria obsługuje też zwykłe pliki; opisano ją w rozwiązywaniu relacji OPC w pakietach XLSX. Przy przejściowym zapisie takiego pliku każda zachowywana część XML, której korzeń wciąż używa ścisłej przestrzeni nazw, jest konwertowana z powrotem na wyjściu, więc wynik nie kończy się w połowie jednym słownictwem, a w połowie drugim

Weryfikuj wyjście strict na pakiecie, nigdy na Excelu, który obie postacie otwiera bez mrugnięcia. Rozpakuj wynik i sprawdź trzy rzeczy: xl/workbook.xml deklaruje http://purl.oclc.org/ooxml/spreadsheetml/main, żadna część nie zawiera ciągu schemas.openxmlformats.org/spreadsheetml, a wartości Type w _rels/.rels i xl/_rels/workbook.xml.rels zaczynają się od http://purl.oclc.org/ooxml/. Krótki przebieg findstr /s /m "schemas.openxmlformats.org/spreadsheetml" *.xml po rozpakowanym katalogu nie powinien wypisać niczego

Potem otwórz plik ponownie przez TXLSXWorkbook.Open i porównaj wartości, formuły, formaty liczb i hiperłącza ze skoroszytem źródłowym. Taki odczyt zwrotny przy okazji ćwiczy mapowanie po stronie czytnika. Jeśli skoroszyt niesie wykresy albo tabele przestawne, weź je do porównania, bo obie te rzeczy przełączają się z kopiowania bajtów na ścieżkę przebudowaną albo odtworzoną pod StrictOOXML

Wyjście strict, odczyt świadomy strict i bezstratne odtwarzanie pakietów przejściowych współdzielą w HotXLS dla Delphi i C++Builder jeden silnik OOXML; strona komponentu arkusza kalkulacyjnego HotXLS dla Delphi wylicza obsługiwane formaty i funkcje