Alfresco

Glavne funkcije

• Kreiranje, uređivanje i pregledanje tekstualnih dokumenata, tabela i prezentacija.
• Konvertovanje fajlova.
• Ko-uređivanje dokumenata u realnom vremenu: dva režima ko-uređivanja (Brzi i Strogi), režim Praćenje promena, komentari i ugrađeni chat.
• Podrška za JWT za osiguranje vašeg saobraćaja kako niko ne bi mogao pristupiti vašim dokumentima osim korisnika sa odgovarajućim pravima.

Podržani formati

• Za kreiranje, uređivanje i pregledanje: DOCX, PPTX, XLSX
• Za rad sa obrascima: PDF
• Za konverziju: ODT, ODP, ODS, DOC, XLS, PPT, RTF
• Za uređivanje putem konverzije u OOXML: ODP, ODS, ODT, RTF, CSV, TXT
• Samo za pregledanje: PDF

Šta je novo u verziji 8.1.0

Dodato

• Dodata podrška za događaje u editoru: onRequestReferenceData, onRequestReferenceSource, onRequestOpen

Izmenjeno

• Ispravljen bug sa postavkom Ignoriši SSL sertifikat

Kompletan changelog je dostupan ovde.

Zahtevi

• ONLYOFFICE Document Server v7.1 (server ili cloud verzija) ili novija

  Potrebna vam je instanca ONLYOFFICE Docs koja je dostupna i povezana kako sa Alfresco, tako i sa svim krajnjim klijentima. Mora biti u mogućnosti da direktno POST-uje na Alfresco.

  Molimo vas da se obratite zvaničnoj stranici dokumentacije da saznate više o instalaciji ONLYOFFICE Docs.
• Alfresco v.7.4, 23, 25
• ONLYOFFICE Connector 7.0.0 za Alfresco

Kompilacija ONLYOFFICE Alfresco modula

Ako planirate da sami kompajlirate ONLYOFFICE Alfresco modul (npr. izmenite izvorni kod i zatim ga kompajlirate), sledite ove korake:

1. Najnovija stabilna verzija Oracle Java je neophodna za uspešnu izgradnju. Ako nije instalirana, koristite sledeće komande za instalaciju Oracle Java 8:

   sudo apt-get update 
                                sudo apt-get install openjdk-8-jdk

2. Instalirajte najnoviji Maven. Proces instalacije je opisan u zvaničnom Maven vodiču.
3. Preuzmite izvorni kod ONLYOFFICE Alfresco modula:

   git clone https://github.com/ONLYOFFICE/onlyoffice-alfresco.git

4. Preuzmite podmodul:

   git submodule update --init --recursive

5. Kompajlirajte pakete u repo i share direktorijumima:

   cd onlyoffice-alfresco && mvn clean install

Drugi način za izgradnju ONLYOFFICE Alfresco modula je korišćenjem docker-compose fajla.

Koristite ovu komandu iz projektne direktorijuma:

docker-compose up

Konfiguracija ONLYOFFICE i Alfresco modula

Idite na Alfresco Administration Console. Otvorite http://<alfrescohost>/alfresco/s/onlyoffice/onlyoffice-config i navedite sledeće parametre.

podešavanja:

• Adresa servisa za uređivanje dokumenata - navedite URL adresu gde je instaliran servis za uređivanje dokumenata.
  Važno Adresa ONLYOFFICE Docs mora biti dostupna iz Alfresco, kao i adresa Alfresco mora biti dostupna iz ONLYOFFICE Docs.
• Tajni ključ - navedite tajni ključ koji se koristi za potpisivanje podataka.
  Počevši od ONLYOFFICE Docs v7.2, JWT je podrazumevano omogućen i tajni ključ se automatski generiše. Potrebno je da ga omogućite i na strani Alfresco: pronađite vaš tajni ključ u konfiguracionom fajlu ONLYOFFICE Docs, a zatim navedite isti tajni ključ u postavkama konektora. Za više detalja, pogledajte odeljak Omogućavanje JWT za integraciju ONLYOFFICE i Alfresco ovog članka.

Napredna podešavanja servera:

• Adresa servisa za uređivanje dokumenata za interne zahteve sa Alfresco servera - navedite adresu koja se koristi za pristup servisu za uređivanje dokumenata sa Alfresco servera.
• Adresa Alfresco servera za interne zahteve sa servisa za uređivanje dokumenata - navedite adresu koja se koristi za pristup Alfresco serveru sa servisa za uređivanje dokumenata.
• Authorization header (ostavite prazno da biste koristili podrazumevani header) - Authorization JWT header koji se koristi u ONLYOFFICE je Authorization. Ako je ovaj header u sukobu sa vašim podešavanjima, možete ga promeniti u prilagođeni header.

Opšta podešavanja:

• Ignoriši SSL sertifikat - isključuje SSL.
• Omogući Force Save - omogućava čuvanje izmena dokumenta direktno u Alfresco skladište nakon klika na dugme Save (ako je onemogućeno, dokument se čuva u kešu uređivača dokumenata dok se dokument ne zatvori).
• Sačuvaj docx, xlsx, pptx kao novu verziju originalnog fajla nakon konverzije - ako je onemogućeno, kreiraće se poseban fajl i postaviti u isti folder.
• Otvori fajl za uređivanje - omogućava administratorima da izaberu formate dokumenata za uređivanje putem konverzije u OOXML formate.
• Nakon zatvaranja uređivača, sačuvaj dokument kao manju verziju - određuje da li se verzije dokumenata čuvaju kao glavne verzije (2.0, 3.0) nakon zatvaranja ili kao manje verzije (1.1, 1.2) tokom uređivanja, sa 1.0 kao početnim praznim dokumentom.

Kako funkcioniše

Integracija ONLYOFFICE prati API dokumentovan ovde.

1. Korisnik se kreće do dokumenta unutar Alfresco Share i bira opciju Uredi u ONLYOFFICE iz menija.
2. Alfresco Share šalje zahtev ka repo kraju (URL u formi: /parashift/onlyoffice/prepare?nodeRef={nodeRef}).
3. Alfresco Repo kraj priprema JSON objekat za Share sa sledećim svojstvima:
   • url - URL koji ONLYOFFICE Docs koristi za preuzimanje dokumenta (uključuje alf_ticket trenutnog korisnika);
   • callbackUrl - URL koji ONLYOFFICE Docs koristi da obavesti o statusu uređivanja dokumenta;
   • onlyofficeUrl - URL na koji klijent treba da odgovori ONLYOFFICE Docs (obezbeđen putem onlyoffice.url svojstva);
   • key - UUID+Modified Timestamp koji upućuje ONLYOFFICE Docs da li da ponovo preuzme dokument ili ne;
   • title - naslov dokumenta (ime).
4. Alfresco Share uzima ovaj objekat i konstruira stranicu iz freemarker šablona, popunjavajući sve te vrednosti kako bi klijent pretraživač mogao da učita uređivač.
5. Klijent pretraživač šalje zahtev ka JavaScript biblioteci iz ONLYOFFICE Docs i šalje ONLYOFFICE Docs konfiguraciju DocEditor sa gore navedenim svojstvima.
6. Zatim ONLYOFFICE Docs preuzima dokument iz Alfresco i korisnik počinje sa uređivanjem.
7. ONLYOFFICE Docs šalje POST zahtev na callbackUrl kako bi obavestio Alfresco da korisnik uređuje dokument.
8. Alfresco zaključava dokument, ali i dalje omogućava drugim korisnicima sa pravom pisanja da sarađuju u realnom vremenu sa ONLYOFFICE Docs ostavljajući Akciju prisutnom.
9. Kada svi korisnici i klijentski pretraživači završe sa uređivanjem, zatvaraju prozor za uređivanje.
10. Nakon 10 sekundi neaktivnosti, ONLYOFFICE Docs šalje POST na callbackUrl obaveštavajući Alfresco da su klijenti završili sa uređivanjem dokumenta i zatvorili ga.
11. Alfresco preuzima novu verziju dokumenta, zamenjujući staru.

Omogućavanje JWT za integraciju ONLYOFFICE i Alfresco

Da bi zaštitili dokumente od neovlašćenog pristupa, ONLYOFFICE uređivači koriste JSON Web Token (JWT). Token se dodaje u konfiguraciju kada se inicijalizuje Document Editor i tokom razmene komandi između unutrašnjih ONLYOFFICE Docs servisa. Tajni ključ se koristi za potpisivanje JSON web tokena i validaciju tokena prilikom zahteva ka ONLYOFFICE Docs.

Počevši od ONLYOFFICE Docs v7.2, JWT je podrazumevano omogućen i tajni ključ se automatski generiše. Potrebno je da pronađete vaš tajni ključ u konfiguracionom fajlu ONLYOFFICE Docs, a zatim navedete isti tajni ključ u postavkama konektora.

Korak 1: Pronađite vaš tajni ključ u konfiguracionom fajlu ONLYOFFICE Docs

1. Otvorite local.json fajl sa bilo kojim dostupnim tekstualnim uređivačem.
   • Za Linux - /etc/onlyoffice/documentserver/local.json
   • Za Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Za Docker - uđite u ONLYOFFICE Docs kontejner koristeći docker exec -it <containerID> bash komandu i otvorite /etc/onlyoffice/documentserver/local.json ``````html

     Alternativno, možete koristiti sledeću komandu da pronađete podrazumevani tajni ključ bez otvaranja local.json:

     sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

   Datoteka local.json treba da izgleda ovako:

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

2. Vrednost true je navedena u tri sekcije. To znači da je validacija tokena omogućena.
   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox
3. Automatski generisani tajni ključ je naveden u tri sekcije. Možete zameniti podrazumevanu tajnu vrednost svojim tajnim ključem. Tajni ključ mora biti isti u sve tri sekcije.
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string
4. Ako napravite izmene, sačuvajte ih i restartujte servise kako bi promene u konfiguraciji stupile na snagu.

   supervisorctl restart all

Korak 2: Navedite isti tajni ključ u postavkama konektora

U postavkama konektora, navedite isti tajni ključ u polju Tajni ključ i sačuvajte postavke.