Questo articolo è stato tradotto dall’AI

Alfresco

Informazioni sull'integrazione tra ONLYOFFICE e Alfresco

ONLYOFFICE offre un connettore ufficiale per integrare ONLYOFFICE Docs con Alfresco per creare, modificare e convertire documenti office all'interno della libreria documenti. Puoi scaricare il connettore ONLYOFFICE dalla directory degli Add-ons di Alfresco o dalla pagina GitHub di ONLYOFFICE.

Per saperne di più sul modulo ONLYOFFICE e Alfresco e su come funziona nel dettaglio, visita la nostra documentazione API.

Caratteristiche principali

Creazione, modifica e visualizzazione di documenti di testo, fogli di calcolo e presentazioni.
Conversione di file.
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, eccetto gli utenti con i diritti appropriati.

Formati supportati

Per la creazione, modifica e visualizzazione: DOCX, PPTX, XLSX
Per lavorare con i moduli: PDF
Per la conversione: ODT, ODP, ODS, DOC, XLS, PPT, RTF
Per la modifica tramite conversione in OOXML: ODP, ODS, ODT, RTF, CSV, TXT
Solo per la visualizzazione: PDF

Novità nella versione 8.1.0

Aggiunto

Aggiunto supporto eventi nell'editor: onRequestReferenceData, onRequestReferenceSource, onRequestOpen

Modificato

Corretto il bug dell'impostazione Ignora Certificato SSL

Il changelog completo è disponibile qui.

Connessione di ONLYOFFICE Docs ad Alfresco Share

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 Alfresco che da qualsiasi client finale. Deve essere in grado di inviare POST direttamente ad Alfresco.
Si prega di fare riferimento alla pagina di documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.
Alfresco v.7.4, 23, 25
ONLYOFFICE Connector 7.0.0 per Alfresco

Installazione del pacchetto modulo ONLYOFFICE e Alfresco

I file del pacchetto compilato più recenti sono disponibili su GitHub. Hai bisogno dei file onlyoffice-integration-repo.amp e onlyoffice-integration-share.amp.

Installazione tramite pacchetti compilati

Scarica i file del pacchetto .amp compilati utilizzando il link sopra.

Crea le seguenti directory sul tuo server:

sudo mkdir -p /var/opt/alfresco/amps

sudo mkdir -p /var/opt/alfresco/amps_share

Sposta i file del pacchetto .amp compilati nelle directory appena create:
- /var/opt/alfresco/amps per onlyoffice-integration-repo.amp
- /var/opt/alfresco/amps_share per onlyoffice-integration-share.amp
Arresta i servizi Alfresco utilizzando uno dei metodi:
1. Metodo 1:
```
sudo systemctl stop alfresco
```
  Assicurati che tutti i servizi Alfresco siano arrestati. Devono essere arrestati consecutivamente; gli ultimi devono essere quelli con content nel loro nome, ad esempio:
```
alfresco-tengine-aio.service.service
alfresco-search.service
alfresco-content-monitored-startup.service
alfresco-content.service
```
2. Metodo 2:
```
sudo ./alfresco.sh stop
```
  Si noti che questo metodo funziona solo se lo script è incluso nella tua versione, il che non è sempre il caso.
Trova il percorso dei file alfresco.war e share.war, ad esempio:
```
sudo find / -type f -iname '*alfresco.war*' 2>/dev/null
```
Trova il percorso del file dello strumento alfresco-mmt.jar.
Installa il componente repo del plugin:
```
java -jar /PATH/alfresco-mmt.jar install \
/PATH/onlyoffice-integration-repo.amp \
/PATH/alfresco.war \
-verbose -nobackup -force
```
dove PATH indica i percorsi dei file precedentemente individuati. Si noti che i valori di PATH sono diversi per ogni iterazione nel comando sopra.
Potrebbe essere necessario aggiornare Java per distribuire alfresco-mmt.jar:
```
sudo apt update
sudo apt install openjdk-17-jre-headless
```
Installa il componente share del plugin:
```
java -jar /PATH/alfresco-mmt.jar install \
/PATH/onlyoffice-integration-share.amp \
/PATH/share.war \
-verbose -nobackup -force
```
dove PATH indica i percorsi dei file precedentemente individuati. Si noti che i valori di PATH sono diversi per ogni iterazione nel comando sopra.

Elimina le directory Tomcat per Alfresco per ricompilare al riavvio:

sudo rm -rf /var/opt/alfresco/tomcat/webapps/alfresco
sudo rm -rf /var/opt/alfresco/tomcat/webapps/share

Riavvia Alfresco utilizzando uno dei metodi:
1. ```
sudo systemctl start alfresco
```
2. ```
sudo ./alfresco.sh start
```
Assicurati di avviare i servizi nello stesso ordine in cui li hai arrestati.

Installazione su Ubuntu

Per iniziare a utilizzare ONLYOFFICE Docs con Alfresco, i seguenti passaggi devono essere eseguiti per Ubuntu 24.04:

Carica i pacchetti compilati *.amp nelle directory corrispondenti per la tua installazione di Alfresco:
- da onlyoffice-alfresco/repo/target/ a /usr/local/tomcat/amps/ per il repository Alfresco,
- da onlyoffice-alfresco/share/target/ a /usr/local/tomcat/amps_share/ per Share.

Puoi scaricare i file del pacchetto già compilati qui e posizionarli nelle rispettive directory.

Usa il Module Management Tool (MMT) per installare i moduli, esegui questi comandi:

Alfresco

java -jar /usr/local/tomcat/alfresco-mmt/alfresco-mmt.jar install /usr/local/tomcat/amps/onlyoffice-integration-repo.amp /usr/local/tomcat/webapps/alfresco

Share

java -jar /usr/local/tomcat/alfresco-mmt/alfresco-mmt.jar install /usr/local/tomcat/amps_share/onlyoffice-integration-share.amp /usr/local/tomcat/webapps/share

Maggiori dettagli sull'uso di MMT possono essere trovati nella guida all'installazione di Alfresco.

Assicurati che il Document Server possa inviare POST ad Alfresco.
Potrebbe essere necessario modificare queste righe in alfresco-global.properties o puoi impostarle tramite la pagina di configurazione:
```
    alfresco.host=<hostname>
    alfresco.port=443
    alfresco.protocol=https
    
    share.host=<hostname>
    share.port=443
    share.protocol=https
    
```

Riavvia Alfresco:

sudo ./alfresco.sh stop sudo ./alfresco.sh start

Il modulo può essere verificato negli strumenti amministrativi su /share/page/console/admin-console/module-package in Alfresco.

Compilazione del pacchetto modulo ONLYOFFICE Alfresco

Se intendi compilare il pacchetto modulo ONLYOFFICE Alfresco da solo (ad esempio, modificare il codice sorgente e compilarlo successivamente), segui questi passaggi:

È necessaria l'ultima versione stabile di Oracle Java per la compilazione riuscita. Se non è installata, utilizza i seguenti comandi per installare Oracle Java 8:
```
sudo apt-get update sudo apt-get install openjdk-8-jdk
```
Installa l'ultima versione di Maven. Il processo di installazione è descritto nella guida ufficiale di Maven.
Scarica il codice sorgente del pacchetto modulo ONLYOFFICE Alfresco:
```
git clone https://github.com/ONLYOFFICE/onlyoffice-alfresco.git
```
Ottieni un sottomodulo:
```
git submodule update --init --recursive
```
Compila i pacchetti nelle directory repo e share:
```
cd onlyoffice-alfresco && mvn clean install
```

Un altro modo per costruire il pacchetto modulo ONLYOFFICE Alfresco è utilizzare il file docker-compose.

Usa questo comando dalla directory del progetto:

docker-compose up

Configurazione del pacchetto modulo ONLYOFFICE e Alfresco

Vai alla Console di Amministrazione di Alfresco. Apri http://<alfrescohost>/alfresco/s/onlyoffice/onlyoffice-config e specifica i seguenti parametri.

impostazioni:

Indirizzo del Servizio di Modifica Documenti - specifica l'indirizzo URL dove è installato il Servizio di Modifica Documenti.
Importante L'indirizzo di ONLYOFFICE Docs deve essere accessibile da Alfresco, così come l'indirizzo di Alfresco deve essere accessibile da ONLYOFFICE Docs.
Chiave Segreta - specifica la chiave segreta utilizzata per firmare i dati.
A partire da ONLYOFFICE Docs v7.2, JWT è abilitato di default e la chiave segreta è generata automaticamente. Devi abilitarlo anche sul lato Alfresco: trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, quindi specifica la stessa chiave segreta nelle impostazioni del connettore. Per maggiori dettagli, vedi la sezione Abilitazione JWT per l'integrazione tra ONLYOFFICE e Alfresco di questo articolo.

Impostazioni avanzate del server:

Indirizzo del Servizio di Modifica Documenti per richieste interne dal server Alfresco - specifica l'indirizzo utilizzato per accedere al Servizio di Modifica Documenti dal server Alfresco.
Indirizzo del server Alfresco per richieste interne dal Servizio di Modifica Documenti - specifica l'indirizzo utilizzato per accedere al server Alfresco dal Servizio di Modifica Documenti.
Header di autorizzazione (lascia vuoto per utilizzare l'header predefinito) - L'header JWT di autorizzazione utilizzato in ONLYOFFICE è Authorization. Nel caso in cui questo header sia in conflitto con la tua configurazione, puoi cambiarlo con uno personalizzato.

Impostazioni comuni:

Ignora Certificato SSL - disattiva SSL.
Abilita Salvataggio Forzato - abilita il salvataggio delle modifiche ai documenti direttamente nello storage di Alfresco dopo aver cliccato il pulsante Salva (se disabilitato, il documento viene salvato nella cache dell'editor fino a quando non viene chiuso).
Salva docx, xlsx, pptx come nuova versione del file originale dopo la conversione - se disabilitato, verrà creato un file separato e posizionato nella stessa cartella.
Apri il file per la modifica - consente agli amministratori di scegliere i formati di documento da modificare tramite conversione in formati OOXML.
Dopo la chiusura dell'editor, salva il documento come versione minore - determina se le versioni dei documenti vengono salvate come versioni principali (2.0, 3.0) dopo la chiusura o come versioni minori (1.1, 1.2) durante la modifica, con 1.0 come documento iniziale vuoto.

Puoi anche aggiungere onlyoffice.url a alfresco-global.properties. La configurazione effettuata tramite la pagina delle impostazioni sovrascriverà alfresco-global.properties.

Come funziona

L'integrazione di ONLYOFFICE segue l'API documentata qui.

L'utente naviga verso un documento all'interno di Alfresco Share e seleziona l'opzione di menu Modifica in ONLYOFFICE.
Alfresco Share effettua una richiesta all'estremità del repository (URL del tipo: /parashift/onlyoffice/prepare?nodeRef={nodeRef}).
L'estremità del repository Alfresco prepara un oggetto JSON per Share con le seguenti proprietà:
- url - l'URL che ONLYOFFICE Docs utilizza per scaricare il documento (include il alf_ticket dell'utente corrente);
- callbackUrl - l'URL che ONLYOFFICE Docs informa sullo stato della modifica del documento;
- onlyofficeUrl - l'URL a cui il client deve rispondere a ONLYOFFICE Docs (fornito dalla proprietà onlyoffice.url);
- key - l'UUID+Timestamp Modificato per istruire ONLYOFFICE Docs se scaricare nuovamente il documento o meno;
- title - il titolo del documento (nome).
Alfresco Share prende questo oggetto e costruisce una pagina da un modello freemarker, riempiendo tutti quei valori in modo che il browser del client possa caricare l'editor.
Il browser del client effettua una richiesta alla libreria JavaScript di ONLYOFFICE Docs e invia a ONLYOFFICE Docs la configurazione DocEditor con le proprietà sopra.
Quindi ONLYOFFICE Docs scarica il documento da Alfresco e l'utente inizia a modificarlo.
ONLYOFFICE Docs invia una richiesta POST a callbackUrl per informare Alfresco che un utente sta modificando il documento.
Alfresco blocca il documento, ma consente comunque ad altri utenti con accesso in scrittura di collaborare in tempo reale con ONLYOFFICE Docs lasciando l'Azione presente.
Quando tutti gli utenti e i browser client hanno terminato la modifica, chiudono la finestra di modifica.
Dopo 10 secondi di inattività, ONLYOFFICE Docs invia un POST a callbackUrl informando Alfresco che i client hanno terminato la modifica del documento e l'hanno chiuso.
Alfresco scarica una nuova versione del documento, sostituendo quella vecchia.

Abilitazione JWT per l'integrazione tra ONLYOFFICE e Alfresco

Per proteggere i documenti da accessi non autorizzati, gli editor di ONLYOFFICE utilizzano il JSON Web Token (JWT). Il token viene aggiunto nella configurazione quando l'Editor di Documenti viene inizializzato e durante lo scambio di comandi tra i servizi interni di ONLYOFFICE Docs. La chiave segreta viene utilizzata per firmare il token web JSON e convalidare il token alla richiesta a ONLYOFFICE Docs.

A partire da ONLYOFFICE Docs v7.2, JWT è abilitato di default e la chiave segreta è generata automaticamente. Devi trovare la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, quindi specificare la stessa chiave segreta nelle impostazioni del connettore.

Passo 1: Trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs

Apri il file local.json con qualsiasi editor di testo disponibile.
- Per Linux - /etc/onlyoffice/documentserver/local.json
- Per Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
- Per Docker - entra nel container ONLYOFFICE Docs utilizzando il docker exec -it <containerID> bash comando e apri /etc/onlyoffice/documentserver/local.json
  In alternativa, puoi utilizzare il seguente comando per trovare la chiave segreta predefinita senza aprire local.json:
```
sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'
```
Il file local.json dovrebbe apparire così:
```
{"services": {"CoAuthoring": {"token": {"enable": {"request": {"inbox": true,"outbox": true},"browser": true}},"secret": {"inbox": {"string": "yoursecret"},"outbox": {"string": "yoursecret"},"session": {"string": "yoursecret"}}}}}
```
Il valore true è specificato in tre sezioni. Significa che la convalida del token è abilitata.
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox
La chiave segreta generata automaticamente è specificata in tre sezioni. Puoi sostituire il valore segreto predefinito con la tua chiave segreta. La chiave segreta deve essere la stessa in tre sezioni.
- services.CoAuthoring.secret.inbox.string
- services.CoAuthoring.secret.outbox.string
- services.CoAuthoring.secret.session.string
Se apporti modifiche, salvale e riavvia i servizi affinché le modifiche alla configurazione abbiano effetto.
```
supervisorctl restart all
```

Passo 2: Specifica la stessa chiave segreta nelle impostazioni del connettore

Nelle impostazioni del connettore, specifica lo stesso segreto nel campo Chiave segreta e salva le impostazioni.

Connessione ai demo di ONLYOFFICE Docs

A partire dalla versione 5.0.0 del connettore ONLYOFFICE, puoi provare gli editor online di ONLYOFFICE all'interno di Alfresco senza installare ONLYOFFICE Docs.

Per attivare la connessione, fai clic sulla casella di controllo Connetti al demo del Document Server di ONLYOFFICE e fai clic sul pulsante Salva.

ImportanteQuesto è un server di test pubblico che sarà disponibile per un periodo di 30 giorni. Non condividere i tuoi dati sensibili lì.

Inizia a utilizzare ONLYOFFICE Docs all'interno di Alfresco

Per creare un documento:

Apri la cartella in cui desideri creare un documento.
Fai clic sul pulsante Crea....
Scegli il tipo di file che desideri creare: Documento, Foglio di calcolo o Presentazione.

Per modificare o visualizzare un documento:

Trova il documento richiesto.
Fai clic sul pulsante Modifica in ONLYOFFICE.

Per convertire un documento non-XML in formato XML (DOCX, XLSX o PPTX):

Trova il documento richiesto.
Fai clic sul pulsante Converti usando ONLYOFFICE.

Il documento verrà automaticamente convertito nel suo analogo XML. I file risultanti sono posizionati nella stessa cartella. Puoi anche configurare regole di conversione automatica per una cartella. Per ulteriori informazioni sulla configurazione delle regole, leggi la documentazione ufficiale di Alfresco.

Per scaricare il file in un formato preferito:

Trova il file richiesto.
Fai clic sul pulsante Scarica come... e scegli il formato di cui hai bisogno.

Per vedere la cronologia delle modifiche del file:

Fai clic sul nome del file o sulla sua icona per aprire la scheda dei dettagli del file.
Trova la scheda Cronologia Versioni nel pannello di destra.
Le sezioni disponibili sono: Ultima Versione e Versioni Precedenti. Le modifiche apportate al file saranno evidenziate.
Per caricare una nuova versione, fai clic sull'icona corrispondente nell'angolo in alto a destra.
Per vedere rapidamente la versione corrente del file, passa il puntatore del mouse sul file. Il numero della versione verrà visualizzato a destra del nome del file, ad esempio .

properties

Vai alla scheda File nell'editor.
Scegli l'opzione Cronologia Versioni nel menu.

Per creare un nuovo file direttamente nell'Editor di Documenti:

Apri la scheda File.
Fai clic sull'opzione Crea Nuovo.

Un nuovo file .docx verrà aperto in una nuova scheda.

Per creare modelli personalizzati:

Accedi al tuo portale Alfresco come amministratore che lo ha creato.
Vai a I miei file -> Dizionario Dati -> Modelli Nodo.
Aggiungi modelli personalizzati nei formati disponibili: .docx, .xlsx, .pptx.

Per creare documenti da modelli:

Apri la cartella in cui desideri creare un documento.
Fai clic sul pulsante Crea....
Seleziona l'opzione Crea documento da modello e scegli uno dei modelli disponibili.
o

Nell'editor, vai alla scheda File.
Fai clic sull'opzione Crea Nuovo....
Scegli il modello richiesto.

Per imparare come confrontare i file dallo storage, segui le istruzioni di questo articolo.

Per imparare come utilizzare la stampa unione dallo storage, segui le istruzioni di questo articolo.

Per imparare come inserire immagini dallo storage, segui le istruzioni di questo articolo.

Per imparare come contrassegnare il documento come preferito direttamente nell'Editor di Documenti, segui le istruzioni di questo articolo.

Per saperne di più sui problemi più comuni e sui modi per risolverli, visita la nostra guida alla risoluzione dei problemi.

Ospita ONLYOFFICE Docs sul tuo server o usalo nel cloud

Ottienilo ora Usalo nel cloud