Article technique

Écrire des fichiers XLSX ISO 29500 Strict depuis Delphi

Un contrôle d'entrée d'archive refuse un classeur avec un seul reproche : l'élément racine de xl/workbook.xml se trouve dans l'espace de noms http://schemas.openxmlformats.org/spreadsheetml/2006/main. Excel ouvre exactement le même fichier sans broncher. Les deux résultats sont corrects. L'ISO/IEC 29500 définit SpreadsheetML Strict en Partie 1 et garde la forme Transitional, avec ses fonctions de compatibilité héritées, en Partie 4, et l'URI citée par le validateur appartient à Transitional. Un appel d'offres ou une politique d'archivage qui mentionne ISO 29500 Strict attend le vocabulaire purl.oclc.org dans chaque partie du package, et un fichier peut satisfaire Excel tout en échouant complètement à ce test

Qu'est-ce qui change entre Strict et Transitional ?

Le changement visible, c'est le vocabulaire. Une partie de classeur Strict déclare http://purl.oclc.org/ooxml/spreadsheetml/main comme espace de noms racine et http://purl.oclc.org/ooxml/officeDocument/relationships pour les références r:id. Les espaces de noms DrawingML, graphiques, images et dessins de feuille se déplacent de la même façon, ainsi que les parties de propriétés de document. Les types de relations changent avec eux : la partie racine des relations pointe vers http://purl.oclc.org/ooxml/officeDocument/relationships/officeDocument, et les types de propriétés étendues et personnalisées passent en camelCase, extendedProperties et customProperties, là où Transitional les écrit avec des traits d'union

Le changement moins visible est le périmètre. Strict laisse de côté les parties du schéma Transitional qui n'existaient que pour transporter le comportement binaire hérité, et il n'a tout simplement aucun vocabulaire pour les extensions qu'Office a ajoutées ensuite. Une recherche-remplacement sur les chaînes ne peut pas masquer ce fossé, car certaines fonctionnalités n'ont aucune écriture Strict. Convertir un package signifie donc deux travaux : renommer tout ce qui a un équivalent Strict, et décider quoi faire de tout ce qui n'en a pas

Bascule de vocabulaire StrictOOXML de HotXLS dans le paquet XLSX : les parties classeur, relationship et propriétés étendues réécrites des espaces de noms openxmlformats transitionnels vers les espaces de noms stricts purl.oclc.org
Chaque partie change de vocabulaire d'un coup, de l'espace de noms racine aux types de relations jusqu'au type extendedProperties en camelCase ; aucun espace de noms transitionnel ne peut survivre nulle part dans le paquet

Passer un export Delphi en StrictOOXML

Dans HotXLS, la bascule tient en un booléen sur TXLSXWorkbook, StrictOOXML, à False par défaut. Le code de création reste exactement tel quel. Vous construisez feuilles, cellules et formules comme d'habitude, vous positionnez la propriété, et vous enregistrez. SaveAs renvoie 1 en cas de succès ; toute autre valeur signifie que le package n'a pas été écrit, et la raison se trouve dans 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;            // vocabulaire 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 propriété est lue au début de chaque enregistrement et pilote un commutateur par enregistrement que les writers consultent, si bien qu'un enregistrement qui échoue à mi-chemin ne peut pas laisser la traduction stricte activée pour le suivant. Sur un serveur où un seul objet classeur répond à plusieurs demandes d'export, vous pouvez basculer StrictOOXML entre les appels et chaque enregistrement obtient exactement le vocabulaire qu'il a demandé

Deux limites méritent d'être connues dès le départ. La sortie Strict s'applique aux formats Open XML : classeur, modèle et modèle à macros. Demander un .xlsb alors que StrictOOXML vaut True est refusé avec un diagnostic qui vous dit d'éteindre la propriété, car le format binaire n'a pas de variante Strict. Et ouvrir un fichier qu'Excel a enregistré comme « Strict Open XML Spreadsheet » ne positionne pas la propriété pour vous. Chargez un tel fichier, enregistrez-le sans toucher à StrictOOXML, et vous récupérez un package Transitional

Pourquoi un enregistrement strict peut-il refuser de s'exécuter ?

Un enregistrement strict refuse de s'exécuter quand le classeur contient du contenu que l'ISO 29500 Strict ne peut pas exprimer. Les familles que HotXLS vérifie sont les projets VBA, les contrôles de formulaire avec leurs parties ctrlProps, les commentaires en fil de discussion (le modèle moderne personnes-et-fils, pas les notes classiques), les slicers, les métadonnées de tableaux dynamiques, les barres de données qui dépendent du bloc d'extension 2009 pour des fonctions comme le remplissage uni, les couleurs de barres négatives ou un axe personnalisé, et les Timelines quand aucune politique de conversion n'a été choisie

Verrou d'enregistrement strict HotXLS en Delphi : SaveAs avec StrictOOXML refuse les projets VBA, les contrôles de formulaire, les commentaires en fil de discussion, les slicers et les métadonnées de tableaux dynamiques, et ne se termine que si aucune fonctionnalité interdite n'est présente
Un enregistrement strict confronte le classeur à ce que l'ISO 29500 Strict peut exprimer et nomme la fonctionnalité bloquante au lieu d'écrire un package qui se prévaut seulement de la conformité

Refuser est le bon défaut ici. L'alternative serait d'abandonner le projet macro ou les slicers et de tamponner quand même le résultat comme Strict, ce qui remet à quelqu'un un classeur qui s'ouvre proprement mais se comporte différemment de celui qu'il a exporté. Excel ne le signalerait jamais. Un refus nomme la fonctionnalité pendant que votre code sait encore quel rapport il produisait. La plupart des refus arrivent sous la forme d'un SaveAs renvoyant -1 avec un diagnostic du type StrictOOXML: Strict output cannot embed VBA. Le stockage en tableau dynamique se décide pendant l'écriture du package, donc une formule affectée dans cette session peut encore arrêter l'enregistrement avec une exception qui nomme la métadonnée ; enveloppez un SaveAs Strict dans un try..except en plus de vérifier son résultat. Si le classeur a besoin de ses macros, c'est le chemin .xlsm Transitional décrit dans la préservation des projets VBA et des liens externes qui les accueille

Vous n'êtes pas obligé de le découvrir en enregistrant. GetConversionReport inspecte le classeur sans le recalculer et renvoie un TXLSConversionReport dont les éléments portent un nom de fonctionnalité, un niveau de fidélité, un index de feuille et un message. Sous StrictOOXML, les éléments bloquants reviennent comme xlsConversionUnsupported. Le cas Timeline montre aussi le seul endroit où vous pouvez échanger du contenu contre de la conformité délibérément : positionner StrictTimelineOutputPolicy à xlsxStrictTimelineDateCriteria convertit les sélections Timeline prises en charge en critères de date de tableau croisé standard et laisse de côté l'interface Timeline, ses parties de cache, ses relations et ses noms définis. Le rapport le liste comme xlsConversionDropped, et le classeur source en mémoire reste inchangé

function StrictBlockers(Wb: TXLSXWorkbook; Log: TStrings): Boolean;
var
  Report: TXLSConversionReport;
  I: Integer;
begin
  Wb.StrictOOXML := True;
    // Accepter l'arbitrage Timeline documenté : les critères de date restent, l'interface Timeline part
  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;

Exécutez ceci avant l'export et journalisez chaque ligne renvoyée. Un index de feuille de -1 marque un élément au niveau du classeur comme le projet VBA ; les éléments de feuille portent le numéro de feuille à base 1 et le nom de la feuille, dans le même ordre d'indexation que Sheets. Le rapport voit les métadonnées de tableaux dynamiques qu'un classeur chargé transporte déjà ; pour les formules affectées en code, fiez-vous à la réécriture scalaire de la section suivante

La formule qui devient discrètement un tableau dynamique

Le refus qui prend les gens au dépourvu, ce sont les métadonnées de tableau dynamique dans un classeur qui n'a jamais utilisé FILTER ni SEQUENCE. Excel 365 évalue un opérateur appliqué à une plage multi-cellules comme un tableau, même à l'intérieur d'un réducteur, donc =SUM(B2:B4*C2:C4) est une formule de tableau aux yeux d'Excel. Quand vous affectez ce texte à Formula, HotXLS stocke la cellule comme Excel le ferait, en tableau dynamique à cellule unique avec une référence cm vers xl/metadata.xml ; sinon Excel appliquerait l'intersection implicite au chargement et afficherait #VALUE!. Le contexte est dans les formules à opérateur de tableau et l'intersection implicite. Strict n'a aucun vocabulaire pour cette partie de métadonnées, donc l'enregistrement s'arrête

// Stockage tableau : le produit de deux plages est évalué comme un tableau
Sh.Cells[5, 2].Formula := '=SUM(B2:B4*C2:C4)';    // bloque un enregistrement Strict

// Stockage scalaire : arguments de plages simples, même total
Sh.Cells[5, 2].Formula := '=SUMPRODUCT(B2:B4,C2:C4)';

Pour les exports Strict, écrivez la forme scalaire. SUMPRODUCT avec des arguments de plages simples donne le même total, n'exige aucun support des tableaux dynamiques dans ce qui lira le fichier plus tard, et tient la cellule complètement hors de la partie de métadonnées. La même réécriture marche pour les comptages conditionnels : SUMPRODUCT((A2:A4="x")*1) multiplie encore des tableaux, donc préférez COUNTIF(A2:A4,"x") là. Si un rapport a vraiment besoin de résultats en débordement, il lui faut une sortie Transitional

Les parties préservées sont reconstruites au lieu d'être copiées

Le XML des feuilles de calcul est la partie facile de la sortie stricte. La partie difficile, c'est tout ce qu'un writer rapide préférerait copier tel quel. Quand HotXLS ouvre un package existant, il conserve le thème, les connexions, les liens externes, les graphiques et les parties de tableaux croisés d'origine, et lors d'un enregistrement Transitional il copie leurs octets compressés directement quand le modèle n'a pas changé. C'est le bon choix pour la fidélité et le mauvais pour Strict, car ces octets portent toujours des espaces de noms Transitional

Avec StrictOOXML actif, le chemin de copie d'octets est contourné pour toutes ces parties. Connexions, liens externes et graphiques sont reconstruits à partir du modèle ; le thème et le XML capturé du tableau croisé, de sa définition de cache et de ses enregistrements de cache sont rejoués à travers le traducteur d'espaces de noms. Ce traducteur analyse chaque balise ouvrante et ne réécrit que deux choses : les déclarations d'espaces de noms, et l'attribut Type des éléments Relationship dans les parties .rels. Le texte des cellules, les autres valeurs d'attributs, les commentaires et les sections CDATA passent octet pour octet, si bien qu'une chaîne partagée qui contient par hasard http://schemas.openxmlformats.org/... n'est jamais touchée. Les URI d'espaces de noms hors schemas.openxmlformats.org, comme les espaces de noms d'extension Microsoft à l'intérieur des blocs extLst, restent tels quels ; si votre validateur refuse le contenu d'extension aussi bien que les espaces de noms Transitional, retirez ces fonctionnalités du classeur source avant l'export

Chemin de sortie strict HotXLS pour les parties XLSX préservées : thème, connexions, liens externes, graphiques et caches de tableaux croisés passent de la copie d'octets verbatim à la reconstruction ou à un rejeu traduisant qui ne réécrit que les déclarations d'espaces de noms et les types de relations
Des octets compressés copiés introduiraient en contrebande des espaces de noms transitionnels dans le package strict, si bien que les chemins préservés contournent la voie rapide ; la traduction ne réécrit que les déclarations d'espaces de noms et les types de relations, et le squelette de feuille diffusé est traduit avant d'être scindé à sheetData

Les feuilles de calcul en flux suivent la même règle avec une torsion. Le writer construit d'abord le squelette de la feuille, le traduit, et seulement ensuite le scinde au niveau de <sheetData> pour diffuser les lignes entre les deux. Les blocs de lignes ne contiennent aucune URI de vocabulaire, donc les grandes feuilles ne paient rien de plus pour la sortie Strict. Les chaînes partagées et les enregistrements de cache de tableaux croisés fonctionnent de la même façon : seul l'élément d'en-tête est traduit. Le reste du volet préservation est dans les allers-retours sans perte des thèmes, listes d'extensions et calcChain

Lire les fichiers Strict et vérifier ce que vous avez écrit

Les fichiers qu'Excel a enregistrés en Strict s'ouvrent comme n'importe quel autre classeur. HotXLS fait correspondre les types de relations Strict à leurs équivalents Transitional partout où une partie de relations est analysée, à la racine du package, dans les feuilles, les dessins, les liens externes et les tableaux croisés, et le lecteur résout les noms d'éléments par URI d'espace de noms plutôt que par préfixe. Les générateurs tiers lient les préfixes librement, donc la même mécanique sert aussi les fichiers ordinaires ; elle est décrite dans la résolution des relations OPC dans les packages XLSX. Lors d'un enregistrement Transitional d'un tel fichier, toute partie XML préservée dont la racine utilise encore un espace de noms Strict est reconvertie en sortie, si bien que le résultat ne se retrouve pas à moitié dans un vocabulaire et à moitié dans l'autre

Vérifiez la sortie Strict contre le package, jamais contre Excel, qui ouvre les deux formes avec joie. Décompressez le résultat et contrôlez trois choses : xl/workbook.xml déclare http://purl.oclc.org/ooxml/spreadsheetml/main, aucune partie ne contient la chaîne schemas.openxmlformats.org/spreadsheetml, et les valeurs Type dans _rels/.rels et xl/_rels/workbook.xml.rels commencent par http://purl.oclc.org/ooxml/. Un petit passage de findstr /s /m "schemas.openxmlformats.org/spreadsheetml" *.xml sur le dossier extrait ne devrait rien lister

Rouvrez ensuite le fichier via TXLSXWorkbook.Open et comparez valeurs, formules, formats de nombre et hyperliens au classeur source. Cette relecture exerce en même temps la correspondance côté lecteur. Si le classeur porte des graphiques ou des tableaux croisés, incluez-les dans la comparaison, car tous deux passent de la copie d'octets à un chemin reconstruit ou rejoué sous StrictOOXML

La sortie Strict, la lecture compatible Strict et les allers-retours sans perte des packages Transitional partagent un seul moteur OOXML dans HotXLS pour Delphi et C++Builder ; la page du composant tableur Delphi HotXLS liste les formats et les fonctionnalités qu'il couvre