Articolo tecnico

Scrivere file XLSX ISO 29500 Strict da Delphi

Un controllo di ingresso in un archivio respinge un foglio elettronico con un'unica lamentela: l'elemento radice di xl/workbook.xml sta nel namespace http://schemas.openxmlformats.org/spreadsheetml/2006/main. Excel apre lo stesso identico file senza fare una piega. Entrambi gli esiti sono corretti. ISO/IEC 29500 definisce SpreadsheetML Strict nella Parte 1 e tiene la forma Transitional, con le sue caratteristiche di compatibilità legacy, nella Parte 4, e l'URI citato dal validatore appartiene a Transitional. Un bando o una policy di conservazione che richiede ISO 29500 Strict si aspetta il vocabolario purl.oclc.org in ogni parte del pacchetto, e un file può accontentare Excel fallendo completamente quel test

Cosa cambia tra Strict e Transitional?

La differenza visibile è il vocabolario. Una parte workbook Strict dichiara http://purl.oclc.org/ooxml/spreadsheetml/main come namespace radice e http://purl.oclc.org/ooxml/officeDocument/relationships per i riferimenti r:id. I namespace di DrawingML, grafici, immagini e disegni dei fogli si spostano allo stesso modo, e così le parti delle proprietà del documento. Con loro cambiano i tipi di relazione: la parte delle relazioni radice punta a http://purl.oclc.org/ooxml/officeDocument/relationships/officeDocument, e i tipi delle proprietà estese e personalizzate diventano camelCase come extendedProperties e customProperties, dove Transitional li scrive con i trattini

La differenza meno visibile è l'ambito. Strict lascia fuori le parti dello schema Transitional che esistevano solo per trasportare il comportamento binario legacy, e non ha proprio alcun vocabolario per le estensioni che Office ha aggiunto dopo. Una ricerca e sostituzione sulle stringhe non può mascherare questo buco, perché alcune funzionalità semplicemente non hanno una grafia Strict. Convertire un pacchetto significa quindi due lavori: rinominare tutto ciò che ha un equivalente Strict e decidere cosa fare di tutto il resto

Commutazione del vocabolario StrictOOXML di HotXLS nel pacchetto XLSX: parti workbook, relationship ed extended-properties riscritte dai namespace transitional openxmlformats ai namespace strict purl.oclc.org
Ogni parte cambia vocabolario in una volta, dal namespace radice ai tipi di relazione fino al tipo camelCase extendedProperties; nessun namespace transitional può sopravvivere in alcun punto del pacchetto

Passare un export Delphi a StrictOOXML

In HotXLS il cambiamento è un solo Boolean su TXLSXWorkbook, StrictOOXML, che per impostazione predefinita vale False. Il codice di creazione resta esattamente com'era: costruisci fogli, celle e formule come al solito, imposti la proprietà e salvi. SaveAs restituisce 1 in caso di successo; qualsiasi altro valore significa che il pacchetto non è stato scritto, e il motivo sta in 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;            // Vocabolario 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;

La proprietà viene letta all'inizio di ogni salvataggio e pilota un interruttore per singolo salvataggio consultato dagli writer, così un salvataggio che fallisce a metà non può lasciare la traduzione strict accesa per quello successivo. Su un server dove un singolo oggetto workbook risponde a più richieste di esportazione puoi commutare StrictOOXML tra una chiamata e l'altra, e ogni salvataggio ottiene esattamente il vocabolario che ha chiesto

Due confini conviene conoscerli in anticipo. L'output strict vale per i formati Open XML: workbook, template e template con macro. Chiedere un .xlsb con StrictOOXML a True viene rifiutato con un diagnostico che ti dice di spegnere la proprietà, perché il formato binario non ha variante Strict. E aprire un file che Excel ha salvato come "Strict Open XML Spreadsheet" non imposta la proprietà per te. Carichi un file del genere, lo salvi senza toccare StrictOOXML, e ti torna indietro un pacchetto Transitional

Perché un salvataggio strict si rifiuta di eseguire?

Un salvataggio strict si rifiuta di eseguire quando la cartella di lavoro contiene contenuti che ISO 29500 Strict non sa esprimere. Le famiglie controllate da HotXLS sono i progetti VBA, i controlli modulo con le loro parti ctrlProps, i commenti in thread (il modello moderno persone-e-thread, non le note classiche), gli slicer, i metadati di array dinamico, le barre dati che dipendono dal blocco di estensioni 2009 per caratteristiche come riempimento pieno, colori della barra negativa o un asse personalizzato, e i Timeline quando non è stata scelta una policy di conversione

Gate di salvataggio strict di HotXLS in Delphi: SaveAs con StrictOOXML rifiuta progetti VBA, controlli modulo, commenti in thread, slicer e metadati di array dinamico, e completa solo quando non è presente nessuna funzionalità vietata
Un salvataggio strict confronta la cartella di lavoro con ciò che ISO 29500 Strict può esprimere e nomina ogni funzionalità bloccante anziché scrivere un pacchetto che si limita a dichiarare conformità

Rifiutare è la scelta predefinita giusta, qui. L'alternativa è buttare via il progetto macro o gli slicer e timbrare comunque il risultato come Strict, consegnando a qualcuno una cartella di lavoro che si apre senza problemi ma si comporta in modo diverso da quella esportata. Excel non lo segnalerebbe mai. Un rifiuto nomina la funzionalità mentre il tuo codice sa ancora quale report stava producendo. La maggior parte dei rifiuti arriva come SaveAs che restituisce -1 con un diagnostico del tipo StrictOOXML: Strict output cannot embed VBA. L'archiviazione ad array dinamico viene decisa mentre il pacchetto viene scritto, quindi una formula assegnata in questa sessione può ancora fermare il salvataggio con un'eccezione che nomina i metadati; avvolgi un SaveAs Strict in un try..except oltre a controllarne il risultato. Se la cartella di lavoro ha bisogno delle sue macro, la strada Transitional .xlsm descritta in preservare progetti VBA e collegamenti esterni è il suo posto giusto

Non devi scoprirlo salvando. GetConversionReport ispeziona la cartella di lavoro senza ricalcolarla e restituisce un TXLSConversionReport i cui elementi portano un nome di funzionalità, un livello di fedeltà, un indice di foglio e un messaggio. Con StrictOOXML gli elementi bloccanti tornano come xlsConversionUnsupported. Il caso Timeline mostra anche l'unico posto in cui puoi scambiare contenuto per conformità di proposito: impostare StrictTimelineOutputPolicy a xlsxStrictTimelineDateCriteria converte le selezioni Timeline supportate in criteri data standard di pivot e lascia fuori la UI Timeline, le sue parti di cache, le relazioni e i defined names. Il report lo elenca come xlsConversionDropped, e la cartella di lavoro sorgente in memoria resta invariata

function StrictBlockers(Wb: TXLSXWorkbook; Log: TStrings): Boolean;
var
  Report: TXLSConversionReport;
  I: Integer;
begin
  Wb.StrictOOXML := True;
  // Accetta il compromesso Timeline documentato: i criteri data restano, la UI Timeline va via
  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;

Esegui questo prima dell'export e logga ogni riga che restituisce. Un indice di foglio pari a -1 contrassegna un elemento a livello di cartella di lavoro come il progetto VBA; gli elementi di foglio portano il numero del foglio in base 1 e il nome del foglio, coerentemente con come è indicizzato Sheets. Il report vede i metadati di array dinamico che una cartella di lavoro caricata porta già dentro; per le formule assegnate via codice affidati alla riscrittura scalare della sezione successiva

La formula che diventa un array dinamico in silenzio

Il rifiuto che prende tutti alla sprovvista sono i metadati di array dinamico in una cartella di lavoro che non ha mai usato FILTER né SEQUENCE. Excel 365 valuta un operatore applicato a un intervallo multicella come un array, anche dentro un riduttore, quindi =SUM(B2:B4*C2:C4) è una formula array agli occhi di Excel. Quando assegni quel testo a Formula, HotXLS archivia la cella come farebbe Excel, come array dinamico a cella singola con un riferimento cm dentro xl/metadata.xml; altrimenti Excel applicherebbe l'intersezione implicita al caricamento e mostrerebbe #VALUE!. Il contesto è in formule con operatori di array e intersezione implicita. Strict non ha vocabolario per quella parte di metadati, quindi il salvataggio si ferma

// Archiviazione ad array: il prodotto di due intervalli viene valutato come array
Sh.Cells[5, 2].Formula := '=SUM(B2:B4*C2:C4)';    // blocca un salvataggio Strict

// Archiviazione scalare: argomenti a intervallo semplici, stesso totale
Sh.Cells[5, 2].Formula := '=SUMPRODUCT(B2:B4,C2:C4)';

Per gli export Strict scrivi la forma scalare. SUMPRODUCT con argomenti a intervallo semplici dà lo stesso totale, non richiede supporto ad array dinamico in chiunque legga il file in seguito, e tiene la cella fuori dalla parte dei metadati del tutto. La stessa riscrittura funziona per i conteggi condizionali: SUMPRODUCT((A2:A4="x")*1) moltiplica comunque array, quindi lì preferisci COUNTIF(A2:A4,"x"). Se un report ha davvero bisogno di risultati spillati, gli serve output Transitional

Le parti preservate vengono ricostruite invece di copiate

L'XML del foglio di lavoro è la parte facile dell'output strict. Quella difficile è tutto ciò che uno writer veloce preferirebbe copiare verbatim. Quando HotXLS apre un pacchetto esistente conserva il tema originale, le connessioni, i collegamenti esterni, i grafici e le parti pivot, e su un salvataggio Transitional copia i loro byte compressi direttamente quando il modello non è cambiato. È la mossa giusta per la fedeltà e quella sbagliata per Strict, perché quei byte portano ancora i namespace Transitional

Con StrictOOXML attivo, il percorso di copia dei byte viene aggirato per tutte quelle parti. Connessioni, collegamenti esterni e grafici vengono ricostruiti dal modello; il tema e l'XML catturato di tabella pivot, definizione di cache e record di cache viene ripassato attraverso il traduttore di namespace. Quel traduttore parsa ogni tag di apertura e riscrive solo due cose: le dichiarazioni di namespace e l'attributo Type degli elementi Relationship nelle parti .rels. Il testo delle celle, gli altri valori di attributo, i commenti e le sezioni CDATA passano byte per byte, così una shared string che per caso contiene http://schemas.openxmlformats.org/... non viene mai toccata. Gli URI di namespace fuori da schemas.openxmlformats.org, come i namespace di estensione Microsoft dentro i blocchi extLst, restano come sono; se il tuo validatore rifiuta anche il contenuto di estensione oltre ai namespace Transitional, rimuovi quelle funzionalità dalla cartella di lavoro sorgente prima di esportare

Percorso di output strict di HotXLS per le parti XLSX preservate: tema, connessioni, collegamenti esterni, grafici e cache pivot passano dalla copia byte verbatim alla ricostruzione o a un replay con traduzione che riscrive solo dichiarazioni di namespace e tipi di relazione
Byte compressi copiati farebbero passare di contrabbando namespace transitional nel pacchetto strict, così i percorsi preservati aggirano la via veloce; la traduzione riscrive solo dichiarazioni di namespace e tipi di relazione, e lo scheletro del foglio in streaming viene tradotto prima di essere spezzato a sheetData

I fogli in streaming seguono la stessa regola con una svolta. Il writer costruisce prima lo scheletro del foglio, lo traduce, e solo dopo lo spezza a <sheetData> per mettere in streaming le righe in mezzo. I blocchi di riga non contengono URI di vocabolario, quindi i fogli grandi non pagano nulla in più per l'output Strict. Shared string e record di cache pivot funzionano allo stesso modo: viene tradotto solo l'elemento di intestazione. Sul fronte della preservazione c'è di più in round-trip lossless di temi, extension list e calcChain

Leggere file Strict e controllare ciò che hai scritto

I file che Excel ha salvato come Strict si aprono come qualsiasi altra cartella di lavoro. HotXLS mappa i tipi di relazione Strict sulle loro controparti Transitional ovunque venga parsata una parte di relazione, alla radice del pacchetto, nei fogli, nei disegni, nei collegamenti esterni e nelle tabelle pivot, e il lettore risolve i nomi degli elementi per URI di namespace anziché per prefisso. I generatori di terze parti legano i prefissi liberamente, quindi la stessa macchina serve anche i file ordinari; è descritta in risoluzione delle relazioni OPC nei pacchetti XLSX. Su un salvataggio Transitional di un file del genere, qualsiasi parte XML preservata la cui radice usa ancora un namespace Strict viene riconvertita in uscita, così il risultato non finisce metà con un vocabolario e metà con l'altro

Verifica l'output Strict sul pacchetto, mai su Excel, che apre entrambe le forme volentieri. Scompatta il risultato e controlla tre cose: xl/workbook.xml dichiara http://purl.oclc.org/ooxml/spreadsheetml/main, nessuna parte contiene la stringa schemas.openxmlformats.org/spreadsheetml, e i valori Type in _rels/.rels e xl/_rels/workbook.xml.rels iniziano con http://purl.oclc.org/ooxml/. Una breve passata di findstr /s /m "schemas.openxmlformats.org/spreadsheetml" *.xml sulla cartella estratta non dovrebbe elencare nulla

Poi riapri il file tramite TXLSXWorkbook.Open e confronta valori, formule, formati numerici e collegamenti ipertestuali con la cartella di lavoro sorgente. La rilettura mette alla prova allo stesso tempo anche la mappatura lato lettura. Se la cartella di lavoro porta grafici o tabelle pivot, includili nel confronto, perché entrambi passano dalla copia dei byte a un percorso ricostruito o ripassato con StrictOOXML

Output strict, lettura consapevole dello Strict e round-trip lossless dei pacchetti Transitional condividono un unico motore OOXML in HotXLS per Delphi e C++Builder; la pagina del componente foglio di calcolo Delphi HotXLS elenca i formati e le funzionalità che copre