Passa al contenuto principale

Alfresco Content App

Informazioni sull'integrazione di ONLYOFFICE e Alfresco Content App​

ONLYOFFICE offre un'integrazione ufficiale per portare la modifica e la collaborazione sui documenti direttamente in Alfresco Content App (ACA), la moderna interfaccia basata su Angular per Alfresco Content Services. Puoi scaricare il pacchetto di integrazione dal registro npm o dalla pagina GitHub di ONLYOFFICE.

note

Questa integrazione è destinata specificamente ad Alfresco Content App. Se utilizzi Alfresco Share, consulta invece l'articolo Connettore ONLYOFFICE per Alfresco Share.

Caratteristiche principali​

  • Creazione, modifica e visualizzazione di documenti di testo, fogli di calcolo e presentazioni.
  • Creazione e compilazione di moduli PDF compilabili.
  • Co-editing dei documenti in tempo reale: due modalità di co-editing (Veloce e Rigorosa), la modalità Revisioni, i commenti e la chat integrata.
  • Monitoraggio della cronologia delle versioni del documento direttamente dall'interfaccia dell'editor.
  • Conversione dei file nei formati OOXML ed esportazione in vari formati.
  • Gestione delle autorizzazioni dei documenti nell'interfaccia di modifica.
  • Azioni avanzate dell'editor: inserimento di immagini da Alfresco, allegato di file per la stampa unione, selezione di documenti da confrontare, utilizzo di plugin, inserimento di dati da collegamenti esterni, navigazione alla cartella del file corrente e creazione di nuovi documenti dall'editor.
  • Supporto JWT per proteggere il traffico in modo che nessuno possa accedere ai tuoi documenti, tranne gli utenti con i diritti appropriati.

Formati supportati​

  • Per la modifica: DOCX, XLSX, PPTX
  • Per la visualizzazione: DOCX, XLSX, PPTX, PDF e altri formati di Office
  • Per la creazione: DOCX, XLSX, PPTX, moduli PDF
  • Per la conversione: formati di Office in OOXML
  • Per l'esportazione: vari formati a seconda della configurazione del backend
note

L'elenco esatto dei formati disponibili per modifica, visualizzazione, conversione ed esportazione può variare in base alla versione installata e alla configurazione del backend.

Novità della versione 1.0.0​

Rilascio iniziale dell'integrazione di ONLYOFFICE per Alfresco Content App.

Il registro completo delle modifiche è disponibile qui.

Connessione di ONLYOFFICE Docs ad Alfresco Content App​

Requisiti​

  • Alfresco Content Services — il backend del repository Alfresco.

  • Alfresco Content App (ACA) — l'applicazione Angular host.

  • ONLYOFFICE Docs (versione server o cloud) risolvibile e raggiungibile sia da ACA sia da qualsiasi client finale.

    Consulta la pagina di documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.

  • Pacchetto del modulo ONLYOFFICE per Alfresco versione 8.3.0 o successiva.

  • Integrazione ONLYOFFICE per Alfresco Content App v1.0.0 o successiva.

Installazione dell'integrazione ONLYOFFICE per Alfresco Content App​

  1. Installa il pacchetto dell'estensione:

    npm install @onlyoffice/alfresco-extension

  2. Registra l'estensione nel tuo progetto ACA.

  3. Avvia l'applicazione:

    npm run start

Per istruzioni dettagliate sull'installazione e sulla configurazione, consulta la documentazione del progetto.

Abilitazione di JWT per l'integrazione di ONLYOFFICE e Alfresco Content App​

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

A partire da ONLYOFFICE Docs v7.2, JWT è abilitato per impostazione predefinita e la chiave segreta viene generata automaticamente. Devi trovare la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs e poi specificare la stessa chiave segreta nelle impostazioni dell'integrazione.

Passaggio 1: trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs

  1. 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 — accedi al contenitore di ONLYOFFICE Docs con il comando docker exec -it <containerID> bash e apri /etc/onlyoffice/documentserver/local.json

    Il file local.json dovrebbe avere questo aspetto:

    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }

  2. Il valore true è specificato in tre sezioni, il che significa che la convalida del token è abilitata:

    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox

  3. La chiave segreta generata automaticamente è specificata in tre sezioni. Puoi sostituire il valore segreto predefinito con uno tuo. La chiave segreta deve essere la stessa in tutte e tre le sezioni:

    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string

  4. Se apporti modifiche, salvale e riavvia i servizi affinché le modifiche alla configurazione abbiano effetto:

    supervisorctl restart all

Passaggio 2: specifica la stessa chiave segreta nelle impostazioni dell'integrazione

Nelle impostazioni dell'integrazione, specifica la stessa chiave segreta nel campo Chiave segreta e salva le impostazioni.

Iniziare a usare ONLYOFFICE Docs in Alfresco Content App​

Dopo l'installazione, nuove azioni di ONLYOFFICE diventano disponibili direttamente nell'interfaccia di Alfresco Content App.

Per modificare un documento:

  1. Fai clic con il pulsante destro del mouse su un file supportato nell'interfaccia ACA.
  2. Scegli Modifica in ONLYOFFICE per aprire il file nell'editor.

Per visualizzare un documento:

  1. Fai clic con il pulsante destro del mouse sul file.
  2. Scegli Visualizza in ONLYOFFICE per aprire un'anteprima di sola lettura senza scaricare il file.

Per creare un nuovo file:

  1. Utilizza l'opzione Crea in ONLYOFFICE nell'interfaccia ACA.
  2. Seleziona il tipo di file che vuoi creare: Documento, Foglio di calcolo, Presentazione o Modulo PDF.
  3. Il nuovo file si aprirà immediatamente per la modifica.

Per convertire un file nel formato OOXML:

  1. Seleziona il file in ACA.
  2. Fai clic su Converti in ONLYOFFICE.

Per esportare un file in un formato diverso:

  1. Seleziona il file in ACA.
  2. Utilizza Scarica come e scegli il formato desiderato senza uscire da Alfresco Content App.

Per saperne di più sui moduli, leggi gli articoli corrispondenti sulla creazione e sulla compilazione dei moduli.