API roundup: ultimi aggiornamenti per ONLYOFFICE DocSpace e Docs

Gli aggiornamenti di agosto 2025 per le API di ONLYOFFICE DocSpace e Docs portano una nuova ondata di possibilità di integrazione e strumenti di sviluppo. Che tu stia costruendo flussi di lavoro documentali, creando plugin personalizzati o collegando ONLYOFFICE al tuo stack tecnologico esistente, questi aggiornamenti offrono soluzioni pratiche che fanno risparmiare tempo e semplificano lo sviluppo.

DocSpace: esempi di integrazione per Backend REST API

L’ultimo aggiornamento delle API di DocSpace include esempi di integrazione completi che dimostrano casi d’uso reali. Non si tratta solo di frammenti di codice, ma di soluzioni complete che puoi adattare ai tuoi progetti.

Integrazioni con Trello

Sincronizzazione bidirezionale degli utenti. Sincronizza automaticamente gli utenti tra DocSpace e le board Trello. Questo elimina l’onboarding manuale e garantisce coerenza del team tra piattaforme. Aggiungi utenti DocSpace a Trello / Aggiungi utenti Trello a DocSpace

Migrazione degli asset. Importa gli allegati delle card Trello direttamente nelle stanze DocSpace. Questo scenario semplifica i passaggi di consegna dei progetti e centralizza la documentazione.

Mirroring della struttura dei progetti. Crea stanze DocSpace direttamente dalle board Trello con titoli corrispondenti. Perfetto per mantenere un’organizzazione unificata dei progetti. Esempio di codice:

import requests

# ONLYOFFICE DocSpace configuration
ONLYOFFICE_API_HOST = "your-docspace.onlyoffice.com"
ONLYOFFICE_API_KEY = "your_onlyoffice_api_key"

# Trello configuration
TRELLO_API_KEY = "your_trello_api_key"
TRELLO_TOKEN = "your_trello_token"
TRELLO_BOARD_ID = "your_board_id"

ONLYOFFICE_HEADERS = {
    "Authorization": f"Bearer {ONLYOFFICE_API_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json"
}

# Step 1: Get Trello board name
def get_trello_board_name(board_id):
    url = f"https://api.trello.com/1/boards/{board_id}"
    params = {"key": TRELLO_API_KEY, "token": TRELLO_TOKEN}
    response = requests.get(url, params=params)
    if response.status_code == 200:
        return response.json()["name"]
    else:
        print(f"Trello board fetch error: {response.status_code}")
        return None

# Step 2: Create a DocSpace room with board name
def create_docspace_room(room_title):
    url = f"https://{ONLYOFFICE_API_HOST}/api/2.0/files/rooms"
    payload = {
        "title": room_title,
        "roomType": 2,  # Collaboration room
        "private": True
    }
    response = requests.post(url, headers=ONLYOFFICE_HEADERS, json=payload)
    if response.status_code == 200:
        print(f"Room created: {room_title}")
        return response.json()
    else:
        print(f"DocSpace room creation error: {response.status_code}, {response.text}")
        return None

# Run integration
if __name__ == "__main__":
    board_name = get_trello_board_name(TRELLO_BOARD_ID)
    if board_name:
        create_docspace_room(board_name)

Integrazioni con archiviazione cloud

Connettività con Dropbox. Le nuove integrazioni con Dropbox supportano flussi di lavoro sia di importazione che di esportazione. Esporta file da DocSpace usando URL presignati per archiviazione o backup. Importa file direttamente in stanze specifiche per una gestione documentale centralizzata.

Automazione della condivisione delle cartelle. Condividi automaticamente cartelle Dropbox con utenti o membri di gruppi DocSpace, creando ponti collaborativi fluidi tra piattaforme.

Workflow con Notion e Asana

Integrazione utenti Notion. Sincronizza gli utenti dello spazio di lavoro Notion con DocSpace, garantendo accesso coerente in tutto l’ecosistema documentale.

Automazione progetti Asana. Genera strutture di stanze DocSpace basate su progetti Asana, con cartelle create automaticamente per ciascun task. Ciò consente un perfetto allineamento tra gestione progetti e collaborazione documentale.

Inviti basati su task. Invita automaticamente gli assegnatari dei task Asana nelle stanze DocSpace rilevanti, eliminando la gestione manuale degli accessi.

DocSpace: Plugins SDK potenziato

Il Plugins SDK riceve aggiornamenti significativi con esempi sia avanzati che di base per accelerare lo sviluppo di plugin.

Esempi di plugin avanzati

• Plugin filtro estensioni file. Aggiunge capacità di filtraggio contestuale con un’interfaccia modale pulita. Gli utenti possono filtrare i contenuti delle stanze per tipo di file, migliorando la navigazione in ambienti ricchi di documenti.
• Plugin finestra modale. Dimostra l’integrazione personalizzata della toolbar con chiamate API backend. Crea nuovi documenti direttamente dall’interfaccia con parametri definiti dall’utente.
• UI plugin impostazioni. Fornisce agli amministratori interfacce di configurazione personalizzate, consentendo un controllo dettagliato del comportamento dei plugin.

Esempi di componenti di base

I nuovi esempi di base coprono componenti UI essenziali:

• Plugin API – mostra la corretta gestione della connessione API della piattaforma.
• Componente Box – esempi di configurazione layout e spaziatura.
• Componente Button – implementazione di elementi interattivi.
• Componente ComboBox – interfacce di selezione a tendina.
• Componente Text – opzioni di tipografia e stile.
• Componente ToggleButton – controlli a stato binario.

Questi esempi forniscono i mattoni di base per uno sviluppo plugin più complesso, con schemi di implementazione chiari da seguire.

Docs: personalizzazione

Il nuovo parametro suggestFeature ti offre un controllo granulare sul nuovo elemento dell’interfaccia dell’editor.

const config = {
  editorConfig: {
    customization: {
...
suggestFeature: true,

Questo parametro controlla la visibilità del pulsante di menu “Suggerisci una funzionalità” nella scheda File. Impostalo su false per implementazioni interne in cui i suggerimenti non sono rilevanti, oppure mantienilo su true per favorire il coinvolgimento degli utenti nello sviluppo del prodotto.

Docs: nuovi esempi per Office API

Per supportare casi d’uso diversificati, abbiamo introdotto nuovi esempi di creazione documenti con applicazioni pratiche.

• Numeri sequenziali. Migliora la navigazione nelle tabelle e il riferimento alle righe aggiungendo numerazione sequenziale alla prima colonna.
• Creazione tabelle formattate. Format automatico delle tabelle in fase di creazione con bordi, intestazioni stilizzate e testo allineato nelle celle. Perfetto per report, esportazioni di database o template leggibili.
• Foglio di calcolo con filtri. Genera un foglio di calcolo con filtri interattivi nelle intestazioni, consentendo agli utenti di ordinare e filtrare facilmente i dati.
• Piè di pagina con data e nome azienda. Aggiungi automaticamente un piè di pagina al documento con la data corrente da un lato e il nome della tua azienda dall’altro. Ideale per memo, report, lettere e template standard.
• Tabella a larghezza automatica. Genera un documento con una tabella che adatta dinamicamente la larghezza delle colonne al contenuto.
• Elenco puntato di task. Genera un documento con un elenco puntato chiaro e organizzato, perfetto per attività, passaggi o requisiti.
• Cancellare tutti i valori dei moduli. Reimposta istantaneamente tutti i campi di un modulo PDF al loro stato iniziale per riutilizzo, cancellazione rapida o annullamento dell’input.
• Generare moduli da JSON. Crea automaticamente moduli da oggetti JSON, con tipi di campo e struttura determinati dal contesto dei dati.
• Applicare uno schema di colori. Applica facilmente uno schema di colori uniforme a tutta la presentazione per un aspetto coerente.
• Controllare i duplicati. Rileva ed evidenzia i valori duplicati in una colonna selezionata, perfetto per ripulire e analizzare dati come elenchi di clienti, ordini o registri dei dipendenti.

Controlla tutti gli esempi di Office API

Docs: plugin e macro

Vediamo il concetto di plugin in bundle in ONLYOFFICE. Questi plugin rimangono attivi in tutti i documenti aperti e persistono anche nei nuovi documenti finché non li disattivi manualmente. Basta cliccare sul pulsante Plugin in background nella barra degli strumenti superiore per gestirli. Esempi di questo plugin includono AI e Generatore di codici QR.

Un plugin è considerato in bundle se:

• è incluso nella distribuzione del prodotto (server/desktop);
• non è stato aggiornato, rimosso o disabilitato.

A partire dalla versione 9.0.4, i plugin in bundle in background si avviano immediatamente.

Inoltre, abbiamo introdotto un miglioramento per le funzioni personalizzate – accesso diretto alle informazioni sugli indirizzi delle celle. Questa nuova funzionalità permette calcoli più dinamici e contestuali, rendendo le funzioni personalizzate ancora più versatili.

• this.address: recupera l’indirizzo della cella in cui viene calcolata la funzione personalizzata (es. “C5”).
• this.args: fornisce un array di argomenti di input. Ogni oggetto argomento include un campo address, che specifica l’indirizzo della cella sorgente (es. “A1”). L’array è strutturato come segue:

[ {"address": "arg1_address"}, {"address": "arg2_address"}, ... ]