Teknik Makale

Delphi'de Kayıpsız XLSX Çift Yönlü Döngüsü

Bir faturalandırma işi, müşteri şablonunu açar, B3 hücresine 42750 yazar ve kaydeder. Sonra paketleri açıp karşılaştırın: değişiklik listesi tek hücreden çok daha uzundur. xl/theme/theme1.xml artık müşterinin petrol yeşili ve kurşun grisi yerine standart Office paletini taşır; çalışma sayfası XML'inin altındaki <extLst>, sparkline grubunu ve daha yeni bir koşullu biçimlendirme kuralını kaybetmiştir; xl/calcChain.xml ise tamamen ortadan yoktur. Excel sonucu açar, bir onarım önerir ve marka renkleri gitmiştir. Kod tek hücreye dokundu; geri kalan her şey, kaydetmenin paketi bellek içi modelin bildiğinden yeniden kurması yüzünden değişti ve tipik bir şablonun üç parçası, hesap tablosu modelinin normalde tuttuğunun dışında durur

Delphi'de kayıpsız bir HotXLS XLSX gidiş dönüşünün ardındaki üç mekanizma: xl/theme/theme1.xml'in ham bayt olarak önbelleklenip ThemeColor yuva geçersiz kılmaları dışında değişmeden geri yazılması, yabancı extLst bloklarının XML olaylarından yakalanıp yeniden oynatılması ve her formül kaydında taze, belirtim-uyumlu bir calcChain.xml üretilmesi
Korunan her parça kaydetme boyunca kendi yolunu izler — aynen tema baytları, olay düzeyi extLst yeniden oynatma ve yeniden üretilmiş bir hesaplama zinciri — çalışma sayfası XML'i ve stiller ise modelden yeniden kurulur

Tek hücrelik düzenleme bütün XLSX paketini neden yeniden yazar

Bir .xlsx dosyası XML parçalarından oluşan bir ZIP'tir: xl/workbook.xml, sayfa başına bir xl/worksheets/sheetN.xml, xl/styles.xml, xl/sharedStrings.xml, tema, hesaplama zinciri ve çalışma kitabının taşıdığı çizimler, tablolar ve pivot önbellekleri ne varsa. Değerleri ve formülleri nesnelere okuyup kaydetmede her parçayı o nesnelerden yeniden üreten bir kütüphanenin tek bir zayıf noktası vardır: nesne modelinin yuvası olmayan hiçbir şey belleğe girmez, dolayısıyla yeniden üretilen parça onsuz çıkar. Kimsenin sparkline'ları silmesine gerek yoktur; onların Open ile SaveAs arasında barınacak hiçbir yeri yoktur

ECMA-376 bunun yarısını öngörmüştü. SpreadsheetML, extLst'i (çalışma kitabı düzeyindeki öğe için ECMA-376 Kısım 1, §18.2.10; çalışma sayfalarında, stillerde ve koşullu biçimlendirmede karşılıkları var) gelecekteki özellikler için bir depolama alanı olarak ayırır. Daha yeni bir üretici her özelliği, uri özniteliği özelliğin adını veren bir <ext> öğesine sarar ve daha eski bir tüketicinin anlamadığını taşıması beklenir. Sparkline'lar, dilimleyici listeleri, daha yeni veri çubuğu ve simge kümesi seçenekleri ile genişletilmiş veri doğrulama, bugün Excel'in yazdığı dosyalarda bu yolla seyahat eder. Bilinmeyen <ext> bloklarını atmak bu yüzden, biçimin üzerine kurulduğu ileriye dönük uyumluluk sözleşmesini kırar ve zarar, müşteri dosyayı Excel'de yeniden açtığında ortaya çıkar

Tema ile hesaplama zinciri farklı nedenlerle başarısız olur; bu yüzden her biri kendi tedavisini ister. Yazının gerisi, HotXLS'in üçünü nasıl ele aldığını, bir Delphi çağıranının ne gözlemleyip denetleyebileceğini ve garantisinin nerede bittiğini izler

Özel theme1.xml'i Delphi'de sapasağlam tutmak

HotXLS bir çalışma kitabının temasını, açılan paketten xl/theme/theme1.xml dosyasının orijinal baytlarını tutarak ve SaveAs sırasında o parçayı olduğu gibi geri yazarak korur. Tema parçası (ECMA-376 Kısım 1, §14.2.7) DrawingML'dir: on iki yuvalı bir renk şeması, bir yazı tipi şeması ve dolgu, çizgi ile efektlerden oluşan bir biçim şeması. Hücre stilleri, <color theme="4"/> ve benzeri başvurularla içine işaret eder; dolayısıyla hesap tablosu motorunun yuvaları çözmesi yeter, degradeleri ya da efekt stillerini anlaması gerekmez. Her kayıtta sabit bir Office temasını yeniden üretmek, tam olarak müşterinin petrol yeşilini Office mavisine çeviren şeydir. Sıfırdan oluşturulan, taşıyacak teması olmayan bir çalışma kitabı ise yerleşik Office temasını alır

HotXLS, xl/theme/theme1.xml'nin ham baytlarını açılışta önbellekler ve kayıtta yalnızca ThemeColor ile geçersiz kılınan renk yuvalarını değiştirerek geri yazar; modelden yeniden inşa eden bir kütüphane ise stok bir Office temasını üretir ve müşterinin marka renklerini geri çevirir
theme1.xml'i aynen önbelleklemek hiçbir tema modeli gerektirmez; ThemeMajorFont ile ThemeMinorFont ise yalnızca yakalanmış tema taşımayan çalışma kitaplarını stillendirir

Günlük durum hiçbir tema koduna ihtiyaç duymaz. Sayfa indeksine dikkat: Sheets, XLSX motorunda 1 tabanlıdır ve Cells[3, 2] 3. satır, 2. sütundur; yani B3

var
  Book: TXLSXWorkbook;
begin
  Book := TXLSXWorkbook.Create;
  try
    Book.Open('branded-invoice.xlsx');
    Book.Sheets[1].Cells[3, 2].Value := 42750.00;  // tek düzenleme
    Book.SaveAs('branded-invoice-out.xlsx');
    // çıktıdaki xl/theme/theme1.xml şablonun kendi temasını taşır
  finally
    Book.Free;
  end;
end;

Ham baytlar, bu tür bir parça için elde edilebilecek en güçlü doğruluktur: ayrıştırma yok, yeniden serileştirme yok, sapacak hiçbir şey yok. Kayıt, geçiş diyalektiği yerine Strict OOXML yazdığında yakalanan tema, kopyalanmak yerine ad alanı çevirmeninden geçer; çünkü bir bayt kopyası, geçiş ad alanı URI'lerini Strict bir paketin içinde bırakırdı

Tuzak API tarafındadır. TXLSXWorkbook, ThemeMajorFont ve ThemeMinorFont özelliklerini sunar ve Open sonrasında bunlar, şablonun yazı tipi şemasından ayrıştırılan başlık ve gövde yazı tiplerini bildirir. Onları ayarlamak yazı tipi değiştirmenin doğal yolu gibi görünür ama yalnızca yeni çalışma kitaplarının aldığı yerleşik Office temasını biçimlendirir. Kendi temasını getiren bir çalışma kitabında yakalanan parça kazanır ve o iki belirleyicinin kaydedilen dosyada hiçbir etkisi olmaz. Renkler farklı işlenir: ThemeColor[Slot], on iki clrScheme yuvasına adres tutar ve bir geçersiz kılma, korunan temaya yalnızca o yuvanın rengini değiştirerek yazılır; yazı tipi şeması, biçim şeması ve tema uzantılarına dokunulmaz

Book.Open('branded-invoice.xlsx');
// Kaydedilen dosyada etkisi yok: şablonun kendi teması korunur
Book.ThemeMajorFont := 'Segoe UI Semibold';
// Dosyaya ulaşır: theme1.xml içinde yalnızca accent1 yuvası değişir
Book.ThemeColor[xlsxThemeAccent1] := $FF0F7B6C;  // $AARRGGBB
Book.SaveAs('rebranded.xlsx');

Bu ayrım kasıtlıdır. Renk geçersiz koması, tek bir öğeye yapılmış dar, iyi tanımlı bir düzenlemedir; tasarımcının temasının geri kalanı tam olarak olduğu gibi kalabilir. Bir yazı tipi şeması yeniden yazımı, veri odaklı bir API'nin iyi ifade edemeyeceği, betik başına yazı tipi listelerine dokunur. Bir şablonun yeni bir yazı tipine ihtiyacı varsa onu Excel'de değiştirin ve yeni şablonu dağıtın; böylece tema, markanın sahibinin elinde kalır

Bilinmeyen extLst bloklarına kaydetmede ne olur

HotXLS, yerel olarak modellemediği her çalışma sayfası düzeyindeki <ext> bloğunu yakalar ve kaydedilen çalışma sayfasının extLst yapısı içinde yeniden oynatır. Modellediği bloklar tüplü nesnelere ayrıştırılır ve onlardan yeniden kurulur: sparkline grupları SparklineGroups koleksiyonuna gider, x14 veri doğrulama uzantısı veri doğrulama koleksiyonuna okunur ve dilimleyici listeleri dilimleyici modeli tarafından yeniden üretilir. Geri kalan her şey — blok başına bir XML parçası olarak — her TXLSXWorksheet üzerindeki salt okunur RawWorksheetExts dizge listesine düşer; yani bir test, ileriye taşınacak olanı tam olarak inceleyebilir

var
  Book: TXLSXWorkbook;
  Sheet: TXLSXWorksheet;
  i: Integer;
begin
  Book := TXLSXWorkbook.Create;
  try
    Book.Open('from-newer-excel.xlsx');
    Sheet := Book.Sheets[1];
    WriteLn(Format('%d foreign ext block(s), %d sparkline group(s)',
      [Sheet.RawWorksheetExts.Count, Sheet.SparklineGroups.Count]));
    for i := 0 to Sheet.RawWorksheetExts.Count - 1 do
      WriteLn(Copy(Sheet.RawWorksheetExts[i], 1, 100)); // açılış etiketi uri'yi gösterir
    // Parçaların <worksheet> kökünden ödünç aldığı ad alanı bildirimleri
    WriteLn(Sheet.RawExtNamespaceDecls);
  finally
    Book.Free;
  end;
end;

Yakalama, XML olay akışından çalışır; çünkü akışlı bir okuyucu öğeleri, metni ve kapanış etiketlerini verir ama kaynağa ait bayt ofsetlerini vermez. Her bilinmeyen alt ağaç, o olaylar geçerken onlardan yeniden kurulur. Naif bir derinlik sayacı burada kırılır: her açılış etiketinde artar, her kapanış etiketinde azalır ve <x14:cfvo type="min"/> gibi kendi kendini kapatan bir çocuk, peşinden kapanış etiketi gelmeyen, boş işaretli tek bir açılış olayı olarak gelir. Onu açık bir öğe sayarsanız sayaç hiç sıfıra dönmez ve yakalama, çalışma sayfasının geri kalanını yutar. HotXLS'teki yakalama döngüsü derinliği yalnızca boş olmayan bir açılış etiketi için artırır; kendisi boş olan bir <ext/> ise hemen tek satırlık bir parça olarak saklanır

Olaylardan yeniden kurmanın görünür bir yan etkisi vardır. Öznitelik tırnakları, öğeler arası boşluklar ve <a></a> ile <a/> arasında yapılan seçim normalize edilmiş döner; yani bir parça anlam olarak orijinaline eşittir ama bayt bayt özdeş değildir. Excel XML'i ayrıştırır, baytları karşılaştırmaz. Yine de metni karşılaştıran bir diff aracı değişikliği işaretler ve birinin bunu regresyon olarak kaydetmesinden önce bunu bilmenin değeri vardır

Ad alanları, yeniden oynatılan bir parçada ters gidebilen ikinci şeydir. Excel genellikle ihtiyaç duyduğu ön ekleri <ext> öğesinin üzerinde bildirir, bu da parçayı kendi kendine yeterli kılar; ama bir blok, kaynak <worksheet> kökünde bir kez bildirilmiş x14ac ya da xr gibi bir ön eke yaslanabilir. Böyle bir parçayı bildirimi olmayan bir çalışma sayfasına oynatırsanız kaydedilen XML, ad alanı açısından iyi biçimli olmaz. HotXLS her yakalanan parçayı, kullandığı hâlde bildirmediği ön ekler için tarar, eşleşen bildirimleri kaynaktan RawExtNamespaceDecls içine kaydeder ve kaydedilen çalışma sayfasının köküne yazar. Parçalar düz dizgeler olduğundan, bir çalışma sayfasını aynı kitap içinde ya da kitaplar arasında çoğaltmak bunları yeni sayfaya taşıyabilir

Excel'in formüllerinize güvenmesi için calcChain.xml yazmak

HotXLS, kaydedilen çalışma kitabı en az bir formül hücresi taşıdığında xl/calcChain.xml dosyasını (Hesaplama Zinciri parçası, ECMA-376 Kısım 1, §12.3.1), içerik türü geçersiz koması ve çalışma kitabı ilişkisiyle birlikte yazar. Her girdi bir <c r="D10" i="1"/> öğesidir: hücre başvurusu artı 1 tabanlı sayfa indeksi. Şema, aynı sayfadaki bir girdi dizisinin bunu atlamasına izin verir; yazıcı ise her girdide üretir. Açık olmak daha basittir ve aynı derecede geçerlidir

Sıra, çalışma kitabının hâlihazırda bildiğine bağlıdır. Formül bağımlılık grafı varsa ve güncelse — ki bu, Recalculate'in hemen ardından gelen durumdur — zincir tam bir topolojik sıra izler: her formül, bağımlı olduğu hücrelerden sonra gelir ve dairesel başvuru üyeleri sona eklenir, böylece zincir yine de her formül hücresini listeler. Graf bayatladığında ya da hiç kurulmadığında formül hücreleri belge sırasıyla, sayfa sayfa listelenir. İkisi de yasaldır. Microsoft'un biçim için uygulama notları [MS-XLSX], zinciri Excel'in hesaplarken denetleyip yeniden sıraladığı bir ipucu olarak tanımlar; dolayısıyla herhangi bir sıradaki eksiksiz bir listeleme sorunsuz yüklenir

HotXLS, Recalculate bağımlılık grafını kurmuşsa xl/calcChain.xml'yi topolojik sırada, aksi hâlde belge sırasında üretir; Excel her iki eksiksiz listelemeyi de bir ipucu sayar ve yükleme sırasında yeniden sıralar
İki sıralama da geçerli kalır, çünkü Excel zinciri yüklemede yeniden doğrular ve HotXLS, SaveAs içinde tam bir bağımlılık grafı kurulumunu asla zorlamaz
Book.Open('model.xlsx');
Book.Sheets[1].Cells[10, 4].Formula := '=SUM(D2:D9)';
// Burada kaydetmek formül hücrelerini belge sırasıyla listeler; çünkü
// formülü değiştirmek bağımlılık grafını geçersiz kıldı.
Book.Recalculate;   // grafı yeniden kurar ve önbellekli değerleri tazeler
Book.SaveAs('model-out.xlsx');
// calcChain.xml artık bağımlılık sırasını izler: D10, D2:D9'dan sonra

SaveAs, grafı kendi inisiyatifiyle kurmaz. Tam bir bağımlılık kurulumu, her formüldeki her başvuruyu çözümlemek demektir; büyük bir modelde bu, yalnızca dosya yazmak isteyen bir çağıranın hiç istemediği gerçek iştir. Çıktıdaki önbellekli değerler sizin için önemliyse — ve açmadan Excel'i okuyan bir aşağı akış sistemi için genellikle önemlidir — yine de kaydetmeden önce Recalculate çağırın; bağımlılık sıralı zincir bedavaya gelir

Excel'in danışman saydığı bir parçayı neden üretelim? Çünkü yokluğu göze batar. Onarım sezgileri, üçüncü taraf görüntüleyiciler ve diff araçları, bir formül çalışma kitabının hesaplama zinciri taşımasını bekler; zincirsiz bir paket, Excel'in kendisinin ürettiği hiçbir şeye benzemez. Geçerli bir zincir yazmak, çıktıyı ekosistem geri kalanının denenmiş olduğu biçimin içinde tutar ve formül hücreleri üzerinden tek bir geçide mal olur

Kayıpsız çift yönlü döngünün bittiği yer

HotXLS bütün paketi bayt bayt kopyalamaz ve çıktı bu ölçüyle yargılanmamalıdır. Çalışma sayfası XML'i, styles.xml, paylaşılan dizeler ve çalışma kitabı parçası ayrıştırılmış modelden yeniden üretilir; içerik olarak sadıktırlar ama girdiyle ikili düzeyde özdeş değildirler. Yalnızca ZIP yerel başlıkları bile taze zaman damgaları taşır. Yakalanan <ext> parçaları yukarıda anlatıldığı gibi normalize edilmiş döner. ThemeMajorFont ile ThemeMinorFont, korunan bir temanın dışında kalır; ThemeColor geçersiz kılmaları ise yuva yuva içine yazılır

Koruma ağının tanımlı bir biçimi vardır: motorun yerel olarak modellediği özellikler — sparkline'lar ve genişletilmiş veri doğrulama gibi — ayrıştırılıp yeniden yazılır; çalışma sayfası düzeyindeki yabancı <ext> içeriği yeniden oynatılır; tema parçası yakalandığı hâliyle taşınır. VBA projeleri ve harici çalışma kitabı başvuruları, kaydetme boyunca modellemediğin-koru yaklaşımıyla geçer ve bu, VBA ile harici bağlantı koruması üzerine tamamlayıcı yazıda ele alınır; docProps içindeki belge özelliklerinin kendi okuma-yazma API'si vardır. Ne modellenen ne de bir uzantı noktası içinde duran, egzotik bir eklentiden gelen parça ise burada kapsanan üç mekanizmanın dışındadır

Anlam taşıyan denetim kendi dosyalarınızı kullanır. Özellik dolu bir üretim şablonunu açın, tek bir değeri değiştirin, kaydedin, iki paketi açın ve parça parça karşılaştırın. Düzenlediğiniz sayfada, styles.xml içinde ve extLst içi öznitelik biçimlendirmesinde fark bekleyin; tema parçası girdiyle eşleşmeli, <ext> öğeleri aynı uri değerlerini listelemeli ve calcChain.xml her formül hücresini adlandırmalıdır. Listenin ötesindeki her şey, şablon üretime girmeden önce kovalamaya değer

Tema koruması, yabancı extLst yeniden oynatması ve hesaplama zinciri çıktısı, HotXLS Delphi Excel Component içindeki XLSX motorunun parçasıdır; ürün sayfası, Delphi ve C++Builder projeleri için okuyup yazdığı geri kalanı listeler