Pređi na glavni sadržaj

Liferay

O integraciji ONLYOFFICE i Liferay​

ONLYOFFICE nudi zvanični konektor za integraciju ONLYOFFICE Docs sa Liferay i uređivanje kancelarijskih dokumenata unutar Liferay biblioteke dokumenata i medija. Možete preuzeti ONLYOFFICE konektor sa Liferay Marketplace ili sa GitHub stranice. Konektor je distribuiran pod Apache licencom.

note

Da biste saznali više o tome kako funkcioniše ONLYOFFICE konektor za Liferay, posetite našu stranicu sa API dokumentacijom.

Glavne funkcije​

  • Kreiranje datoteka pomoću opcije menija Create with ONLYOFFICE (Kreiraj pomoću ONLYOFFICE).
  • Kreiranje i popunjavanje online obrazaca.
  • Pregledanje i uređivanje postojećih tekstualnih dokumenata, tabela ili prezentacija pomoću opcije menija ONLYOFFICE Edit/View (ONLYOFFICE Uredi/Pregledaj) unutar odeljka Documents and Media (Dokumenti i mediji).
  • Zajedničko uređivanje dokumenata u realnom vremenu: dva režima zajedničkog uređivanja (Brzi i Strogi), Praćenje promena, komentari i ugrađeni čet.
  • 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 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 uređivanje:
    • WORD: DOCM, DOCX, DOTM, DOTX
    • CELL: XLSB, XLSM, XLSX, XLTM, XLTX
    • SLIDE: POTM, POTX, PPSM, PPSX, PPTM, PPTX
    • PDF: PDF
  • Za konvertovanje u Office Open XML formate:
    • WORD: DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTM, HTML, HWP, HWPX, MD, MHT, MHT, MHTML, ODT, OTT, PAGES, RTF, STW, SXW, TXT, WPS, WPT, XML
    • CELL: CSV, ET, ETT, FODS, NUMBERS, ODS, OTS, SXC, XLS, XLSB, XLSM, XLSX, XLT, XLTM, XLTX
    • SLIDE: DPS, DPT, FODP, KEY, ODG, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, SXI
    • PDF: DOCXF, OXPS, PDF, XPS

Šta je novo u verziji 3.1.0​

Dodato

  • Podrška za ONLYOFFICE Docs v9.1.0

Izmenjeno

  • Ažurirana verzija com.onlyoffice:docs-integration-sdk
    • novi podržani formati: .vsdx, .md, .odg, .xlsb, Apple iWork, .hwp, .hwpx, .mht
    • dodat novi tip dokumenata: DIAGRAM
    • prošireni šabloni praznih datoteka

Kompletan dnevnik promena je dostupan ovde.

Povezivanje ONLYOFFICE Docs sa Liferay​

Zahtevi​

  • ONLYOFFICE Document Server v6.1.0 (server ili cloud verzija) ili novija.

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

    note

    Molimo vas da se obratite zvaničnoj stranici dokumentacije za više informacija o instalaciji ONLYOFFICE Docs.

  • Liferay CE Portal 7.2 GA1+, Liferay DXP 7.2 GA1+, Liferay CE Portal 7.3 GA1+, Liferay DXP 7.3 GA1+, Liferay CE Portal 7.4 GA1+, Liferay CE 7.4 GA44 - GA73, Liferay DXP 7.4 U44 - U73.

  • ONLYOFFICE Connector v2.2.0 za Liferay.

Instalacija ONLYOFFICE konektora za Liferay​

ONLYOFFICE konektor možete instalirati pomoću App Manager.

Da biste ga instalirali pomoću App Manager:

  1. Idite na Control Panel > System > App Manager.
  2. Kliknite na dugme Options Options (Opcije).
  3. Kliknite na dugme Upload (Otpremi).
  4. U otvorenom prozoru izaberite datoteku aplikacije ONLYOFFICE.

Kada je instalacija završena, aplikacija je spremna za upotrebu.

Ako sami gradite konektor, jednostavno stavite kompajliranu .jar datoteku iz foldera build\libs u /opt/liferay/deploy. Liferay će je automatski instalirati.

note

Datoteke preuzete sa Marketplace-a dolaze u .lpkg formatu. Možete raspakovati .lpkg paket da biste dobili odgovarajuću .jar datoteku. Izdvojena .jar datoteka se zatim može implementirati preko App Manager.

Kompajliranje ONLYOFFICE konektora za Liferay​

Jednostavno pokrenite gradle build. Izlazna .jar datoteka biće smeštena u direktorijum build/libs.

Konfigurisanje ONLYOFFICE konektora za Liferay​

Idite na Control Panel > Configuration > System Settings. U odeljku Platform izaberite kategoriju Connectors i izaberite ONLYOFFICE.

Ovde možete konfigurisati sledeće postavke:

  • ONLYOFFICE Docs address (Adresa ONLYOFFICE Docs) - navedite URL adresu na kojoj je instaliran Document Editing Service.

    note

    Adresa ONLYOFFICE Docs mora biti dostupna sa Liferay, kao i adresa Liferay mora biti dostupna sa ONLYOFFICE Docs.

  • ONLYOFFICE Docs address for internal requests from the server (Adresa ONLYOFFICE Docs za interne zahteve sa servera) - navedite adresu koja se koristi za pristup Document Editing Service iz Liferay.

  • Server address for internal requests from ONLYOFFICE Docs (Adresa servera za interne zahteve iz ONLYOFFICE Docs) - navedite adresu koja se koristi za pristup Liferay iz Document Editing Service.

  • Secret key (Tajni ključ) - navedite tajnu koja se koristi za potpisivanje podataka.

    note

    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 Liferay: pronađite svoj 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 Liferay u ovom članku.

  • Authorization header (Zaglavlje za autorizaciju) (ostavite prazno da biste koristili podrazumevano zaglavlje) - JWT zaglavlje za autorizaciju koje se koristi u ONLYOFFICE je Authorization. Ako je ovo zaglavlje u sukobu sa vašom konfiguracijom, možete ga promeniti u prilagođeno.

  • Enable Force Save (Omogući prinudno čuvanje) - označite polje da biste zadržali međuverzije dokumenta prilikom uređivanja.

  • Enable ONLYOFFICE Web Preview (Omogući ONLYOFFICE web pregled) - označite polje da biste omogućili pregled datoteka.

Configuration

Nakon konfigurisanja aplikacije za integraciju, kliknite na dugme Save (Sačuvaj) da biste primenili izmene.

Kako funkcioniše​

Integracija ONLYOFFICE prati API dokumentovan ovde.

  1. Korisnik odlazi u odeljak Documents and Media unutar Liferay i bira akciju Edit in ONLYOFFICE.
  2. Liferay priprema JSON objekat za Document Server sa sledećim svojstvima:
    • url: URL koji ONLYOFFICE Docs koristi za preuzimanje dokumenta;
    • callbackUrl: URL koji ONLYOFFICE Docs koristi da informiše o statusu uređivanja dokumenta;
    • key: fileVersionId koji obaveštava ONLYOFFICE Docs da li da ponovo preuzme dokument ili ne;
    • title: naslov (ime) dokumenta.
  3. Klijent pregledač šalje zahtev JavaScript biblioteci iz ONLYOFFICE Docs i šalje ONLYOFFICE Docs konfiguraciju DocEditor sa gore navedenim svojstvima.
  4. Zatim ONLYOFFICE Docs preuzima dokument iz Liferay i korisnik počinje sa uređivanjem.
  5. ONLYOFFICE Docs šalje POST zahtev na callbackUrl da obavesti Liferay da korisnik uređuje dokument.
  6. Liferay zaključava dokument, ali i dalje dozvoljava drugim korisnicima sa pravom pisanja da sarađuju u realnom vremenu sa ONLYOFFICE Docs tako što ostavlja dostupnu Action (Akciju).
  7. Kada svi korisnici i klijentski pregledači završe sa uređivanjem, zatvaraju prozor za uređivanje.
  8. Nakon 10 sekundi neaktivnosti, ONLYOFFICE Docs šalje POST na callbackUrl obaveštavajući Liferay da su klijenti završili sa uređivanjem dokumenta i zatvorili ga.
  9. Liferay preuzima novu verziju dokumenta, zamenjujući staru.

Omogućavanje JWT za integraciju ONLYOFFICE i Liferay​

Da bi se dokumenti zaštitili od neovlašćenog pristupa, ONLYOFFICE urednici koriste JSON Web Token (JWT). Token se dodaje u konfiguraciju prilikom inicijalizacije Document Editor-a 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 verzije v7.2 ONLYOFFICE Docs, JWT je podrazumevano omogućen i tajni ključ se automatski generiše. Potrebno je da pronađete vaš tajni ključ u konfiguracionoj datoteci ONLYOFFICE Docs, a zatim navedete isti tajni ključ u podešavanjima konektora.

Korak 1: Pronađite vaš tajni ključ u konfiguracionoj datoteci ONLYOFFICE Docs

  1. Otvorite datoteku local.json pomoću bilo kog dostupnog tekstualnog urednika.

    • 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'

    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 vrednost tajnog ključa vašim sopstvenim 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.

    • Za Linux:

      sudo supervisorctl restart all

    • Za Docker:

      docker exec <containerID> supervisorctl restart all

      ili restartujte ceo kontejner:

      docker restart <containerID>

Korak 2: Navedite isti tajni ključ u podešavanjima konektora

U podešavanjima konektora, navedite isti tajni ključ u polju Secret key (Tajni ključ) i sačuvajte podešavanja.

Počnite koristiti ONLYOFFICE Docs unutar Liferay-a​

Da kreirate datoteku:

  1. Idite u odeljak Documents and Media.

  2. Kliknite na dugme Add File Add File (Dodaj datoteku).

  3. U otvorenom meniju kliknite na dugme Create with ONLYOFFICE.

    Create

  4. Na otvorenoj stranici izaberite tip datoteke i navedite njen naslov i opis (opciono).

  5. Kliknite na dugme Save (Sačuvaj).

    Create file

Da uredite datoteku:

  1. Pronađite potrebnu datoteku u odeljku Documents and Media.

  2. Kliknite na dokument.

  3. U otvorenom meniju kliknite na dugme Edit in ONLYOFFICE.

    Edit

Da kreirate PDF obrazac:

  1. Idite u odeljak Documents and Media.

  2. Kliknite na dugme Add File Add File (Dodaj datoteku).

  3. U otvorenom meniju kliknite na dugme Create with ONLYOFFICE.

    Create

  4. Na otvorenoj stranici izaberite tip datoteke PDF form (PDF obrazac).

  5. Kliknite na dugme Save (Sačuvaj).

note

Da biste saznali više o obrascima, pročitajte odgovarajuće članke o kreiranju obrazaca.

note

Da biste saznali više o najčešćim problemima i načinima njihovog rešavanja, molimo vas da posetite naš vodič za rešavanje problema.