C#용 .NET 리포팅 도구
sgcReports는 .NET 리포팅 도구이자 C# 보고서 생성기예요. 코드로 보고서를 만들고, WinForms, WPF, Avalonia에 표시하고, PDF와 Excel로 내보내요.
sgcReports는 .NET 리포팅 도구이자 C# 보고서 생성기예요. 코드로 보고서를 만들고, WinForms, WPF, Avalonia에 표시하고, PDF와 Excel로 내보내요.
그룹형 목록, 청구서, 표, 카탈로그를 보고서 엔진이 한 번 준비해서 미리 보기에 표시하거나 PDF, Excel, CSV, 이미지로 작성해요.
.NET WinForms의 ReportTables 데모: 페이지 탐색, 확대 축소, 인쇄, PDF, 찾기, 축소판, 내보내기를 갖춘 미리 보기와 디자이너 및 표 편집기 버튼.
그룹마다 머리글, 소계, 페이지 번호가 있는 그룹형 보고서.
마스터와 디테일 데이터로 만든 청구서. 항목 줄, 합계, QR 코드가 있어요.
JSON 보고서 정의와 그것이 렌더링하는 페이지예요. 애플리케이션을 다시 컴파일하지 않고 레이아웃을 바꿀 수 있어요.
준비된 보고서 하나를 PDF, Excel 통합 문서, CSV 파일, 페이지당 PNG 하나로 작성해요.
보고서 디자이너의 표 편집기: 머리글, 데이터, 바닥글 행, 병합된 셀, 스타일, 강조 표시.
DataTable에 TsgcReportDataTableSource로 보고서에 데이터를 주고, 플루언트 TsgcReportBuilder로 레이아웃을 기술한 다음 저장하세요. 빌더는 자체 보고서와 보고서 엔진을 만들어 소유해요. 모든 형식은 Delphi 에디션과 같은 클래스 이름으로 esegece.sgcReports 네임스페이스에 있어요.
using esegece.sgcReports;
public static class SalesReport
{
// aSales: a TsgcReportDataTableSource named "Sales" over a DataTable
// with the columns Region, Customer and Amount, sorted by Region
public static TsgcReportBuilder Build(TsgcReportDataSource aSales)
{
TsgcReportBuilder oBuilder = new TsgcReportBuilder();
oBuilder.Title("Sales by region").Units(TsgcReportUnits.ruMillimeters)
.Style("Group").Font("Arial", 11).Bold().BackColor(0xEEEEEE).EndStyle()
.Page().Paper(TsgcReportPaperSize.rpsA4).Margins(15)
.ReportTitle(14)
.Text("Sales by region", 0, 0, 180, 10).Bold().EndBand()
// one header per region, one line per sale, a total per region
.GroupHeader("Sales.Region", 9).Style("Group")
.Text("Region: [Sales.Region]", 0, 1, 180, 7).EndBand()
.MasterData("Sales", 6)
.Text("[Sales.Customer]", 2, 0, 120, 6)
.Text("[Sales.Amount]", 130, 0, 50, 6).AlignRight().Format("#,0.00").EndBand()
.GroupFooter(9)
.Text("Region total [FormatFloat('#,0.00', Sum(Sales.Amount))]", 80, 1, 100, 6)
.AlignRight().Bold().EndBand()
.EndPage().Data(aSales);
return oBuilder;
}
}
데이터베이스나 객체로 DataTable을 채우고, 데이터 소스에 넘긴 다음 보고서를 저장하세요. PDF 출력은 기본적으로 태그된 PDF/UA이고, 같은 준비된 페이지가 Excel과 CSV로도 내보내져요.
using System.Data;
using esegece.sgcReports;
DataTable oTable = new DataTable("Sales");
oTable.Columns.Add("Region", typeof(string));
oTable.Columns.Add("Customer", typeof(string));
oTable.Columns.Add("Amount", typeof(double));
oTable.Rows.Add("East", "Acme Corp", 1450.00);
oTable.Rows.Add("East", "Blue Harbor", 600.00);
oTable.Rows.Add("North", "Nordic Labs", 2100.75);
using (TsgcReportDataTableSource oSales = new TsgcReportDataTableSource())
{
oSales.SourceName = "Sales";
oSales.DataTable = oTable;
using (TsgcReportBuilder oBuilder = SalesReport.Build(oSales))
{
// tagged PDF/UA by default, the same pages as an Excel workbook and a CSV file
oBuilder.SaveToPDF("sales.pdf");
oBuilder.SaveToXLSX("sales.xlsx");
oBuilder.SaveToCSV("sales.csv");
// PDF/A-3 on request, for archiving
oBuilder.PDFExport.PDFA = TsgcReportPDFAMode.rpaA3b;
oBuilder.SaveToPDF("sales-archive.pdf");
// keep the layout as a JSON report definition
sgcReports_Definition.sgcReportSaveToJSONFile(oBuilder.Report, "sales.json");
}
}
빌더는 페이지 머리글과 바닥글, 열 머리글, 디테일 밴드, 표, 체크 박스, 바코드, 보고서 매개변수, 책갈피도 추가해요. TsgcReportBuilder 도움말 주제와 시작 가이드를 참고하세요.
각 UI 패키지에는 보고서 미리 보기와 바로 쓸 수 있는 최종 사용자 보고서 디자이너가 들어 있어서, 사용자가 애플리케이션 안에서 보고서 레이아웃을 열고, 바꾸고, 저장할 수 있어요. 디자이너에는 도구 모음, Design과 Preview 탭, Toolbox, Outline, Data 트리, 속성 인스펙터, 눈금자, 실행 취소와 다시 실행, 스크립트 편집기가 있어요. 세 호스트는 플랫폼에 중립적인 디자이너 모델 하나를 공유해요.
esegece.sgcReports.WinForms 패키지: 보고서 미리 보기 컨트롤, TsgcWinFormsReportDesigner(UserControl), 모달 TsgcWinFormsReportDesignerForm, sgcReports_Designer_WinForms.sgcShowReportDesigner.
esegece.sgcReports.Wpf 패키지: 페이지 탐색, 확대 축소, 인쇄, PDF 저장이 있는 TsgcWpfReportPreview, TsgcWpfReportDesigner(DockPanel), 모달 TsgcWpfReportDesignerWindow.
esegece.sgcReports.Avalonia 패키지: 페이지 탐색, 확대 축소, PDF 저장이 있는 TsgcAvaloniaReportPreview, TsgcAvaloniaReportDesigner, 비동기 파일 선택기가 있는 sgcShowReportDesignerAsync.
미리 보기에는 찾기 표시줄, 페이지 축소판, PDF 개요, 11가지 형식의 Export 메뉴, 긴 보고서를 준비하는 동안의 취소 버튼, 보고서 매개변수 입력창이 있어요. 미리 보기는 모든 에디션에, 디자이너 클래스는 Registered 에디션에 들어 있어요. 디자이너는 ReportBuilder .rtm 템플릿도 새 보고서로 가져와요. .NET 디자이너 도움말을 참고하세요.
using System.Data;
using System.Windows.Forms;
using esegece.sgcReports;
public class SalesForm : Form
{
TsgcReportDataTableSource FSales;
TsgcReportBuilder FBuilder;
TsgcReportPreviewVCL FPreview;
public SalesForm(DataTable aSales)
{
Width = 1000;
Height = 760;
FSales = new TsgcReportDataTableSource();
FSales.SourceName = "Sales";
FSales.DataTable = aSales;
FBuilder = SalesReport.Build(FSales);
// the preview: page navigation, zoom, find, thumbnails, print and export
FPreview = new TsgcReportPreviewVCL();
FPreview.Dock = DockStyle.Fill;
Controls.Add(FPreview);
Button oDesign = new Button();
oDesign.Text = "Design...";
oDesign.Dock = DockStyle.Top;
oDesign.Click += (s, e) =>
{
// the end-user designer (Registered edition) as a modal window
if (sgcReports_Designer_WinForms.sgcShowReportDesigner(FBuilder.Engine, FSales))
{
sgcReports_Definition.sgcReportSaveToJSONFile(FBuilder.Engine.Report, "sales.json");
FPreview.Prepare();
}
};
Controls.Add(oDesign);
FPreview.Engine = FBuilder.Engine;
FPreview.Prepare();
}
}
using System.Windows;
using esegece.sgcReports;
public class DesignerWindow : Window
{
public DesignerWindow(TsgcReportEngine aEngine, TsgcReportDataSource aSales)
{
Title = "Report designer";
TsgcWpfReportDesigner oDesigner = new TsgcWpfReportDesigner();
Content = oDesigner;
oDesigner.Engine = aEngine;
oDesigner.AddDataSource(aSales);
oDesigner.LoadFromFile("sales.json");
Closed += (s, e) => oDesigner.Dispose();
}
}
public class PreviewWindow : Window
{
public PreviewWindow(TsgcReportEngine aEngine)
{
TsgcWpfReportPreview oPreview = new TsgcWpfReportPreview();
Content = oPreview;
oPreview.Engine = aEngine;
oPreview.Prepare();
}
}
sgcReports는 밴드형 C# 보고서 생성기예요. 페이지는 밴드를, 밴드는 항목을 담고, 엔진이 데이터에 맞는 시점에 각 밴드를 인쇄해요.
보고서 제목과 요약, 페이지 머리글과 바닥글, 열 머리글, 그룹 머리글과 바닥글, 마스터 데이터와 디테일 데이터 밴드. 각각 자체 높이, 스타일, 항목을 가져요.
그룹 머리글은 식이 바뀔 때마다 새 그룹을 시작하고, 그룹 바닥글은 Sum이나 Count 같은 집계 함수로 소계를 인쇄해요.
청구서가 항목을 청구서에 연결하듯, MasterSource, MasterFields, DetailFields로 디테일 소스를 마스터에 연결해요.
텍스트 항목 안에 대괄호로 쓴 필드와 함수, 예를 들어 [Sales.Customer]나 [FormatFloat('#,0.00', Sum(Sales.Amount))], 그리고 조건이 참일 때 항목의 스타일을 바꾸는 강조 표시를 지원해요.
머리글, 데이터, 바닥글 행, 병합된 셀, 텍스트에 맞춰 늘어나는 행이 있는 표 항목과, 여러 측정값과 합계를 가진 교차 표.
입력창이 있는 형식 있는 보고서 매개변수, 보고서에 저장되는 작은 스크립트 언어, 레터헤드 같은 기본 레이아웃을 상속하는 보고서.
데이터는 DataTable에 TsgcReportDataTableSource를 쓰거나, 객체의 JSON 배열에 TsgcReportJSONSource를 써서 가져와요. 서식 있는 텍스트, 워터마크, 바코드, 체크 박스, 책갈피는 모든 에디션에 들어 있어요. 차트, 스파크라인, 게이지, 피벗 테이블 항목은 Registered sgcCharts, sgcGauges, sgcPivotGrid 브리지 패키지와 함께 제공돼요. sgcReports 기능 매트릭스를 참고하세요.
엔진은 페이지를 한 번만 준비하고, 각 내보내기가 자신의 형식으로 작성해요. PDF 출력은 sgcPDF 엔진을 쓰므로 모든 구성에서 sgcPDF가 필요해요.
| 형식 | 세부 정보 | .NET Community(무료) |
|---|---|---|
| PDF/UA | 기본적으로 읽기 순서, 이미지 대체 텍스트, 표시된 제목이 있는 태그된 PDF/UA-1이에요. 요청 시 PDF/UA-2를 쓸 수 있어요. | ✓ |
| PDF/A | 보관 문서와 청구서 XML이 포함된 전자 청구서용 PDF/A-3(rpaA3b, rpaA3a), 그리고 PDF/A-4. | ✓ |
| XLSX와 CSV | 같은 준비된 페이지로 만든 Excel 통합 문서와 CSV 파일. | ✓ |
| PNG, SVG, ODS, HTML, 텍스트 | 페이지당 이미지 하나, OpenDocument 스프레드시트, HTML, 일반 텍스트. | ✓ |
| DOCX, ODT, RTF | Word 문서, OpenDocument 텍스트, Rich Text Format. | − |
| 서명된 PDF | sgcSign 브리지 패키지가 PDF 내보내기에 서명해요(PAdES). | ✓ |
엔진과 내보내기는 UI가 필요 없어서, 같은 보고서를 Windows 서비스, 웹 API, Linux 데몬에서 실행할 수 있어요. 코드나 디자이너가 저장한 JSON 보고서 정의를 불러오고, 데이터를 연결해서 파일을 작성하세요.
using System.Data;
using esegece.sgcReports;
public static class ReportJob
{
public static void Run(DataTable aSales, string aFileName)
{
using (TsgcReport oReport = new TsgcReport())
using (TsgcReportEngine oEngine = new TsgcReportEngine())
using (TsgcReportDataTableSource oSales = new TsgcReportDataTableSource())
using (TsgcReportPDFExport oPDF = new TsgcReportPDFExport())
{
// the layout comes from a JSON definition, the data from your code
sgcReports_Definition.sgcReportLoadFromJSONFile(oReport, "sales.json");
oSales.SourceName = "Sales";
oSales.DataTable = aSales;
oEngine.Report = oReport;
oEngine.AddDataSource(oSales);
TsgcReportPreparedPages oPages = oEngine.Prepare();
oPDF.SaveToFile(oPages, aFileName);
}
}
}
TsgcReportHTTPEndpoint는 등록된 보고서(RegisterReport)를 PDF, XLSX, CSV, HTML 등의 파일로 제공하고, esegece.sgcReports.HTML과 esegece.sgcReports.AspNetCore 패키지가 그 경로를 ASP.NET Core에서 호스팅해요.
서버는 스레드당 엔진 하나와 데이터 소스 세트 하나로 동시 보고서를 준비해요. .NET 데모에는 LinuxDaemon과 HTTPServer 프로젝트가 들어 있어요.
esegece.sgcReports에는 빌더, 데이터 소스, 엔진, 내보내기가 들어 있어요. 미리 보기와 디자이너에는 UI 프레임워크의 패키지를, 웹에서 보고서를 제공하려면 HTML과 ASP.NET Core 패키지를 추가하세요.
dotnet add package esegece.sgcReports
dotnet add package esegece.sgcReports.WinForms
dotnet add package esegece.sgcReports.Wpf
dotnet add package esegece.sgcReports.Avalonia
dotnet add package esegece.sgcReports.AspNetCore
무료 Community 에디션은 같은 패키지 ID에 .Community 접미사를 붙여 쓰세요. 예를 들어 dotnet add package esegece.sgcReports.Community예요. 전체 패키지 목록은 sgcReports 다운로드 페이지에 있고, .NET 개요가 컴포넌트를 설명해요. .NET 데모는 Invoice, Groups, JSONDefinition, PDFUA, Exports, Fluent, HTTPServer, LinuxDaemon, DatabaseSQL, MobileMAUI예요.
무료 Community 패키지에는 엔진, 내보내기, 미리 보기가 들어 있어요. Registered 에디션은 최종 사용자 디자이너, DOCX, ODT, RTF 내보내기, 차트, 게이지, 피벗 테이블 브리지를 더해 줘요.
| 기능 | .NET Community(무료) | Registered |
|---|---|---|
| 플루언트 빌더, 보고서 모델, JSON 정의 | ✓ | ✓ |
| 밴드, 그룹, 마스터 디테일, 식 | ✓ | ✓ |
| PDF/UA와 PDF/A-3 내보내기 | ✓ | ✓ |
| XLSX, CSV, PNG, ODS, SVG, HTML, 일반 텍스트 내보내기 | ✓ | ✓ |
| WinForms, WPF, Avalonia 미리 보기 | ✓ | ✓ |
| 서비스와 Linux용 헤드리스 엔진 | ✓ | ✓ |
| WinForms, WPF, Avalonia용 최종 사용자 보고서 디자이너 | − | ✓ |
| DOCX, ODT, RTF 내보내기 | − | ✓ |
| 차트, 스파크라인, 게이지, 피벗 테이블 항목 | − | ✓ |
.Community 패키지는 연간 총매출이 EUR 1M 미만이고 개발자가 5명 이하인 개인과 조직에 무료예요. 둘 중 하나의 기준 이상인 조직은 Registered 라이선스가 필요해요.
모든 기능과 상용 라이선스. Single, Team, Site 라이선스이며, 각각 전체 소스 코드, 1년 업데이트, 50%에서 70%까지의 갱신 할인이 포함돼요.
sgcReports .NET 가격 →€199
Single, Team, Site 라이선스를 제공해요.
네. sgcReports에는 WinForms(esegece.sgcReports.WinForms), WPF(esegece.sgcReports.Wpf), Avalonia(esegece.sgcReports.Avalonia)용 보고서 미리 보기와 최종 사용자 보고서 디자이너가 있어요. 미리 보기는 탐색, 확대 축소, 찾기, 축소판, 내보내기와 함께 페이지를 보여 줘요. 엔진과 내보내기는 코어 esegece.sgcReports 패키지에 있고 UI 없이도 동작해요.
esegece.sgcReports NuGet 패키지(또는 esegece.sgcReports.Community)를 추가하고, DataTable을 TsgcReportDataTableSource로 감싼 다음, 플루언트 TsgcReportBuilder로 페이지, 밴드, 항목을 기술하고 SaveToPDF, SaveToXLSX, SaveToCSV를 호출하세요. 보고서 만들기 샘플과 같아요. JSON 보고서 정의에서 레이아웃을 불러올 수도 있어요.
네, Registered 에디션에서 가능해요. TsgcWinFormsReportDesigner, TsgcWpfReportDesigner, TsgcAvaloniaReportDesigner는 자신의 창에 배치하는 디자이너이고, sgcShowReportDesigner는 모달 창으로 하나를 열어요. 사용자는 항목과 필드를 밴드로 끌어다 놓고, 속성, 표, 스크립트를 편집하고, 결과를 미리 본 다음 서버가 헤드리스로 실행할 수 있는 JSON 정의로 레이아웃을 저장해요.
네. SaveToPDF는 기본적으로 태그된 PDF/UA를 작성하고, PDFExport.PDFA로 PDF/A-3으로 전환하며, SaveToXLSX는 같은 준비된 페이지로 Excel 통합 문서를 작성해요. CSV, PNG, SVG, ODS, HTML, 일반 텍스트는 모든 에디션에서, DOCX, ODT, RTF는 Registered 에디션에서 쓸 수 있어요.
네. 헤드리스 엔진과 내보내기는 Windows와 Linux의 서비스와 데몬에서 실행되고, .NET 데모에는 LinuxDaemon 프로젝트가 들어 있어요. 웹에서는 esegece.sgcReports.AspNetCore 패키지가 보고서 엔드포인트를 ASP.NET Core와 통합하며, 보고서를 PDF, XLSX, CSV, HTML 등의 파일로 제공해요.
네. 모든 sgcReports NuGet 패키지는 엔진, 내보내기, 미리 보기가 들어 있는 .Community 접미사의 무료 Community 에디션으로도 제공돼요. 연간 총매출이 EUR 1M 미만이고 개발자가 5명 이하인 개인과 조직에 무료예요. 최종 사용자 디자이너와 DOCX, ODT, RTF 내보내기에는 Registered 라이선스가 필요해요. sgcReports 가격을 참고하세요.