Strapi

Caratteristiche principali

• Modifica e visualizzazione di documenti di testo, fogli di calcolo e presentazioni.
• Co-editing dei documenti in tempo reale: due modalità di co-editing (Veloce e Rigida), modalità Traccia Modifiche, commenti e chat integrata.
• Supporto JWT per proteggere il traffico e garantire che solo gli utenti autorizzati, con i permessi adeguati, possano accedere ai tuoi documenti.

Formati supportati

• Per visualizzazione e modifica: DOCX, XLSX, PPTX
• Per sola lettura: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF, TXT, HTML, HTM, MHT, XML, PDF, DJVU, FB2, EPUB, XPS, XLS, XLSX, XLSM, XLT, XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTX, PPTM, POT, POTX, POTM, ODP, FODP, OTP

Novità nella versione 2.0.1

Cambiamenti

• Aggiornate le dipendenze del motore

Il registro completo delle modifiche è disponibile qui.

Requisiti

• ONLYOFFICE Document Server v7.1 (server o versione cloud) o superiore

  È necessaria un’istanza di ONLYOFFICE Docs raggiungibile e risolvibile sia da Strapi che dai client finali. Inoltre, l’istanza deve poter inviare richieste POST direttamente a Strapi per garantire il corretto funzionamento dell'integrazione.

  Per maggiori informazioni sul processo di installazione di ONLYOFFICE Docs, consultare la documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.
• Strapi v4.2.0 o superiore
• Connettore ONLYOFFICE v1.1.0 per Strapi

Installazione del plugin di integrazione ONLYOFFICE per Strapi

1. Per consentire l'inserimento di un frame con l'editor e il caricamento di api.js, sostituire la riga strapi::security nel file strapi/config/middlewares.js con la seguente configurazione:

    { name: "strapi::security", config: { contentSecurityPolicy: { useDefaults: true, directives: { "script-src": ["'self'", "https:", "http:"], "frame-src": ["'self'", "https:", "http:"], }, }, } }, 

   Se tale configurazione esiste già, è sufficiente aggiungere directives.

2. Installa il plugin nel tuo progetto Strapi:

   npm install onlyoffice-strapi --save

3. Ricostruisci e riavvia Strapi per includere il plugin ONLYOFFICE nell'interfaccia amministrativa. Esegui:

    # usando yarn yarn build yarn develop # usando npm npm run build npm run develop 

   Ora il plugin di integrazione ONLYOFFICE per Strapi è installato e pronto per essere configurato. È possibile accedere al plugin tramite il pannello a sinistra nella sezione Plugins sotto il nome ONLYOFFICE.

   

Configurazione del plugin di integrazione ONLYOFFICE per Strapi

Per configurare il plugin di integrazione ONLYOFFICE in Strapi:

1. Apri la sezione Impostazioni nel pannello di sinistra.
2. Nella sezione Impostazioni globali, fai clic sul menù di ONLYOFFICE.
3. Nella pagina delle impostazioni di ONLYOFFICE, inserisci l'indirizzo del Docs Server, ovvero l'URL dell'istanza installata di ONLYOFFICE Docs.
   L'indirizzo di ONLYOFFICE Docs deve essere accessibile da Strapi, così come l'indirizzo di Strapi deve essere accessibile da ONLYOFFICE Docs.

Come funziona

L'interazione tra utente e documento avviene sia a lato client che a lato server.

Di seguito sono elencati i concetti principali utilizzati in questa guida.

Il lato client include:

• Gestore documenti - l’elenco dei documenti visualizzati nel browser dell’utente. Da qui l’utente può selezionare il documento desiderato ed eseguire diverse operazioni in base ai permessi assegnati, come aprire il documento per la visualizzazione o la modifica oppure condividerlo con altri utenti.
• Editor di documenti - l’interfaccia per la visualizzazione e la modifica dei documenti, dotata delle funzionalità di editing più comuni. Funge da collegamento tra l’utente e il servizio di modifica documenti.

Il lato server include:

• Servizio di archiviazione documenti - il servizio che memorizza tutti i documenti accessibili agli utenti autorizzati. Fornisce al gestore documenti gli ID e i link dei documenti mostrati nel browser.
• Servizio di modifica documenti - il servizio che consente la visualizzazione e la modifica dei documenti, se l’utente dispone dei permessi necessari. Le sue funzionalità sono accessibili tramite l’editor di documenti.
• Servizio di comando documenti - il servizio che consente di eseguire comandi aggiuntivi con il servizio di modifica documenti.
• Servizio di conversione documenti - il servizio che consente di convertire il file del documento nel formato Office Open XML appropriato (docx per documenti di testo, xlsx per fogli di calcolo e pptx per presentazioni) per modificarli o scaricarli.
• Servizio di costruzione documenti - il servizio che consente di generare facilmente un documento senza dover effettivamente utilizzare un editor di elaborazione documenti.

Si prega di notare che ONLYOFFICE Document Server include l'editor di documenti, il servizio di modifica documenti, il servizio di comando documenti, il servizio di conversione documenti e il servizio di costruzione documenti. Il gestore documenti e il servizio di archiviazione documenti sono inclusi nel Community Server; in alternativa devono essere implementati dagli integratori software che utilizzano ONLYOFFICE Document Server sul proprio server.

Abilitazione di JWT per l'integrazione di ONLYOFFICE e Strapi

JWT, o JSON Web Token, è una stringa inviata dal client al server all'interno della richiesta HTTP per convalidare l'autenticità del client. JWT è salvato solo sul lato client, quindi la trasmissione tra le parti è protetta e firmata digitalmente.

Il token è generato utilizzando lo standard JWT (JSON Web Tokens). I token sono firmati dalla chiave del server, quindi il client è in grado di verificare che il token sia legittimo.

ONLYOFFICE Docs convalida il token. I dati dal payload sono considerati validi e vengono utilizzati al posto dei dati corrispondenti dai parametri principali. Se il token è invalido, il comando non viene eseguito. Per saperne di più, leggi la guida API Security.

Per proteggere i tuoi documenti con JWT,

1. Apri la sezione Impostazioni nel pannello di sinistra.
2. Nella sezione Impostazioni globali, fai clic sulla voce di menu ONLYOFFICE.
3. Nella pagina delle impostazioni di ONLYOFFICE, inserisci la chiave segreta nel campo Chiave segreta JWT del Docs Server. Ulteriori informazioni possono essere trovate qui.
   

   Ora che il plugin di integrazione ONLYOFFICE è configurato, puoi iniziare a usarlo.

Caricamento di file su Strapi

1. Nella sezione Plugins nel pannello di sinistra, apri la pagina Libreria multimediale.
2. Fai clic sul pulsante Aggiungi nuovi asset nell'angolo in alto a destra.
   
3. Si apre la finestra Aggiungi nuovi asset. Scegli se vuoi caricare un file dal tuo computer o da URL facendo clic sulla scheda corrispondente nel pannello superiore.
   

Visualizzazione, modifica e gestione dei file in Strapi

Per visualizzare, modificare e collaborare sui documenti aggiunti alla Libreria multimediale di Strapi,

1. Dal pannello a sinistra, nella sezione Plugins, apri la pagina dei file ONLYOFFICE all'interno di Strapi.
2. Per aprire il file negli editor di ONLYOFFICE, fai clic sul nome del file o fai clic sul pulsante Modifica in ONLYOFFICE a destra.
   

Per salvare i file nel formato desiderato direttamente allìinterno dell'editor,

1. Vai alla scheda File.
2. Fai clic sull'opzione Scarica come... e scegli il formato richiesto.

Per contrassegnare i file come preferiti direttamente nell'editor, fai clic sull'icona Contrassegna come preferito nella barra degli strumenti superiore.

Per tornare all'elenco dei file,

1. Vai alla scheda File.
2. Fai clic sull'opzione Apri posizione file nel menu a destra.

Diritti di accesso

Per gestire i diritti di accesso ai file aggiunti alla Libreria multimediale di Strapi:

1. Vai alla scheda Impostazioni situata nella sezione Generale sul pannello di sinistra.
2. Nella sezione Pannello di amministrazione, vai alla scheda Ruoli.
3. Modifica il ruolo facendo clic sull'icona Modifica a destra del nome del ruolo.

Per consentire agli utenti di modificare i file, imposta i diritti di accesso Aggiorna + Elimina per il ruolo utente richiesto.

Per consentire agli utenti di accere ai file in modalità sola lettura, imposta il diritto di accesso Accedi alla Libreria multimediale per il ruolo utente richiesto.