Delphi용 보고서 빌더: 시각적으로 또는 코드로 보고서 설계

sgcReports는 Delphi와 C++ Builder용 보고서 빌더예요. 사용자는 보고서를 시각적으로 설계하고, 코드는 플루언트 TsgcReportBuilder 클래스로 보고서를 만들어요.

VCL, FireMonkey, 웹 디자이너
코드로 만드는 보고서
밴드, 그룹, 마스터 디테일
PDF, Excel, CSV로 내보내기

가격 보기 →

지역별, 월별 매출 보고서가 완성된 Delphi 보고서 미리 보기. KPI 상자와 누적 매출 차트, PDF 내보내기와 XLSX 내보내기 버튼이 있어요. Altamira ERP 데모에서 sgcReports로 만들었어요

Delphi에서 보고서를 만드는 두 가지 방법

보고서는 페이지, 밴드, 항목, 스타일, 데이터 소스로 이루어진 모델이에요. 디자이너와 코드가 모두 그 모델을 편집하고, JSON 정의로 저장해요.

사용자는 VCL, FireMonkey, 웹 보고서 디자이너에서 보고서를 시각적으로 설계하고, 코드는 플루언트 TsgcReportBuilder 클래스로 보고서를 만들어요. 두 방식 모두 밴드, 그룹, 마스터 디테일, 식이 있는 같은 보고서 모델을 만들어요. 이 보고서는 데스크톱이나 창 없는 서비스에서 미리 보기, 인쇄하거나 PDF, Excel, CSV 등으로 내보낼 수 있어요.

비주얼 보고서 디자이너

폼에 TsgcVCLReportDesigner나 TsgcFMXReportDesigner를 놓거나, 브라우저에서 TsgcReportHTMLDesigner를 제공하세요. 사용자는 필드를 밴드로 끌어다 놓고, 인스펙터에서 속성을 설정하고, 실시간 미리 보기로 전환해요. Registered

보고서를 시각적으로 설계하기 →

코드로 만드는 보고서

TsgcReportBuilder는 스타일, 페이지, 밴드, 항목을 하나의 플루언트 체인으로 기술해요. 보고서는 프로젝트의 나머지 코드와 함께 컴파일, 비교(diff), 리팩터링되고, 익명 메서드 없이 Delphi 7부터 동작해요.

코드로 보고서 만들기 →

JSON 정의

sgcReportSaveToJSONFile로 보고서를 저장하고 실행 시점에 불러오면, 레이아웃을 데이터베이스나 고객 폴더에 두고 새로 빌드하지 않고도 바꿀 수 있어요. 디자이너도 같은 파일을 열고 저장해요.

JSON 정의 알아보기 →

VCL, FireMonkey, 브라우저에서 보고서를 시각적으로 설계하세요

사용자가 애플리케이션 안에서 실행하는 최종 사용자용 보고서 디자이너이며, IDE의 디자인 타임에서도 같은 디자이너를 쓸 수 있어요.

납품서가 열려 있는 sgcReports의 VCL 보고서 디자이너. 밴드 개요, 디자인 화면, 속성 인스펙터가 보여요

보고서 디자이너 Registered 전용

사용자가 직접 실행하는 보고서 디자이너

TsgcVCLReportDesigner는 도구 모음, Toolbox, Outline, Data 탭, 눈금자가 있는 디자인 화면, 속성 인스펙터, Design과 Preview 탭을 갖춘 패널이에요. 폼에 놓고 Engine을 지정한 다음 데이터 소스를 추가하면, 사용자가 보고서를 편집하고 JSON 정의로 저장하고 실제 데이터로 미리 볼 수 있어요. TsgcFMXReportDesigner는 같은 디자이너 유닛 위에 만든 FireMonkey 짝이에요.

  • New, Open, Import, Save, Undo, Redo, 정렬, 간격 분배, 확대 축소가 있는 도구 모음
  • Toolbox의 항목이나 Data 트리의 필드를 밴드로 끌어다 놓아요. 텍스트, 서식 있는 텍스트, 이미지, 선, 도형, 바코드, 하위 보고서, 페이지 나누기, 교차 표, 표를 쓸 수 있어요
  • 보고서 매개변수, 표, 보고서 스크립트용 편집기
  • Preview 탭은 엔진의 데이터로 보고서를 준비해요
  • 디자인 타임에 IDE에서 TsgcReportEngine을 마우스 오른쪽 버튼으로 클릭하고 Design report…를 선택하면 같은 디자이너로 보고서를 편집할 수 있어요
도움말 주제 읽기

폼을 만들 때 디자이너를 엔진과 데이터 소스에 연결하고, 마지막으로 저장한 레이아웃을 불러오세요.

procedure TfrmMain.FormCreate(Sender: TObject);
begin
  sgcDesigner.Engine := sgcEngine;
  sgcDesigner.AddDataSource(sgcOrders);
  if FileExists('orders.json') then
    sgcDesigner.LoadFromFile('orders.json')
  else
    sgcDesigner.NewReport;
end;

procedure TfrmMain.FormCloseQuery(Sender: TObject; var CanClose: Boolean);
begin
  if sgcDesigner.Modified then
    sgcDesigner.SaveToFile('orders.json');
end;

전용 폼 없이 메뉴에서 보고서를 편집하려면, sgcShowReportDesigner(VCL) 또는 sgcShowReportDesignerFMX(FireMonkey, Windows와 macOS)가 확인과 취소 버튼이 있는 모달 디자이너를 표시하고, 사용자가 취소하면 보고서를 복원해요.

procedure TfrmMain.mnuEditReportClick(Sender: TObject);
begin
  if sgcShowReportDesigner(sgcEngine) then
    sgcReportSaveToJSONFile(sgcEngine.Report, 'orders.json');
end;

FireMonkey 디자이너

TsgcFMXReportDesigner(Delphi XE6 이상)는 같은 도구 모음, 트리, 화면, 인스펙터, 미리 보기 탭을 갖추고 TsgcReportPreviewFMX를 호스팅해요. ToolbarButtonSize로 터치 화면에서 버튼을 쉽게 누를 수 있어요. 모달 폼과 파일 대화 상자는 Windows와 macOS에서 쓸 수 있어요.

웹 보고서 디자이너

TsgcReportHTMLDesigner는 밴드 캔버스, 속성 인스펙터, 실시간 미리 보기로 브라우저에서 JSON 정의를 편집해요. 완성된 보고서와 같은 HTTP 엔드포인트가 제공해요. sgcWebSockets Professional 이상과 sgcHTML이 필요해요. 운영 엔드포인트에서는 DesignerEnabled를 꺼 두고, 자체 인증 뒤에 두세요.

웹 디자이너 알아보기 →

.NET 디자이너

.NET용 sgcReports에는 WinForms, WPF, Avalonia용 최종 사용자 디자이너가 들어 있어요. TsgcVCLReportDesigner의 짝으로, 같은 도구 모음, 트리, 인스펙터, 미리 보기를 갖추었고 JSON 정의도 불러오고 저장해요.

TsgcReportBuilder로 코드에서 보고서 만들기

모든 TDataSet을 대상으로 한 그룹별 매출 보고서입니다. 지역별 머리글, 판매당 한 줄, 지역별 소계, 페이지 바닥글이 있고 PDF와 Excel로 저장해요.

uses
  Classes, SysUtils, DB,
  sgcReports_Types, sgcReports_Model, sgcReports_Data, sgcReports_Fluent;

const
  CS_TOTAL = '[FormatFloat(''#,0.00'', Sum(Sales.Amount))]';

procedure ExportSalesReport(aSales: TDataSet; const aFolder: string);
var
  oSales: TsgcReportDataSetSource;
  oBuilder: TsgcReportBuilder;
begin
  oSales := TsgcReportDataSetSource.Create(nil);
  oBuilder := TsgcReportBuilder.Create;
  try
    // any TDataSet: FireDAC, TClientDataSet, dbExpress...
    oSales.SourceName := 'Sales';
    oSales.DataSet := aSales;
    oBuilder.Title('Sales by region').Units(ruMillimeters)
      .Style('Base').Font('Arial', 10).EndStyle
      .Style('Group').Font('Arial', 11).Bold.BackColor($EEEEEE).EndStyle
      .Page.Paper(rpsA4).Margins(15)
      .GroupHeader('Sales.Region', 9).Style('Group')
      .Text('Region: [Sales.Region]', 0, 1, 180, 7).TagRole(rtrHeading2).EndBand
      .MasterData('Sales', 6).Style('Base')
      .Text('[Sales.Customer]', 2, 0, 120, 6)
      .Text('[Sales.Amount]', 130, 0, 50, 6).AlignRight.Format('#,0.00').EndBand
      .GroupFooter(9).Style('Base')
      .Text('Region total ' + CS_TOTAL, 80, 1, 100, 6).AlignRight.Bold.EndBand
      .PageFooter(8).Style('Base')
      .Text('Page [Page] of [TotalPages]', 0, 1, 180, 6).AlignCenter.EndBand
      .EndPage.Data(oSales);
    oBuilder.SaveToPDF(IncludeTrailingPathDelimiter(aFolder) + 'sales.pdf');
    oBuilder.SaveToXLSX(IncludeTrailingPathDelimiter(aFolder) + 'sales.xlsx');
  finally
    oBuilder.Free;
    oSales.Free;
  end;
end;

TsgcReportBuilder 도움말 주제 읽기

밴드, 그룹, 식

진짜 밴드형 레이아웃이라서 지역별 매출이나 고객별 청구서 같은 업무 보고서도 편법 없이 만들 수 있어요.

그룹마다 머리글, 소계, 페이지 번호가 있는 그룹형 Delphi 보고서

밴드와 그룹

보고서 제목, 머리글, 데이터, 바닥글, 요약

보고서에는 보고서 제목, 페이지 머리글, 그룹 머리글, 데이터, 그룹 바닥글, 페이지 바닥글, 요약 밴드와 열 머리글, 열 바닥글이 있어요. 그룹은 식이 바뀔 때 나뉘고, 자체 합계를 인쇄하며, 새 페이지에서 시작하거나 모든 페이지에 머리글을 반복할 수 있어요. 하위 보고서를 쓰면 한 페이지에 다른 페이지의 레이아웃을 포함할 수 있어요.

  • 그룹 머리글 밴드의 GroupExpression, 그리고 둘 이상의 수준을 위한 중첩 그룹
  • StartNewPage, RepeatOnEveryPage, KeepTogether로 페이지 흐름을 제어해요
  • PrintOnFirstPage와 PrintOnLastPage로 페이지 밴드가 나타날 위치를 정해요
  • 표, 교차 표, 서식 있는 텍스트, 바코드, 체크 박스, SVG 그림을 보고서 항목으로 사용
도움말 주제 읽기

식

대괄호 안의 합계, 서식, 조건

모든 텍스트 항목은 대괄호 안에 식을 담을 수 있고, 엔진이 행마다 평가해서 바닥글 합계가 위에 인쇄된 줄과 항상 일치해요. 날짜 계산, 채우기와 서식, 12개 언어의 ToWords, 조건부 집계, 그룹마다 다시 시작하는 누적 값을 포함해 함수 68개와 집계 10개가 있어요.

'[Sum(Lines.Qty * Lines.Price)]'
'[FormatDateTime(''dd/mm/yyyy'', Invoices.Date)]'
'Page [Page] of [TotalPages]'
  • Sum, FormatFloat, FormatDateTime, Upper, Round, IsNull, SumIf, CountIf, RunningSum, Previous
  • OnGetVariable이 실행 시점에 자체 변수를 제공해요
  • Highlights는 조건이 참일 때 스타일을 적용해요. 예를 들어 음수 금액을 빨간색으로 표시할 수 있고 스크립트가 필요 없어요
도움말 주제 읽기

TDataSet의 데이터, 마스터 디테일 포함

보고서는 데이터가 이미 있는 곳에서 읽어요. 쿼리, JSON 문서, 직접 만든 객체 모두 가능해요.

마스터와 디테일 데이터셋으로 만든 청구서 보고서. 항목 줄, 합계, QR 코드가 있어요

마스터 디테일

두 데이터셋에서 가져온 청구서와 그 항목

TsgcReportDataSetSource는 TClientDataSet, FireDAC, dbExpress 같은 모든 TDataSet을 읽어요. 디테일 소스는 키 필드로 마스터에 연결되어 청구서마다 자신의 항목이 인쇄되고, 그룹 바닥글이 항목을 합산해요. 열려 있지 않은 데이터셋은 실행 전후로 열고 닫으며, 이미 열려 있다면 실행이 끝난 뒤 상태와 위치를 복원해요.

  • MasterSource, MasterFields, DetailFields가 소스를 연결해요
  • TsgcReportJSONSource는 JSON 문자열이나 파일을 읽고, RecordsPath로 배열을 선택해요
  • TsgcReportEventSource는 OnFirst, OnNext, OnGetValue를 통해 코드에서 행을 가져와요
  • 보고서 매개변수는 실행 전에 같은 이름의 쿼리 매개변수로 전달돼요
도움말 주제 읽기
srcInvoices.SourceName := 'Invoices';
srcInvoices.DataSet := cdsInvoices;
srcLines.SourceName := 'Lines';
srcLines.DataSet := cdsLines;
srcLines.MasterSource := srcInvoices;
srcLines.MasterFields := 'Number';
srcLines.DetailFields := 'Invoice';
sgcEngine.AddDataSource(srcInvoices);
sgcEngine.AddDataSource(srcLines);

Delphi 보고서를 PDF, Excel, CSV 등으로 내보내기

엔진은 페이지를 한 번만 준비하고, 모든 내보내기가 같은 준비 결과로 동작해서 모든 파일의 숫자가 똑같아요.

PDF, Excel 통합 문서, CSV 파일로 내보낸 같은 보고서

출력 형식

준비된 보고서 하나, 모든 형식

PDF 내보내기는 기본적으로 태그된 PDF/UA-1을 쓰고, 장기 보관용으로는 PDF/A-3을 써요. XLSX 출력은 숫자를 숫자로 유지해서 스프레드시트가 정리 작업 없이 바로 합산해요. 모든 내보내기는 파일이나 스트림으로 쓸 수 있어요.

  • 모든 에디션: PDF, PDF/A, PDF/UA, XLSX, CSV, PNG, HTML, ODS, SVG, 일반 텍스트
  • Registered 에디션: DOCX, ODT, RTF
  • sgcPDF Delphi PDF 라이브러리를 통한 PDF 출력. 글꼴 포함과 벡터 바코드를 지원해요
도움말 주제 읽기
FPages := sgcEngine.Prepare;
try
  pdfExport.SaveToFile(FPages, OutputFolder + 'orders.pdf');
  xlsxExport.SaveToFile(FPages, OutputFolder + 'orders.xlsx');
  csvExport.SaveToFile(FPages, OutputFolder + 'orders.csv');
  imageExport.SaveToFiles(FPages, OutputFolder + 'orders_%d.png');
finally
  FPages.Free;
end;

VCL과 FireMonkey에서 보고서 미리 보기와 인쇄

사용자는 인쇄하거나 저장하기 전에 보고서를 넘겨 보고, PDF와 같은 렌더링을 확인해요.

청구서 페이지와 QR 코드가 보이는 Delphi 애플리케이션의 sgcReports 미리 보기 창

미리 보기와 인쇄

인쇄와 내보내기가 있는 미리 보기 컨트롤

TsgcReportPreviewVCL은 준비된 페이지를 탐색, 확대 축소, 맞춤 모드와 함께 보여 주고, 인쇄하고, PDF로 저장해요. 미리 보기는 일치 항목을 강조하며 텍스트를 찾고, 페이지 축소판을 보여 주며, Export 메뉴에서 PDF, Excel, CSV, PNG, HTML, Word, ODT, ODS, RTF, SVG, 일반 텍스트로 내보내요. TsgcReportPreviewFMX는 Windows, macOS, iOS, Android의 FireMonkey 미리 보기예요.

  • FirstPage, NextPage, PriorPage, LastPage, ZoomIn, ZoomOut, FitWidth, FitPage
  • 보고서를 준비하기 전에 입력을 받는 형식 있는 보고서 매개변수
  • 긴 보고서를 준비하는 동안 페이지와 레코드 수를 보여 주며 취소 버튼 제공
도움말 주제 읽기
procedure TfrmMain.btnPreviewClick(Sender: TObject);
begin
  sgcPreview.Engine := sgcEngine;
  sgcPreview.Prepare;
end;

procedure TfrmMain.btnPrintClick(Sender: TObject);
begin
  sgcPreview.Print('Sales by region');
end;

서비스와 데몬에서 헤드리스로 보고서 생성하기

야간 명세서, 결제 후 청구서, API 뒤의 내보내기를 창 없는 서버에서 실행해요.

VCL도, DLL도, 프린터 드라이버도 필요 없어요

sgcReports 코어는 VCL이나 FireMonkey에 의존하지 않고 외부 DLL이나 프린터 드라이버도 필요 없어요. TsgcReportEngine은 Windows 서비스나 Linux64 데몬에서 창 없이 보고서를 준비해요.

스레드당 엔진 하나

각 작업자는 자신의 보고서, 엔진, 데이터 소스, 내보내기를 만들고, 읽기 전용 TsgcReportFontManager가 모든 스레드에 제공돼요. sgcReportsConfigureForServer는 Windows에서 많은 스레드를 위해 메모리 관리자를 조정해요.

디자이너에서 만든 레이아웃

디자이너가 저장한 정의는 일반 JSON 파일이라서 서버가 sgcReportLoadFromJSONFile로 불러와 헤드리스로 실행해요. ReportLinuxDaemon 데모는 작업 폴더를 감시하고 작업자 스레드 4개로 PDF, XLSX, CSV, PNG를 렌더링해요.

Linux 데몬 도움말 주제 →

기존 보고서 템플릿 가져오기

sgcReports로 옮기는 애플리케이션에는 보통 이미 많은 보고서가 있어요. 다시 그리지 말고 변환하세요.

보고서 가져오기 Registered 전용

ReportBuilder .rtm 템플릿과 QuickReport 폼 가져오기

TsgcReportImporter는 QuickReport 폼(TQuickRep이 있는 .dfm)과 ReportBuilder 템플릿(.rtm)을 텍스트든 바이너리든 보고서 정의로 변환하고, 매핑하지 못한 모든 객체, 속성, 식, 스크립트를 목록으로 보여 줘요. VCL, FireMonkey, WinForms, WPF, Avalonia 디자이너에는 가져오기 명령이 있어요. 목록을 검토하고, 데이터 소스를 추가하고, 나머지를 디자이너에서 고친 다음 결과를 JSON 정의로 저장하세요.

  • 형식은 자동으로 감지되므로 호출 한 번으로 두 종류의 파일을 모두 처리해요
  • ReportBuilder 파이프라인이나 QuickReport 데이터셋은 데이터 소스 이름이 되고, DataSourceMap이 그 이름을 직접 만든 소스로 바꿔요
  • ImportResult가 마지막 가져오기 결과를 담고, 디자이너는 문제를 창에 표시해요
도움말 주제 읽기
oReport := TsgcReport.Create(nil);
oImporter := TsgcReportImporter.Create;
try
  // the old pipeline Orders is the data source Sales here
  oImporter.DataSourceMap.Values['Orders'] := 'Sales';
  try
    oImporter.ImportFromFile(oReport, 'orders.rtm');
    sgcReportSaveToJSONFile(oReport, 'orders.json');
  except
    on E: ESgcReportImportError do
      WriteLn('Not imported: ', E.Message);
  end;
finally
  oImporter.Free;
  oReport.Free;
end;

애플리케이션 전체를 옮기나요? QuickReport 마이그레이션 키트가 번호가 붙은 단계로 밴드와 컨트롤을 sgcReports의 짝에 매핑해 줘요.

Delphi 버전, 플랫폼, 에디션

대상실행되는 것플랫폼
Delphi 7~13보고서 모델, 식, 데이터, 레이아웃, 엔진, 플루언트 빌더, 내보내기Windows, Linux64, macOS, iOS, Android
C++ Builder 2007부터 13까지같은 클래스생성된 .hpp 헤더와 정적 라이브러리
VCL 디자이너와 미리 보기TsgcVCLReportDesigner, TsgcReportPreviewVCLWindows
FireMonkey 디자이너와 미리 보기TsgcFMXReportDesigner(Delphi XE6 이상), TsgcReportPreviewFMXWindows, macOS, iOS, Android에서 미리 보기

sgcReports는 개발자당 €199부터 단독 판매되며 전체 소스 코드와 1년 업데이트가 포함돼요. sgcUI Enterprise와 All-Access 번들에도 포함돼요. PDF는 sgcPDF로 작성하며, 모든 구성에서 sgcPDF가 필요해요. 최종 사용자 디자이너, 보고서 가져오기, DOCX, ODT, RTF 내보내기, 웹 디자이너는 Registered 에디션에 들어 있고, 체험판에는 모든 기능이 잠금 해제되어 있어요.

가격 보기 기능 매트릭스

보고서 빌더 자주 묻는 질문

TDataSet에 TsgcReportDataSetSource로 데이터를 바인딩하고, TsgcReportBuilder로 밴드를 기술한 다음 SaveToPDF를 호출하세요. 위의 코드 샘플과 같아요. 레이아웃을 직접 그리고 싶다면 폼에 TsgcReport, TsgcReportEngine, TsgcVCLReportDesigner를 놓고 보고서를 설계한 다음 JSON 정의로 저장하세요. 두 방식 모두 같은 보고서 모델을 만들어요.

네, Registered 에디션에서 가능해요. TsgcVCLReportDesigner와 TsgcFMXReportDesigner는 폼에 포함하는 최종 사용자 디자이너이고, sgcShowReportDesigner는 메뉴에서 모달로 하나를 열어요. 웹 애플리케이션에서는 TsgcReportHTMLDesigner가 브라우저에서 실행돼요. 모든 디자이너는 sgcReports 어디서든 불러올 수 있는 JSON 정의를 저장해요.

네, Registered 에디션에서 가능해요. TsgcReportImporter는 ReportBuilder 템플릿(.rtm)을 텍스트든 바이너리든, 그리고 QuickReport 폼(TQuickRep이 있는 .dfm)을 보고서 정의로 변환하고, 매핑하지 못한 모든 객체, 속성, 식, 스크립트를 목록으로 보여 줘요. 디자이너에도 같은 일을 하는 가져오기 명령이 있어요. 기존 보고서 템플릿 가져오기를 참고하세요.

네. 빌더의 SaveToPDF와 SaveToXLSX, 또는 준비된 페이지의 TsgcReportPDFExport와 TsgcReportXLSXExport가 태그된 PDF/UA-1(요청 시 PDF/A-3)과 숫자를 숫자로 유지하는 Excel 통합 문서를 작성해요. CSV, PNG, HTML, ODS, SVG, 일반 텍스트는 모든 에디션에서, DOCX, ODT, RTF는 Registered 에디션에서 쓸 수 있어요.

엔진을 TsgcReportPreviewVCL에 지정하고 Prepare를 호출하세요. 미리 보기가 페이지를 넘기고, 확대 축소하고, 텍스트를 찾고, 내보내며, Print는 표시된 문서를 인쇄해요. FireMonkey 애플리케이션은 Windows, macOS, iOS, Android에서 TsgcReportPreviewFMX를 써요.

네. 코어는 VCL이나 FireMonkey에 의존하지 않고 외부 DLL도 필요 없어서, TsgcReportEngine과 내보내기가 스레드당 엔진 하나로 Windows 서비스와 Linux64 데몬에서 실행돼요. ReportLinuxDaemon 데모는 작업자 스레드 4개로 폴더의 작업을 렌더링해요.

Delphi 7부터 13까지, C++ Builder 2007부터 13까지 지원해요. TsgcReportBuilder는 익명 메서드 없이 Delphi 7에서 동작하는 일반 클래스예요. FireMonkey 디자이너는 Delphi XE6 이상이 필요해요. 같은 클래스를 .NET에서도 쓸 수 있어요.

네, 항상 필요해요. sgcReports는 sgcPDF 엔진으로 PDF를 작성하고 바코드를 그리며, 미리 보기는 sgcPDF 뷰어 컨트롤을 통해 그려요. sgcUI Enterprise에는 둘 다 들어 있어요.

최고의 가성비: All-Access모든 eSeGeCe 제품과 프리미엄 지원이 포함되어 연 €1,059부터 이용할 수 있어요.
All-Access 가격 보기

보고서 빌더를 사용해 보세요

sgcUI 체험판에는 sgcReports, 디자이너, sgcPDF가 모든 기능이 잠금 해제된 상태로 들어 있어요.