ONLYOFFICE 10.0 per sviluppatori: novità

ONLYOFFICE 10.0 porta una serie di aggiornamenti solidi per gli sviluppatori che costruiscono sopra gli editor. Ci sono nuovi endpoint che semplificano la gestione dei file, la modifica dei PDF in Document Builder e un’API Plugin modernizzata con metodi async. Il rilascio aggiunge anche nuovi controlli per le funzioni AI e impostazioni predefinite più sicure su tutto il server.

Ecco un rapido tour delle modifiche che contano di più per le tue integrazioni, con un paio di cambiamenti di comportamento da verificare prima di aggiornare.

Strumenti AI, opzioni di personalizzazione e gestione AI lato server

ONLYOFFICE Docs 10.0 introduce gli strumenti AI per ogni editor, e fanno molto più che generare testo: capiscono la struttura del documento, riconoscono gli elementi, collegano i contenuti tra le sezioni e creano riferimenti cliccabili per navigare più facilmente. Puoi collegare qualsiasi modello AI, compresi i modelli locali per i casi d’uso sensibili alla privacy, e assegnare modelli diversi a compiti specifici.

Nelle edizioni commerciali di ONLYOFFICE Docs 10.0, gli amministratori possono configurare i fornitori AI una sola volta nel Pannello di Amministrazione. Una volta impostati, gli utenti dell’editor ricevono strumenti AI pronti all’uso, senza dover inserire le proprie chiavi API. Gli amministratori possono assegnare modelli diversi a compiti specifici, collegare server MCP per accedere a strumenti esterni e decidere se la ricerca web è disponibile. Dopo aver salvato una configurazione lato server, gli utenti sono limitati ai fornitori e ai modelli approvati: non possono più aggiungere le proprie chiavi né cambiare il modello usato. Scopri di più

Decidi se gli strumenti AI devono comparire nel tuo prodotto. La versione 10.0 offre due livelli di controllo:

• Per istanza dell’editor: usa editorConfig.customization.ai con il parametro disabled per nascondere le funzioni AI in una specifica configurazione dell’editor.
• Globale per il server: usa l’impostazione del server aiSettings.enable per disattivare le funzioni AI ed escludere gli Strumenti AI da /plugins.json.

È utile se servi livelli di clienti diversi, o se alcune installazioni devono restare senza AI per motivi di conformità.

App modulari

ONLYOFFICE Docs 10.0 introduce le app modulari: un nuovo modo di estendere gli editor senza toccarne il core. App come agenti AI, Moduli, Stanze e File si integrano in ONLYOFFICE Docs e aggiungono nuove funzionalità.

Per gli sviluppatori questo significa poter abilitare solo le funzioni che servono ai propri utenti, tenere snella l’integrazione e ampliarla a poco a poco man mano che il prodotto cresce.

Miglioramenti di sicurezza e architettura

La versione 10.0 sposta diverse protezioni su “attive di default”, quindi le nuove integrazioni partono da una base più sicura.

• JWT abilitato di default. JWT è ora attivo in default.json.
• Gestione dei token più rigorosa. Se un segreto è vuoto o non impostato, compresi i segreti dei tenant, ONLYOFFICE Docs ora rifiuta il token invece di verificarlo o firmarlo.
• Token scoping per le API di servizio. /converter, /docbuilder e /command non accettano più un token dalla configurazione dell’editor. Un nuovo campo operation nel token è facoltativo per queste richieste ed è obbligatorio per /converter/from-file e /docbuilder/from-file.
• Verifica di integrità dei file scaricati. Quando la tua integrazione invia intestazioni di integrità, il server controlla i file scaricati rispetto a esse. Le intestazioni supportate includono Content-Digest, Repr-Digest, x-amz-checksum-* e WOPI SHA256. Il comportamento è controllato da services.CoAuthoring.requestDefaults.checksumVerification, che di default è true.
• Host WOPI espliciti. Gli host WOPI devono ora essere autorizzati da una regola del filtro IP. La regola jolly allow: * non basta più, quindi specifica ogni host in modo esplicito.
• Controlli di accesso alle API. Usa services.CoAuthoring.server.convertServiceEnable e services.CoAuthoring.server.docbuilderEnable per disattivare le API pubbliche di conversione e di Document Builder. Entrambi sono true di default.
• Configurazione runtime più rigorosa. Tramite runtime.json si può ora modificare solo il livello di logging di log4js.

Uno sguardo più da vicino alle ultime correzioni di sicurezza

Modifica dei PDF in Document Builder

Document Builder ora può modificare i PDF, e questo apre la strada a molti nuovi scenari di automazione:

• OpenFile gestisce i PDF in modo intelligente. I moduli PDF creati in ONLYOFFICE si aprono nell’editor di documenti. Gli altri PDF si aprono nell’editor PDF, con pieno accesso all’API PDF.
• PDF protetti da password. Il nuovo parametro m_sPassword in OpenFile permette di aprire i file protetti.
• Creazione di moduli PDF. Chiama CreateFile con il tipo pdf per creare moduli PDF.

Lato server, i moduli salvati come PDF normale vengono ora firmati quando gli utenti li inviano. Questo dà un ulteriore livello di fiducia ai tuoi flussi di lavoro sui moduli.

Alexander Trofimov, Responsabile del team di sviluppo degli editor in ONLYOFFICE:

Con ONLYOFFICE Docs 10.0 abbiamo reso gli editor ancora più sicuri per le tue integrazioni. Inoltre, questo rilascio porta il supporto completo ai PDF in Document Builder, così sviluppatori e utenti finali possono creare, modificare e gestire i PDF direttamente da Builder, senza ricorrere a soluzioni alternative o a strumenti di terze parti.

Aggiornamenti di distribuzione e amministrazione

Far girare ONLYOFFICE Docs in produzione è diventato più semplice:

• Il Pannello di Amministrazione parte con il server. Nelle edizioni commerciali, il Pannello di Amministrazione ora si avvia automaticamente di default. Include anche blocchi per visualizzare il segreto JWT e pulsanti per aprire, avviare e fermare l’esempio di test.
• Creazione dell’admin da CLI. Ora puoi creare il primo amministratore con la CLI host documentserver-admin, usando create-admin e reset-admin-password. Sostituisce la vecchia pagina web, che si basava sui log di bootstrap.
• Recupero automatico delle modifiche non salvate. Se il server si spegne, le modifiche non salvate vengono recuperate automaticamente in “file dimenticati”. Lo script separato changes2forgotten è stato rimosso.
• Nuova porta predefinita. Le installazioni DEB e RPM ora usano di default la porta 8083. Se serve, aggiorna le regole di proxy e firewall.
• Monitoraggio migliore. La nuova metrica coauth.connections include i tag mode (modifica, visualizzazione in tempo reale, visualizzazione) e replica.
• Flag per l’aggiornamento desktop. Su Windows, il flag da riga di comando --prefer-alternate-url permette ai Desktop Editors di scaricare gli aggiornamenti da una fonte alternativa.
• Pagina di benvenuto rinnovata. La pagina di benvenuto del server ha un nuovo design.

Nuovo supporto per i formati di file

La versione 10.0 aggiunge due novità sui formati, che ti aiutano a gestire più documenti con meno lavoro personalizzato:

• Visualizzazione e conversione OFD. Puoi aprire e convertire i file ofd. Come xps, si aprono in sola visualizzazione.
• Conversione in XLS. Puoi convertire qualsiasi formato di foglio di calcolo nel classico formato xls. È utile quando i tuoi utenti o partner dipendono ancora da sistemi legacy.

Endpoint multipart per il caricamento diretto dei file

Finora i servizi di conversione e di Document Builder scaricavano i file sorgente da un URL. Quindi il file doveva essere ospitato in un posto raggiungibile dal server. La versione 10.0 aggiunge due nuovi endpoint che eliminano questo passaggio:

• POST /converter/from-file
• POST /docbuilder/from-file

Entrambi accettano dati in formato multipart/form-data. Puoi inviare un file o uno script direttamente nella richiesta, senza doverlo esporre tramite un URL temporaneo.

È un’opzione più pulita per molti flussi di lavoro. Per esempio, un servizio backend può convertire al volo i file caricati dagli utenti, o eseguire uno script di Document Builder senza dover prima preparare i file.

Esempio di richiesta: conversione da TXT a DOCX

curl -f -X POST "https://documentserver/converter/from-file" 
  -F 'params={"filetype":"txt","outputtype":"docx","title":"Titolo del Documento Esempio.txt"}' 
  -F 'file=@example.txt' 
  -o "Titolo del Documento Esempio.docx"

Modernizzazione dell’API Plugin

Le API Plugins e Macros ricevono il più grande aggiornamento degli ultimi tempi.

Un nuovo oggetto globale Editor

I metodi ora si chiamano come normali funzioni che restituiscono una Promise. Invece di far passare ogni chiamata da window.Asc.plugin.executeMethod, puoi scrivere un codice async pulito:

const text = await Editor.GetSelectedText();

Il risultato è un codice più breve e leggibile, che si inserisce in modo naturale nei progetti JavaScript moderni.

Nuovi metodi ed eventi

La versione 10.0 aggiunge anche nuovi strumenti per costruire plugin più completi:

• Metodi: Editor.RunMacro, GetRestrictions, SetButtonDisabled, GetOFormRole
• Eventi: onFloatActionButtonClick, onSelectionEnd, onSelectionCancel

Per esempio, gli eventi di selezione permettono al plugin di reagire nel momento in cui l’utente termina o annulla una selezione.

Consulta il changelog completo dell’API Plugins

Inizia a costruire con ONLYOFFICE 10.0

La versione 10.0 ti offre API più pulite, più potenza di automazione e impostazioni predefinite più sicure. Ecco un piano rapido per sfruttarla al meglio:

• Rivedi i cambiamenti di comportamento. Controlla l’uso dei token, le regole del filtro IP per WOPI e la nuova porta predefinita.
• Aggiorna i tuoi plugin. Passa all’oggetto globale Editor e sostituisci gli eventuali metodi rinominati o rimossi.
• Prova i nuovi endpoint. Testa /converter/from-file e /docbuilder/from-file nei tuoi flussi di conversione.
• Decidi come usare l’AI. Configura editorConfig.customization.ai o aiSettings.enable in base alle esigenze del tuo prodotto.

SCARICA VERSIONE PER SVILUPPATORI

Stai sviluppando con la versione cloud di ONLYOFFICE Docs? Prova Docs Connect, un modo più semplice di collegare gli editor a piattaforme e servizi esterni. A differenza della versione self-hosted di ONLYOFFICE Docs, che richiede di installare e mantenere gli editor sui propri server, Docs Connect si occupa per te di hosting, manutenzione e aggiornamenti regolari.

Consulta il changelog completo per tutti i dettagli, e condividi il tuo feedback sul forum della community di ONLYOFFICE. Non vediamo l’ora di scoprire cosa costruirai!