Delphi, C++ Builder & .NET Onderdeel van sgcUI

sgcDocs, een headless API voor Office-bestanden voor Delphi, C++ Builder & .NET

Maak, lees en converteer Word-documenten en spreadsheets in een desktoptoepassing, een Windows-service of een Linux-server. sgcDocs voert mail merges uit, drukt werkmappen af naar PDF, voegt PDF-bestanden samen, splitst, vult, versleutelt en ondertekent ze, rendert barcodes en bouwt ZIP64-archieven. Er is geen Office-installatie en geen UI-framework nodig, want elke lezer, schrijver en renderer is Pascal- of C#-code.

Geen Office-installatieGeen UI-frameworkWindows en Linux64Inbegrepen in sgcUI Enterprise
De mail mergecode van sgcDocs naast de twee factuur-PDF-bestanden die het schreef, door sgcDocs naar PNG gerenderd

Office-bestanden zonder Office

Zeven niet-visuele componenten op de palettabpagina sgcDocs. Hieronder de hoogtepunten, en de functiematrix toont elke functie.

Word-documenten

Lees, bewerk en schrijf documenten en voeg ze daarna samen met je gegevens.

Word-documenten

DOCX, RTF, HTML en Markdown lezen, bewerken en schrijven

Contracten, rapporten en brieven beginnen vaak als een DOCX die in Word is gemaakt. TsgcDocsWordProcessor laadt DOCX, RTF, HTML, Markdown en tekst, behoudt secties, kopteksten, voetteksten, velden, voetnoten en bladwijzers en slaat het document in elk van die formaten op. Het zoekt en vervangt tekst in de hoofdtekst, de tabellen, de kopteksten en de voetteksten, en exporteert de opgemaakte pagina's naar PDF, PNG of SVG.

  • Getagde PDF met de structuur van koppen, lijsten en tabellen, en PDF/A
  • PNG-pagina's van 1 tot 2400 dpi, en SVG-pagina's
  • SearchText and ReplaceAll in elk deel van het document
  • Beveiliging als alleen-lezen, opmerkingen, bijgehouden wijzigingen en formulieren met een gezouten wachtwoordhash

Word-documenten

Mail merge vanuit JSON, CSV, een dataset of events

Facturen, brieven en certificaten komen uit een sjabloon en een lijst met records. MailMerge schrijft elk record in één document, en MailMergeEach schrijft één bestand per record, ook PDF, met het recordnummer en elke veldwaarde in de bestandsnaam. Het sjabloon is een gewone DOCX die in Word is gemaakt met MERGEFIELD- en IF-velden.

  • Schakelaars voor getal, datum en hoofdletters, zoals \# ,0.00 and \@ "MMMM d, yyyy"
  • IF-velden met geneste velden, en regio's die tabelrijen herhalen per onderliggend record
  • TsgcDocsMergeJSON, TsgcDocsMergeCSV, TsgcDocsMergeDataSet and TsgcDocsMergeEvents

Spreadsheets

Werkmappen met formules, opmaak en grafieken, berekend en afgedrukt op de server.

Spreadsheets

XLSX, ODS en CSV met 320 Excel-functies

TsgcDocsSpreadsheet laadt, maakt, berekent en bewaart werkmappen zonder gebruikersinterface. Cellen worden net als in Excel geadresseerd, een tekst die met = begint is een formule, en de formule-engine berekent 320 Excel-functies, inclusief LET, LAMBDA en benoemde LAMBDA-functies. Opmaak, samengevoegde cellen, grafieken en voorwaardelijke opmaak blijven behouden wanneer een XLSX-bestand wordt geladen en opnieuw opgeslagen.

  • Values, Formulas and Text op celadres, Evaluate voor elke formule
  • Lettertypen, opvulling, uitlijning, getalnotaties, kolombreedten en rijhoogten
  • ImportDataSet kopieert de rijen van een dataset naar een werkblad
  • Beveiliging van werkbladen en werkmappen

Spreadsheets

Werkmappen afgedrukt naar PDF, HTML en PNG

Een werkblad wordt gepagineerd zoals Excel het afdrukt, met de pagina-instelling die in de werkmap is opgeslagen: afdrukstand, papierformaat, schaal of aanpassen aan pagina's, marges, afdrukgebieden, afdruktitels, rasterlijnen en codes voor kop- en voetteksten. De grafieken van het werkblad worden meegedrukt, en ExportToHTML schrijft een HTML-tabel per werkblad met de grafieken als inline SVG.

  • ExportToPDFFile voor één werkblad of elk zichtbaar werkblad
  • ExportSheetPageToPNG voor één afgedrukte pagina
  • Afdrukgebieden, afdruktitels en aanpassen tot één pagina breed

PDF, barcodes en ZIP

Het bestandswerk rond de documenten, in hetzelfde pakket.

PDF-verwerking

PDF-bestanden samenvoegen, splitsen, vullen, versleutelen en ondertekenen

TsgcDocsPDFProcessor opent een PDF, ook een versleutelde, en wijzigt die: bestanden samenvoegen, ze splitsen op paginabereiken, pagina's extraheren, verwijderen, verplaatsen en roteren, de tekst lezen en doorzoeken, en pagina's naar PNG renderen. Het vult AcroForm-velden in en maakt ze plat, versleutelt met AES-256, converteert naar PDF/A en valideert het resultaat, en maakt van HTML met CSS of afbeeldingen een PDF.

  • RC4- en AES-versleuteling met rechten voor afdrukken, kopiëren en wijzigen
  • PDF/A-1, PDF/A-2, PDF/A-3 and PDF/A-4 conversie en validatie
  • Digitale handtekeningen via OnExternalSign op elk platform, en op Windows met een PFX-bestand of een certificaat uit de certificaatopslag

Barcodes en ZIP

Barcodes en ZIP64-archieven

TsgcDocsBarcode codeert 11 lineaire en 2D-symbolen, zoals Code 128, EAN-13, QR Code, Data Matrix en PDF417, valideert de gegevens en schrijft PNG, SVG of PDF, of tekent het symbool als vectoren op een PDF-pagina. TsgcDocsZipArchive maakt en leest ZIP-archieven met ZIP64, UTF-8-namen en invoertijden, en weigert een archief met een padtraversal-naam voordat er iets wordt geschreven.

  • 11 soorten barcodes met controlecijfers en GS1-validatie
  • ZIP64 voor archieven van meer dan 4 GB of met meer dan 65.535 items
  • Grootte, gecomprimeerde grootte, CRC32 en tijd van elk item

Conversie en implementatie

Conversies met één aanroep, en dezelfde code op een desktop en op een server.

Conversie

63 formaatparen in één aanroep

TsgcDocsConverter converteert bestanden en streams tussen documenten, spreadsheets, PDF-bestanden en afbeeldingen. De formaten komen uit de bestandsextensies, of worden uit de inhoud van een stream herkend, en CanConvert geeft vooraf aan of een paar wordt ondersteund. ConvertToImages schrijft één PNG of SVG per pagina, en ConvertImagesToPDF maakt één PDF-pagina per afbeelding.

  • DOCX, RTF, HTML, Markdown en tekst naar elkaar, naar PDF, PNG en SVG
  • XLSX, ODS en CSV naar elkaar, naar HTML, PDF en PNG
  • PDF naar tekst en PNG, en elke PDF-uitvoer als PDF/A wanneer je erom vraagt

Implementatie

Dezelfde code op Windows en Linux64

De sgcDocs-units gebruiken geen VCL-, FireMonkey- of GDI-code en hebben geen Office nodig, dus dezelfde code draait in een consoleprogramma, een Windows-service, een Linux64-daemon of een webserver. De componenten zijn niet thread-safe: maak de componenten die een aanvraag nodig heeft aan in de thread die de aanvraag afhandelt, en afzonderlijke instanties draaien parallel. Voeg op Linux de TrueType-lettertypen die je documenten gebruiken toe met AddFontFolder of de lijst Fonts van de converter.

  • Delphi 7 tot 13 en C++ Builder 2007 tot 13
  • Win32, Win64 and Linux64
  • Het .NET-pakket esegece.sgcDocs voor .NET Framework 4.7.2, .NET Standard 2.0 en .NET 6 tot 10

Wie bouwt er met sgcDocs

Facturen, brieven en contracten uit je gegevens

Bedrijfstoepassingen vullen DOCX-sjablonen die in Word zijn gemaakt met de records van een database of een JSON-document, en schrijven één PDF per klant. De gebruikers blijven de sjablonen in Word bewerken, en de toepassing heeft nooit Office op de machine nodig.

  • Mail merge
  • Eén bestand per record
  • PDF-uitvoer
Start de MailMerge-demo

Een conversieservice op je eigen server

Portalen en backoffices converteren geüploade documenten naar PDF, tekst of pagina-afbeeldingen op een Linux- of Windows-server, zonder ze naar een dienst van een derde partij te sturen. Elke aanvraag krijgt zijn eigen converter, en de aanvragen draaien parallel.

  • 63 formaatparen
  • Linux64
  • REST-endpoints
Start de ConversionServer-demo

Rapporten en exports zonder Excel

Rapportage- en boekhoudtoepassingen maken werkmappen met formules, opmaak en grafieken, berekenen ze en drukken ze af naar PDF met de pagina-instelling van de werkmap, in een service zonder gebruikerssessie.

  • 320 Excel-functies
  • Grafieken
  • Afdrukken naar PDF
Start de SpreadsheetCreate-demo

Vullen, samenvoegen en converteren in enkele regels

De componenten hebben geen formulier en geen parent nodig: maak ze aan met een nil-eigenaar, roep hun methoden aan en maak ze vrij.

TsgcDocsWordProcessor vult een DOCX-sjabloon en exporteert het naar PDF. TsgcDocsConverter converteert elk ondersteund paar in één aanroep en schrijft één PNG per pagina.

uses
  SysUtils, Classes,
  sgcDocs_Types, sgcDocs_Word, sgcDocs_Converter;

procedure ContractToPDF;
var
  oWord: TsgcDocsWordProcessor;
  oConverter: TsgcDocsConverter;
begin
  // fill a DOCX template made in Word, save it and export it to PDF
  oWord := TsgcDocsWordProcessor.Create(nil);
  try
    oWord.LoadFromFile('contract_template.docx');
    oWord.ReplaceAll('[CUSTOMER]', 'Anna Lopez');
    oWord.ReplaceAll('[DATE]', FormatDateTime('mmmm d, yyyy', Date));
    oWord.SaveToFile('contract.docx');
    oWord.ExportToPDFFile('contract.pdf');
    WriteLn('Pages: ', oWord.PageCount);
  finally
    oWord.Free;
  end;

  // one call conversions, the formats come from the file extensions
  oConverter := TsgcDocsConverter.Create(nil);
  try
    oConverter.Convert('contract.docx', 'contract.html');
    oConverter.Convert('contract.pdf', 'contract.txt');
    // one PNG per page, at 96 dpi
    oConverter.ConvertToImages('contract.pdf', 'pages', 96);
  finally
    oConverter.Free;
  end;
end;

MailMergeEach schrijft één PDF per bestelling van een JSON-array. {#} is het recordnummer en {Name} een veldwaarde.

uses
  SysUtils, Classes,
  sgcDocs_Types, sgcDocs_MailMerge, sgcDocs_Word;

procedure InvoicesFromJSON;
var
  oWord: TsgcDocsWordProcessor;
  oData: TsgcDocsMergeJSON;
  vCount: Integer;
begin
  oWord := TsgcDocsWordProcessor.Create(nil);
  oData := TsgcDocsMergeJSON.Create;
  try
    // a template made in Word: MERGEFIELD Name, MERGEFIELD Total \# ,0.00
    // and a table region from TableStart:Lines to TableEnd:Lines
    oWord.LoadFromFile('invoice_template.docx');
    // [{"Name": "Anna Lopez", "Total": 1250.5, "Lines": [...]}, ...]
    oData.LoadFromFile('orders.json');
    // one PDF per order: invoice_1_Anna Lopez.pdf, invoice_2_Ben Miller.pdf
    vCount := oWord.MailMergeEach(oData, 'invoice_{#}_{Name}.pdf');
    WriteLn(vCount, ' invoices written');
  finally
    oData.Free;
    oWord.Free;
  end;
end;

Waarden, een formule met LET, het berekende resultaat, en de werkmap opgeslagen als XLSX en ODS en afgedrukt naar PDF.

uses
  SysUtils, Classes,
  sgcDocs_Types, sgcDocs_Spreadsheet;

procedure CreateSales;
var
  oSheet: TsgcDocsSpreadsheet;
begin
  oSheet := TsgcDocsSpreadsheet.Create(nil);
  try
    oSheet.New;
    oSheet.Values['A1'] := 'Product';
    oSheet.Values['B1'] := 'Units';
    oSheet.Values['C1'] := 'Price';
    oSheet.Values['A2'] := 'Paper';
    oSheet.Values['B2'] := 12;
    oSheet.Values['C2'] := 4.5;
    oSheet.Values['A3'] := 'Toner';
    oSheet.Values['B3'] := 3;
    oSheet.Values['C3'] := 39.9;
    oSheet.Values['A4'] := 'Total';
    // a text that starts with = is a formula, LET and LAMBDA included
    oSheet.Values['C4'] := '=LET(t, SUMPRODUCT(B2:B3, C2:C3), ROUND(t, 2))';
    oSheet.Calculate;
    WriteLn('Total: ', oSheet.Text['C4']);
    oSheet.SaveToFile('sales.xlsx');
    oSheet.SaveToFile('sales.ods');
    WriteLn(oSheet.ExportToPDFFile('sales.pdf'), ' PDF page(s)');
  finally
    oSheet.Free;
  end;
end;

Het .NET-pakket esegece.sgcDocs behoudt de Delphi-klassenamen. Een consoleprogramma dat een sjabloon vult, een werkmap maakt, de twee PDF-bestanden samenvoegt tot een PDF/A-2b-bestand en de bronnen converteert.

using System;
using esegece.sgcDocs;
using esegece.sgcPDF;

static class Program
{
    static void Main()
    {
        // fill a DOCX template made in Word and export it to PDF
        using (var word = new TsgcDocsWordProcessor())
        {
            word.LoadFromFile("contract_template.docx");
            word.ReplaceAll("[CUSTOMER]", "Anna Lopez");
            word.SaveToFile("contract.docx");
            word.ExportToPDFFile("contract.pdf");
        }

        // a spreadsheet with a formula, saved as XLSX and printed to PDF
        using (var sheet = new TsgcDocsSpreadsheet())
        {
            sheet.New();
            sheet.SetValues("A1", "Units");
            sheet.SetValues("A2", 12);
            sheet.SetValues("A3", 30);
            sheet.SetFormulas("A4", "=SUM(A2:A3)");
            sheet.Calculate();
            Console.WriteLine("Total: " + sheet.Text("A4"));
            sheet.SaveToFile("units.xlsx");
            sheet.ExportToPDFFile("units.pdf");
        }

        // merge both PDF files and convert the result to PDF/A-2b
        using (var pdf = new TsgcDocsPDFProcessor())
        {
            pdf.LoadFromFile("contract.pdf");
            pdf.Merge("units.pdf");
            pdf.ConvertToPDFA(TsgcPDFALevel.paA2b);
            pdf.SaveToFile("contract_pack.pdf");
            Console.WriteLine(pdf.PageCount + " pages");
        }

        // one call conversions, the formats come from the file extensions
        using (var converter = new TsgcDocsConverter())
        {
            converter.Convert("contract.docx", "contract.md");
            converter.Convert("units.xlsx", "units.csv");
        }
    }
}

Start de sgcDocs-demo's

De Delphi- en C++ Builder-demo's worden met de sgcUI-proefversie geïnstalleerd in Demos\Docs. De .NET-demo's zitten in de Registered .NET-download. De Delphi-consoledemo's gebruiken alleen de RTL en de sgc-units, dus ze bouwen en draaien ongewijzigd op Windows en Linux64.

WordCreate en WordConvert

Een document met koppen, een opgemaakte tabel, lijsten, een afbeelding, een koptekst, een voettekst met paginanummers en een voetnoot, opgeslagen als DOCX, PDF en PNG. WordConvert laadt elk document en slaat het op in elk ander formaat.

MailMerge

Samenvoegvelden met schakelaars, een IF-veld en een tabelregio: brieven uit CSV en bestellingen uit JSON, in één document en één bestand per record.

WordFindReplace

Zoeken en vervangen in de hoofdtekst, een tabel, de koptekst en de voettekst, daarna een alleen-lezenbeveiliging met een wachtwoord.

SpreadsheetCreate en SpreadsheetConvert

Een verkoopwerkblad en een leningwerkblad met LET, LAMBDA, XLOOKUP en financiële functies, opmaak, een kolomgrafiek en een pagina-instelling, opgeslagen als XLSX, ODS, CSV, PDF en HTML.

PDFTools

HTML naar PDF, samenvoegen, splitsen, roteren, tekst extraheren en zoeken, PNG-pagina's, AES-256-versleuteling, formulieren invullen en plat maken, en PDF/A-conversie en -validatie.

Barcodes en ZipArchive

Alle 11 soorten barcodes als PNG, SVG en op een PDF-pagina. Een ZIP-archief met itemmetadata, een geweigerd archief met padtraversal en een ZIP64-archief van 70.000 items.

DocumentConverter

De CanConvert-matrix van de 14 formaten en hun 63 paren, en de conversie van elk bestand naar een doelformaat, met pagina-afbeeldingen voor PNG en SVG.

ConversionServer

Een REST-conversieservice met POST /convert, POST /merge, GET /formats en GET /health, één converter per aanvraag en een maximale uploadgrootte.

C++ Builder- en .NET-demo's

DocumentConverter, MailMerge, PDFTools en WordCreate voor C++ Builder 13. De 11 C#-projecten voor .NET 8 zijn porteringen van de Delphi-demo's, en ConversionServer is een minimale ASP.NET Core-API.

Waar sgcDocs in zit

sgcDocs zit in sgcUI Enterprise en All-Access. Het wordt niet als apart pakket verkocht. Het bouwt voort op sgcUICore, sgcRichEdit, sgcGrid, sgcSpreadsheet, sgcCharts en sgcPDF, die deel uitmaken van sgcUI Enterprise, en het installatieprogramma voegt ze erbij. Er is geen gratis Community-editie, en het .NET-pakket esegece.sgcDocs is alleen Registered.

sgcUI Enterprise

Elk sgcUI-product, inclusief sgcDocs en de engines waarop het voortbouwt, vanaf €699.

Bekijk Enterprise →

All-Access

Elk eSeGeCe-product, inclusief sgcUI Enterprise en sgcDocs.

Bekijk All-Access →

Ondersteunde compilers en platforms

Componenten in sgcDocs

Documenten

TsgcDocsWordProcessor en TsgcDocsMailMerge.

Spreadsheets

TsgcDocsSpreadsheet.

PDF, barcodes en ZIP

TsgcDocsPDFProcessor, TsgcDocsBarcode en TsgcDocsZipArchive.

Conversie

TsgcDocsConverter.

DoelComponentVersies en platforms
Delphi 7 tot 13De zeven sgcDocs-componentenWin32, en Win64 vanaf Delphi XE2
C++ Builder 2007 tot 13Dezelfde klassenGegenereerde .hpp-headers en statische bibliotheken
Linux64Dezelfde units, zonder VCL-, FireMonkey- of GDI-codeConsoleprogramma's, daemons en webservers. Vereist libz.so.1 en de TrueType-lettertypen van de documenten
.NETesegece.sgcDocs.NET Standard 2.0, .NET Framework 4.7.2, .NET 6, 8, 9 en 10
.NET-pagina-afbeeldingenesegece.sgcUICore.RenderingWordt alleen toegevoegd voor PNG- en SVG-pagina's van documenten en werkbladen

Veelgestelde vragen

Nee. sgcDocs heeft geen Microsoft Office, geen LibreOffice, geen COM en geen externe DLL's nodig. Elke lezer, schrijver en renderer is Pascal-code van de sgcUI-engines, of C#-code in het .NET-pakket.

Documenten in DOCX, RTF, HTML, Markdown en tekst, spreadsheets in XLSX, ODS en CSV, en PDF-bestanden. De uitvoer omvat ook PDF-, PNG- en SVG-pagina's, en PNG-, JPEG-, BMP- en TIFF-afbeeldingen worden naar PDF geconverteerd. PPTX, de binaire formaten XLS en DOC, het lezen van ODT, draaitabellen, opmerkingen en revisies, en Office-bestandsversleuteling zitten niet in deze release.

Ja. De units compileren voor Linux64 en draaien in consoleprogramma's en daemons. De binary heeft libz.so.1 nodig, die elke distributie installeert, en de TrueType-lettertypen die je documenten gebruiken, ofwel op de server geïnstalleerd, ofwel vanuit een map toegevoegd met AddFontFolder.

Ja, daarvoor is het gebouwd. De componenten zijn niet thread-safe, dus maak de componenten die een aanvraag nodig heeft aan in de thread die de aanvraag afhandelt en maak ze aan het eind van de aanvraag vrij. Afzonderlijke instanties draaien parallel. De ConversionServer-demo toont een complete REST-conversieservice.

Nee. sgcDocs maakt deel uit van sgcUI Enterprise en All-Access. Het .NET-pakket is alleen Registered en wordt niet op nuget.org gepubliceerd. Evalueer het met de sgcUI-proefversie.

Ja. Elke sgcUI Enterprise-licentie bevat de volledige broncode en 1 jaar updates. Zie de prijspagina van sgcUI.

sgcDocs-help

Online help

De sgcUI-help voor Delphi, C++ Builder en .NET: installatie, ondersteunde formaten, aan de slag, mail merge, documentconversie, lettertypen op Linux en implementatie op servers.

PDF-handleidingen

Delphi, C++ Builder en .NET, voor elk sgcUI-product.

3,000+Ontwikkelaars
20+Jaar
761+Componenten
30+API-integraties
5Platformen
Niet-goed-geld-terug-garantie van 30 dagenNiet tevreden? Vraag binnen 30 dagen na aankoop een volledige terugbetaling aan. Bekijk het terugbetalingsbeleid

Probeer sgcDocs vandaag nog

De sgcUI-proefversie bevat sgcDocs en elk ander sgcUI-product.