sgcReports 功能矩阵
按任务分类的 sgcReports 全部功能，每项功能都链接到对应的帮助主题。核心不依赖 VCL 或 FMX，也没有外部 DLL，因此可在 Windows 服务和 Linux64 守护进程中运行。
按任务分类的 sgcReports 全部功能，每项功能都链接到对应的帮助主题。核心不依赖 VCL 或 FMX，也没有外部 DLL，因此可在 Windows 服务和 Linux64 守护进程中运行。
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 流式构建器 | TsgcReportBuilder 通过流式链式调用在代码中构建报表。 | 帮助 | |
| 报表模型 | 直接填充 TsgcReport 模型。 | 帮助 | |
| JSON 定义 | 在运行时从 JSON 加载报表定义，无需重新编译。 | 帮助 | |
| 分带与分组 | 分组页眉和页脚、主数据、页脚、小计和页码。 | 帮助 | |
| 主从明细 | 主带和明细带，例如带明细行的发票。 | 帮助 | |
| 表达式 | 诸如 Sum(Sales.Amount) 之类的表达式。 | 帮助 | |
| 脚本 | TsgcReport.Script 用一种类似 Pascal 的小型语言保存过程（变量、if、case、for、while、repeat 和所有表达式函数），存储在报表定义和 JSON 中。报表运行 StartScript 和 FinishScript，每个带区运行 BeforePrintScript、AfterPrintScript 和 AfterDataScript，每个项目运行 BeforePrintScript 和 AfterPrintScript。脚本可以隐藏带区，修改当前打印中某个项目的文本、字体颜色或高度，读取数据字段并设置报表变量。ScriptMaxSteps 会停止不会结束的脚本，ScriptErrorAction 和 OnScriptError 决定出错时如何处理。适用于 Delphi、C++Builder 和 .NET。 | 帮助 | |
| 条形码 | 通过 sgcPDF 条形码引擎在报表中使用条形码。 | 帮助 | |
| 从右到左（阿拉伯语和希伯来语） | TsgcReport.RightToLeft 以及带区和项目上的 BiDiMode 会镜像布局，文本经过整形、双向排序和两端对齐。PDF 导出会设置从右到左的阅读方向，XLSX 会写出从右到左的工作表，HTML 查看器和设计器会获得 dir="rtl"。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 无障碍 PDF | 默认生成带标签的 PDF/UA-1（PDFUA 为 True）。 | 帮助 | |
| PDF/A-3 | 按需生成归档用 PDF/A-3（rpaA3b、rpaA3a）。在 Delphi 和 .NET 中，还支持 PDF/A-4（rpaA4）和 PDF/UA-2（将 PDFUAPart 设为 rpuPart2）。 | 帮助 | |
| XLSX、CSV 和 PNG | 一份准备好的报表，多种输出：TsgcReportXLSXExport、TsgcReportCSVExport 和 TsgcReportImageExport。 | 帮助 | |
| 预览 | 带页面导航的 TsgcReportPreviewVCL 和 TsgcReportPreviewFMX。FireMonkey 预览可在 Windows、macOS、iOS 和 Android 上运行，支持触摸平移和双指缩放。在 iOS 和 Android 上，打印和保存 PDF 会打开系统的共享面板，由它提供 AirPrint 或 Android 打印（SharePDF，Delphi 10.3 及更高版本），RenderPage 可在所有平台上把任意页面绘制到位图中。 | 帮助 | |
| Linux 守护进程 | 在 Linux64 守护进程中以无界面方式运行引擎。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 通过 HTTP 提供报表 | TsgcReportHTTPEndpoint 以 PDF、XLSX、CSV 和 PNG 形式提供报表。需要 Professional 或更高版本的 sgcWebSockets 和 sgcHTML。 | ~Delphi 和 C++ Builder：需要 sgcWebSockets Professional 或更高版本以及 sgcHTML。.NET：esegece.sgcReports.HTML 和 AspNetCore 包托管相同的路由。 | 帮助 |
| 浏览器查看器 | TsgcReportHTMLViewer 在浏览器中显示报表。 | 帮助 | |
| Web 报表设计器 | TsgcReportHTMLDesigner 在浏览器中编辑报表定义。 | ~在生产环境的端点上请保持 DesignerEnabled 关闭，并把它放在您自己的身份验证之后。 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| VCL 设计器 | TsgcVCLReportDesigner 是一个面板，用户可以在您的应用程序中编辑报表。把它放到窗体上，指定 Engine 并添加数据源即可。 | 注册版 | 帮助 |
| FireMonkey 设计器 | TsgcFMXReportDesigner 是基于同一套设计器单元的 FireMonkey 版本。模式设计器可在 Windows 和 macOS 上使用。 | 注册版 | 帮助 |
| 工具箱、大纲、数据树和属性检查器 | 把工具箱中的元素类型和数据树中的字段拖到带区上，在大纲中浏览页面、带区和元素，并在属性检查器中编辑属性。每次放置都是一个撤销步骤。 | 注册版 | 帮助 |
| 标尺、对齐和撤销 | 带标尺和缩放的设计画面，对齐与分布命令，以及撤销和重做。 | 注册版 | 帮助 |
| 预览和 JSON 文件 | 预览页使用引擎的数据准备报表。新建、打开和保存使用 JSON 报表定义，服务器可以无界面运行它。只需一次调用即可打开带确定和取消按钮的模式设计器。 | 注册版 | 帮助 |
| 本地化设计器 | 设计器的文本由 sgcUISetLanguage 翻译成 sgcUI 内置的 12 种语言。 | 注册版 | 帮助 |
| .NET 设计器类 | 包含适用于 WinForms、WPF 和 Avalonia 的设计器控件：TsgcWinFormsReportDesigner、TsgcWpfReportDesigner 和 TsgcAvaloniaReportDesigner，提供工具箱、大纲、数据树、属性检查器、标尺和实时预览，以及模态设计器窗口。它们基于与平台无关的设计器模型，您也可以用该模型构建自己的宿主。 | 注册版 | 帮助 |
| 脚本编辑器 | VCL、FireMonkey、WinForms、WPF 和 Avalonia 的设计器都在代码编辑器中编辑报表脚本，并带有“检查”按钮，会显示错误所在的行和列。检查器列出报表、带区和项目的脚本事件，可从脚本的过程中选择，并有“(new procedure)”条目用于添加空过程。脚本的更改属于撤销和重做的一部分。 | 注册版 | 帮助 |
| 功能 | 详情 | 社区版 | 帮助 |
|---|---|---|---|
| 富文本 | 在一个元素中使用粗体、斜体、颜色、字体、列表和链接，用类似 HTML 的标记书写并支持 [表达式]。链接会保留在 PDF、HTML 和 DOCX 导出中。 | 帮助 | |
| 水印 | 在每个报表页上加文字或图片水印，可设置不透明度、旋转、居中、平铺或自定义位置、位于内容之后或之前、页范围和可见性表达式。 | 帮助 | |
| 交叉表 | 行字段和列字段，多个度量（求和、计数、平均值、最小值和最大值），合计，以及 PDF/UA 和 HTML 中的无障碍表格。放不下的列会延续到后续页面。 | 帮助 | |
| 自定义元素类型 | 按名称注册您自己的 TsgcReportCustomRenderer。它会在 PDF、PNG、HTML 和 DOCX 导出中输出，并出现在设计器的工具箱中。现成的 Chart 和 PivotTable 桥接属于注册版。 | 帮助 | |
| 报表中的图表 | sgcReportsCharts 桥接添加由 sgcCharts 绘制的 Chart 元素：柱形、堆积柱形、折线和面积，在 PDF 中是矢量内容，在 HTML 中是内联 SVG。需要 sgcCharts。 | 注册版 | 帮助 |
| 报表中的数据透视表 | sgcReportsPivotGrid 桥接添加由 sgcPivotGrid 计算的 PivotTable 元素，聚合方式比内置交叉表更多。需要 sgcPivotGrid。 | 注册版 | 帮助 |
| HTML 导出 | TsgcReportHTMLExport 写出单个自包含的 HTML 文件，可分页或连续。语义模式会写出标题、段落和 ARIA 表格，并对辅助技术隐藏装饰性元素。 | 帮助 | |
| DOCX 导出 | TsgcReportDOCXExport 写出 Word 文档，可以用精确的框架固定版式，也可以是可流动、可编辑的表格。不需要外部 zip 库。 | 注册版 | 帮助 |
.NET 报表是类名相同的 C# 移植版本：包括构建器、JSON 数据源、引擎和导出、WinForms 预览，以及 HTML、ASP.NET Core 和 sgcSign 包。
| 包 | 版本 | 内容 |
|---|---|---|
esegece.sgcReports.Community | 社区版（免费） | 核心库 |
esegece.sgcReports.WinForms.Community | 社区版（免费） | Windows Forms 控件 |
esegece.sgcReports.HTML.Community | 社区版（免费） | HTML 查看器与 Web 集成 |
esegece.sgcReports.AspNetCore.Community | 社区版（免费） | ASP.NET Core 集成 |
esegece.sgcReports.Wpf.Community | 社区版（免费） | WPF 控件 |
esegece.sgcReports.Avalonia.Community | 社区版（免费） | Avalonia 控件 |
esegece.sgcReports.sgcSign.Community | 社区版（免费） | sgcSign 桥接，为导出的 PDF 签名（PAdES） |
esegece.sgcReports | 注册版 | 核心库 |
esegece.sgcReports.WinForms | 注册版 | Windows Forms 控件 |
esegece.sgcReports.HTML | 注册版 | HTML 查看器与 Web 集成 |
esegece.sgcReports.AspNetCore | 注册版 | ASP.NET Core 集成 |
esegece.sgcReports.Wpf | 注册版 | WPF 控件 |
esegece.sgcReports.Avalonia | 注册版 | Avalonia 控件 |
esegece.sgcReports.sgcCharts | 仅限注册版 | sgcCharts 桥接，Chart 项 |
esegece.sgcReports.sgcPivotGrid | 仅限注册版 | sgcPivotGrid 桥接，PivotTable 项 |
esegece.sgcReports.sgcSign | 注册版 | sgcSign 桥接，为导出的 PDF 签名（PAdES） |
sgcReports 的每项功能都记录在 sgcUI 帮助中，每种开发环境各有一个版本。