ONLYOFFICE Docs 8.2 per sviluppatori: aggiornamenti dell’API

Insieme al rilascio delle nuove funzionalità nella versione 8.2, abbiamo aggiornato le API per gli editor, le API di Office e i plugin, abbiamo aggiunto il framework Java per il Document Builder e l’SDK di integrazione PHP. Leggi di seguito per conoscere tutti i dettagli.

Distribuzione zero-downtime

La distribuzione zero-downtime è un ottimo modo per aggiornare un’applicazione senza richiedere alcuna pausa, il che rende possibile aggiornare gli editor senza doverli mettere offline.

Come funziona? L’istanza di ONLYOFFICE Docs (Document Server, DS) con la nuova versione viene lanciata in parallelo al Document Server in esecuzione. Nel nuovo DS vengono aperte nuove sessioni di editing, mentre la versione precedente del DS funziona finché gli utenti non terminano le loro sessioni di – solo allora il DS precedente si ferma.

Parlando invece di ONLYOFFICE Docs Shards, siamo in grado di indirizzare una sessione di editing a un DS specifico nel cluster, pertanto, è possibile far lavorare in parallelo server di documenti di versioni diverse. Non dimenticare di considerare che la duplicazione delle risorse e il processo di aggiornamento stesso possono richiedere del tempo.

Nota bene: la distribuzione zero-downtime è disponibile per ONLYOFFICE Docs fornito come shard Kubernetes. Sei interessato a saperne di più? Contattaci via sales@onlyoffice.com.

SDK di integrazione PHP

Integra facilmente ONLYOFFICE Docs nella tua applicazione scritta in PHP. L’SDK include il codice generale per le integrazioni PHP, la creazione della configurazione di inizializzazione e la gestione dei metodi più comuni sul backend. Scoprilo

L’SDK PHP adesso è implementato, ad esempio, nell’integrazione di ONLYOFFICE e Chamilo.

Nuovi stili per l’interfaccia

Il parametro editorConfig.customization.features introduce due ulteriori campi: tabStyle e tabBackground. In questo modo, è possibile regolare l’aspetto dell’editor a proprio piacimento.

Il primo permette di impostare lo stile Riempimento (le schede della barra degli strumenti superiore sono visualizzate in modo distinto) o Linea (le schede della barra degli strumenti superiore sono evidenziate da una sottolineatura).

Il secondo definisce se lo sfondo delle schede della barra degli strumenti superiore corrisponde allo sfondo dell’intestazione o a quello della barra degli strumenti.

Inoltre, abbiamo aggiunto il campo imageLight al parametro editorConfig.customization.logo. Questo campo definisce il percorso del file immagine utilizzato per l’intestazione chiara, ad esempio nel nuovo tema Grigio.

const logo = {
  image: "https://example.com/logo.png",
  imageDark: "https://example.com/dark-logo.png",
  imageLight: "https://example.com/light-logo.png",
  url: "https://example.com",
  visible: true,
}

Inserimento di testo da fonti terze

Il tipo di selezione del documento insert-text viene aggiunto al parametro c del metodo setRequestedDocument. In questo modo, gli utenti possono selezionare un documento dal file locale/URL/storage per inserirne il contenuto nel documento corrente.

docEditor.setRequestedDocument({
  c: "insert-text",
  fileType: "docx",
  url: "https://example.com/url-to-example-document.docx",
...

Controllo dello stato del documento

Il parametro users è stato aggiunto alla risposta del comando info. Questo parametro definisce l’elenco degli identificatori degli utenti che hanno aperto il documento per la modifica. Quando il documento viene modificato, users restituisce l’identificativo dell’utente che ha modificato per ultimo il documento.

{
  "error": 0,
  "key": "Khirz6zTPdfd7",
  "users": ["6d5a81d0", "78e1e841"]
}

Cos’altro è cambiato per l’API Docs

• Nuovi parametri di richiesta per l’API di conversione WOPI per lavorare con documenti protetti: Password e PasswordToOpen.
• L’indirizzo https://documentserver/coauthoring/CommandService.ashx del servizio di comando è sostituito da https://documentserver/command.
• Per il servizio di conversione, usa l’indirizzo https://documentserver/converter.
• Il campo editorConfig.location ora non viene usato più. Utilizza invece il campo editorConfig.region per definire le unità di misura predefinite in tutti i tipi di editor.
• Il campo editorConfig.customization.toolbarNoTabs non viene usato più; si usano i campi editorConfig.customization.features.tabStyle e <editorConfig.customization.features.tabBackground.

Ottieni l’ultima versione di ONLYOFFICE Docs Developer:

SCARICALO ORA

Notifiche via e-mail: avvisi di licenza e limite di quota

Ora è possibile inviare notifiche via e-mail, ad esempio quando la licenza sta per scadere o il limite di connessione sta per essere raggiunto.

Come funziona? Abbiamo aggiunto la possibilità di impostare le impostazioni del server di posta alla configurazione del server. Per l’invio delle notifiche viene utilizzato un server di posta esterno, la cui connessione avviene tramite la libreria Nodemailer. Molte impostazioni della configurazione del server vengono trasferite direttamente a questa libreria.

Miglioramenti dell’API per i plugin

L’API dei plugin apporta anche utili miglioramenti, in particolare i metodi per eseguire le azioni Undo e Redo.

• api.prototype.Undo = function()
• api.prototype.Redo = function()
• api.prototype.CanUndo = function()
• api.prototype.CanRedo = function()

Controlla la lista completa degli aggiornamenti delle API dei plugin.

Java Framework per Document Builder

Per ONLYOFFICE Document Builder adesso è disponibile un Java Builder Framework. Contiene una raccolta di librerie, classi e funzioni che rendono molto più semplice lo sviluppo rapido di applicazioni in Java con capacità di creazione di documenti.

OTTIENI DOCUMENT BUILDER

Office API

Per l’API JavaScript di Office, abbiamo aggiunto molti nuovi metodi per la versione 8.2, tra cui quelli per:

• range;
• tabelle pivot;
• segnaposto;
• ottenere e sostituire parole/frasi;
• aggiornamento di tutti i campi;
• contorni;
• e altri ancora.

Consulta l’elenco completo dei nuovi metodi.