Resoconto API: gli ultimi aggiornamenti per ONLYOFFICE Docs e DocSpace

Dalle nuove opzioni di personalizzazione agli SDK e alla generazione di macro basata sull’AI, questi aggiornamenti sono pensati per aumentare la produttività e la creatività di ogni sviluppatore e integratore. Ecco una panoramica dettagliata delle novità.

Novità per l’integrazione di Docs

Abbiamo rilasciato aggiornamenti per i nostri SDK dedicati all’integrazione degli editor ONLYOFFICE nelle tue app e servizi. Le ultime versioni degli SDK Java e PHP offrono un supporto migliorato per i formati, nuove opzioni di configurazione e l’aggiunta di un nuovo tipo di visualizzatore: il Diagramma. Vediamo nel dettaglio le novità.

Java SDK 1.6.0

Disponibile su Maven Central, il nuovo Java SDK aggiornato include:

• Nuovo tipo di visualizzatore: Diagramma. Lo SDK ora supporta l’inizializzazione del Visualizzatore di diagrammi ONLYOFFICE, introdotto nella versione 9.0.
• Nuovi campi di configurazione. Compatibile con la versione 9.0 dell’editor, consente un controllo più dettagliato dell’inizializzazione.
• Elenco aggiornato dei formati supportati. Garantisce la compatibilità con i più recenti tipi di file: documenti, fogli di calcolo, presentazioni, moduli e diagrammi.
• Aggiornamenti delle dipendenze. Tutti i componenti con vulnerabilità note sono stati aggiornati per migliorare sicurezza e stabilità.

PHP SDK 1.3.0

Disponibile su Packagist, la nuova versione dello SDK PHP supporta:

• Nuovo tipo di visualizzatore: Diagramma. Gli sviluppatori possono ora integrare il visualizzatore ONLYOFFICE Diagram, ideale per diagrammi di flusso, mappe mentali e altro.
• Supporto per la visualizzazione di file .odg e .md. Estende la compatibilità ai formati aperti e ai file Markdown.
• Supporto per la modifica di file .xlsb. Ora è possibile integrare la modifica dei file Excel in formato binario.
• Nuovi modelli di file vuoti. Aggiunti per le seguenti lingue: catalano (ca-ES), ceco (cs-CZ), danese (da-DK), ungherese (hu-HU), indonesiano (id-ID), rumeno (ro-RO), albanese (sq-AL), urdu (ur-PK).
• Versione minima compatibile dell’editor: 8.0. Assicurati che la tua istanza di ONLYOFFICE Docs sia aggiornata per garantire la piena compatibilità.

Consigliamo a tutti gli sviluppatori che integrano gli editor ONLYOFFICE di aggiornare alle ultime versioni degli SDK per sfruttare le nuove funzionalità e mantenere la compatibilità con ONLYOFFICE Docs 8.0 e versioni successive.

Novità per l’API di Docs

FAQ sulla personalizzazione. Abbiamo aggiunto nuove risposte alle domande frequenti, fornendo spunti su opzioni di personalizzazione meno note.

• Come disattivare i suggerimenti sulle funzioni negli editor per un’interfaccia più pulita.
• Come cambiare il font e la dimensione del testo per un layout editor personalizzato.
• Come nascondere le icone degli utenti attivi e i nomi utente nell’intestazione dell’editor per una maggiore privacy.

Nuovi esempi per Office API. Per supportare diversi casi d’uso, abbiamo introdotto nuovi esempi di creazione documenti con applicazioni pratiche.

• Layout a due colonne. Genera rapidamente documenti professionali, come brochure o report, in formato compatto a due colonne.
• Layout orizzontali. Crea pagine in orientamento orizzontale, ideali per tabelle e grafici ampi.
• Filigrane testuali. Automatizza l’inserimento di filigrane semi-trasparenti “Riservato” per rafforzare la sicurezza dei documenti.
• Inviti a eventi. Crea inviti con dimensioni predefinite e messaggi personalizzati per eventi.

Novità per plugin e macro

Personalizzazione aggiornata delle macro. Con la versione 9.0.3, abbiamo migliorato il comportamento del parametro customization.macros. Impostare macros su false disattiva completamente la funzionalità macro. Questo significa che gli utenti non potranno eseguire, aggiungere o modificare macro; il pulsante Macros verrà nascosto dalla scheda Visualizza.

const config = {
  editorConfig: {
    customization: {
...
macros: false, 
...

Generazione di macro con AI.L’integrazione dell’intelligenza artificiale nello sviluppo delle macro accelera notevolmente il processo di creazione delle macro per ONLYOFFICE.

A partire dalla versione 9.0, il plugin AI può generare modelli di macro a partire da descrizioni testuali, risparmiando ore di lavoro manuale. Scopri di più

Inoltre, è possibile convertire automaticamente il codice VBA in macro JavaScript compatibili con ONLYOFFICE.

Ecco tre esempi di macro convertite da VBA usando l’AI:

• Separare tutte le celle unite. Semplifica la formattazione dei fogli rimuovendo tutte le unioni di celle con un solo comando.
• Convertire formule in valori. Converte rapidamente i calcoli dinamici in dati statici per garantire la coerenza.
• Modificare il valore di una cella. Automatizza la personalizzazione di celle specifiche.

Guarda un esempio di macro per modificare il valore della cella selezionata:

(function(){
    // Get the active sheet
    var activeSheet = Api.GetActiveSheet();
    
    // Select cell A1
    activeSheet.GetRange("A1").Select();
    
    // Set the value of the selected cell to "Hello World"
    activeSheet.GetRange("A1").SetValue("Hello World");
})();

Calcoli asincroni. Aggiungi funzioni personalizzate asincrone per gestire qualsiasi richiesta all’interno del corpo della funzione. Dai un’occhiata a un esempio di calcolo di un indicatore della Banca Mondiale.

Nuovi esempi di macro. Amplia le tue possibilità con nuovi esempi di macro che semplificano i flussi di lavoro sui documenti (in più, sfrutta la nuova guida su come eseguire un esempio di macro).

Incorporando queste macro, puoi ridurre il lavoro manuale e migliorare l’efficienza operativa:

• Compilazione automatica dei campi
• Adattamento automatico dei campi di testo
• Inserimento di calcoli
• Limite al numero di caratteri
• Modifica dei valori di elenco
• Rimozione dei valori predefiniti
• Impostazione di un segnaposto
• Evidenziare gli elenchi puntati
• Generazione di un sommario
• Rimozione delle diapositive duplicate
• Eliminazione delle diapositive
• Ricerca di email non valide

Guarda un esempio di codice per impostare un segnaposto:

(function () {
    let key = "MyKey";
    let placeholderText = "Placeholder";
    let doc = Api.GetDocument();

    doc.GetAllForms()
        .filter(field => field.GetFormType() === "comboBoxForm" && field.GetFormKey() === key)
        .forEach(field => field.SetPlaceholderText(placeholderText));
})();