Mattermost

O integraciji ONLYOFFICE i Mattermost

ONLYOFFICE nudi zvanični konektor za integraciju ONLYOFFICE Docs sa Mattermost kako biste mogli da sarađujete na kancelarijskim dokumentima poslatim u privatnim ili grupnim četovima. Možete ga preuzeti sa zvanične veb stranice ili sa GitHub-a. Aplikacija se distribuira pod Apache licencom.

note

Da biste saznali više o tome kako funkcioniše i kako da kompajlirate ONLYOFFICE konektor za Mattermost, posetite našu API dokumentaciju.

Glavne funkcije

• Pogledajte i uređujte tekstualne dokumente, tabele i prezentacije koristeći opciju Otvori fajl u ONLYOFFICE-u.
• Upravljajte pravima pristupa (Uredi ili Čitaj) iz kontekstnog menija pomoću opcije Promeni prava pristupa.
• Ko-uređivanje dokumenata u realnom vremenu: dva režima ko-uređivanja (Brzi i Strogi).
• Live Viewer: korisnici sa pravom samo za čitanje mogu da prate izmene koje drugi urednici prave u dokumentu u realnom vremenu, uključujući njihove kursore. Dostupno samo za serverske instalacije, podrazumevano omogućeno.
• Pogledajte istoriju promena fajla.
• Moderne Svetle i Tamne teme interfejsa za uređivače.
• Obaveštenja za administratore kada ONLYOFFICE uređivač postane nedostupan (Omogući obaveštenja o stanju u Sistemskoj konzoli).
• Automatsko ponovno učitavanje uređivača kada se veza ponovo uspostavi.
• JWT podrška za zaštitu vašeg saobraćaja kako bi samo korisnici sa odgovarajućim pravima imali pristup vašim dokumentima.

Podržani formati

• Za uređivanje:
  • WORD: DOCM, DOCX, DOTM, DOTX
  • CELL: XLSB, XLSM, XLSX, XLTM, XLTX
  • SLIDE: POTM, POTX, PPSM, PPSX, PPTM, PPTX
  • PDF: PDF
• Za pregled:
  • WORD: DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODT, HML, 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, TSV, 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: DJVU, OXPS, PDF, XPS
  • DIAGRAM: VSDM, VSDX, VSSM, VSSX, VSTM, VSTX

Šta je novo u verziji 2.3.0

Dodato

• Live Viewer: korisnici sa pravom samo za čitanje sada mogu da vide izmene drugih urednika u realnom vremenu, uključujući njihove kursore. Dostupno samo za serverske instalacije, nije potrebna dodatna konfiguracija.
• Podrška za teme interfejsa Savremeni svetli i Savremeni tamni (kartica Vidi → Tema Interfejsa → Savremeni svetli / Savremeni tamni).
• Obaveštenja za administratore o prekidu veze uređivača putem opcije Omogući obaveštenja o stanju u Sistemskoj konzoli.
• Automatsko ponovno učitavanje uređivača kada se veza ponovo uspostavi.

Potpuni dnevnik promena je dostupan ovde.

Povezivanje ONLYOFFICE Docs sa Mattermost

Zahtevi

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

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

  note

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

  ONLYOFFICE Docs i Mattermost mogu biti instalirani ili na različitim računarima, ili na istom uređaju. Ako koristite jedan uređaj, podesite prilagođeni port za Document Server.

• Mattermost v. 10.11.0 ili noviji

• ONLYOFFICE Connector v2.3.0 za Mattermost

Instalacija ONLYOFFICE konektora za Mattermost

Da biste povezali Mattermost, sledite ove korake:

1. Instalirajte Node.js. Za više detalja pogledajte dokumentaciju za instalaciju.

2. Instalirajte Go. Za više detalja pogledajte dokumentaciju za instalaciju. Koraci instalacije se razlikuju u zavisnosti od vašeg operativnog sistema.

3. Instalirajte make:

   sudo apt install make

4. Klonirajte granu dodatka:

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

5. Idite do korena projekta i preuzmite git podmodule:

   cd onlyoffice-mattermost/
   git submodule update --init --recursive

6. Pokrenite izgradnju:

   make

Konfigurisanje ONLYOFFICE konektora za Mattermost

Idite na Sistemsku konzolu → pronađite ONLYOFFICE dodatak putem pretrage → Konfiguriši. Omogućite dodatak u odgovarajućem polju i navedite sledeće parametre:

1. Adresa ONLYOFFICE Docs — unesite URL adresu gde je instaliran ONLYOFFICE Docs (npr., https://documentserver).

   note

   Adresa ONLYOFFICE Docs mora biti dostupna iz Mattermost, kao i adresa Mattermost mora biti dostupna iz ONLYOFFICE Docs.

2. JWT tajna Document Server-a — JWT tajni ključ servera dokumenata koji 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. Morate ga omogućiti i na strani Mattermost: pronađite svoj tajni ključ u konfiguracionoj datoteci ONLYOFFICE Docs, a zatim navedite isti tajni ključ u postavkama konektora. Za više detalja, pogledajte odeljak Omogućavanje JWT za integraciju ONLYOFFICE i Mattermost u ovom članku.

3. JWT zaglavlje — navedite JWT zaglavlje.

   note

   Ako je JWT zaštita omogućena, potrebno je navesti prilagođeno ime zaglavlja, jer sigurnosna politika Mattermost blokira spoljašnja 'Authorization' zaglavlja. Ovo zaglavlje treba navesti i u postavkama potpisa ONLYOFFICE Docs (više informacija možete pronaći ovde).

4. JWT prefiks — navedite JWT prefiks.

5. Možete se povezati i na javni test server ONLYOFFICE Docs na mesec dana ako označite polje Veza sa demo ONLYOFFICE Docs serverom omogućena.

6. Formati — izaberite formate fajlova koji treba da se otvaraju u ONLYOFFICE Docs. Svi formati su podrazumevano omogućeni. Poništite izbor formata da biste ih onemogućili.

7. Zaštita fajlova samo od strane vlasnika — kada je omogućeno, samo vlasnici fajlova mogu da zaštite/uklone zaštitu fajlova preko kartice Zaštita. Kada je onemogućeno, zaštita fajlova je dostupna svima.

8. Omogući ONLYOFFICE dodatke — kada je omogućeno, korisnici mogu da pristupe dodacima u uređivačima. Kada je onemogućeno, dodaci su skriveni.

9. Omogući makroe — kada je omogućeno, korisnici mogu da kreiraju i pokreću makroe u uređivačima. Kada je onemogućeno, sve funkcionalnosti makroa su skrivene.

10. Omogući obaveštenja o stanju — omogućite ovu opciju da biste primali obaveštenja za administratore kada ONLYOFFICE uređivač postane nedostupan.

Kako funkcioniše

Interakcija korisnika sa dokumentima odvija se i na klijentskoj i na serverskoj strani.

Glavni pojmovi korišćeni kroz ovu dokumentaciju su objašnjeni u nastavku.

Klijentska strana uključuje:

• Menadžer dokumenata — lista dokumenata prikazana u pretraživaču korisnika gde korisnik može izabrati željeni dokument i izvršiti neke radnje sa njim (u zavisnosti od dodeljenih prava, korisnik može otvoriti dokument za pregled ili uređivanje, deliti dokument sa drugim korisnicima).
• Uređivač dokumenata — interfejs za pregled i uređivanje dokumenata sa svim najpoznatijim funkcijama za uređivanje dokumenata, korišćen kao posrednik između korisnika i servisa za uređivanje dokumenata.

Serverska strana uključuje:

• Servis za skladištenje dokumenata — serverski servis koji skladišti sve dokumente dostupne korisnicima sa odgovarajućim pravima pristupa. On obezbeđuje ID-ove dokumenata i linkove ka tim dokumentima menadžeru dokumenata koji korisnik vidi u pretraživaču.
• Servis za uređivanje dokumenata — serverski servis koji omogućava pregled i uređivanje dokumenata (u slučaju da korisnik ima odgovarajuća prava za to). Interfejs uređivača dokumenata se koristi za pristup svim funkcijama servisa za uređivanje dokumenata.
• Servis za komande dokumenata — serverski servis koji omogućava izvršavanje dodatnih komandi sa servisom za uređivanje dokumenata.
• Servis za konverziju dokumenata — serverska usluga koja omogućava konvertovanje dokumenta u odgovarajući Office Open XML format (docx za tekstualne dokumente, xlsx za tabele i pptx za prezentacije) radi njihovog uređivanja ili preuzimanja.
• Servis za izgradnju dokumenata — serverska usluga koja omogućava jednostavno kreiranje dokumenta bez potrebe za pokretanjem uređivača dokumenata.

Napomena, ONLYOFFICE Document Server uključuje uređivač dokumenata, servis za uređivanje dokumenata, servis za komande dokumenata, servis za konverziju dokumenata i servis za izgradnju dokumenata. Menadžer dokumenata i servis za skladištenje dokumenata su ili uključeni u Community Server ili moraju biti implementirani od strane softverskih integratora koji koriste ONLYOFFICE Document Server na svom serveru.

Omogućavanje JWT za integraciju ONLYOFFICE i Mattermost

Da bi se dokumenti zaštitili od neovlašćenog pristupa, ONLYOFFICE uređivači koriste JSON Web Token (JWT). Token se dodaje u konfiguraciju prilikom inicijalizacije Document Editor-a 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 svoj tajni ključ u konfiguracionom fajlu ONLYOFFICE Docs, a zatim navedete isti tajni ključ u podešavanjima konektora.

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

1. Otvorite fajl local.json sa bilo kojim dostupnim uređivačem teksta.

   • 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 vrednost tajnog ključa 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 podešavanjima konektora

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

Počnite koristiti ONLYOFFICE Docs unutar Mattermost-a

Pregled i uređivanje fajlova

• Kliknite na dugme Više akcija pored fajla poslatog u Mattermost četu.

• Izaberite opciju Otvori fajl u ONLYOFFICE iz kontekstnog menija.

  

ili

• Kliknite na ime fajla.

• Pojaviće se prozor za pregled fajla. Da biste podelili fajl sa drugim korisnicima, kliknite na dugme Podeli. Da biste nastavili sa uređivanjem, kliknite na dugme Uredi u ONLYOFFICE.

  

Fajl će biti otvoren u odgovarajućem ONLYOFFICE uređivaču.

Korisnici sa pravom samo za čitanje mogu da koriste Live Viewer da prate izmene koje drugi urednici prave u realnom vremenu, uključujući njihove kursore, bez prelaska u režim uređivanja. Live Viewer je dostupan samo za serverske instalacije i podrazumevano je omogućen — nije potrebna dodatna konfiguracija. Da biste saznali više o Live Viewer-u, pogledajte API dokumentaciju.

Promena prava pristupa

Pošiljalac ima prava uređivanja, a primalac prava čitanja po defaultu. Da biste ih promenili, koristite opciju Promeni prava pristupa dostupnu u kontekstnom meniju fajla. Ova opcija je dostupna samo pošiljaocu.

Da biste zajednički uređivali dokument, ovlašćeni korisnici treba da otvore isti fajl zajedno.

U privatnom četu:

• Koristite padajući meni u polju Prava pristupa za @korisnik.

  

U grupnom četu za sve članove:

• Koristite padajući meni u polju Podrazumevana prava pristupa za članove četa.

  

U grupnom četu za određenog korisnika:

• Koristite padajući meni na vrhu, izaberite potrebnog korisnika i kliknite na dugme Dodaj sa desne strane.

  

• Korisnik će se pojaviti na listi ispod. Promenite njegova prava pristupa putem padajućeg menija sa desne strane.

  

note

Upravljanje pravima pristupa će poslati obaveštenje putem bota odgovarajućoj strani.

Pregled istorije izmena

Sve izmene u fajlu biće poslate kao obaveštenja koja sadrže korisničko ime.

Obaveštenja su dostupna u posebnom thread-u. Da biste otvorili thread, kliknite na strelicu desno od fajla.

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.