Novità sull’API per sviluppatori: ONLYOFFICE Docs 9.1 e DocSpace 3.5

Ecco l’ultimo riepilogo sulle API per l’ecosistema ONLYOFFICE. Con il rilascio di ONLYOFFICE Docs 9.1 e DocSpace 3.5, introduciamo una serie di nuove e potenti funzionalità pensate per offrire agli sviluppatori maggiore controllo, flessibilità ed efficienza.

Questo articolo ti guiderà tra gli aggiornamenti principali: dal supporto di nuovi formati e opzioni di personalizzazione in Docs ai significativi miglioramenti dell’SDK per DocSpace. Scopri cosa offrono queste nuove versioni per i tuoi progetti di sviluppo.

Aggiornamenti in ONLYOFFICE Docs 9.1

La versione 9.1 di ONLYOFFICE Docs introduce numerosi miglioramenti all’API.

Nuovo supporto di formati e conversione

Per ampliare la compatibilità dei documenti, abbiamo aggiunto il supporto a nuovi formati e potenziato le capacità di conversione:

• apertura di file HML;
• conversione delle presentazioni PPTX in TXT.

Personalizzazione

Ora hai più controllo sull’aspetto degli editor. Il parametro editorConfig.customization.uitheme, che definisce il tema dell’editor, è ora disponibile anche per gli editor mobili. Questo ti consente di mantenere un’esperienza visiva coerente su tutte le piattaforme.

Abbiamo inoltre aggiornato i requisiti di dimensione per il logo personalizzato: ora puoi utilizzare un’immagine di 300×20 pixel per mostrare il tuo logo personalizzato nell’intestazione dell’editor.

const config = {  
   editorConfig: {    
     customization: {
      logo: {        
      image: "https://example.com/logo.png",
      ....
      uiTheme: "theme-dark", ...

Integrazione WOPI

Per chi utilizza la Web Application Open Platform Interface (WOPI), abbiamo introdotto la proprietà UserCanOnlyComment nell’operazione CheckFileInfo. Questa proprietà booleana consente di specificare se un utente deve avere solo i permessi di commento, impedendogli altre modifiche.

Inoltre, è stata migliorata la gestione degli errori. Se un documento non può essere bloccato tramite WOPI, ora si aprirà in modalità visualizzazione con un messaggio di errore appropriato, garantendo un’esperienza più fluida.

Nuovo metodo per i plugin

Abbiamo ampliato l’API per i fogli di calcolo e le presentazioni con il metodo RemoveOleObject (per i fogli / per le diapositive). Questo permette di rimuovere un oggetto OLE da una cartella di lavoro o da una presentazione utilizzando il suo ID interno, offrendo un maggiore controllo sui contenuti incorporati.

expression.RemoveOleObject(internalId);

Office API

La versione 9.1 introduce numerosi nuovi metodi nella Office JavaScript API. Queste aggiunte aprono nuove possibilità per la manipolazione programmata dei documenti, in particolare nei fogli di calcolo.

Le principali aree di espansione includono:

• Formattazione condizionale: una gamma completa di metodi per gestire regole come medie superiori, scale di colore, barre dati, set di icone, top 10 e valori univoci.
• Geometria e tracciati: nuovi metodi per lavorare con geometrie, percorsi e comandi di tracciato, offrendo un controllo più preciso su forme e disegni.
• XML personalizzato: metodi per interagire con parti XML personalizzate nei documenti.
• Gestione di oggetti e proprietà: nuovi metodi di conversione e strumenti per la gestione delle proprietà dei documenti.
• Controllo avanzato degli oggetti: metodi migliorati per sezioni, cartelle di lavoro, tabelle pivot, intervalli e presentazioni.

Consulta l’elenco completo dei nuovi metodi

SDK e esempi di integrazione aggiornati

Per supportare questi aggiornamenti, abbiamo rilasciato un Java SDK aggiornato compatibile con Docs 9.1, che include il supporto per la conversione da presentazioni a TXT e la gestione del formato HTML.

Abbiamo inoltre aggiornato gli esempi di test per la connessione degli editor, inclusi esempi Node.js che mostrano il supporto ai nuovi formati in Docs v9.1. Scoprili su GitHub

Aggiornamenti in ONLYOFFICE DocSpace 3.5

DocSpace 3.5 introduce numerosi miglioramenti pensati per potenziare gli sviluppatori, con SDK ottimizzati e un Backend API aggiornato.

DocSpace Plugins SDK 2.0.0

Il nuovo Plugins SDK introduce importanti novità mirate a migliorare la sicurezza e la funzionalità delle finestre modali.

• Sicurezza dei file migliorata: le impostazioni di sicurezza dei file sono state spostate in un nuovo enum FilesSecurity per una migliore organizzazione e chiarezza. L’interfaccia IFileItem ora include le proprietà fileSecurity e security.
• Finestre modali ottimizzate: è ora possibile creare finestre modali con un controllo maggiore sull’aspetto, usando le proprietà withoutBodyPadding e withoutHeaderMargin. È stato inoltre aggiunto l’evento updateCreateDialogModal per aggiornamenti dinamici.
• Finestre di creazione più intelligenti: l’interfaccia ICreateDialog è stata ampliata con nuove proprietà come isAutoFocusOnError, errorText, onError, onChange, isCloseAfterCreate e isCreateDisabled, offrendo un controllo più preciso sulle interazioni e la validazione dei moduli.

Puoi anche consultare i plugin di sistema aggiornati basati su SDK 2.0.0 già in azione in DocSpace:

• draw.io
• Markdown
• PDF Converter
• Speech-to-Text

SDK API DocSpace v3.5 aggiornati

In linea con il rilascio di DocSpace 3.5, abbiamo aggiornato gli SDK API in diversi linguaggi. Questi SDK offrono un modo pratico per interagire con l’API di DocSpace e gestire file, utenti e stanze in modo programmatico.

Gli SDK aggiornati sono disponibili per:

• TypeScript: @onlyoffice/docspace-api-sdk su npm
• C#: DocSpace.API.SDK su NuGet
• Python: docspace-api-sdk su PyPI

Inizia a sviluppare oggi

Gli ultimi aggiornamenti di ONLYOFFICE Docs e DocSpace offrono un pacchetto di strumenti più completo e potente per gli sviluppatori: dal maggiore controllo API e personalizzazione negli editor a un SDK più robusto per i plugin di DocSpace, questi miglioramenti sono pensati per aiutarti a creare soluzioni più integrate e ricche di funzionalità.

Ti invitiamo a esplorare la documentazione aggiornata, scaricare gli ultimi SDK e iniziare a implementare queste nuove capacità nei tuoi progetti. Non vediamo l’ora di scoprire cosa creerai!

Ottieni l’ultima versione di ONLYOFFICE Docs per sviluppatori:

SCARICA