Pređi na glavni sadržaj

Redmine

O integraciji ONLYOFFICE i Redmine​

ONLYOFFICE nudi zvanični konektor za integraciju ONLYOFFICE Docs sa Redmine kako bi se omogućila saradnja na kancelarijskim dokumentima priloženim uz sledeće Redmine module: Problemi, Fajlovi, Dokumenti, Wiki i Vesti. ONLYOFFICE konektor možete preuzeti sa Redmine Marketplace-a ili sa ONLYOFFICE GitHub stranice. Aplikacija se distribuira pod Apache licencom.

note

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

Glavne funkcije​

  • Pregled i uređivanje tekstualnih dokumenata, tabela i prezentacija iz Redmine modula u zavisnosti od korisničkih prava pristupa.
  • Kreiranje i popunjavanje online obrazaca.
  • Saradnja u realnom vremenu: dva režima uređivanja (Brzi i Strogi), režim Praćenja promena, komentari i ugrađeni chat.
  • Podrška za JWT kako bi se obezbedio vaš saobraćaj tako da niko osim korisnika sa odgovarajućim pravima ne može pristupiti vašim dokumentima.

Podržani formati​

  • Za kreiranje i uređivanje: DOCX, PPTX, XLSX
  • Za popunjavanje obrazaca: PDF
  • Za pregled: DOC, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF, TXT, HTML, HTM, MHT, XML, PDF, DJVU, FB2, EPUB, XPS, XLS, XLSM, XLT, XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTM, POT, POTX, POTM, ODP, FODP, OTP.

Novosti u verziji 3.1.0​

Funkcije

  • Popunjavanje pdf umesto oform.

Ispravljeno

  • Ispravljen ručni pregled zavisnosti verzije.

Kompletan dnevnik promena je dostupan ovde.

Povezivanje ONLYOFFICE Docs sa Redmine​

Zahtevi​

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

    Potrebna vam je instanca ONLYOFFICE Docs koja je dostupna i povezana i sa Redmine i sa bilo kojim krajnjim klijentima. Mora biti u mogućnosti da POST-uje direktno na Redmine.

    note

    Molimo vas da se obratite zvaničnoj stranici dokumentacije kako biste saznali više o instalaciji ONLYOFFICE Docs.

  • Redmine v4.0.0 - v5.0.x. Ako ste novi u Redmine, instalirajte ga prateći ove instrukcije.

  • ONLYOFFICE Connector v2.0.0 za Redmine

Instalacija ONLYOFFICE konektora za Redmine​

  1. Preuzmite ONLYOFFICE integracioni dodatak za Redmine. Postoji nekoliko načina da to uradite:

    1. Preuzmite najnoviju arhiviranu verziju sa Redmine Marketplace-a.

    2. Preuzmite najnoviju arhiviranu verziju sa ONLYOFFICE GitHub stranice:

      wget https://github.com/ONLYOFFICE/onlyoffice-redmine/archive/refs/tags/vX.X.X.tar.gz

      Gde je vX.X.X potrebna verzija konektora.

      Raspakujte arhivu:

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

    3. Klonirajte master granu:

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

    4. Pre instalacije dodatka, uverite se da je Redmine instanca zaustavljena.

    5. Idite u fasciklu Redmine ONLYOFFICE integracionog dodatka i preuzmite podmodul:

      cd onlyoffice-redmine
      git submodule update --init --recursive
    note

    Poddirektorijum dodatka mora biti nazvan onlyoffice_redmine. Preimenujte kloniranu fasciklu onlyoffice-redmine ili raspakovanu fasciklu onlyoffice_redmine-X.X.X u onlyoffice_redmine.

    mv onlyoffice-redmine onlyoffice_redmine
    mv onlyoffice-redmine-X.X.X onlyoffice_redmine

  2. Stavite direktorijum dodatka onlyoffice_redmine u direktorijum plugins, npr.:

    cp -r /root/onlyoffice_redmine/. /redmine/plugins/onlyoffice_redmine
    note

    Putanja do direktorijuma plugins može se razlikovati u zavisnosti od opcija instalacije Redmine-a. Možete koristiti komandu find / -type d -name plugins da pronađete putanju.

  3. Idite u korenski direktorijum Redmine-a:

    cd redmine

  4. Instalirajte zavisnosti:

    bundle install

  5. Inicijalizujte/ažurirajte bazu podataka:

    RAILS_ENV=production bundle exec rake db:migrate
    RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine

  6. Ponovo pokrenite Redmine instancu.

Konfigurisanje ONLYOFFICE konektora za Redmine​

Idite na Administracija panel > Dodaci, pronađite ONLYOFFICE integracioni dodatak za Redmine i kliknite na Konfiguriši. Navedite sledeće parametre:

  • Adresa servisa za uređivanje dokumenata - unesite URL adresu i port na kojem je instaliran ONLYOFFICE Docs (npr. https://documentserver:8080). Ovo polje je obavezno.

    note

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

  • Sekcija Napredna podešavanja servera može se koristiti ako vaša mrežna konfiguracija ne dozvoljava zahteve između instaliranog Redmine i ONLYOFFICE Docs koristeći javne adrese. U tom slučaju, navedite adrese za interne zahteve u odgovarajućim poljima:

    • Adresa ONLYOFFICE Docs za interne zahteve sa servera - navedite adresu koja se koristi za pristup Servisu za uređivanje dokumenata iz Redmine.
    • Adresa servera za interne zahteve iz ONLYOFFICE Docs - navedite adresu koja se koristi za pristup Redmine iz Servisa za uređivanje dokumenata.

  • Tajni ključ - navedite tajni ključ 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. Potrebno je da ga omogućite i na strani Redmine-a: pronađite svoj tajni ključ u konfiguracionom fajlu ONLYOFFICE Docs, a zatim navedite isti tajni ključ u postavkama konektora. Za više detalja, pogledajte sekciju Omogućavanje JWT za integraciju ONLYOFFICE i Redmine u ovom članku.

  • Onemogući verifikaciju sertifikata (nesigurno) - označite ovu opciju da biste onemogućili verifikaciju sertifikata i omogućili Redmine da uspostavi vezu sa ONLYOFFICE Docs ako koristite samopotpisani sertifikat za vaš ONLYOFFICE Docs (inače, Redmine neće validirati samopotpisani sertifikat i neće omogućiti vezu sa/do ONLYOFFICE Docs). Ovo je nesigurno rešenje i snažno preporučujemo da zamenite sertifikat onim koji je izdao neki CA.

  • Proverite sledeće postavke prilagođavanja ako je potrebno:

    • Prikazivanje dugmeta Chat u meniju.
    • Prikazivanje zaglavlja na kompaktniji način.
    • Prikazivanje dugmeta Povratne informacije u meniju.
    • Prikazivanje dugmeta Pomoć u meniju.
    • Prikazivanje jednobojnog zaglavlja alatne trake.

Kliknite na dugme Primeni na dnu da biste sačuvali promene.

ONLYOFFICE_configure

Omogućavanje JWT za integraciju ONLYOFFICE i Redmine​

Da biste zaštitili dokumente od neovlašćenog pristupa, ONLYOFFICE urednici koriste JSON Web Token (JWT). Token se dodaje u konfiguraciju kada se pokreće Urednik dokumenata 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 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 urednika.

    • Za Linux - /etc/onlyoffice/documentserver/local.json

    • Za Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

    • Za Docker – uđite u kontejner ONLYOFFICE Docs 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.

Povezivanje sa demo ONLYOFFICE Docs​

Počevši od verzije 2.0.0 ONLYOFFICE konektora, možete isprobati ONLYOFFICE online urednike unutar Redmine-a bez instalacije ONLYOFFICE Docs.

Da biste uključili vezu, označite polje Poveži se sa demo ONLYOFFICE Document Server i kliknite na dugme Primeni.

Važno

Ovo je javni test server koji će biti dostupan tokom perioda od 30 dana. Ne delite svoje poverljive podatke tamo.

Počnite koristiti ONLYOFFICE Docs unutar Redmine-a​

note

Sve promene u fajlovima se čuvaju u originalnom fajlu.

Promena dozvola​

Imajte na umu da dostupne akcije sa fajlovima (pregled ili uređivanje) za svaki pojedinačni modul zavise od dozvola korisničke uloge.

Idite na Administracija > Uloge i dozvole, izaberite potrebnu ulogu sa liste, označite/odznačite potrebne dozvole i kliknite Sačuvaj.

Možete se obratiti zvaničnoj dokumentaciji Redmine-a za više detalja.

Modul za probleme​

Da biste otvorili fajlove priložene uz probleme ili komentare na probleme u odgovarajućem uredniku, kliknite na dugme ONLYOFFICE ikona Uredi u ONLYOFFICE / Otvori u ONLYOFFICE desno od imena fajla.

Mogućnost uređivanja dokumenata je dostupna za korisničke uloge sa dozvolom Uredi probleme.

Mogućnost otvaranja fajlova za pregled je dostupna za korisničke uloge sa dozvolom Pogledaj probleme.

Modul za probleme

Fajlovi modul​

Fajlovi su dostupni samo za pregled i isključivo korisnicima sa dozvolama Pogledaj fajlove ili Upravljaj fajlovima. Da biste otvorili fajl u odgovarajućem editoru, kliknite na dugme ONLYOFFICE ikona Otvori u ONLYOFFICE desno od naziva fajla.

Fajlovi modul

Modul za dokumente​

Da biste otvorili fajlove u odgovarajućem uredniku, kliknite na dugme ONLYOFFICE ikona Uredi u ONLYOFFICE / Otvori u ONLYOFFICE desno od imena fajla.

Mogućnost uređivanja dokumenata je dostupna za korisničke uloge sa dozvolom Uredi dokumente.

Mogućnost otvaranja fajlova za pregled je dostupna za korisničke uloge sa dozvolom Pogledaj dokumente.

Modul za dokumente

Da biste kreirali obrazac, kliknite na link Kreiraj u ONLYOFFICE i izaberite opciju Šablon obrasca.

Kreiranje obrasca

Popunite potrebna polja i kliknite Kreiraj.

note

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

Wiki modul​

Da biste otvorili fajlove u odgovarajućem editoru, kliknite na dugme ONLYOFFICE ikona Uredi u ONLYOFFICE / Otvori u ONLYOFFICE desno od naziva fajla.

Mogućnost uređivanja dokumenata dostupna je za korisničke uloge sa dozvolom Uredi Wiki stranice.

Mogućnost otvaranja fajlova za pregled dostupna je za korisničke uloge sa dozvolom Pogledaj Wiki.

Wiki modul

Modul za vesti​

Da biste otvorili fajlove u odgovarajućem uredniku, kliknite na dugme ONLYOFFICE ikona Uredi u ONLYOFFICE / Otvori u ONLYOFFICE desno od imena fajla.

Mogućnost uređivanja dokumenata je dostupna za korisničke uloge sa dozvolom Uredi vesti.

Mogućnost otvaranja fajlova za pregled je dostupna za korisničke uloge sa dozvolom Pogledaj vesti.

Modul za vesti

Konvertovanje fajlova​

Mogućnost konvertovanja fajlova dostupna je u sledećim Redmine modulima: Problemi, Dokumenti, Wiki i Vesti.

Konvertovanje fajlova

Kliknite na dugme ONLYOFFICE ikona Konvertuj sa ONLYOFFICE desno od naziva fajla.

Izaberite potreban format sa liste. Opcionalno, možete promeniti naziv fajla.

Konvertovanje fajlova

Kliknite na dugme Konvertuj da biste sačuvali konvertovani fajl u odgovarajućem Redmine odeljku. Kliknite na dugme Preuzmi da biste sačuvali konvertovani fajl lokalno na vašem računaru.