Confluence

O integraciji ONLYOFFICE i Confluence

ONLYOFFICE nudi zvanični konektor za integraciju ONLYOFFICE Docs sa Confluence i uređivanje kancelarijskih dokumenata unutar biblioteke dokumenata. Možete instalirati ONLYOFFICE konektor sa Atlassian Marketplace ili ga preuzeti sa GitHub stranice. Naš GitHub repozitorijum uključuje konektore i za Confluence i za Confluence Cloud. Aplikacija se distribuira pod Apache licencom.

note

Za više informacija o tome kako funkcioniše i kako da kompajlirate ONLYOFFICE konektor za Confluence, posetite našu API dokumentaciju.

Glavne funkcije

• Kreiranje tekstualnih dokumenata, tabela i prezentacija koristeći opciju Novi dokument.

• Kreiranje i popunjavanje online obrazaca.

• Uređivanje i pregled dokumenata sa opcijom Uredi u ONLYOFFICE.

  note

  Confluence Cloud podržava otpremanje i uređivanje fajlova.

• Ko-uređivanje dokumenata u realnom vremenu: dva režima ko-uređivanja (Brzi i Strogi), Praćenje promena, komentari i ugrađeni chat.

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

Podržani formati

• Za kreiranje: DOCX, XLSX, PPTX, PDF obrasci

• Za uređivanje i pregled: DOCM, DOCX, PDF obrasci, DOTM, DOTX, HTM, POTM, POTX, PPSM, PPSX, PPTM, PPTX, XLSM, XLSX, XLTM, XLTX, XML

• Za uređivanje sa mogućim gubitkom informacija: CSV, EPUB, FB2, HTML, ODP, ODS, ODT, OTP, OTS, OTT, RTF, TXT

• Za konverziju u Office Open XML: DOC, DOCM, PDF obrasci, DOT, DOTM, DOTX, EPUB, FB2, FODP, FODS, FODT, HTM, HTML, MHT, ODP, ODS, ODT, OTP, OTS, OTT, OXPS, PDF, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, RTF, XLS, XLSM, XLT, XLTM, XLTX, XML, XPS

  note

  Confluence Cloud ne podržava konverziju. Svi ovi formati su podržani samo za pregled.

• Samo za pregled: CSV, DJVU, DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODP, FODS, FODT, HTM, HTML, MHT, ODP, ODS, ODT, OTP, OTS, OTT, OXPS, PDF, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, RTF, TXT, XLS, XLSM, XLSX, XLT, XLTM, XLTX, XML, XPS

• Za pregled u Confluence Cloud: PAGES, KEY, NUMBERS, HWP, HWPX, MD, ODG, VSDX, VSSX, VSTX, VSDM, VSSM, VSTM.

Konektor za Confluence: novosti u verziji 6.3.0

Dodato

• Podrška za pokretanje makroa dokumenata

Izmenjeno

• Proverena kompatibilnost sa Confluence verzijom 9.5.2
• Ažurirana lista podržanih formata, sada usklađena sa ONLYOFFICE/document-formats v3.0.0
• Ispravljena ranjivost: CVE-2025-27820

Kompletan dnevnik promena je dostupan ovde.

Konektor za Confluence Cloud: novosti u verziji 2.1.0

Dodato

• Novi šabloni praznih fajlova
• Forge stranica sa podešavanjima za konfigurisanje veze sa ONLYOFFICE Docs i pristupa demo serveru
• Stranica prostora i radnja nad sadržajem za pregledanje Confluence stranica, blog objava i priloga
• Radnje u stablu sadržaja za kreiranje, otvaranje, preuzimanje i brisanje priloga
• Otvaranje referenciranih dokumenata direktno iz uređivača

Izmenjeno

• Aplikacija je migrirana sa zastarele udaljene Atlassian Connect aplikacije na Forge sa Custom UI
• Proširena lista podržanih formata
• Poboljšan pregledač fajlova sa lokalizovanim korisničkim interfejsom, pretragom, filterima, sortiranjem, putanjom navigacije i straničenjem
• Ažuriran tok autorizacije i konfiguracije uređivača tako da koristi Forge resolvere i konfiguraciju uređivača na backend-u

Ispravljeno

• Rukovanje duplim nazivima priloga prilikom kreiranja fajla
• Stanja greške za nedostajuću konfiguraciju uređivača, nedostupan ONLYOFFICE Docs API i nedostajući sadržaj
• Ponovna autorizacija sesije uređivača pre isteka sesije

Uklonjeno

• Zastarela udaljena Atlassian Connect aplikacija i povezani resursi za isporuku

Kompletan dnevnik promena je dostupan ovde.

Povezivanje ONLYOFFICE Docs sa Confluence

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 Confluence, tako i sa svim krajnjim klijentima. Mora biti u mogućnosti da šalje POST zahteve direktno ka Confluence.

  note

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

• Confluence Data Center 7.12.0 - 9.5.2 ili Confluence Server 7.12.0 - 9.5.2

  note

  Atlassian više ne podržava Confluence Server. Podrška za ONLYOFFICE konektor se odnosi na postojeće instalacije.

• ONLYOFFICE Konektor za Confluence

Instalacija ONLYOFFICE konektora za Confluence sa Atlassian Marketplace

Možete preuzeti najnoviju verziju konektora sa zvaničnog Atlassian Marketplace. Da biste to uradili, pratite sledeće korake:

1. Prijavite se u vašu Confluence instancu kao administrator.

2. Kliknite na dugme Podešavanja u gornjem desnom uglu, zatim skrolujte do Atlassian Marketplace. Kliknite na dugme Pronađi nove aplikacije.

3. Pronađite ONLYOFFICE Konektor za Confluence putem pretrage. Rezultati će uključivati verzije dodatka kompatibilne sa vašom Confluence instancom.

   

4. Kliknite na Instaliraj da biste preuzeli i instalirali vašu aplikaciju.

5. Sada možete kliknuti na Zatvori u dijalogu Instalirano i spremno za korišćenje.

Ili možete otpremiti kompajlirani target/onlyoffice-confluence-plugin.jar u Confluence na stranici Upravljanje dodacima.

Najnoviji kompajlirani paketi su dostupni ovde i na Atlassian Marketplace.

Kompajliranje aplikacije za integraciju Confluence ONLYOFFICE

Ako planirate sami da kompajlirate aplikaciju za integraciju Confluence ONLYOFFICE (npr. da izmenite izvorni kod i zatim ga kompajlirate), pratite ove korake:

1. Stabilna verzija Jave je neophodna za uspešnu izgradnju. Ako je nemate instaliranu, koristite sledeće komande za instalaciju Open JDK 8:

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

2. Instalirajte Atlassian Plugin SDK. Proces instalacije je opisan ovde.

3. Preuzmite podmodul:

   git submodule update --init --recursive

4. Kompajlirajte paket:

   atlas-package

Konfigurisanje ONLYOFFICE konektora za Confluence

Idite na Administracija Confluence → Upravljanje aplikacijama → ONLYOFFICE Konektor za Confluence → Konfiguriši:

• Document Server - navedite URL adresu gde je instaliran ONLYOFFICE Docs (npr. https://documentserver).

  Važno

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

• Tajni ključ - navedite JWT 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 Confluence: pronađite vaš tajni ključ u konfiguracionom fajlu ONLYOFFICE Docs, zatim navedite isti tajni ključ u podešavanjima konektora. Za više detalja, pogledajte odeljak Omogućavanje JWT za integraciju ONLYOFFICE i Confluence ovog članka.

Napredne postavke servera:

• Adresa servera za interne zahteve iz Servisa za uređivanje dokumenata - adresa koja se koristi za pristup Confluence serveru iz Servisa za uređivanje dokumenata.

• Adresa Servisa za uređivanje dokumenata za interne zahteve sa servera - adresa koja se koristi za pristup Servisu za uređivanje dokumenata sa Confluence servera.

  note

  Confluence Cloud ne podržava konfiguraciju naprednih postavki.

Kako funkcioniše

Integracija sa ONLYOFFICE prati API dokumentovan ovde.

1. Korisnik odlazi na Confluence priloge i bira akciju Uredi u ONLYOFFICE.
2. Confluence šalje zahtev ka OnlyOfficeEditorServlet (URL u formi: /plugins/servlet/onlyoffice/doceditor?attachmentId=$attachment.id).
3. Confluence šalje dokument na ONLYOFFICE Document storage service i dobija privremeni link.
4. Confluence priprema JSON objekat sa sledećim svojstvima:
   • url - privremeni link koji ONLYOFFICE Docs koristi za preuzimanje dokumenta;
   • callbackUrl - URL koji ONLYOFFICE Docs koristi da obavesti o statusu uređivanja dokumenta;
   • docserviceApiUrl - URL na koji klijent treba da odgovori ONLYOFFICE Docs (obezbeđen svojstvom files.docservice.url.api);
   • key - UUID koji upućuje ONLYOFFICE Docs da li da ponovo preuzme dokument ili ne;
   • title - naslov dokumenta (ime).
5. Confluence koristi ovaj objekat da generiše stranicu iz freemarker šablona, popunjavajući je datim vrednostima kako bi omogućio klijentskom pretraživaču da učita uređivač.
6. Klijentski pretraživač šalje zahtev JavaScript biblioteci iz ONLYOFFICE Docs i šalje ONLYOFFICE Docs konfiguraciju DocEditor-a sa gore navedenim svojstvima.
7. Zatim ONLYOFFICE Docs preuzima dokument iz Confluence i korisnik počinje sa uređivanjem.
8. Kada svi korisnici i klijentski pretraživači završe sa uređivanjem, zatvaraju prozor za uređivanje.
9. Nakon 10 sekundi neaktivnosti, ONLYOFFICE Docs šalje POST na callbackUrl obaveštavajući Confluence da su klijenti završili sa uređivanjem dokumenta i zatvorili ga.
10. Confluence preuzima novu verziju dokumenta, zamenjujući staru.

Omogućavanje JWT za integraciju ONLYOFFICE i Confluence

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 pokreće 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 omogućeno po defaultu i tajni ključ se generiše automatski. Potrebno je pronaći vaš tajni ključ u ONLYOFFICE Docs konfiguracionom fajlu, zatim navesti isti tajni ključ u postavkama konektora.

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

1. Otvorite fajl local.json 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 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 bi trebalo 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 sa vašim sopstvenim tajnim ključem. Tajni ključ mora biti isti u 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.

Povezivanje na demo ONLYOFFICE Docs

Ako želite da testirate ONLYOFFICE online uređivače unutar Confluence bez instaliranja ONLYOFFICE Docs:

1. Idite na administraciju Confluence → Upravljanje aplikacijama → ONLYOFFICE Connector za Confluence → Konfiguriši.
2. Označite kućicu Poveži se sa demo ONLYOFFICE Document Server.
3. Kliknite na dugme Sačuvaj.

Za Confluence Cloud, otvorite stranicu sa ONLYOFFICE podešavanjima sa ekrana za konfiguraciju aplikacije, zatim označite opciju za povezivanje na demo ONLYOFFICE Docs server.

Važno

Ovo je javni test server koji će biti dostupan tokom perioda od 30 dana. Nemojte deliti svoje osetljive podatke tamo.

Počnite koristiti ONLYOFFICE Docs unutar Confluence

Počevši od verzije 2.1.0, korisnici Confluence Cloud mogu pristupiti ONLYOFFICE prostoru, tj. namenskom radnom prostoru za pregledanje svih Confluence stranica, blog objava i priloga na jednom mestu. Da biste ga otvorili, kliknite na ikonu ONLYOFFICE na levom panelu. Odatle možete kreirati nove fajlove na bilo kojoj stranici pomoću dugmeta Kreiraj, bez potrebe da prvo otvorite samu stranicu.

Da biste kreirali fajl:

1. Otvorite stranicu na kojoj treba da kreirate fajl.
2. Kliknite na dugme Novi dokument.
3. Izaberite potrebnu vrstu fajla.
4. Unesite naziv fajla u tekstualno polje pored ikone tipa fajla.
5. Kliknite na dugme Sačuvaj.

Dokument će biti otvoren u ONLYOFFICE Docs uređivaču.

Da biste kreirali pregled fajla:

1. Otvorite bilo koju Confluence stranicu za uređivanje.
2. Kliknite na opciju Umetni više sadržaja.
3. Izaberite opciju Ostali makroi.
4. Izaberite opciju ONLYOFFICE Pregled.
5. Izaberite potrebni fajl na stranici Prilozi.
6. Podesite širinu i visinu pregleda fajla ako je potrebno.
7. Kliknite na dugme Umetni.

Da biste preuzeli fajl:

1. Otvorite kontekstni meni fajla klikom na strelicu levo od njegovog naziva.
2. Kliknite na dugme Preuzmi kao. Otvoriće se prozor Preuzmi kao sa ONLYOFFICE.
3. Izmenite Naziv fajla u odgovarajućem polju ako je potrebno.
4. Otvorite padajući meni Ciljani tip i izaberite željeni format.
5. Kliknite na dugme Preuzmi.

Da biste uredili ili pregledali dokument:

1. Pronađite potrebni fajl.
2. Kliknite na dugme Uredi u ONLYOFFICE.

Dokument će biti otvoren u ONLYOFFICE uređivaču.

Da biste zajednički uređivali dokument, autorizovani korisnici treba da otvore isti fajl zajedno.

Da biste kreirali formular:

1. Otvorite stranicu na kojoj treba da kreirate fajl.

2. Kliknite na dugme Novi dokument i izaberite opciju Formular.

   

3. Unesite naziv fajla u tekstualno polje pored ikone tipa fajla.

4. Izaberite .docx fajl priložen na ovoj ili drugim stranicama ili izaberite opciju Kreiraj iz praznog.

5. Formular će biti otvoren u ONLYOFFICE Docs uređivaču.

6. Sačuvajte formular kao PDF da biste imali budući pristup uređivanju, reviziji ili saradnji.

Da biste kreirali formular koji se može popuniti i ograničili uređivanje fajla od strane drugih korisnika:

1. Idite na Priloge.

2. Kliknite na link Kreiraj formular koristeći ONLYOFFICE desno od PDF fajla. Fajl će biti kreiran u sekciji Prilozi.

   

Da biste popunili formular:

1. Idite na Priloge.

2. Kliknite na link Popuni formular u ONLYOFFICE desno od PDF fajla.

   

3. Formular će biti otvoren u ONLYOFFICE Docs uređivaču.

note

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

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.