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łą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
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
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