ownCloud

Glavne funkcije

• Kreiranje, uređivanje i pregledanje dokumenata, tabela i prezentacija.
• Deljenje fajlova sa različitim dozvolama — pregledanje/uređivanje, pregled, popunjavanje formulara i komentarisanje sa pominjanjem korisnika. Takođe je moguće ograničiti preuzimanje (u svim editorima) i menjanje filtera (u tabelama). Dostupno je i deljenje putem javnih linkova.
• Ko-uređivanje dokumenata u realnom vremenu: dva režima ko-uređivanja (Brzi i Strogi), Praćenje promena, komentari i ugrađeni chat.
• Ko-uređivanje između nekoliko federisanih ownCloud instanci povezanih na jedan Document Server.
• JWT podrška za osiguranje vašeg saobraćaja tako da niko, osim korisnika sa odgovarajućim pravima, ne može pristupiti vašim dokumentima.

Podržani formati

• Za uređivanje: DOCM, DOCX, DOTM, DOTX, XLSB, XLSM, XLSX, XLTM, XLTX, POTM, POTX, PPSM, PPSX, PPTM, PPTX, PDF
• Za pregledanje:
  • WORD: DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTM, HTML, HWP, HWPX, MD, MHT, MHTML, ODT, OTT, PAGES, RTF, STW, SXW, TXT, WPS, WPT, XML
  • CELL: CSV, ET, ETT, FODS, NUMBERS, ODS, OTS, SXC, XLS, XLSM, XLSX, XLT, XLTM, XLTX
  • SLIDE: DPS, DPT, FODP, KEY, ODG, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, SXI
  • PDF: DJVU, DOCXF, OFORM, OXPS, PDF, XPS
  • DIAGRAM: VSDM, VSDX, VSSM, VSSX, VSTM, VSTX
• Za konvertovanje u Office Open XML formate koristeći opciju Convert with ONLYOFFICE: DOC, DOCM, DOT, DOTX, EPUB, HTM, HTML, ODP, ODT, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, RTF, XLS, XLSM, XLT, XLTM, XLTX.
  ODT, ODS i ODP su takođe dostupni za trenutnu konverziju. Nakon što omogućite odgovarajuću opciju u administratorskim podešavanjima, dokumenti u ODF formatu se odmah konvertuju u editoru i otvaraju nakon što kliknete na njih.

Šta je novo u verziji 9.12.1

Dodato

• Opis dodatka i korisni linkovi u administratorskim podešavanjima

Izmenjeno

• Ispravljeno otvaranje deljenog linka kada je grupni pristup aplikaciji ograničen
• Zamenjena opšta poruka Uspešno sačuvano sa posebnim porukama za svaku sekciju podešavanja
• Promenjena boja dugmeta za čuvanje podešavanja u primarnu
• Prikazivanje modalnog prozora za potvrdu pre brisanja metapodataka verzije
• Preuzimanje svih stranica dokumenta prilikom konverzije u tipove slika metodom Preuzmi kao

Kompletan changelog je dostupan ovde.

Zahtevi

• ONLYOFFICE Document Server v7.0 (server ili cloud verzija) ili noviji

  Potrebna vam je instanca ONLYOFFICE Docs koja je dostupna i povezana kako sa ownCloud, tako i sa bilo kojim krajnjim klijentima. ONLYOFFICE Docs mora biti u mogućnosti da direktno šalje POST zahteve ka ownCloud.

  Počevši od verzije 4.3.0, ONLYOFFICE Docs i ownCloud mogu biti instalirani ili na različitim računarima ili na istoj mašini. U slučaju da odaberete ovu drugu opciju, moraćete da podesite prilagođeni port za ONLYOFFICE Docs, jer po defaultu i ONLYOFFICE Docs i ownCloud rade na portu 80.

  Molimo vas da se obratite zvaničnoj stranici dokumentacije kako biste saznali više o instalaciji ONLYOFFICE Docs.
• ownCloud v10.0.0 i noviji
• ONLYOFFICE Connector v8.2.3 i noviji za ownCloud

Instalacija ONLYOFFICE konektora za ownCloud

Administrator ownCloud-a može instalirati integracionu aplikaciju iz ugrađenog tržišta aplikacija. Da biste to učinili, pratite sledeće korake:

1. Kliknite na meni u gornjem levom uglu.
2. Izaberite Market.
3. Idite na kategoriju Tools.
4. Pronađite ONLYOFFICE na listi dostupnih aplikacija.
5. Kliknite na dugme Install.

Alternativno, administrator može instalirati aplikaciju ručno:

1. Nabavite ONLYOFFICE aplikaciju za ownCloud. Postoji nekoliko načina da to uradite:
   • Preuzmite najnoviju potpisanu verziju iz zvanične ownCloud prodavnice.
   • Ili možete preuzeti najnoviju potpisanu verziju sa stranice izdanja aplikacije na GitHub-u. Na primer:

     tar -xvzf vX.X.X.tar.gz

     Gde je vX.X.X potrebna verzija konektora.

     Raspakujte arhivu:

     tar -xvzf vX.X.X.tar.gz

     Preimenujte folder u onlyoffice:

     mv onlyoffice-owncloud-X.X.X onlyoffice

   • Ili možete klonirati izvorni kod aplikacije i sami ga kompajlirati:

     git clone https://github.com/ONLYOFFICE/onlyoffice-owncloud.git onlyoffice
         cd onlyoffice
         git submodule update --init --recursive

   ownCloud ne radi sa nepotpisanim aplikacijama i prikazuje poruku upozorenja, tako da ćete morati koristiti opciju a ili b da biste dobili aplikaciju za vaše produkciono okruženje.
2. Premestite folder onlyoffice na ownCloud server u direktorijum apps/ (ili neki drugi direktorijum koristi za povezivanje aplikacija):

   cp -r /root/onlyoffice/ /var/www/owncloud/apps/

3. Idite u direktorijum apps/:

   cd /var/www/owncloud/apps

4. Promenite vlasnika kako biste ažurirali aplikaciju direktno iz ownCloud web interfejsa:

   chown -R www-data:www-data onlyoffice

5. U ownCloud-u, idite na Settings > Admin > Apps, kliknite Show disabled apps i kliknite Enable za ONLYOFFICE aplikaciju.

Konfigurisanje ONLYOFFICE konektora za ownCloud

Da biste konfigurisali postavke ONLYOFFICE aplikacije, idite na Settings > Admin > Additional.

U sekciji Server settings, navedite sledeće opcije:

• Adresa ONLYOFFICE Docs - navedite URL adresu gde je instaliran Document Editing Service. Ovo polje je obavezno. Ako instalirate ONLYOFFICE Docs na prilagođenom portu, morate navesti port, npr.: http://127.0.0.1:8081/
  Adresa ONLYOFFICE Docs mora biti dostupna sa ownCloud, kao i adresa ownCloud mora biti dostupna sa ONLYOFFICE Docs.
• Onemogući verifikaciju sertifikata (nesigurno) - označite ovu opciju da biste onemogućili verifikaciju sertifikata i omogućili ownCloud da uspostavi vezu sa ONLYOFFICE Docs ako koristite samopotpisani sertifikat za vaš ONLYOFFICE Docs (inače, ownCloud neće validirati samopotpisani sertifikat i neće dozvoliti vezu sa/od ONLYOFFICE Docs). Ovo je nesigurno rešenje i snažno preporučujemo da zamenite sertifikat onim koji je izdao neki CA.
• Tajni ključ ``````html - navedite tajnu koja 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 ownCloud strani: pronađite svoj tajni ključ u konfiguracionoj datoteci ONLYOFFICE Docs, zatim navedite isti tajni ključ u podešavanjima konektora. Za više detalja, pogledajte odeljak Omogućavanje JWT za integraciju ONLYOFFICE i ownCloud u ovom članku.
• Sekcija Napredna podešavanja servera može se koristiti ako vaša mrežna konfiguracija ne dozvoljava zahteve između instaliranih ownCloud i ONLYOFFICE Docs koristeći javne adrese. U tom slučaju, navedite adrese za interne zahteve u odgovarajućim poljima:
  • U polju Adresa ONLYOFFICE Docs za interne zahteve sa servera, navedite adresu koja se koristi za pristup Servisu za uređivanje dokumenata iz ownCloud-a.
  • U polju Adresa servera za interne zahteve iz ONLYOFFICE Docs, navedite adresu koja se koristi za pristup ownCloud-u iz Servisa za uređivanje dokumenata.

Kliknite na dugme Sačuvaj. Nakon čuvanja Podešavanja servera, pojaviće se sekcije Opšta podešavanja, Podešavanja prilagođavanja editora i Opšti šabloni.

U sekciji Opšta podešavanja, možete navesti sledeće opcije:

• Ograniči pristup editorima za sledeće grupe - označite ovu opciju i izaberite korisničke grupe kojima neće biti dozvoljeno korišćenje ONLYOFFICE editora u ownCloud-u.
• Koristi ONLYOFFICE za generisanje pregleda dokumenta - označite ovu opciju za generisanje sličica putem ONLYOFFICE-a. Ovo će zauzeti deo prostora na disku.
• Otvori datoteku u istom tabu - označite ovu opciju da biste otvorili datoteku u trenutnom tabu pretraživača. Ako ova opcija nije označena, datoteka će se otvoriti u novom tabu pretraživača.
• Zadrži metapodatke za svaku verziju nakon uređivanja dokumenta funkcija omogućava zadržavanje metapodataka i prikazivanje promena za svaku verziju dokumenta u istoriji verzija. Ovo će zauzeti deo prostora na disku. Možete koristiti dugme Obriši da uklonite metapodatke i oslobodite prostor na disku.
• Podrazumevana aplikacija za otvaranje formata - omogućava vam da označite formate koje želite povezati sa ONLYOFFICE editorima. Formati docx, xlsx i pptx su podrazumevano odabrani.
  Otvaranje u ONLYOFFICE editorima će se izvršavati samo za formate odabrane u ovoj sekciji.
• Otvori datoteku za uređivanje - omogućava administratorima da izaberu formate dokumenata za uređivanje putem konverzije u OOXML formate. Formati csv i txt su podrazumevano odabrani.
  VažnoZbog ograničenja formata, neki podaci mogu biti izgubljeni prilikom čuvanja u formate sa liste (csv, odp, ods, odt, rtf, txt).

  Nakon što omogućite odgovarajuću opciju, dokumenti u navedenim formatima će biti odmah konvertovani i otvoreni u ONLYOFFICE editoru za uređivanje nakon klika na njih i odabira stavke Otvori u ONLYOFFICE menija. Ako format nije označen, datoteka će biti otvorena za pregled.

U sekciji Podešavanja prilagođavanja editora, možete navesti sledeće opcije:

• Zadrži međuverzije prilikom uređivanja (forcesave) funkcija omogućava da pošaljete sve promene direktno u skladište kada kliknete na dugme Sačuvaj u interfejsu ONLYOFFICE editora ako želite da sprečite gubitak podataka. Kada je ova opcija onemogućena, vaše promene se automatski čuvaju u kešu editora.
• Izaberite elemente interfejsa editora koje želite sakriti / prikazati (Chat, Kompaktnija zaglavlje, Povratne informacije i podrška, Pomoć, Monohromatska traka sa alatkama).
• Režim pregleda za prikaz funkcija omogućava postavljanje podrazumevanog režima prikaza pregleda dokumenta:
  • Označeno - za isticanje predloženih promena,
  • Konačno - za prikaz sa primenjenim promenama,
  • Originalno - za prikaz originalnog dokumenta bez ikakvih promena.

Nakon što napravite izmene u Opšta podešavanja i/ili Podešavanja prilagođavanja editora, kliknite na dugme Sačuvaj koje se nalazi ispod da biste sačuvali izmene.

U sekciji Opšti šabloni, možete kliknuti na ikonu i učitati docx, xlsx ili pptx šablone za kreiranje novih dokumenata.

Možete preuzeti ili obrisati šablon sa ove liste koristeći odgovarajuće ikone.

Nakon dodavanja šablona u administratorskim podešavanjima, korisnici će moći da izaberu šablon prilikom kreiranja novog dokumenta koristeći dugme dodaj u interfejsu ownCloud-a ili putem menija Datoteka > Kreiraj novo u interfejsu ONLYOFFICE editora.

Provera veze

Možete proveriti vezu sa ONLYOFFICE Docs koristeći sledeću occ komandu:

occ onlyoffice:documentserver --check

Videćete tekst, bilo sa informacijama o uspešnoj vezi ili uzrokom greške.

Kako funkcioniše

Integracija ONLYOFFICE-a prati API dokumentovan ovde.

1. Kada kreira novu datoteku, korisnik odlazi u folder sa dokumentima unutar ownCloud-a i klikne na stavku Dokument, Tabela ili Prezentacija u meniju novo (+).
2. Pretraživač poziva metodu create u kontroleru /lib/Controller/EditorController.php. Ova metoda dodaje kopiju datoteke iz foldera assets u folder u kojem se korisnik trenutno nalazi.
3. Kada otvara postojeću datoteku, korisnik odlazi do nje unutar ownCloud-a i bira opciju menija Otvori u ONLYOFFICE.
4. Otvara se novi tab u pretraživaču i poziva se metoda index kontrolera /lib/Controller/EditorController.php.
5. Aplikacija priprema JSON objekat sa sledećim svojstvima:
   • url - URL koji ONLYOFFICE Docs koristi za preuzimanje dokumenta;
   • callbackUrl - URL koji ONLYOFFICE Docs koristi za obaveštavanje o statusu uređivanja dokumenta;
   • documentServerUrl - URL na koji klijent treba da odgovori ONLYOFFICE Document Server-u (može se postaviti na stranici sa administratorskim podešavanjima);
   • key - UUID+Modified Timestamp za instrukciju ONLYOFFICE Docs da li da ponovo preuzme dokument ili ne.
6. ownCloud uzima ovaj objekat i konstruira stranicu iz šablona templates/editor.php, popunjavajući sve potrebne vrednosti kako bi klijentski pretraživač uspešno učitao editor.
7. Klijentski pretraživač šalje zahtev JavaScript biblioteci iz ONLYOFFICE Docs i šalje ONLYOFFICE Docs konfiguraciju DocEditor-a sa gore navedenim svojstvima.
8. Zatim ONLYOFFICE Docs preuzima dokument iz ownCloud-a i korisnik započinje uređivanje.
9. ONLYOFFICE Docs šalje POST zahtev na callbackUrl da obavesti ownCloud da korisnik uređuje dokument.
10. Kada svi korisnici i klijentski pretraživači završe sa uređivanjem, zatvaraju prozor za uređivanje.
11. Nakon 10 sekundi neaktivnosti, ONLYOFFICE Docs šalje POST na callbackUrl obaveštavajući ownCloud da su klijenti završili sa uređivanjem dokumenta i zatvorili ga.
12. ownCloud preuzima novu verziju dokumenta, zamenjujući staru.

Omogućavanje JWT za integraciju ONLYOFFICE i ownCloud

Da bi zaštitili dokumente od neovlašćenog pristupa, ONLYOFFICE editori koriste JSON Web Token (JWT). Token se dodaje u konfiguraciju kada se inicijalizuje Document Editor i tokom razmene komandi između unutrašnjih servisa ONLYOFFICE Docs. 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 svoj tajni ključ u konfiguracionoj datoteci ONLYOFFICE Docs ``````html , zatim navedite isti tajni ključ u postavkama konektora.

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

1. Otvorite fajl local.json pomoću bilo kog dostupnog tekstualnog editora.
   • 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 komandu docker exec -it <containerID> bash i otvorite /etc/onlyoffice/documentserver/local.json

     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'

   Fajl 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 izvršite promene, 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.

Povezivanje sa demo ONLYOFFICE Docs

Počevši od verzije 3.0.1 konektora za ONLYOFFICE, možete isprobati online editore ONLYOFFICE unutar ownCloud-a bez instaliranja ONLYOFFICE Docs.

Da biste omogućili povezivanje, označite polje Poveži se sa demo ONLYOFFICE Docs serverom i kliknite na dugme Sačuvaj.

Instalacija Docker i Docker Compose

1. Pratite ovo uputstvo da preuzmete i instalirate Docker na vaš računar. Docker je program za automatizaciju razvoja i upravljanja aplikacijama u okruženjima sa podrškom za kontejnere.
2. Zatim pratite ovo uputstvo da preuzmete i instalirate paket menadžer Docker Compose, koji vam omogućava da opišete i pokrenete aplikacije sa više kontejnera.

Instalacija ONLYOFFICE Docs i ownCloud servera

1. Preuzmite najnoviju verziju docker-onlyoffice-owncloud repozitorijuma. Da biste to uradili, unesite sledeću liniju u komandnu liniju:

   git clone --recursive https://github.com/ONLYOFFICE/docker-onlyoffice-owncloud

2. Kada se repozitorijum preuzme, idite u folder docker-onlyoffice-owncloud:

   cd docker-onlyoffice-owncloud

3. Ažurirajte podmodule u repozitorijumu:

   git submodule update --remote

4. Pokrenite Docker Compose:

   sudo docker-compose up -d

   Možda ćete morati da sačekate nekoliko minuta dok svi kontejneri ne budu pokrenuti nakon gornje komande.

U adresnoj traci pretraživača, unesite http://localhost da otvorite stranicu za podešavanje ownCloud-a i kreirate svoj administratorski nalog. Unesite svoj Login i Lozinku (podrazumevano, admin se koristi za oba polja).

Sada možete kreirati i uređivati dokumente u ownCloud koristeći ONLYOFFICE Docs bez podešavanja bilo kakvih postavki.

Postavke servera su navedene tokom implementacije, ali možete prilagoditi Opšte postavke, Postavke prilagođavanja editora, i Opšte šablone. Molimo vas da se obratite na sekciju Konfigurisanje ONLYOFFICE konektora za ownCloud za više informacija o dostupnim postavkama konektora.

Preuzmite potrebne komponente

Prvo, potrebno je da instalirate hipervizor za virtuelnu mašinu. Izaberite između VMware Workstation Pro ili VirtualBox i pratite dokumentaciju za detaljna uputstva za instalaciju.

Zatim preuzmite ONLYOFFICE-ownCloud VM za hipervizor koji ste odabrali.

Uvoz virtuelnog uređaja

Sada otvorite hipervizor i uvezite ONLYOFFICE-ownCloud virtuelni uređaj. Ovaj vodič opisuje kako to učiniti na obe platforme.

Instalacija aplikacije

Kada je slika uspešno uvezena, pokrenite Virtuelnu mašinu. Prođite kroz proces pokretanja putem čarobnjaka za instalaciju, prateći sledeće korake.

1. Izaberite svoj jezik i unesite najbliži grad.
   

   Čarobnjak će preuzeti podrazumevane postavke sistema, vremensku zonu i raspored tastature.

   
2. Podesite svoj domen i mrežne postavke. Podrazumevano, IP adresa se dobija automatski. Alternativno, možete ručno uneti svoju IP adresu, mrežnu masku i prolaz. Unesite adresu preferiranog DNS servera.
   
3. Izaberite postavke domena. Opcija Upravljaj korisnicima i dozvolama direktno na ovom sistemu je podrazumevano izabrana. Omogućava kreiranje novog domena na ovom sistemu. Alternativno, možete se povezati sa postojećim UCS ili Microsoft Active Directory domenom.
   
4. Unesite naziv svoje kompanije, administratorsku email adresu za aktivaciju ONLYOFFICE (fajl sa licencom će biti poslat na ovu email adresu), kreirajte i potvrdite novu lozinku za svoj administratorski nalog.
   
5. Navedite potpuno kvalifikovano ime domena za ovaj sistem i LDAP bazu:
   
6. Pregledajte svoje postavke i uverite se da je sve ispravno popunjeno. Zatim kliknite na dugme Konfiguriši sistem.
   
7. Kada je sve konfigurisano, ONLYOFFICE je spreman za pokretanje na novo kreiranoj UCS platformi.
   
   
8. Unesite svoju IP adresu u adresnu traku pretraživača i učitajte svoj ucs.license fajl primljen putem emaila.
9. Da biste se prijavili na svoj ONLYOFFICE Docs i ownCloud uređaj, kliknite na ownCloud u sekciji Aplikacije i unesite podrazumevano korisničko ime i lozinku (owncloud, owncloud).

   Da biste se prijavili na svoj Univention Management Console, kliknite na LOGIN na vrhu ili Postavke sistema i domena u sekciji Administracija i unesite svoju administratorsku email adresu i lozinku navedenu tokom registracije (pogledajte korak 4).

   

Omogućavanje uređivanja za ownCloud Web

Da biste omogućili rad unutar ownCloud Web, registrujte konektor u ownCloud Web config.json:

• Ako ste instalirali ownCloud Web sa zvaničnog tržišta, putanja je

  owncloud-root-catalog

• Ako ste ga sami kompajlirali iz izvornog koda koristeći ovu instrukciju, putanja je

  owncloud-web-root-catalog/config/config.json

Da biste registrovali konektor, koristite ove linije:

"external_apps": [
    {
    "id": "onlyoffice",
    "path": "http(s):///custom/onlyoffice/js/web/onlyoffice.js"
    }
    ]

U zavisnosti od konfiguracije vašeg web servera, možete izostaviti segment index.php iz URL putanje.