Teknik Makale

Delphi'den ISO 29500 Strict XLSX Dosyaları Yazma

Bir arşiv kabul denetimi, bir elektronik tabloyu tek bir şikâyetle reddediyor: xl/workbook.xml'in kök öğesi http://schemas.openxmlformats.org/spreadsheetml/2006/main ad alanında duruyor. Excel ise aynı dosyayı hiçbir itiraz olmadan açıyor. Her iki sonuç da doğrudur. ISO/IEC 29500, Strict SpreadsheetML'yi Bölüm 1'de tanımlar ve geçişli (transitional) biçimi eski uyumluluk özellikleriyle birlikte Bölüm 4'te tutar; doğrulayıcının alıntıladığı URI de Transitional'a aittir. ISO 29500 Strict adını geçen bir ihale veya kayıt politikası, paketin her parçasında purl.oclc.org kelime dağarcığını bekler ve bir dosya Excel'i memnun ederken bu sınavdan tamamen kalabilir

Strict ile Transitional arasında ne değişir?

Görünür fark kelime dağarcığıdır. Bir Strict çalışma kitabı parçası kök ad alanı olarak http://purl.oclc.org/ooxml/spreadsheetml/main'i bildirir ve ilişki adresi olarak http://purl.oclc.org/ooxml/officeDocument/relationships'i kullanır; r:id referansları bu adresle çözülür. DrawingML, grafik, resim ve spreadsheet-drawing ad alanları da aynı yolu izler; belge özelliği parçaları da öyle. İlişki türleri de onlarla birlikte değişir: kök ilişkiler parçası http://purl.oclc.org/ooxml/officeDocument/relationships/officeDocument adresini işaret eder ve genişletilmiş ile özel özellik türleri, Transitional'ın tireyle yazdığı adları extendedProperties ve customProperties olarak camelCase'e taşınır

Daha az görünür fark kapsamdır. Strict, yalnızca eski ikili davranışı taşımak için var olan Transitional şema parçalarını dışarıda bırakır ve Office'in sonra eklediği uzantılar için hiçbir kelime dağarcığına sahip değildir. Dizeler üzerinde bir ara-değiştir işlemi bu boşluğu kapatamaz, çünkü bazı özelliklerin Strict yazımı basitçe yoktur. Bir paketi dönüştürmek bu yüzden iki iş demektir: Strict karşılığı olan her şeyi yeniden adlandırmak ve olmayanlarla ne yapılacağına karar vermek

XLSX paketinde HotXLS StrictOOXML söz dağarcığı değişimi: workbook, relationship ve extended-properties parçaları openxmlformats geçiş ad alanlarından purl.oclc.org katı ad alanlarına yeniden yazılır
Her parça söz dağarcığını bir anda değiştirir; kök ad alanından ilişki türlerine ve camelCase'li extendedProperties türüne kadar. Pakette hiçbir yerde geçiş ad alanı hayatta kalamaz

Bir Delphi dışa aktarmasını StrictOOXML'e geçirmek

HotXLS'te bu anahtar, TXLSXWorkbook üzerindeki tek bir Boolean'dır: StrictOOXML, varsayılanı False'tur. Yazma kodu birebir aynı kalır. Sayfaları, hücreleri ve formülleri her zamanki gibi kurar, özelliği ayarlar ve kaydedersiniz. SaveAs başarı durumunda 1 döndürür; başka her değer, paketin yazılmadığı anlamına gelir ve nedeni Diagnostics içindedir

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;            // ISO/IEC 29500 Strict kelime dağarcığı
    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;

Özellik her kaydetmenin başında okunur ve yazarların baktığı kaydetme başına bir anahtarı sürer; böylece yarısında başarısız olan bir kaydetme, katı çeviriyi bir sonrakine açık bırakamaz. Tek bir çalışma kitabı nesnesinin birkaç dışa aktarma isteğine yanıt verdiği bir sunucuda StrictOOXML'i çağrılar arasında çevirebilirsiniz ve her kaydetme tam olarak istediği kelime dağarcığını alır

Önceden bilinmesinde fayda olan iki sınır var. Strict çıktı Open XML biçimleri için geçerlidir: çalışma kitabı, şablon ve makro içeren şablon. .xlsb istemek, StrictOOXML True iken özelliği kapatmanızı söyleyen bir tanıyla reddedilir, çünkü ikili biçimin Strict varyantı yoktur. Bir de Excel'in "Strict Open XML Spreadsheet" olarak kaydettiği bir dosyayı açmak özelliği sizin için ayarlamaz. Böyle bir dosyayı yükleyip StrictOOXML'e dokunmadan kaydederseniz karşınıza geçişli bir paket çıkar

Katı bir kaydetme neden çalışmayı reddeder?

Katı bir kaydetme, çalışma kitabı ISO 29500 Strict'in ifade edemediği içerik taşıdığında çalışmayı reddeder. HotXLS'in kontrol ettiği aileler şunlardır: VBA projeleri, ctrlProps parçalarıyla birlikte form denetimleri, iş parçacıklı yorumlar (klasik notlar değil, modern kişiler-ve-iş parçacıkları modeli), dilimleyiciler (slicer), dinamik dizi meta verileri, düz dolgu, negatif çubuk renkleri veya özel eksen gibi özellikler için 2009 uzantı bloğuna yaslanan veri çubukları ve bir dönüşüm politikası seçilmemişse Timelines

HotXLS katı kaydetme kapısı Delphi'de: StrictOOXML ile SaveAs, VBA projelerini, form denetimlerini, iş parçacıklı yorumları, dilimleyicileri ve dinamik dizi meta verisini reddeder ve yasak hiçbir özellik yokken tamamlanır
Katı bir kaydetme, çalışma kitabını ISO 29500 Strict'in ifade edebilecekleriyle karşılaştırır ve yalnızca uygunluk iddia eden bir paket yazmak yerine engelleyen her özelliği adlandırır

Reddetmek burada doğru varsaylandır. Alternatif, makro projesini veya dilimleyicileri sessizce düşürüp sonuca yine de Strict damgası vurmak olur; bu da birine, sorunsuz açılan ama dışa aktardığı dosyadan farklı davranan bir çalışma kitabı verir. Excel bunu asla işaretlemez. Bir red, kodunuz hâlâ hangi raporu ürettiğini bilirken özelliği adlandırır. Redlerin çoğu, SaveAs'in -1 döndürmesi ve StrictOOXML: Strict output cannot embed VBA gibi bir tanı olarak gelir. Dinamik dizi depolamasına paket yazılırken karar verilir, bu yüzden bu oturumda atanmış bir formül, meta veriyi adlandıran bir istisna ile kaydetmeyi yine de durdurabilir; Strict bir SaveAs sonucunu kontrol etmenin yanına try..except'e de alınmalıdır. Çalışma kitabının makrolara ihtiyacı varsa, VBA projelerini ve dış bağlantıları koruma yazısında anlatılan geçişli .xlsm yolu onun yeridir

Bunu kaydederek öğrenmek zorunda değilsiniz. GetConversionReport, çalışma kitabını yeniden hesaplamadan inceler ve öğeleri bir özellik adı, bir sadakat düzeyi, bir sayfa indeksi ve bir ileti taşıyan TXLSConversionReport döndürür. StrictOOXML altında engelleyen öğeler xlsConversionUnsupported olarak gelir. Timeline vakası ayrıca içeriği bilinçli olarak uygunlukla takas edebileceğiniz tek yeri gösterir: StrictTimelineOutputPolicy'yi xlsxStrictTimelineDateCriteria yapmak, desteklenen Timeline seçimlerini standart pivot tarih ölçütlerine dönüştürür ve Timeline arayüzünü, önbellek parçalarını, ilişkilerini ve tanımlı adlarını dışarıda bırakır. Rapor bunu xlsConversionDropped olarak listeler ve bellekteki kaynak çalışma kitabı değişmeden kalır

function StrictBlockers(Wb: TXLSXWorkbook; Log: TStrings): Boolean;
var
  Report: TXLSConversionReport;
  I: Integer;
begin
  Wb.StrictOOXML := True;
  // Belgelenmiş Timeline takasını kabul et: tarih ölçütleri kalır, Timeline arayüzü gider
  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;

Bunu dışa aktarmadan önce çalıştırın ve döndürdüğü her satırı günlüğe yazın. -1 sayfa indeksi, VBA projesi gibi çalışma kitabı düzeyinde bir öğeyi işaretler; çalışma sayfası öğeleri 1 tabanlı sayfa numarasını ve sayfa adını taşır, Sheets indekslemesiyle aynı şekilde. Rapor, yüklenmiş bir çalışma kitabının hâlihazırda taşıdığı dinamik dizi meta verisini de görür; kodda atanan formüller için bir sonraki bölümdeki skaler yeniden yazıma güvenin

Sessizce dinamik diziye dönüşen formül

İnsanları en çok yakalayan red, hiç FILTER veya SEQUENCE kullanmamış bir çalışma kitabındaki dinamik dizi meta verisidir. Excel 365, çok hücreli bir aralığa uygulanan operatörü bir indirgeyicinin içinde bile dizi olarak değerlendirir; bu yüzden =SUM(B2:B4*C2:C4) Excel'in gözünde bir dizi formülüdür. Bu metni Formula'ya atadığınızda HotXLS hücreyi Excel'in yapacağı gibi saklar: cm referansıyla xl/metadata.xml'e bağlanan tek hücreli bir dinamik dizi olarak; aksi halde Excel yüklemede örtük kesişim uygular ve #VALUE! gösterir. Arka plan dizi operatörlü formüller ve örtük kesişim yazısındadır. Strict'in o meta veri parçası için kelime dağarcığı yoktur, bu yüzden kaydetme durur

// Dizi depolaması: iki aralığın çarpımı dizi olarak değerlendirilir
Sh.Cells[5, 2].Formula := '=SUM(B2:B4*C2:C4)';    // Strict kaydetmeyi engeller

// Skaler depolama: düz aralık argümanları, aynı toplam
Sh.Cells[5, 2].Formula := '=SUMPRODUCT(B2:B4,C2:C4)';

Strict dışa aktarmalar için skaler biçimi yazın. Düz aralık argümanlarıyla SUMPRODUCT aynı toplamı verir, dosyayı sonra okuyacak herhangi bir şeyde dinamik dizi desteği gerektirmez ve hücreyi meta veri parçasının tamamen dışında tutar. Aynı yeniden yazım koşullu sayımlar için de çalışır: SUMPRODUCT((A2:A4="x")*1) hâlâ dizileri çarpar, orada COUNTIF(A2:A4,"x")'i tercih edin. Bir rapor gerçekten taşma (spill) sonuçlarına ihtiyaç duyuyorsa, geçişli çıktıya ihtiyacı vardır

Korunan parçalar kopyalanmak yerine yeniden kurulur

Çalışma sayfası XML'i, katı çıktının kolay kısmıdır. Zor kısım, hızlı bir yazarın olduğu gibi kopyalamayı tercih edeceği her şeydir. HotXLS mevcut bir paketi açtığında özgün temayı, bağlantıları, dış bağlantıları, grafikleri ve pivot parçalarını tutar; geçişli bir kaydetmede, model değişmemişse onların sıkıştırılmış baytlarını doğrudan geçirir. Bu, sadakat için doğru hamle ve Strict için yanlış hamledir, çünkü o baytlar hâlâ Transitional ad alanları taşır

StrictOOXML açıkken bayt kopyalama yolu bu parçaların hepsi için atlanır. Bağlantılar, dış bağlantılar ve grafikler modelden yeniden kurulur; tema ile yakalanan pivot tablo, önbellek tanımı ve önbellek kaydı XML'i, ad alanı çevirmeninden yeniden oynatılır. O çevirmen her açılış etiketini ayrıştırır ve yalnızca iki şeyi yeniden yazar: ad alanı bildirimleri ile Type özniteliği — Relationship öğelerinin .rels parçalarında taşıdığı öznitelik. Hücre metni, diğer öznitelik değerleri, yorumlar ve CDATA bölümleri bayt bayt geçer; böylece içinde tesadüfen http://schemas.openxmlformats.org/... bulunan bir paylaşılan dizeye asla dokunulmaz. schemas.openxmlformats.org dışındaki ad alanı URI'leri, extLst bloklarının içindeki Microsoft uzantı ad alanları gibi, olduğu gibi bırakılır; doğrulayıcınız Transitional ad alanlarının yanı sıra uzantı içeriğini de reddediyorsa, o özellikleri dışa aktarmadan önce kaynak çalışma kitabından çıkarın

Korunan XLSX parçaları için HotXLS katı çıktı yolu: theme, connections, dış bağlantılar, grafikler ve pivot önbellekleri birebir bayt kopyalamadan, yalnızca ad alanı bildirimlerini ve ilişki türlerini yeniden yazan bir yeniden kurma veya çeviren yeniden oynatmaya geçer
Kopyalanan sıkıştırılmış baytlar geçişli ad alanlarını katı pakete kaçırırdı; bu yüzden korunan yollar hızlı yolu atlar. Çeviri yalnızca ad alanı bildirimlerini ve ilişki türlerini yeniden yazar ve akıtılan çalışma sayfası iskeleti, sheetData'da bölünmeden önce çevrilir

Akıtılan çalışma sayfaları aynı kuralı bir ayrıntıyla izler. Yazar önce çalışma sayfası iskeletini kurar, çevirir ve ancak sonra aradaki satırları akıtmak için <sheetData>'da böler. Satır blokları kelime dağarcığı URI'si içermez; bu yüzden büyük sayfalar Strict çıktısı için fazladan hiçbir şey ödemez. Paylaşılan dizeler ve pivot önbellek kayıtları da aynı şekilde çalışır: yalnızca başlık öğesi çevrilir. Korunum tarafının devamı temaların, uzantı listelerinin ve calcChain'in kayıpsız gidiş-dönüşleri içindedir

Strict dosyaları okumak ve yazdığınızı kontrol etmek

Excel'in Strict olarak kaydettiği dosyalar herhangi bir çalışma kitabı gibi açılır. HotXLS, bir ilişki parçasının ayrıştırıldığı her yerde — paket kökünde, çalışma sayfalarında, çizimlerde, dış bağlantılarda ve pivot tablolarda — Strict ilişki türlerini Transitional karşılıklarına eşler ve okuyucu öğe adlarını önek yerine ad alanı URI'siyle çözer. Üçüncü taraf üreteçler önekleri serbestçe bağlar, bu yüzden aynı mekanizma sıradan dosyalara da hizmet eder; XLSX paketlerinde OPC ilişki çözümlemesi yazısında anlatılmıştır. Böyle bir dosyanın geçişli kaydında, kökü hâlâ Strict ad alanı kullanan korunan her XML parçası çıkışta geriye dönüştürülür; böylece sonuç yarısı bir kelime dağarcığı yarısı öbürü olan bir şeye dönüşmez

Strict çıktısını pakete karşı doğrulayın, iki biçimi de memnuniyetle açan Excel'e karşı asla. Sonucu zip'ten çıkarın ve üç şeyi kontrol edin: xl/workbook.xml http://purl.oclc.org/ooxml/spreadsheetml/main ad alanını bildirir, hiçbir parça schemas.openxmlformats.org/spreadsheetml dizesini içermez ve Type değerleri — _rels/.rels ile xl/_rels/workbook.xml.rels'tekiler — http://purl.oclc.org/ooxml/ ile başlar. Çıkarılan klasörün üzerinde kısa bir findstr /s /m "schemas.openxmlformats.org/spreadsheetml" *.xml turu hiçbir şey listelememelidir

Ardından dosyayı TXLSXWorkbook.Open üzerinden yeniden açın ve değerleri, formülleri, sayı biçimlerini ve köprüleri kaynak çalışma kitabıyla karşılaştırın. Bu geri okuma, aynı zamanda okuyucu tarafı eşlemeyi de çalıştırır. Çalışma kitabı grafik veya pivot tablo taşıyorsa onları da karşılaştırmaya ekleyin, çünkü ikisi de StrictOOXML altında bayt kopyadan yeniden kurulmuş veya yeniden oynatılmış bir yola geçer

Strict çıktı, Strict farkında okuma ve Transitional paketlerin kayıpsız gidiş-dönüşü, Delphi ve C++Builder için HotXLS'te tek bir OOXML motorunu paylaşır; HotXLS Delphi elektronik tablo bileşeni sayfası kapsadığı biçimleri ve özellikleri listeler