데이터로 만드는 송장, 편지, 계약서
업무용 애플리케이션이 Word에서 만든 DOCX 템플릿을 데이터베이스의 레코드나 JSON 문서로 채우고 고객마다 PDF 하나를 작성해요. 사용자는 계속 Word에서 템플릿을 편집하고, 애플리케이션은 해당 컴퓨터에 Office가 필요하지 않아요.
- 편지 병합
- 레코드당 파일 하나
- PDF 출력
데스크톱 애플리케이션, Windows 서비스, Linux 서버에서 Word 문서와 스프레드시트를 만들고 읽고 변환해 보세요. sgcDocs는 편지 병합을 실행하고, 통합 문서를 PDF로 인쇄하고, PDF 파일을 병합, 분할, 채우기, 암호화, 서명하고, 바코드를 렌더링하고, ZIP64 아카이브를 만들어 줘요. 모든 리더, 라이터, 렌더러가 Pascal 또는 C# 코드이기 때문에 Office 설치도 UI 프레임워크도 필요하지 않아요.
sgcDocs 팔레트 페이지에 있는 일곱 개의 비시각 컴포넌트입니다. 아래에 주요 기능을 소개하고, 모든 기능은 기능 매트릭스에서 확인할 수 있어요.
문서를 읽고, 편집하고, 저장한 다음 여러분의 데이터와 병합해 보세요.
Word 문서
계약서, 보고서, 편지는 Word에서 만든 DOCX로 시작하는 경우가 많아요. TsgcDocsWordProcessor는 DOCX, RTF, HTML, Markdown, 텍스트를 불러오고, 섹션, 머리글, 바닥글, 필드, 각주, 책갈피를 유지하며, 문서를 이 형식 중 어느 것으로든 저장해요. 본문, 표, 머리글, 바닥글의 텍스트를 찾아 바꾸고, 레이아웃이 적용된 페이지를 PDF, PNG, SVG로 내보내요.
SearchText와 ReplaceAll 지원Word 문서
송장, 편지, 증명서는 템플릿과 레코드 목록에서 만들어져요. MailMerge는 모든 레코드를 하나의 문서에 쓰고, MailMergeEach는 레코드마다 PDF를 포함한 파일을 하나씩 쓰며, 파일 이름에 레코드 번호와 원하는 필드 값을 넣을 수 있어요. 템플릿은 Word에서 MERGEFIELD와 IF 필드로 만든 평범한 DOCX예요.
\# ,0.00, \@ "MMMM d, yyyy" 같은 숫자, 날짜, 대소문자 스위치TsgcDocsMergeJSON, TsgcDocsMergeCSV, TsgcDocsMergeDataSet and TsgcDocsMergeEvents수식, 서식, 차트가 있는 통합 문서를 서버에서 계산하고 인쇄해 보세요.
스프레드시트
TsgcDocsSpreadsheet는 사용자 인터페이스 없이 통합 문서를 불러오고, 만들고, 계산하고, 저장해요. 셀은 Excel과 같은 방식으로 지정하고, =로 시작하는 텍스트는 수식이며, 수식 엔진은 LET, LAMBDA, 명명된 LAMBDA 함수를 포함해 Excel 함수 320개를 계산해요. XLSX 파일을 불러와 다시 저장해도 서식, 병합된 셀, 차트, 조건부 서식이 유지돼요.
Values, Formulas, Text, 임의의 수식을 계산하는 EvaluateImportDataSet은 데이터셋의 행을 시트로 복사스프레드시트
시트는 Excel이 인쇄하는 방식 그대로 페이지로 나뉘며, 통합 문서에 저장된 페이지 설정(용지 방향, 용지 크기, 배율 또는 페이지 맞춤, 여백, 인쇄 영역, 인쇄 제목, 눈금선, 머리글과 바닥글 코드)을 따라요. 시트의 차트도 함께 인쇄되고, ExportToHTML은 시트마다 HTML 표를 쓰면서 차트를 인라인 SVG로 넣어요.
ExportToPDFFileExportSheetPageToPNG문서 주변의 파일 작업을 같은 패키지에서 처리해요.
PDF 처리
TsgcDocsPDFProcessor는 암호화된 PDF를 포함해 PDF를 열고 수정해요. 파일을 병합하고, 페이지 범위로 분할하고, 페이지를 추출, 삭제, 이동, 회전하고, 텍스트를 읽고 검색하며, 페이지를 PNG로 렌더링해요. AcroForm 필드를 채우고 평면화하고, AES-256으로 암호화하고, PDF/A로 변환한 뒤 결과를 검증하며, CSS나 이미지가 있는 HTML을 PDF로 바꿔요.
OnExternalSign을 통한 전자 서명, Windows에서는 PFX 파일 또는 인증서 저장소의 인증서로도 서명바코드 및 ZIP
TsgcDocsBarcode는 Code 128, EAN-13, QR Code, Data Matrix, PDF417 등 11가지 1D 및 2D 심볼을 인코딩하고, 데이터를 검증한 뒤 PNG, SVG, PDF로 쓰거나 PDF 페이지에 심볼을 벡터로 그려요. TsgcDocsZipArchive는 ZIP64, UTF-8 이름, 항목 시간을 지원하는 ZIP 아카이브를 만들고 읽으며, 경로 순회 이름이 있는 아카이브는 아무것도 쓰기 전에 거부해요.
한 번의 호출로 변환하고, 같은 코드를 데스크톱과 서버에서 사용해요.
변환
TsgcDocsConverter는 문서, 스프레드시트, PDF 파일, 이미지 사이에서 파일과 스트림을 변환해요. 형식은 파일 확장자에서 가져오거나 스트림의 내용으로 감지하며, CanConvert로 해당 쌍이 지원되는지 미리 알 수 있어요. ConvertToImages는 페이지마다 PNG 또는 SVG 하나를 쓰고, ConvertImagesToPDF는 이미지마다 PDF 페이지 하나를 만들어요.
배포
sgcDocs 유닛은 VCL, FireMonkey, GDI 코드를 사용하지 않고 Office도 필요하지 않기 때문에, 같은 코드가 콘솔 프로그램, Windows 서비스, Linux64 데몬, 웹 서버에서 실행돼요. 컴포넌트는 스레드에 안전하지 않으므로, 요청에 필요한 컴포넌트는 그 요청을 처리하는 스레드에서 만들어 사용하세요. 별도의 인스턴스는 병렬로 실행돼요. Linux에서는 문서에서 사용하는 TrueType 글꼴을 AddFontFolder 또는 변환기의 Fonts 목록으로 추가하세요.
esegece.sgcDocs업무용 애플리케이션이 Word에서 만든 DOCX 템플릿을 데이터베이스의 레코드나 JSON 문서로 채우고 고객마다 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는 페이지 이미지로 변환해요.
POST /convert, POST /merge, GET /formats, GET /health를 갖춘 REST 변환 서비스로, 요청마다 변환기 하나를 사용하고 최대 업로드 크기를 제한해요.
C++ Builder 13용 DocumentConverter, MailMerge, PDFTools, WordCreate. .NET 8용 C# 프로젝트 11개는 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 코드가 없는 동일한 유닛 | 콘솔 프로그램, 데몬, 웹 서버. 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 가격 페이지를 참고하세요.
Delphi, C++ Builder, .NET용 sgcUI 도움말로, 설치, 지원 형식, 시작하기, 편지 병합, 문서 변환, Linux의 글꼴, 서버 배포를 다뤄요.
Delphi, C++ Builder, .NET용으로, 모든 sgcUI 제품을 다뤄요.