由您的数据生成发票、信函和合同
业务应用程序用数据库记录或 JSON 文档填充用 Word 制作的 DOCX 模板,并为每位客户写出一个 PDF。用户继续在 Word 中编辑模板,而应用程序无需在机器上安装 Office。
- 邮件合并
- 每条记录一个文件
- PDF 输出
在桌面应用程序、Windows 服务或 Linux 服务器中创建、读取和转换 Word 文档与电子表格。sgcDocs 可执行邮件合并,把工作簿打印为 PDF,合并、拆分、填写、加密和签名 PDF 文件,生成条形码并创建 ZIP64 压缩包。它无需安装 Office,也无需任何界面框架,因为所有读取器、写入器和渲染器都是 Pascal 或 C# 代码。
读取、编辑和写入文档,然后与您的数据合并。
Word 文档
合同、报告和信函往往一开始就是用 Word 制作的 DOCX。TsgcDocsWordProcessor 可加载 DOCX、RTF、HTML、Markdown 和文本,保留节、页眉、页脚、域、脚注和书签,并能把文档保存为其中任何一种格式。它可以在正文、表格、页眉和页脚中搜索和替换文本,并把排好版的页面导出为 PDF、PNG 或 SVG。
SearchText 和 ReplaceAllWord 文档
发票、信函和证书由一个模板和一组记录生成。MailMerge 把所有记录写入同一个文档,MailMergeEach 则为每条记录写一个文件(包括 PDF),文件名中可带记录编号和任意字段值。模板就是用 Word 制作的普通 DOCX,其中包含 MERGEFIELD 和 IF 域。
\# ,0.00 and \@ "MMMM d, yyyy"TsgcDocsMergeJSON, TsgcDocsMergeCSV, TsgcDocsMergeDataSet and TsgcDocsMergeEvents带有公式、格式和图表的工作簿,在服务器上计算和打印。
电子表格
TsgcDocsSpreadsheet 无需用户界面即可加载、创建、计算和保存工作簿。单元格的寻址方式与 Excel 相同,以 = 开头的文本就是公式,公式引擎可计算 320 个 Excel 函数,包括 LET、LAMBDA 和命名 LAMBDA 函数。加载并再次保存 XLSX 文件时,格式、合并单元格、图表和条件格式都会保留。
Values、Formulas 和 Text,用 Evaluate 计算任意公式ImportDataSet 把数据集的行复制到工作表中电子表格
工作表按 Excel 的打印方式分页,页面设置保存在工作簿中:方向、纸张大小、缩放或适应页数、页边距、打印区域、打印标题、网格线以及页眉页脚代码。工作表中的图表会一并打印,ExportToHTML 为每个工作表写出一个 HTML 表格,图表以内联 SVG 形式输出。
ExportToPDFFile 可导出一个工作表或所有可见工作表ExportSheetPageToPNG 导出一个打印页面围绕文档的文件处理工作,都在同一个包中。
PDF 处理
TsgcDocsPDFProcessor 可打开 PDF(包括加密的 PDF)并对其进行修改:合并文件,按页范围拆分,提取、删除、移动和旋转页面,读取并搜索文本,把页面渲染为 PNG。它可填写并展平 AcroForm 字段,用 AES-256 加密,转换为 PDF/A 并验证结果,还能把带 CSS 或图像的 HTML 转换为 PDF。
OnExternalSign 进行数字签名,在 Windows 上还可使用 PFX 文件或证书存储区中的证书条形码和 ZIP
TsgcDocsBarcode 可编码 11 种一维和二维符号,例如 Code 128、EAN-13、QR Code、Data Matrix 和 PDF417,验证数据并写出 PNG、SVG 或 PDF,也可把符号以矢量形式绘制在 PDF 页面上。TsgcDocsZipArchive 可创建和读取支持 ZIP64、UTF-8 名称和条目时间的 ZIP 压缩包,并在写入任何内容之前拒绝带有路径遍历名称的压缩包。
一次调用即可完成转换,同样的代码可用于桌面和服务器。
转换
TsgcDocsConverter 在文档、电子表格、PDF 文件和图像之间转换文件和流。格式由文件扩展名确定,或从流的内容中检测,CanConvert 可预先告知某个格式对是否受支持。ConvertToImages 为每页写出一个 PNG 或 SVG,ConvertImagesToPDF 则为每张图像生成一个 PDF 页面。
部署
sgcDocs 单元不使用 VCL、FireMonkey 或 GDI 代码,也无需 Office,因此同样的代码可运行在控制台程序、Windows 服务、Linux64 守护进程或 Web 服务器中。组件不是线程安全的:请在处理请求的线程中创建该请求所需的组件,不同的实例可并行运行。在 Linux 上,请通过 AddFontFolder 或转换器的 Fonts 列表添加文档所用的 TrueType 字体。
esegece.sgcDocs,适用于 .NET Framework 4.7.2、.NET Standard 2.0 和 .NET 6 至 10业务应用程序用数据库记录或 JSON 文档填充用 Word 制作的 DOCX 模板,并为每位客户写出一个 PDF。用户继续在 Word 中编辑模板,而应用程序无需在机器上安装 Office。
门户网站和后台系统在 Linux 或 Windows 服务器上把上传的文档转换为 PDF、文本或页面图像,无需发送给第三方服务。每个请求都有自己的转换器,请求并行运行。
报表和会计应用程序创建带有公式、格式和图表的工作簿,在没有用户会话的服务中计算它们,并按工作簿的页面设置打印为 PDF。
这些组件无需窗体,也无需父控件:用 nil 所有者创建它们,调用其方法,然后释放。
TsgcDocsWordProcessor 填充 DOCX 模板并将其导出为 PDF。TsgcDocsConverter 一次调用即可转换任何受支持的格式对,并为每页写出一个 PNG。
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 为 JSON 数组中的每个订单写出一个 PDF。{#} 是记录编号,{Name} 是字段值。
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;写入值,使用 LET 的公式,计算结果,并把工作簿保存为 XLSX 和 ODS 且打印为 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;.NET 包 esegece.sgcDocs 保留了 Delphi 的类名。这个控制台程序填充模板,创建工作簿,把两个 PDF 文件合并为 PDF/A-2b 文件,并转换源文件。
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");
}
}
}Delphi 和 C++ Builder 演示随 sgcUI 试用版安装在 Demos\Docs 中。.NET 演示随 Registered 版 .NET 下载一同提供。Delphi 控制台演示只使用 RTL 和 sgc 单元,因此无需修改即可在 Windows 和 Linux64 上构建并运行。
一份带有标题、样式表格、列表、图像、页眉、带页码的页脚和脚注的文档,保存为 DOCX、PDF 和 PNG。WordConvert 加载任意文档并将其保存为所有其他格式。
带开关的合并域、IF 域和表格区域:由 CSV 生成信函,由 JSON 生成订单,输出为一个文档,或每条记录一个文件。
在正文、表格、页眉和页脚中搜索和替换,然后用密码设置只读保护。
一个销售表和一个贷款表,使用 LET、LAMBDA、XLOOKUP 和财务函数,带格式、柱形图和页面设置,保存为 XLSX、ODS、CSV、PDF 和 HTML。
HTML 转 PDF,合并、拆分、旋转,文本提取和搜索,PNG 页面,AES-256 加密,表单填写和展平,以及 PDF/A 转换和验证。
全部 11 种条形码,输出为 PNG、SVG 以及绘制在 PDF 页面上。一个带条目元数据的 ZIP 压缩包,一个被拒绝的路径遍历压缩包,以及一个含 70,000 个条目的 ZIP64 压缩包。
14 种格式及其 63 个格式对的 CanConvert 矩阵,以及把任意文件转换为目标格式,PNG 和 SVG 输出页面图像。
一个 REST 转换服务,提供 POST /convert、POST /merge、GET /formats 和 GET /health,每个请求一个转换器,并限制最大上传大小。
适用于 C++ Builder 13 的 DocumentConverter、MailMerge、PDFTools 和 WordCreate。适用于 .NET 8 的 11 个 C# 项目移植自 Delphi 演示,ConversionServer 是一个 ASP.NET Core 最小 API。
sgcDocs 包含在 sgcUI Enterprise 和 All-Access 中,不作为单独的产品销售。它建立在 sgcUICore、sgcRichEdit、sgcGrid、sgcSpreadsheet、sgcCharts 和 sgcPDF 之上,这些都属于 sgcUI Enterprise,安装程序会随之一并安装。没有免费的 Community 版,.NET 包 esegece.sgcDocs 仅提供 Registered 版。
TsgcDocsWordProcessor 和 TsgcDocsMailMerge。
TsgcDocsSpreadsheet。
TsgcDocsPDFProcessor、TsgcDocsBarcode 和 TsgcDocsZipArchive。
TsgcDocsConverter。
| 目标 | 组件 | 版本和平台 |
|---|---|---|
| Delphi 7 至 13 | 七个 sgcDocs 组件 | Win32,以及 Delphi XE2 起的 Win64 |
| C++ Builder 2007 至 13 | 相同的类 | 生成的 .hpp 头文件和静态库 |
| Linux64 | 相同的单元,不含 VCL、FireMonkey 或 GDI 代码 | 控制台程序、守护进程和 Web 服务器。需要 libz.so.1 以及文档所用的 TrueType 字体 |
| .NET | esegece.sgcDocs | .NET Standard 2.0、.NET Framework 4.7.2、.NET 6、8、9 和 10 |
| .NET 页面图像 | esegece.sgcUICore.Rendering | 仅在需要文档和工作表的 PNG 和 SVG 页面时添加 |
不需要。sgcDocs 不需要 Microsoft Office、LibreOffice、COM,也不需要外部 DLL。所有读取器、写入器和渲染器都是 sgcUI 引擎的 Pascal 代码,或 .NET 包中的 C# 代码。
文档支持 DOCX、RTF、HTML、Markdown 和文本,电子表格支持 XLSX、ODS 和 CSV,另外还有 PDF 文件。输出还包括 PDF、PNG 和 SVG 页面,PNG、JPEG、BMP 和 TIFF 图像可转换为 PDF。PPTX、二进制 XLS 和 DOC 格式、ODT 读取、数据透视表、批注和修订以及 Office 文件加密不在此版本中。
可以。这些单元可编译为 Linux64,并在控制台程序和守护进程中运行。可执行文件需要 libz.so.1(每个发行版都会安装它)以及文档所用的 TrueType 字体,字体可安装在服务器上,也可用 AddFontFolder 从某个文件夹添加。
可以,这正是它的设计目的。组件不是线程安全的,因此请在处理请求的线程中创建该请求所需的组件,并在请求结束时释放。不同的实例可并行运行。ConversionServer 演示展示了一个完整的 REST 转换服务。
没有。sgcDocs 属于 sgcUI Enterprise 和 All-Access。.NET 包仅提供 Registered 版,不在 nuget.org 上发布。请使用 sgcUI 试用版进行评估。
包含。每个 sgcUI Enterprise 许可证都含完整源代码和 1 年更新。请参阅 sgcUI 价格页面。
sgcUI 帮助:Delphi、C++ Builder 和 .NET,内容包括安装、支持的格式、入门、邮件合并、文档转换、Linux 上的字体以及服务器部署。
Delphi、C++ Builder 和 .NET,涵盖所有 sgcUI 产品。