ONLYOFFICE Docs 9.3 per sviluppatori: API PDF, nuovi metodi per l’API JavaScript di Office e altro ancora

ONLYOFFICE Docs 9.3 introduce numerosi aggiornamenti per gli sviluppatori. Questa versione amplia in modo significativo le capacità della nostra API, offrendo maggiore controllo e flessibilità per integrare ed estendere gli editor. Vediamo nel dettaglio i miglioramenti principali.

Introduzione della nuova PDF API

Una delle aggiunte più importanti della versione 9.3 è la nuovissima API di PDF. Questo potente set di strumenti consente di creare e manipolare documenti PDF tramite codice. Ora è possibile costruire file PDF complessi da zero, aggiungendo vari elementi come testo, immagini, tabelle e forme.

L’API offre un ampio controllo sulla struttura e sul contenuto del documento. È possibile gestire le pagine, lavorare con la formattazione avanzata del testo e inserire disegni e altri oggetti con precisione. Questo apre nuove possibilità per automatizzare la generazione di documenti e creare soluzioni personalizzate basate su PDF all’interno delle proprie applicazioni.

Consulta l’esempio di codice per creare un nuovo file 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()

Aggiornamenti importanti alla Office JavaScript API

La Office JavaScript API ha ricevuto un aggiornamento significativo, con numerosi nuovi metodi distribuiti in diversi moduli per migliorare l’automazione e l’interazione con i documenti.

Miglioramenti per i moduli

Abbiamo aggiunto un ricco set di metodi per lavorare con i moduli. Ora è possibile gestire programmaticamente i campi dei moduli, inclusi pulsanti, checkbox, combobox e campi di testo. Questo permette di creare e gestire moduli dinamici, rendendo più semplice sviluppare soluzioni avanzate per l’inserimento dei dati.

Capacità estese per disegni e annotazioni

L’API per disegni e annotazioni è stata notevolmente migliorata. I nuovi metodi consentono un controllo più preciso su forme, geometrie e proprietà visive come riempimenti e bordi. Questo include nuovi metodi per gestire:

• Annotazioni (caret, cerchio, evidenziazione, ink, ecc.)
• Geometrie e percorsi
• Riempimenti (gradienti, colori) e bordi

Consulta l’esempio di codice per il metodo ApiStroke/GetFill (Spreadsheet API):

// 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());
    }
}

Metodi avanzati per grafici e tabelle

Lavorare con grafici e tabelle è ora più flessibile. I nuovi metodi ApiChart e ApiTable offrono un maggiore controllo programmatico sulla loro creazione e modifica, consentendo di costruire documenti più dinamici e ricchi di dati.

Altre importanti aggiunte alla JavaScript API

• Filtri e validazione: Sono stati introdotti nuovi metodi per Autofilter, Filter e Validation per gestire meglio i dati nei fogli di calcolo.
• Note a piè di pagina e note di chiusura: È possibile aggiungere e gestire programmaticamente footnotes ed endnotes nei documenti.
• Collegamenti ipertestuali e transizioni: Maggiore controllo sui collegamenti ipertestuali e sulle transizioni delle slide nelle presentazioni.

Consulta l’elenco completo dei nuovi metodi

Miglioramenti alla Plugins and Macros API

La API per plugin e macro riceve aggiornamenti importanti anche nella versione 9.3. Questi miglioramenti sono pensati per offrire agli sviluppatori più possibilità di estendere le funzionalità degli editor ONLYOFFICE. Ora è possibile creare plugin ancora più potenti e integrati, automatizzare workflow complessi con le macro e sviluppare funzionalità personalizzate adattate a esigenze specifiche.

Ad esempio, il metodo IsFormSigned verifica se il modulo specificato è stato firmato digitalmente:

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

La nuova API per le macro nell’Editor PDF consente di aggiungere, eliminare e modificare pagine, moduli, annotazioni, forme automatiche, tabelle, immagini e grafici. Ad esempio, ecco il metodo SetMacros all’interno di window.Asc.plugin.executeMethod per la PDF API:

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

Consulta il changelog completo della Plugins and Macros API