データから作る請求書、手紙、契約書
業務アプリケーションは、Word で作った DOCX テンプレートにデータベースのレコードや JSON ドキュメントを差し込み、顧客ごとに 1 つの PDF を書き出します。ユーザーは引き続き Word でテンプレートを編集でき、アプリケーションを動かすマシンに Office は不要です。
- 差し込み印刷
- レコードごとに 1 ファイル
- PDF 出力
デスクトップアプリケーション、Windows サービス、Linux サーバーで、Word 文書とスプレッドシートを作成、読み込み、変換できます。sgcDocs は、差し込み印刷の実行、ブックの PDF 出力、PDF ファイルの結合、分割、入力、暗号化、署名、バーコードの描画、ZIP64 アーカイブの作成を行います。リーダー、ライター、レンダラーはすべて Pascal または C# のコードなので、Office のインストールも UI フレームワークも不要です。
sgcDocs パレットページには、画面を持たないコンポーネントが 7 つあります。以下は主な機能です。機能比較表では、すべての機能を一覧にしています。
文書を読み込み、編集し、書き出して、データと差し込みます。
Word 文書
契約書、報告書、手紙は、Word で作った DOCX から始まることがよくあります。TsgcDocsWordProcessor は DOCX、RTF、HTML、Markdown、テキストを読み込み、セクション、ヘッダー、フッター、フィールド、脚注、しおりを保持したまま、これらのどの形式でも保存できます。本文、表、ヘッダー、フッターのテキストを検索して置換し、レイアウトしたページを PDF、PNG、SVG に出力します。
SearchText と ReplaceAllWord 文書
請求書、手紙、証明書は、テンプレートとレコードの一覧から作成します。MailMerge はすべてのレコードを 1 つの文書に書き出し、MailMergeEach はレコードごとに 1 つのファイルを書き出します。PDF にも対応し、ファイル名にはレコード番号や任意のフィールド値を使えます。テンプレートは、Word で作った MERGEFIELD と IF フィールドを含む通常の DOCX です。
\# ,0.00 や \@ "MMMM d, yyyy"TsgcDocsMergeJSON、TsgcDocsMergeCSV、TsgcDocsMergeDataSet、TsgcDocsMergeEvents数式、書式、グラフを持つブックを、サーバー上で計算して印刷します。
スプレッドシート
TsgcDocsSpreadsheet は、ユーザーインターフェイスなしでブックを読み込み、作成、計算、保存します。セルは Excel と同じように指定し、= で始まるテキストは数式になります。数式エンジンは、LET、LAMBDA、名前付き LAMBDA 関数を含む 320 個の Excel 関数を計算します。XLSX ファイルを読み込んで再び保存しても、書式、セルの結合、グラフ、条件付き書式は保持されます。
Values、Formulas、Text、任意の数式を評価する EvaluateImportDataSet はデータセットの行をシートにコピースプレッドシート
シートは Excel が印刷するときと同じ方法でページ分割され、ブックに保存されたページ設定が使われます。用紙の向き、用紙サイズ、拡大縮小またはページに合わせる設定、余白、印刷範囲、印刷タイトル、枠線、ヘッダーとフッターのコードに対応します。シートのグラフも一緒に印刷され、ExportToHTML はシートごとに HTML の表を書き出し、グラフはインライン SVG になります。
ExportToPDFFileExportSheetPageToPNG文書まわりのファイル処理も、同じパッケージで行えます。
PDF 処理
TsgcDocsPDFProcessor は、暗号化されたものを含む 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 種類の 1 次元と 2 次元シンボルをエンコードし、データを検証して、PNG、SVG、PDF に書き出すか、PDF ページにシンボルをベクターで描画します。TsgcDocsZipArchive は、ZIP64、UTF-8 のファイル名、エントリの日時に対応した ZIP アーカイブを作成、読み込みし、パストラバーサルの名前を含むアーカイブは、何かを書き出す前に拒否します。
1 回の呼び出しで変換でき、デスクトップでもサーバーでも同じコードが動きます。
変換
TsgcDocsConverter は、文書、スプレッドシート、PDF ファイル、画像の間で、ファイルとストリームを変換します。形式はファイル拡張子から決まり、ストリームの場合は内容から検出されます。CanConvert を使うと、その組み合わせに対応しているかどうかを事前に確認できます。ConvertToImages はページごとに 1 つの PNG または SVG を書き出し、ConvertImagesToPDF は画像ごとに 1 つの PDF ページを作成します。
展開
sgcDocs のユニットは VCL、FireMonkey、GDI のコードを使わず、Office も不要なので、同じコードがコンソールプログラム、Windows サービス、Linux64 のデーモン、Web サーバーで動作します。コンポーネントはスレッドセーフではありません。リクエストに必要なコンポーネントは、そのリクエストを処理するスレッドで作成してください。別々のインスタンスは並列に動作します。Linux では、文書で使う TrueType フォントを AddFontFolder またはコンバーターの Fonts リストで追加します。
esegece.sgcDocs業務アプリケーションは、Word で作った DOCX テンプレートにデータベースのレコードや JSON ドキュメントを差し込み、顧客ごとに 1 つの PDF を書き出します。ユーザーは引き続き Word でテンプレートを編集でき、アプリケーションを動かすマシンに Office は不要です。
ポータルやバックオフィスでは、アップロードされた文書を、第三者のサービスに送ることなく、Linux または Windows のサーバー上で PDF、テキスト、ページ画像に変換します。リクエストごとに専用のコンバーターを使い、リクエストは並列に処理されます。
レポートや会計のアプリケーションは、数式、書式、グラフを持つブックを作成して計算し、ユーザーセッションのないサービスの中で、ブックのページ設定のまま PDF に出力します。
コンポーネントにフォームも親も不要です。所有者に nil を指定して作成し、メソッドを呼び出して、解放します。
TsgcDocsWordProcessor は DOCX テンプレートに入力して PDF に出力します。TsgcDocsConverter は、対応している任意の組み合わせを 1 回の呼び出しで変換し、ページごとに 1 つの 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 配列の注文ごとに 1 つの 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 と同じクラス名を使います。テンプレートに入力し、ブックを作成し、2 つの 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 から注文書を、1 つの文書にまとめる方法と、レコードごとに 1 ファイルを作る方法で生成します。
本文、表、ヘッダー、フッターでの検索と置換を行い、続いてパスワード付きの読み取り専用保護を設定します。
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 変換サービス。リクエストごとに 1 つのコンバーターを使い、アップロードサイズの上限を設定します。
C++ Builder 13 向けの DocumentConverter、MailMerge、PDFTools、WordCreate。.NET 8 向けの 11 個の C# プロジェクトは Delphi デモの移植版で、ConversionServer は ASP.NET Core の minimal 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 | 7 つの 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 の価格ページをご覧ください。
Delphi、C++ Builder、.NET 向けの sgcUI ヘルプです。インストール、対応形式、はじめに、差し込み印刷、文書の変換、Linux でのフォント、サーバーへの展開を扱っています。
Delphi、C++ Builder、.NET。すべての sgcUI 製品を網羅しています。