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), la modalità Traccia Modifiche, commenti e chat integrata.
• Supporto JWT per proteggere il tuo traffico in modo che nessuno possa accedere ai tuoi documenti tranne gli utenti con i diritti appropriati.

Formati supportati

• Per visualizzazione e modifica: DOCX, XLSX, PPTX
• Solo per visualizzazione: 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

Modificato

• Dipendenze del motore aggiornate

Il registro completo delle modifiche è disponibile qui.

Requisiti

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

  Hai bisogno di un'istanza di ONLYOFFICE Docs che sia risolvibile e connettibile sia da Strapi che da qualsiasi client finale. Deve essere in grado di inviare POST direttamente a Strapi.

  Si prega di fare riferimento alla pagina di documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.
• Strapi v4.2.0 o successiva
• 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. Il plugin può essere accesso tramite il pannello di 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 sulla voce di menu ONLYOFFICE.
3. Nella pagina delle impostazioni di ONLYOFFICE, inserisci l'indirizzo del server dei documenti, ovvero l'URL di ONLYOFFICE Docs installato.
   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 utente-documento avviene sia lato client che lato server.

I concetti principali utilizzati nella documentazione corrente sono spiegati di seguito.

Il lato client include:

• Gestore documenti - l'elenco dei documenti visualizzati nel browser dell'utente dove l'utente può selezionare il documento necessario ed eseguire alcune azioni con esso (a seconda dei diritti forniti, l'utente può aprire il documento per visualizzarlo o modificarlo, condividere il documento con altri utenti).
• Editor di documenti - l'interfaccia di visualizzazione e modifica dei documenti con tutte le funzionalità di modifica dei documenti più conosciute disponibili, utilizzata come mezzo tra l'utente e il servizio di modifica documenti.

Il lato server include:

• Servizio di archiviazione documenti - il servizio server che memorizza tutti i documenti disponibili per gli utenti con i diritti di accesso appropriati. Fornisce gli ID dei documenti e i link a questi documenti al gestore documenti che l'utente vede nel browser.
• Servizio di modifica documenti - il servizio server che consente di eseguire la visualizzazione e la modifica dei documenti (nel caso in cui l'utente abbia i diritti appropriati per farlo). L'interfaccia editor di documenti viene utilizzata per accedere a tutte le funzionalità del servizio di modifica documenti.
• Servizio di comando documenti - il servizio server che consente di eseguire comandi aggiuntivi con il servizio di modifica documenti.
• Servizio di conversione documenti - il servizio server 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 la loro modifica o download.
• Servizio di costruzione documenti - il servizio server che consente di costruire un documento facilmente senza la necessità di eseguire effettivamente 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 o 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 server dei documenti. 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 co-autore documenti aggiunti alla Libreria multimediale di Strapi,

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

Per salvare i file nel formato richiesto direttamente nell'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 visualizzare solo i file, imposta il diritto di accesso Accedi alla Libreria multimediale per il ruolo utente richiesto.