Delphi, C++ Builder & .NET Parte do sgcUI

sgcDocs, uma API de arquivos Office sem interface para Delphi, C++ Builder & .NET

Crie, leia e converta documentos do Word e planilhas em um aplicativo desktop, em um serviço do Windows ou em um servidor Linux. O sgcDocs executa malas diretas, imprime pastas de trabalho em PDF, une, divide, preenche, criptografa e assina arquivos PDF, gera códigos de barras e cria arquivos ZIP64. Ele não precisa de instalação do Office nem de framework de interface, porque cada leitor, gravador e renderizador é código Pascal ou C#.

Sem instalação do OfficeSem framework de interfaceWindows e Linux64Incluído no sgcUI Enterprise
O código de mala direta do sgcDocs ao lado dos dois arquivos PDF de fatura que ele gravou, renderizados em PNG pelo sgcDocs

Arquivos Office sem o Office

Sete componentes não visuais na página de paleta sgcDocs. Os destaques estão abaixo, e a matriz de recursos lista todos os recursos.

Documentos do Word

Leia, edite e grave documentos e depois mescle-os com os seus dados.

Documentos do Word

Leia, edite e grave DOCX, RTF, HTML e Markdown

Contratos, relatórios e cartas muitas vezes começam como um DOCX feito no Word. O TsgcDocsWordProcessor carrega DOCX, RTF, HTML, Markdown e texto, mantém seções, cabeçalhos, rodapés, campos, notas de rodapé e indicadores, e grava o documento em qualquer um desses formatos. Ele procura e substitui texto no corpo, nas tabelas, nos cabeçalhos e nos rodapés, e exporta as páginas diagramadas para PDF, PNG ou SVG.

  • PDF com tags da estrutura de títulos, listas e tabelas, e PDF/A
  • Páginas PNG de 1 a 2400 dpi e páginas SVG
  • SearchText e ReplaceAll em todas as partes do documento
  • Proteção somente leitura, comentários, alterações controladas e formulários com um hash de senha com salt

Documentos do Word

Mala direta a partir de JSON, CSV, um dataset ou eventos

Faturas, cartas e certificados vêm de um modelo e de uma lista de registros. O MailMerge grava cada registro em um único documento, e o MailMergeEach grava um arquivo por registro, inclusive em PDF, com o número do registro e qualquer valor de campo no nome do arquivo. O modelo é um DOCX comum feito no Word com campos MERGEFIELD e IF.

  • Chaves de número, data e maiúsculas e minúsculas, como \# ,0.00 e \@ "MMMM d, yyyy"
  • Campos IF com campos aninhados, e regiões que repetem linhas de tabela por registro filho
  • TsgcDocsMergeJSON, TsgcDocsMergeCSV, TsgcDocsMergeDataSet e TsgcDocsMergeEvents

Planilhas

Pastas de trabalho com fórmulas, formatos e gráficos, calculadas e impressas no servidor.

Planilhas

XLSX, ODS e CSV com 320 funções do Excel

O TsgcDocsSpreadsheet carrega, cria, calcula e grava pastas de trabalho sem interface de usuário. As células são endereçadas como no Excel, um texto que começa com = é uma fórmula, e o motor de fórmulas calcula 320 funções do Excel, inclusive LET, LAMBDA e funções LAMBDA nomeadas. Formatos, células mescladas, gráficos e formatos condicionais são mantidos quando um arquivo XLSX é carregado e gravado novamente.

  • Values, Formulas e Text por endereço de célula, Evaluate para qualquer fórmula
  • Fontes, preenchimentos, alinhamento, formatos de número, larguras de coluna e alturas de linha
  • ImportDataSet copia as linhas de um dataset para uma planilha
  • Proteção de planilha e de pasta de trabalho

Planilhas

Pastas de trabalho impressas em PDF, HTML e PNG

Uma planilha é paginada como o Excel a imprime, com a configuração de página guardada na pasta de trabalho: orientação, tamanho do papel, escala ou ajuste ao número de páginas, margens, áreas de impressão, títulos de impressão, linhas de grade e códigos de cabeçalho e rodapé. Os gráficos da planilha são impressos com ela, e o ExportToHTML grava uma tabela HTML por planilha com os gráficos como SVG embutido.

  • ExportToPDFFile para uma planilha ou para todas as planilhas visíveis
  • ExportSheetPageToPNG para uma página impressa
  • Áreas de impressão, títulos de impressão e ajuste a uma página de largura

PDF, códigos de barras e ZIP

O trabalho com arquivos em torno dos documentos, no mesmo pacote.

Processamento de PDF

Una, divida, preencha, criptografe e assine arquivos PDF

O TsgcDocsPDFProcessor abre um PDF, inclusive os criptografados, e o altera: une arquivos, divide-os por intervalos de páginas, extrai, exclui, move e gira páginas, lê e procura o texto e renderiza páginas em PNG. Ele preenche e nivela campos AcroForm, criptografa com AES-256, converte para PDF/A e valida o resultado, e transforma HTML com CSS ou imagens em PDF.

  • Criptografia RC4 e AES com permissões de impressão, cópia e modificação
  • Conversão e validação para PDF/A-1, PDF/A-2, PDF/A-3 e PDF/A-4
  • Assinaturas digitais pelo OnExternalSign em todas as plataformas, e com um arquivo PFX ou um certificado do repositório no Windows

Códigos de barras e ZIP

Códigos de barras e arquivos ZIP64

O TsgcDocsBarcode codifica 11 símbolos lineares e 2D, como Code 128, EAN-13, QR Code, Data Matrix e PDF417, valida os dados e grava PNG, SVG ou PDF, ou desenha o símbolo como vetores em uma página PDF. O TsgcDocsZipArchive cria e lê arquivos ZIP com ZIP64, nomes UTF-8 e horários de entrada, e recusa um arquivo com um nome de path traversal antes que qualquer coisa seja gravada.

  • 11 tipos de código de barras com dígitos verificadores e validação GS1
  • ZIP64 para arquivos com mais de 4 GB ou com mais de 65.535 entradas
  • Tamanho, tamanho compactado, CRC32 e horário de cada entrada

Conversão e implantação

Conversões em uma só chamada, e o mesmo código em um desktop e em um servidor.

Conversão

63 pares de formatos em uma só chamada

O TsgcDocsConverter converte arquivos e streams entre documentos, planilhas, arquivos PDF e imagens. Os formatos vêm das extensões dos arquivos, ou são detectados a partir do conteúdo de um stream, e o CanConvert informa de antemão se um par é compatível. O ConvertToImages grava um PNG ou SVG por página, e o ConvertImagesToPDF cria uma página PDF por imagem.

  • DOCX, RTF, HTML, Markdown e texto entre si, e para PDF, PNG e SVG
  • XLSX, ODS e CSV entre si, e para HTML, PDF e PNG
  • PDF para texto e PNG, e toda saída PDF como PDF/A quando você pedir

Implantação

O mesmo código no Windows e no Linux64

As units do sgcDocs não usam código de VCL, FireMonkey nem GDI e não precisam do Office, de modo que o mesmo código roda em um programa de console, em um serviço do Windows, em um daemon Linux64 ou em um servidor web. Os componentes não são thread safe: crie os que uma requisição precisa na thread que a atende, e instâncias separadas rodam em paralelo. No Linux, adicione as fontes TrueType que os seus documentos usam com o AddFontFolder ou com a lista Fonts do conversor.

  • Delphi 7 a 13 e C++ Builder 2007 a 13
  • Win32, Win64 e Linux64
  • O pacote .NET esegece.sgcDocs para .NET Framework 4.7.2, .NET Standard 2.0 e .NET 6 a 10

Quem cria com o sgcDocs

Faturas, cartas e contratos a partir dos seus dados

Aplicativos corporativos preenchem modelos DOCX feitos no Word com os registros de um banco de dados ou de um documento JSON, e gravam um PDF por cliente. Os usuários continuam editando os modelos no Word, e o aplicativo nunca precisa do Office na máquina.

  • Mala direta
  • Um arquivo por registro
  • Saída em PDF
Execute o demo MailMerge

Um serviço de conversão no seu próprio servidor

Portais e sistemas de retaguarda convertem documentos enviados em PDF, texto ou imagens de página em um servidor Linux ou Windows, sem enviá-los a um serviço de terceiros. Cada requisição recebe o seu próprio conversor, e as requisições rodam em paralelo.

  • 63 pares de formatos
  • Linux64
  • Endpoints REST
Execute o demo ConversionServer

Relatórios e exportações sem o Excel

Aplicativos de relatórios e de contabilidade criam pastas de trabalho com fórmulas, formatos e gráficos, calculam-nas e imprimem-nas em PDF com a configuração de página da pasta de trabalho, em um serviço sem sessão de usuário.

  • 320 funções do Excel
  • Gráficos
  • Impressão em PDF
Execute o demo SpreadsheetCreate

Preencha, mescle e converta em poucas linhas

Os componentes não precisam de formulário nem de pai: crie-os com um owner nil, chame os seus métodos e libere-os.

O TsgcDocsWordProcessor preenche um modelo DOCX e o exporta para PDF. O TsgcDocsConverter converte qualquer par compatível em uma só chamada e grava um PNG por página.

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;

O MailMergeEach grava um PDF por pedido de uma matriz JSON. {#} é o número do registro e {Name} o valor de um campo.

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;

Valores, uma fórmula com LET, o resultado calculado, e a pasta de trabalho gravada em XLSX e ODS e impressa em 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;

O pacote .NET esegece.sgcDocs mantém os nomes das classes do Delphi. Um programa de console que preenche um modelo, cria uma pasta de trabalho, une os dois arquivos PDF em um arquivo PDF/A-2b e converte as origens.

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");
        }
    }
}

Execute os demos do sgcDocs

Os demos de Delphi e C++ Builder são instalados com a avaliação do sgcUI em Demos\Docs. Os demos .NET acompanham o download .NET Registered. Os demos de console do Delphi usam apenas a RTL e as units sgc, de modo que compilam e rodam sem alterações no Windows e no Linux64.

WordCreate e WordConvert

Um documento com títulos, uma tabela com estilo, listas, uma imagem, um cabeçalho, um rodapé com números de página e uma nota de rodapé, gravado em DOCX, PDF e PNG. O WordConvert carrega qualquer documento e o grava em todos os outros formatos.

MailMerge

Campos de mesclagem com chaves, um campo IF e uma região de tabela: cartas a partir de CSV e pedidos a partir de JSON, em um único documento e em um arquivo por registro.

WordFindReplace

Procurar e substituir no corpo, em uma tabela, no cabeçalho e no rodapé, e depois uma proteção somente leitura com senha.

SpreadsheetCreate e SpreadsheetConvert

Uma planilha de vendas e uma planilha de empréstimo com LET, LAMBDA, XLOOKUP e funções financeiras, formatos, um gráfico de colunas e uma configuração de página, gravadas em XLSX, ODS, CSV, PDF e HTML.

PDFTools

HTML para PDF, unir, dividir, girar, extração e busca de texto, páginas PNG, criptografia AES-256, preenchimento e nivelamento de formulários, e conversão e validação para PDF/A.

Barcodes e ZipArchive

Os 11 tipos de código de barras como PNG, SVG e em uma página PDF. Um arquivo ZIP com metadados de entrada, um arquivo com path traversal recusado e um arquivo ZIP64 de 70.000 entradas.

DocumentConverter

A matriz do CanConvert dos 14 formatos e dos seus 63 pares, e a conversão de qualquer arquivo para um formato de destino, com imagens de página para PNG e SVG.

ConversionServer

Um serviço de conversão REST com POST /convert, POST /merge, GET /formats e GET /health, um conversor por requisição e um tamanho máximo de upload.

Demos de C++ Builder e .NET

DocumentConverter, MailMerge, PDFTools e WordCreate para o C++ Builder 13. Os 11 projetos C# para .NET 8 são portes dos demos do Delphi, e o ConversionServer é uma minimal API do ASP.NET Core.

Onde o sgcDocs está incluído

O sgcDocs está incluído no sgcUI Enterprise e no All-Access. Ele não é vendido separadamente. Ele se baseia no sgcUICore, no sgcRichEdit, no sgcGrid, no sgcSpreadsheet, no sgcCharts e no sgcPDF, que fazem parte do sgcUI Enterprise, e o instalador os adiciona junto com ele. Não há edição Community gratuita, e o pacote .NET esegece.sgcDocs é somente Registered.

sgcUI Enterprise

Todos os produtos sgcUI, com o sgcDocs e os motores em que ele se baseia incluídos, a partir de €699.

Ver Enterprise →

All-Access

Todos os produtos da eSeGeCe, com o sgcUI Enterprise e o sgcDocs incluídos.

Ver All-Access →

Compiladores e plataformas compatíveis

Componentes do sgcDocs

Documentos

TsgcDocsWordProcessor e TsgcDocsMailMerge.

Planilhas

TsgcDocsSpreadsheet.

PDF, códigos de barras e ZIP

TsgcDocsPDFProcessor, TsgcDocsBarcode e TsgcDocsZipArchive.

Conversão

TsgcDocsConverter.

AlvoComponenteVersões e plataformas
Delphi 7 a 13Os sete componentes do sgcDocsWin32, e Win64 a partir do Delphi XE2
C++ Builder 2007 a 13As mesmas classesCabeçalhos .hpp gerados e bibliotecas estáticas
Linux64As mesmas units, sem código de VCL, FireMonkey nem GDIProgramas de console, daemons e servidores web. Precisa do libz.so.1 e das fontes TrueType dos documentos
.NETesegece.sgcDocs.NET Standard 2.0, .NET Framework 4.7.2, .NET 6, 8, 9 e 10
Imagens de página no .NETesegece.sgcUICore.RenderingAdicionado somente para páginas PNG e SVG de documentos e planilhas

Perguntas frequentes

Não. O sgcDocs não precisa do Microsoft Office, do LibreOffice, de COM nem de DLLs externas. Cada leitor, gravador e renderizador é código Pascal dos motores do sgcUI, ou código C# no pacote .NET.

Documentos em DOCX, RTF, HTML, Markdown e texto, planilhas em XLSX, ODS e CSV, e arquivos PDF. A saída também inclui PDF e páginas PNG e SVG, e imagens PNG, JPEG, BMP e TIFF são convertidas em PDF. PPTX, os formatos binários XLS e DOC, a leitura de ODT, tabelas dinâmicas, comentários e revisões, e a criptografia de arquivos do Office não estão nesta versão.

Sim. As units compilam para Linux64 e rodam em programas de console e daemons. O binário precisa do libz.so.1, que toda distribuição instala, e das fontes TrueType que os seus documentos usam, instaladas no servidor ou adicionadas a partir de uma pasta com o AddFontFolder.

Sim, ele foi feito para isso. Os componentes não são thread safe, portanto crie os que uma requisição precisa na thread que a atende e libere-os no fim da requisição. Instâncias separadas rodam em paralelo. O demo ConversionServer mostra um serviço de conversão REST completo.

Não. O sgcDocs faz parte do sgcUI Enterprise e do All-Access. O pacote .NET é somente Registered e não é publicado no nuget.org. Avalie-o com a avaliação do sgcUI.

Sim. Toda licença do sgcUI Enterprise inclui o código-fonte completo e 1 ano de atualizações. Veja a página de preços do sgcUI.

Ajuda do sgcDocs

Ajuda online

A ajuda do sgcUI para Delphi, C++ Builder e .NET: instalação, formatos compatíveis, primeiros passos, mala direta, conversão de documentos, fontes no Linux e implantação em servidor.

Manuais em PDF

Delphi, C++ Builder e .NET, que cobrem todos os produtos sgcUI.

3,000+Desenvolvedores
20+Anos
761+Componentes
30+Integrações de API
5Plataformas
Garantia de reembolso de 30 diasNão ficou satisfeito? Solicite o reembolso total em até 30 dias após a compra. Ver política de reembolso

Experimente o sgcDocs hoje

A avaliação do sgcUI inclui o sgcDocs e todos os outros produtos sgcUI.