ONLYOFFICE Docs 9.3 Para desenvolvedores: API PDF, novos métodos para a API JavaScript do Office e muito mais

ONLYOFFICE Docs 9.3 traz uma série de atualizações para desenvolvedores. Esta versão expande significativamente os recursos da nossa API, oferecendo mais controle e flexibilidade para integrar e ampliar os editores. Vamos conhecer as principais melhorias.

Apresentando a nova API PDF

Uma das adições mais significativas na versão 9.3 é o novo API PDF. Este poderoso conjunto de ferramentas permite criar e manipular documentos PDF programaticamente. Agora você pode criar arquivos PDF complexos do zero, adicionando vários elementos, como texto, imagens, tabelas e formas.

A API oferece amplo controle sobre a estrutura e o conteúdo dos documentos. Você pode gerenciar páginas, trabalhar com formatação de rich text e inserir desenhos e outros objetos com precisão. Isso abre novas possibilidades para automatizar a geração de documentos e criar soluções personalizadas baseadas em PDF dentro de seus aplicativos.

Verifique o exemplo de código para criar um novo arquivo PDF:

// create a PDF file with ONLYOFFICE Document Builder
builder.CreateFile("pdf")

// create a new 'oDocument' variable and get the created PDF document
const oDocument = Api.GetDocument()

// create a new paragraph for the PDF content
const oParagraph = Api.CreateParagraph()

// set the paragraph justification to center the text
oParagraph.SetJc("center")

// add a text containing a single 'Center' word to the paragraph
oParagraph.AddText("Center")

// push the paragraph to the document
oDocument.Push(oParagraph)

// save the resulting PDF document as a file in the .pdf format with the 'example.pdf' name and close it
builder.SaveFile("pdf", "example.pdf")
builder.CloseFile()

Atualizações importantes na API JavaScript do Office

The API JavaScript do Office recebeu uma atualização substancial, com vários novos métodos em diferentes módulos para melhorar a automação e a interação de documentos.

Melhorias no formulário

Adicionamos um rico conjunto de métodos para trabalhar com formulários. Agora você pode gerenciar programaticamente campos de formulário, incluindo botões, caixas de seleção, caixas de combinação e campos de texto. Isso permite a criação e interação dinâmica de formulários, facilitando a construção de soluções sofisticadas de entrada de dados.

Recursos ampliados de desenho e anotação

A API para desenhos e anotações foi bastante aprimorada. Novos métodos permitem um controle mais preciso sobre formas, geometria e propriedades visuais, como preenchimentos e traços. Isso inclui novos métodos para gerenciar:

• Anotações (cursor, círculo, destaque, tinta, etc.)
• Geometrias e trajetórias
• Preenchimentos (gradientes, cores) e traços

Verifique o exemplo de código para o método ApiStroke/GetFill (API de planilha eletrônica):

// Creates a shape with a colored border and retrieves its fill properties.
let worksheet = Api.GetActiveSheet();
let fill = Api.CreateSolidFill(Api.CreateRGBColor(255, 200, 100));
let stroke = Api.CreateStroke(2 * 36000, Api.CreateSolidFill(Api.CreateRGBColor(0, 0, 255)));
let shape = worksheet.AddShape("rect", 60 * 36000, 40 * 36000, fill, stroke, 3, 0, 2, 2);
let strokeObj = shape.GetLine();
if (strokeObj) {
    let strokeFill = strokeObj.GetFill();
    if (strokeFill) {
        worksheet.GetRange("A1").SetValue("Stroke fill type: " + strokeFill.GetType());
    }
}

Métodos avançados de gráficos e tabelas

Trabalhar com gráficos e tabelas agora é mais flexível. Novo métodos ApiChart e ApiTable proporcionam maior controle programático sobre sua criação e modificação, permitindo que você crie documentos mais dinâmicos e ricos em dados.

Outras adições notáveis à API JavaScript

• Filtragem e validação: Novos métodos para Autofilter, Filter, e Validation foram introduzidas para melhorar a gestão de dados em planilhas.
• Notas de rodapé e notas finais: adicione e gerencie notas de rodapé e notas finais em seus documentos de forma programática.
• Hiperlinks e transições: obtenha mais controle sobre hiperlinks e transições de slides de apresentação.

Confira a lista completa dos novos métodos

Melhorias na API de plug-ins e macros

A API para plugins e macros também apresenta atualizações importantes na versão 9.3. Essas melhorias foram projetadas para oferecer aos desenvolvedores mais opções para ampliar a funcionalidade dos editores ONLYOFFICE. Agora você pode criar plug-ins ainda mais poderosos e integrados, automatizar fluxos de trabalho complexos com macros e oferecer recursos personalizados sob medida para as necessidades específicas dos usuários.

Por exemplo, o método IsFormSigned verifica se o formulário especificado foi assinado digitalmente:

window.Asc.plugin.executeMethod ("IsFormSigned", [], function(isSigned) {    
console.log ("Form is signed: " + isSigned);
});

A API para macros recém-introduzida no PDF Editor permite adicionar, excluir e editar páginas, formulários, anotações, formas automáticas, tabelas, imagens e gráficos. Por exemplo, aqui está o método SetMacros dentro do window.Asc.plugin.executeMethod para a API PDF:

window.Asc.plugin.executeMethod ("SetMacros", [JSON.stringify (Content)], function () {    
window.Asc.plugin.executeCommand ("close", "");
});

Confira o changelog completo da API de plug-ins e macros