Panoramica delle API: ultimi aggiornamenti per ONLYOFFICE Docs

Abbiamo rilasciato una serie di aggiornamenti delle API per ONLYOFFICE Docs, pensati per migliorare la compatibilità, la personalizzazione e la sicurezza. Che tu stia creando flussi di lavoro personalizzati, abilitando la collaborazione sicura sui documenti o integrando API avanzate, questi miglioramenti offrono possibilità illimitate. Ecco una panoramica delle ultime novità e migliorie.

Supporto esteso per i formati di file

Le API di Docs ora supportano nuovi formati di file, offrendo una compatibilità più ampia per garantire un’esperienza fluida a chi lavora con tipi di file diversi. Tra questi ci sono i formati Apple iWork e Hancom Office:

• pages
• key
• numbers
• hwp
• hwpx

Questi formati possono essere specificati usando la proprietà documentType, per esempio:

const config = { 
 documentType: "pages",

Opzioni di personalizzazione avanzate

Gli sviluppatori ora hanno un controllo maggiore sul comportamento e sull’aspetto dell’editor. Gli aggiornamenti principali includono:

• Nascondere i suggerimenti sulle funzionalità

Il parametro editorConfig.customization.features.featuresTips consente di attivare o disattivare i suggerimenti sulle nuove funzionalità al primo caricamento dell’editor dopo un aggiornamento. Il valore predefinito è true.

• Visualizzazione delle barre di scorrimento nei fogli di calcolo

A partire dalla versione 8.3, è possibile decidere se mostrare o nascondere automaticamente lo scorrimento orizzontale/verticale quando viene caricato l’editor per i fogli di calcolo. Controlla i parametri editorConfig.customization.showHorizontalScroll e editorConfig.customization.showVerticalScroll.

• Sfondo della presentazione in modalità slideshow

Utilizza il parametro editorConfig.customization.slidePlayerBackground per definire il colore di sfondo della presentazione in formato HEX, RGB o RGBA. Ad esempio: #ff0000, rgb(255, 0, 0), rgba(255, 0, 0, 0.5).

showHorizontalScroll: true,
      showVerticalScroll: true,
      slidePlayerBackground: "#000000",

• Colori per i titoli nei documenti

Personalizza gli stili dei titoli nell’editor di documenti con il parametro editorConfig.customization.wordHeadingsColor, che consente la definizione dei colori in formato HEX.

• Pulsante Info su mobile

Attiva o disattiva la visualizzazione del pulsante Document Info negli editor mobili usando editorConfig.customization.mobile.info. Il valore predefinito è false.

• Modalità puntatore

Modifica la modalità puntatore (select o hand) nel visualizzatore delle presentazioni tramite il parametro editorConfig.customization.pointerMode. Il valore predefinito è select.

• Toolbar compatta nel visualizzatore

Il parametro editorConfig.customization.compactToolbar ora supporta anche la modalità di visualizzazione, consentendo di passare tra toolbar completa e compatta. Il valore predefinito per la modalità di visualizzazione è true.

Miglioramenti alla sicurezza

Le API di Docs introducono la gestione dei file protetti da password grazie all’evento events.onUserActionRequired. Questa funzione viene richiamata quando è richiesta un’azione da parte dell’utente per aprire un documento nei seguenti casi:

• quando è necessario inserire una password per aprire il documento protetto;
• quando è necessario selezionare una codifica per il file TXT;
• quando è necessario selezionare una codifica e un delimitatore per il file CSV.

Ecco un esempio di funzionamento dell’evento:

function onUserActionRequired() {
  console.log("Enter a password")
};
const config = {
  events: {
    onUserActionRequired,
  },
};
const docEditor = new DocsAPI.DocEditor("placeholder", config);

Inoltre, ora puoi utilizzare il comando drop per proibire la modifica dei documenti a utenti specifici:

{
  "c": "drop",
  "key": "Khirz6zTPdfd7",
  "users": ["6d5a81d0"]
}

Il changelog completo delle API di Docs è disponibile qui.

Scarica l’ultima versione di ONLYOFFICE Docs Developer:

SCARICA ORA

Nuovi metodi nelle Office API

Le Office API ricevono aggiornamenti significativi per una gestione documentale più efficiente, in particolare:

• Segnalibri
• Controlli del contenuto
• Sezioni
• Filtri automatici
• Selezione
• E altro ancora

Questi miglioramenti consentono interazioni più ricche e una migliore esperienza di modifica. Per una panoramica completa dei comandi, consulta il changelog delle Office API.

Aggiornamenti delle API per i plugin

Numerosi nuovi metodi e proprietà ampliano le possibilità dei plugin:

• Recupero dei contenuti

Il metodo GetSelectedContent consente di recuperare il contenuto selezionato in un formato specificato.

expression.GetSelectedContent(prop);

• Messaggi di errore

Il metodo ShowError consente ai plugin di visualizzare messaggi di errore o avviso.

expression.ShowError(error, level);

• Proprietà avanzate per i controlli del contenuto

Le nuove proprietà Shd (ombreggiatura di sfondo) e Border migliorano l’oggetto ContentControlProperties per una personalizzazione visiva avanzata.

• Attivazione dei pannelli

Il parametro isActivated ti permette di specificare se un pannello del plugin debba essere espanso (true) o ridotto (false) al caricamento.

Consulta la lista completa degli aggiornamenti delle API per i plugin.