Elle idare edilen bir finans çalışma kitabı pivot önbellekleri, dilimleyiciler, koşullu biçimler ve yılların hücre stillerini biriktirir; gece işinin yapması gereken tek şey ise tek bir veri sekmesindeki sayıları değiştirmektir. Tam bir yükleme ve kaydetme, her parçayı yeniden ayrıştırır, yeniden kurar ve yeniden sıkıştırır. Yalnızca o çalışma sayfası parçasını yeniden yazmak ve öteki her zip girdisini dokunmadan karşıya aktarmak, o işin neredeyse tamamını atlatır
Bunu mümkün kılan şey paket biçiminin kendisidir. Bir .xlsx dosyası, Open Packaging Conventions (ECMA-376 Bölüm 2) ile dizilmiş XML parçalarından oluşan bir zip arşividir ve her zip girdisi kendi sıkıştırma yöntemini, CRC-32'sini ve sıkıştırılmış boyutunu yerel başlıkta ve merkezi dizinde bir kez daha kaydeder. Bir girdi bu yüzden hiç açılmadan bir arşivden ötekine taşınabilir; kopyalayanın o üç değeri ham baytlarla birlikte yazması şartıyla. Pivot önbelleğini korumak için anlamak gerekmez; yalnızca kopyalamak gerekir
Neden çalışma kitabını yeniden kaydetmek yerine sıkıştırılmış baytları kopyalamalı?
Sıkıştırılmış düzeyde kopyalamak, yamanın çoğunu düz bir akış kopyasına çevirir. HotXLS'te TXLSDirectWriter.BeginPatch, kaynak paketi salt okunur açar ve yamanın dokunmadığı her girdiyi TZipArchive.CopyCompressedFrom'a verir; o da kaynak girdisin sıkıştırılmış baytlarını, CRC'sini ve boyutlarını doğrudan hedef arşive yazar. Geleneksel yazma yolu girişte bir açma ve çıkışta bir sıkıştırma bedeli öder ve pahalı yarısı sıkıştırmadır. Bütünü büyük bir pivot önbelleği ile bir düzine gömülü resimden oluşan bir çalışma kitabında zaman, gerçekten yazdığınız sayfaya gider
Ham kopya, sıkıştırılmamış saklanan girdileri (zip yöntemi 0) ve söndürülmüş girdileri (yöntem 8) kapsar. Başka bir sıkıştırma yöntemi kullanan bir girdi yine de taşınır: yazıcı onu açan bir akış üzerinden okur ve yeniden yazar; parça her iki durumda da hedefe düşer. Dizin işaretçi girdileri içerik taşımaz ve atlanır, çünkü yazıcı kendi üretir. Bir avuç girdi hiç kopyalanmaz, çünkü yeniden üretilir ya da düzenlenir: hedef çalışma sayfası ve onun _rels parçası, xl/calcChain.xml, xl/_rels/workbook.xml.rels ve [Content_Types].xml; ayrıca bir sayfa eklenirken xl/workbook.xml
BeginPatch ile tek bir sayfayı yerinde değiştirmek
İki argümanlı aşırı yükleme BeginPatch(FileName, SheetName), var olan bir çalışma sayfasının yerine yazar ve sonucu aynı yola geri yazdırır. Adı, xl/workbook.xml'deki sayfa kayıt defteri üzerinden ve her sayfayı parçasına bağlayan ilişki haritası üzerinden çözer; adları büyük küçük harf duyarsız karşılaştırır ve hiçbir şey eşleşmezse "worksheet not found" içeren bir istisna fırlatır. Oradan itibaren sayfa, akış yazarının yeni dosyalar için kullandığı aynı AddSheet, AddRow ve Write* çağrılarıyla yazılır
var
W: TXLSDirectWriter;
begin
W := TXLSDirectWriter.Create;
try
W.BeginPatch('monthly-dashboard.xlsx', 'Data'); // yerinde değiştir
W.AddSheet('Data'); // yama kipinde ad yalnızca bilgilendiricidir
W.AddRow(1);
W.WriteString(1, 'Region');
W.WriteString(2, 'Revenue');
W.AddRow(2);
W.WriteString(1, 'North');
W.WriteNumber(2, 184320.55);
W.AddRow(3);
W.WriteString(1, 'South');
W.WriteNumber(2, 97410.20);
W.AddRow(4);
W.WriteString(1, 'Total');
W.WriteFormula(2, 'SUM(B2:B3)'); // başında '=' yok
W.Close;
finally
W.Free;
end;
end;
Listedeki iki ayrıntı yanlış okumaya açıktır. AddSheet'e geçilen ad hiçbir şeyi yeniden adlandırmaz: sekme, sheetId'sini ve xl/workbook.xml'deki konumunu korur; dolayısıyla AddSheet('Totals') yine de Data'ya yazardı. Ve ikinci bir AddSheet fırlatır, çünkü bir yama tam olarak bir çalışma sayfası yazar. Üç sekmeyi tazelemek, üç yama demektir; her biri paketi bir kez daha kopyalar
Formül, eşittir işareti olmadan girer. WriteFormula metnini doğrudan hücrenin <f> öğesine yerleştirir ve ECMA-376 Bölüm 1 §18.3.1.40, formülleri orada, Excel'in formül çubuğunda gösterdiği "=" olmadan saklar; '=SUM(B2:B3)' yazmak, XML'e harfiyen bir eşittir işareti koyar. WriteFormula ayrıca önbelleklenmiş sonuç da üretmez. Aşağı akışta bir şey yeniden hesaplamak yerine önbellek değerlerini okuyorsa, WriteFormulaNumber formülü, neye değerlendiğini hâlihazırda bildiğiniz sayıyla birlikte yazar
Yerinde aşırı yükleme çalışırken asla özgün dosyaya yazmaz. Yamalanmış paket, kaynağın adından ve sonuna eklenmiş .hxlpatch.tmp'den oluşan bir kardeş dosyada kurulur. Close'da kaynak tanıtıcı serbest bırakılır ve hazırlanan dosya, tek bir yeniden adlandırma ile özgünün yerine geçer. O yeniden adlandırma başarısız olursa Close, iletisinde her iki yolu da adlandıran bir istisna fırlatır, hazırlanmış kopyayı tutar ve özgünü olduğu yerde bırakır. Close'dan önce öldürülen bir süreç, özgünü sağlam ve yanına bir başıboş .hxlpatch.tmp bırakır; o dosya için bir sonraki BeginPatch, başlamadan önce onu siler
Şablonun bir kopyasına yeni bir çalışma sayfası eklemek
Dört argümanlı aşırı yükleme BeginPatch(SourceFileName, TargetFileName, SheetName, InsertSheet), kaynak dosyaya dokunmaz ve yeni bir paket yazar. InsertSheet = False iken kopyadaki adlandırılmış sayfanın yerine yazar; True iken o ad altında yeni bir çalışma sayfası ekler ve şablonda o ada sahip bir sekme hâlihazırda varsa "worksheet already exists" fırlatır
// template.xlsx el değmeden kalır; output.xlsx bir sekme fazla alır
W.BeginPatch('template.xlsx', 'output.xlsx', 'Extra', True);
W.AddSheet('Extra');
W.AddRow(1);
W.WriteString(1, 'Appended by the nightly job');
W.Close;
Ekleme, paket defter tutmanın düzenlendiği yerdir. Yazıcı, mevcut xl/worksheets/sheetN.xml girdilerini en yüksek parça numarası için, <sheet> öğelerini en yüksek sheetId için ve çalışma kitabı ilişkilerini en yüksek rId için tarar, sonra her birinin bir sonraki değerini alır. Yeni <sheet> öğesi, tam </sheets>'in önüne girer; böylece yeni sekme en sonda görünür. İlişki özniteliği, kaynak çalışma kitabının sayfaları hangi önekle bağladıysa onu yeniden kullanır; genellikle r:id'dir ama olması gerekmez
İlişki türleri de kaynak paketi izler. Çalışma kitabı ilişkileri hâlihazırda purl.oclc.org altındaki ISO/IEC 29500 Strict ad alanlarını kullanıyorsa, yeni çalışma sayfası ilişkisi Strict tür URI'siyle yazılır; geçişli bir çalışma kitabı geçişli olanı alır. Yamalanmış bir Strict çalışma kitabı bu yüzden Strict'lerin arasında bir tek geçişli ilişkiyle kalmaz
Stiller, dizeler ve bir yamanın dokunmadığı parçalar
Bir yamanın içinde, yeni sayfanın işaret ettiği her şey kaynak pakette hâlihazırda bulunmalıdır. Bu yüzden dizeler, xl/sharedStrings.xml'e değil, sayfanın içine satır içi yazılır; çünkü paylaşılan dize tablosu bayt bayt karşıya geçer ve büyüyemez. UseSharedStrings'i True yapmak, yama kipinde AddSheet'in fırlatmasına yol açar
Aynı kural, StyleIndex'in ne anlama geldiğini değiştirir. Bir yamada o, kaynak çalışma kitabının cellXfs listesindeki bir konumdur (ECMA-376 Bölüm 1 §18.8.10) ve yazıcı yalnızca 0 ile 65534 arasında olduğunu kontrol eder. 14 indeksinin o belirli dosyada var olup olmadığını söyleyemez; dolayısıyla yanlış bir sayı doğrudan çıktıya girer. Doğrusunu bulmanın en güvenilir yolu, sayfanın güncel sürümünü zip'ten çıkarmak ve istediğiniz biçimi hâlihazırda taşıyan bir hücrenin s özniteliğini okumaktır; o sayı cellXfs konumudur. Excel, şablonda biri hücre biçimlendirdiğinde o listeye girdiler ekleyebilir; dolayısıyla bir yıl önce yazılmış bir sabite güvenmek yerine her şablon düzenlemesinden sonra indeksi yeniden arayın
const
// BU şablondaki bir tarih biçiminin cellXfs konumu; mevcut bir tarih
// hücresinin s="..." özniteliğinden alınır; şablon düzenlemelerinden sonra yeniden kontrol edin
TemplateDateXf = 5;
begin
...
W.AddRow(5);
W.WriteString(1, 'Refreshed');
W.WriteDateTime(2, Now, TemplateDateXf); // açık indeks: kabul edilir
// W.WriteDateTime(2, Now); yama kipinde fırlatır: onun örtük tarih stili
// yamanın hiç yazmadığı bir styles parçasında yaşar
end;
Yeni paket parçaları ekleyecek her şey reddedilir. AddTable, AddChart, AddImage ailesi, AddComment, AddDefinedName ve AddCellStyle, çağrıldıkları anda fırlatır ve Close, taahhüt etmeden önce yeniden kontrol eder; bu, kendi dolgusunu, font rengini, kalın ya da eğik stilini ayarlayan koşullu biçimleri de yakalar, çünkü onlar styles.xml'de yeni girdiler gerektirir. Reddedilen bir çağrı, sayfanın kimsenin kaydetmediği bir tablo parçasına başvurduğu bir paketten iyidir
Değiştirme kipi de sayfayı boşluktan başlatır. Eski sayfanın ilişki parçası kopyalanmaz; böylece önceki sürüme bağlı bir çizim, yorumlar ya da dış köprüler artık yeniye bağlı değildir ve eski sayfa XML'inde saklanan sütun genişlikleri, donmuş bölmeler, birleştirilmiş aralıklar ve veri doğrulaması da gider. Sayfa XML'inde yaşayanlar SetColumnWidth, FreezePanes, MergeCells, AddDataValidation ve AddHyperlink ile yeniden yazılabilir. Veri sekmesine demirlemiş bir grafik ya da resim bir yamayla geri gelemez; grafikleri kendi sayfalarında tutun ve serilerini veri sekmesine yönlendirin
Hesaplama zinciri her iki kipte de düşürülür. xl/calcChain.xml, formül hücrelerini Excel'in en son değerlendirdiği sırada listeler; bir değiştirmeden sonra girdileri, o biçimde artık var olmayan hücreleri anlatır ve bir eklemeden sonra atıfta bulunduğu sayfa indeksleri kaymıştır. Parça kopyanın dışında bırakılır; Override'u ve [Content_Types].xml'deki kaydı kaldırılır; böylece paket, eksik bir parçaya başvurmaz. Excel zinciri, bir sonraki yeniden hesaplamada yeniden kurar
Satır döngüsü yarısında patladığında
TXLSDirectWriter'ın yıkıcısı, Close hiç çağrılmadığında paketi tamamlar; dolayısıyla unutulmuş bir Close, yarım yazılmış bir zip öylece bırakmaz. Yazıcının tuttuğu her şeyi tamamladığı için, yerinde aşırı yükleme altında Free'den sarkan bir istisna, hâlihazırda yazılmış satırları yine de taahhüt eder ve onları özgünün üzerine takas eder. Satır çeken ve yazan, yarısında fırlatan ve yazarı bir finally bloğunda serbest bırakan bir döngü tam olarak böyle biter
Gözetimsiz çalışan her şey için: açık bir hedefe yazın, sonucu açın, kontrol edin ve ancak sonra canlı dosyayı kendiniz değiştirin. Satır döngüsünden gelen bir istisna Free'in hazırlanan dosyayı tamamlamasına yine de izin verir ama takası da atlar; böylece canlı çalışma kitabı, bugünün yarısını değil dünün sayılarını korur
uses
Windows, SysUtils, Variants, lxDirectWrite, lxHandleX;
procedure RefreshDashboard;
const
Live = 'monthly-dashboard.xlsx';
Staged = 'monthly-dashboard.next.xlsx';
var
W: TXLSDirectWriter;
Check: TXLSXWorkbook;
Sheet: TXLSXWorksheet;
begin
W := TXLSDirectWriter.Create;
try
W.BeginPatch(Live, Staged, 'Data', False);
W.AddSheet('Data');
WriteRefreshedRows(W); // kendi satır döngünüz, HotXLS'in parçası değildir
W.Close;
finally
W.Free;
end;
Check := TXLSXWorkbook.Create;
try
if Check.Open(Staged) <> 1 then
raise Exception.Create('Staged workbook does not open');
Sheet := Check.Sheets.SheetByName('Data');
if (Sheet = nil) or (VarToStr(Sheet.Cells[2, 1].Value) <> 'North') then
raise Exception.Create('Data sheet did not come back as written');
finally
Check.Free;
end;
// Windows API, HotXLS değil: canlı dosyayı yalnızca kontrollerden sonra değiştirin
if not MoveFileEx(PChar(Staged), PChar(Live), MOVEFILE_REPLACE_EXISTING) then
RaiseLastOSError;
end;
TXLSXWorkbook.Open başarıda 1 döndürür ve hem Sheets hem Cells 1 tabanlıdır: Check.Sheets[1] ilk sekme, Cells[2, 1] A2'dir. Tek bir nokta değerinin ötesinde, iki yapısal kontrol çoğu hatayı yakalar. Check.Sheets.Count bir değiştirmeden sonra şablonun sayısına eşit, bir eklemeden sonra bir fazla olmalıdır ve herhangi bir zip aracıyla alınan arşiv dökümü ne xl/calcChain.xml ne de iki kez geçen bir girdi adı göstermelidir. Yinelenen adlar önemlidir, çünkü bazı okuyucular verilen adla son girdiyi alır; bu da iki sayfanın içerikleri takas edilmiş gibi görünmesine yol açar
Yama mı, akış mı, yoksa çalışma kitabını yüklemek mi?
Yamalama, çalışma kitabı büyükken, değişim tek bir sayfayla sınırlıyken ve dosyanın gerisi bit bit hayatta kalmak zorundayken uygundur. Değişim birkaç sayfaya yayıldığında, yeni verinin şablonun hâlihazırda tanımlamadığı biçimlere ihtiyacı olduğunda, grafik ya da tablo kurulması gerektiğinde ya da dosya, sıradan bir yükleme ve kaydetmenin ölçülmeye değer hiçbir şey eklemediği kadar küçükken yanlış araçtır. Sıfırdan toplu üretim için akış doğrudan yazıcı daha uygundur; o da aynı AddRow ve Write* çağrılarını paylaştığı için iki taraf arasında kod taşımak çoğunlukla BeginFile'ı BeginPatch ile değiştirmekten ibarettir
İş gerçekten tam nesne modeline ihtiyaç duyuyorsa, yüklenmiş bir çalışma kitabı içinde sayfa düzeyli iş XLSX paketlerinde çalışma sayfası çoğaltma yazısında kapsanır. Ve yamalama masada yalnızca bütün-çalışma-kitabı işleme yavaşlamış olduğu içinse, büyük çalışma kitabı performansı, bir yaklaşım üzerinden karar vermeden önce yükleme-kaydetme zamanının ve belleğin gerçekte nereye gittiğine bakar
Yama yazıcı, akış yazıcı ve tam TXLSXWorkbook nesne modeli, Delphi ve C++Builder için tek bir kütüphanede gelir; sürümler ve eksiksiz özellik listesi HotXLS Delphi elektronik tablo bileşeni sayfasındadır