SuiteCRM

O integraciji ONLYOFFICE-a i SuiteCRM-a

SuiteCRM je sistem za upravljanje odnosima sa klijentima. ONLYOFFICE nudi zvanični modul za integraciju ONLYOFFICE Docs sa SuiteCRM-om i uređivanje kancelarijskih dokumenata u vašem SuiteCRM prostoru. ONLYOFFICE integracioni modul možete preuzeti sa GitHub stranice. Modul se distribuira pod licencom AGPL-3.

note

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

Glavne funkcije

• Uređivanje i pregled tekstualnih dokumenata, tabela i prezentacija.

• Zajedničko uređivanje dokumenata u realnom vremenu: dva režima zajedničkog uređivanja (Brzi i Strogi), režim Praćenje promena, komentari i ugrađeni čet.

• Kreiranje i uređivanje šablona obrazaca.

  note

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

• JWT podrška za zaštitu vašeg saobraćaja tako da niko ne može pristupiti vašim dokumentima, osim korisnika sa odgovarajućim pravima.

Podržani formati

• Za pregled i uređivanje: DOCX, XLSX, PPTX.
• Samo za pregled: PDF, ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM, TXT, CSV.

Povezivanje ONLYOFFICE Docs sa SuiteCRM-om

Zahtevi

• ONLYOFFICE Document Server v7.1 (server) ili noviji

  Potrebna vam je instanca ONLYOFFICE Docs koja je dostupna i razrešiva i sa SuiteCRM-a i sa svih krajnjih klijenata. Mora imati mogućnost da direktno šalje POST zahteve ka SuiteCRM-u.

  note

  Pogledajte zvaničnu stranicu dokumentacije da biste saznali više o instalaciji ONLYOFFICE Docs.

• SuiteCRM 7 (sva izdanja 7.x)

• ONLYOFFICE konektor v1.0.0 i noviji za SuiteCRM

Instaliranje ONLYOFFICE integracionog modula za SuiteCRM

Da biste instalirali ONLYOFFICE aplikaciju:

1. Preuzmite najnovije kompajlirane datoteke paketa ONLYOFFICE integracionog dodatka sa GitHub stranice.

2. Pokrenite SuiteCRM i pređite na Admin > Admin Tools > Module Loader.

   

3. Otpremite arhivu ONLYOFFICE dodatka.

4. Instalirajte otpremljeni modul pritiskom na dugme Install.

5. Pređite na Admin > Admin Tools > Repair.

6. Pokrenite Quick Repair and Rebuild.

   

Kako funkcioniše

Interakcija korisnika i dokumenta odvija se i na strani klijenta i na strani servera.

U nastavku je objašnjenje ključnih pojmova koji se koriste u ovoj dokumentaciji.

Strana klijenta obuhvata:

• Menadžer dokumenata - lista dokumenata prikazana u korisničkom pregledaču, u kojoj korisnik može izabrati potreban dokument i izvršiti neke radnje nad njim (u zavisnosti od dodeljenih prava, korisnik može otvoriti dokument radi pregleda ili uređivanja, te ga podeliti sa drugim korisnicima).
• Uređivač dokumenata - interfejs za pregled i uređivanje dokumenata sa svim najpoznatijim dostupnim funkcijama uređivanja, koji se koristi kao posrednik između korisnika i servisa za uređivanje dokumenata.

Strana servera obuhvata:

• Servis za skladištenje dokumenata - serverski servis koji čuva sve dokumente dostupne korisnicima sa odgovarajućim pravima pristupa. On menadžeru dokumenata, koji korisnik vidi u pregledaču, obezbeđuje ID-ove dokumenata i veze ka njima.
• Servis za uređivanje dokumenata - serverski servis koji omogućava pregled i uređivanje dokumenata (ako korisnik ima odgovarajuća prava za to). Interfejs uređivača dokumenata koristi se za pristup svim funkcijama servisa za uređivanje dokumenata.
• Servis za komande nad dokumentima - serverski servis koji omogućava izvršavanje dodatnih komandi sa servisom za uređivanje dokumenata.
• Servis za konverziju dokumenata - serverski servis koji omogućava konverziju datoteke dokumenta u odgovarajući Office Open XML format (docx za tekstualne dokumente, xlsx za tabele i pptx za prezentacije) radi uređivanja ili preuzimanja.
• Servis za izradu dokumenata - serverski servis koji omogućava jednostavnu izradu dokumenta bez potrebe da se zapravo pokreće uređivač za obradu dokumenata.

Imajte u vidu da ONLYOFFICE Document Server obuhvata uređivač dokumenata, servis za uređivanje dokumenata, servis za komande nad dokumentima, servis za konverziju dokumenata i servis za izradu dokumenata. Menadžer dokumenata i servis za skladištenje dokumenata ili su uključeni u Community Server, ili ih moraju implementirati softverski integratori koji koriste ONLYOFFICE Document Server na sopstvenom serveru.

Konfigurisanje JWT-a za integraciju ONLYOFFICE-a i SuiteCRM-a

JWT ili JSON Web Token je niska koja se šalje od klijenta ka serveru u okviru HTTP zahteva radi provere autentičnosti klijenta. JWT se čuva samo na strani klijenta, pa je prenos između strana zaštićen i digitalno potpisan.

Token se generiše korišćenjem standarda JWT (JSON Web Tokens). Tokeni su potpisani ključem servera, tako da klijent može da proveri da je token legitiman.

ONLYOFFICE Docs validira token. Podaci iz payload-a smatraju se važećim i koriste se umesto odgovarajućih podataka iz glavnih parametara. Ako je token nevažeći, komanda se ne izvršava. Da biste saznali više, pročitajte vodič za bezbednost API-ja.

U ONLYOFFICE Docs, JWT je podrazumevano omogućen počevši od verzije 7.2.

Pratite ove korake da biste ga ručno konfigurisali ako je potrebno:

1. Idite na Admin > ONLYOFFICE > ONLYOFFICE Settings.

   

2. Unesite vrednosti u sledeća polja:

   • Document Editing Service Address: Navedite URL adresu na kojoj je instaliran ONLYOFFICE Docs (npr. https://documentserver).
   • Secret key (ostavite prazno da biste onemogućili): Tajni ključ se generiše automatski radi ograničavanja pristupa ONLYOFFICE Docs. Ako želite da u ovo polje unesete sopstveni tajni ključ, navedite isti tajni ključ i u konfiguracionoj datoteci ONLYOFFICE Docs kako biste omogućili validaciju.
   • Authorization header (ostavite prazno da biste koristili podrazumevano zaglavlje): Standardno JWT zaglavlje koje se koristi u ONLYOFFICE-u je Authorization. Ako je ovo zaglavlje u sukobu sa vašim podešavanjem, možete ga promeniti u prilagođeno.

   

Početak korišćenja ONLYOFFICE Docs unutar SuiteCRM-a

Da biste uređivali kancelarijske datoteke i sarađivali na njima:

• Idite na modul Documents.
• Otvorite stranicu Detail View klikom na naziv datoteke.
• Na stranici Detail View kliknite na Open in ONLYOFFICE u padajućem meniju ACTIONS - datoteka će se otvoriti u istoj kartici.

note

Da biste saznali više o najčešćim problemima i načinima za njihovo rešavanje, posetite naš vodič za rešavanje problema.