ONLYOFFICE Docs 7.1 per sviluppatori: aggiornamenti API

20 maggio 2022By Elena

Insieme al rilascio delle nuove funzionalità, abbiamo aggiornato l’API per gli editor, plugin e Document Builder. Scopri i dettagli qui sotto.

ONLYOFFICE Docs 7.1 for developers: API updates

Regolazione del salvataggio dei documenti per le operazioni WOPI

Le nuove intestazioni delle richieste sono disponibili per PutFile per distinguere tra tre tipi di salvataggio dei file:

X-LOOL-WOPI-IsModifiedByUser indica se un utente ha modificato il documento prima del salvataggio o se ha appena premuto il pulsante Salvare senza alcuna modifica.
X-LOOL-WOPI-IsAutosave indica se PutFile viene attivato dal salvataggio automatico o da qualsiasi operazione dell’utente come premere il pulsante Salvare o la voce di menu.
X-LOOL-WOPI-IsExitSave indica se il salvataggio automatico verrà attivato quando il documento viene eliminato dalla memoria, ad es. quando tutti gli utenti si disconnettono, o no.

Conversione aggiornata e nuovi formati

È ora possibile definire il layout del documento che specifica i parametri per la stampa di moduli come documenti PDF o immagini. Per saperne di più

Un altro parametro consente di definire il renderer del documento durante la conversione di un file da PDF, XPS e OXPS. Per saperne di più

Inoltre, abbiamo aggiunto nuove opzioni di conversione:

da PDF a DOCX,
da XPS e OXPS a DOCX,
dal formato XLSB (insieme all’apertura di file XLSB).

Definizione dei gruppi di utenti per la visualizzazione delle informazioni

Con il parametro document.permissions.userInfoGroups, puoi specificare i gruppi di utenti le cui informazioni sono mostrate negli editor, inclusi:

nomi utente nell’elenco degli utenti che stanno attualmente modificando nell’intestazione,
cursori utente e descrizioni comandi con i loro nomi durante la digitazione del testo,
nomi utente quando si bloccano gli oggetti nella modalità di co-editing strict.

"permissions": {
  ...
  "userInfoGroups": ["Group1", ""]
  ...    },

Qui il [“Group1”, “”] significa che vengono visualizzate le informazioni sugli utenti del Gruppo 1 e sugli utenti che non appartengono ad alcun gruppo.

Impostazioni del correttore ortografico

A partire dalla versione 7.1, abbiamo aggiunto la sezione dei parametri editorConfig.customization.features, che consente di impostare i parametri che gli utenti possono disabilitare o personalizzare se possibile, incluso il correttore ortografico.

Il campo editorConfig.customization.spellcheck è ora deprecato e dovresti usare il campo editorConfig.customization.features.spellcheck invece di definire se il correttore ortografico viene attivato o disattivato automaticamente quando viene caricato l’editor di documenti o di presentazioni.

"features": {
  "spellcheck": {
  "mode": true,
  }

Altri cambiamenti

L’elenco dei parametri nella firma della configurazione di inizializzazione è ora rigorosamente regolato.
Il parametro editorConfig.customization.chat è deprecato — invece usa il parametro document.permissions.chat.
I parametri services.CoAuthoring.token.inbox.inBody e services.CoAuthoring.token.outbox.inBody per attivare token nel body sono deprecati.

Ottieni l’ultima versione di ONLYOFFICE Docs Developer Edition:

SCARICA ORA

Aggiornamenti API per i plugin

L’accesso agli oggetti della finestra e documento nonché alla funzione di avviso è limitato codice di comando del plugin e macro. Per saperne di più
Nuovi metodi per plugin con oggetto OLE: GetAllOleObjects, RemoveOleObject, RemoveOleObjects e SelectOleObject.

Scopri come creare plugin

Aggiornamenti API per Document Builder

L’API DocBuilder è stata notevolmente migliorata. Oltre a generare file DOCX, XLSX, PPTX e PDF, ora puoi lavorare con moduli compilabili, ad es.:

builder.CreateFile("docxf");
ONLYOFFICE Document Builder
var oDocument = Api.GetDocument();  
text document contents
var oTextForm = Api.CreateTextForm();
var oParagraph = oDocument.GetElement(0);
oParagraph.AddElement(oTextForm); 
oTextForm.SetText("John Smith"); 
builder.SaveFile("docxf", "example.docxf");
format with the 'example.docxf' name
builder.CloseFile();   
ONLYOFFICE Document Builder