ONLYOFFICE 10.0 za programere: Šta je novo

ONLYOFFICE 10.0 donosi solidan set ažuriranja za programere koji razvijaju aplikacije preko editora. Dobijate nove krajnje tačke koje olakšavaju upravljanje datotekama, uređivanje PDF-a u Document Builder-u, i modernizovanu Plugin API sa asinhronim metodama. Ova verzija takođe dodaje nove kontrole za AI funkcije i sigurnije podrazumevane postavke širom servera.

Ispod je brzi pregled promena koje su najvažnije za vaša povezivanja, plus nekoliko promena u ponašanju koje treba proveriti pre nego što nadogradite.

AI alati, AI opcije prilagođavanja i upravljanje AI na serveru

ONLYOFFICE Docs 10.0 donosi AI alate u svaki editor. Više od osnovnog generisanja teksta, oni razumeju strukturu dokumenata, prepoznaju elemente, povezuju sadržaj širom sekcija i kreiraju klikabilne reference za lakšu navigaciju. Možete povezati bilo koji AI model, uključujući lokalne modele za slučajeve koji zahtevaju privatnost, i dodeliti različite modele različitim zadacima.

U komercijalnim izdanjima ONLYOFFICE Docs 10.0, administratori mogu jednogodišnje konfigurisati AI provajdere u Administratorskom panelu. Kada se postave, korisnici editora dobijaju spremne AI alate bez potrebe da unose svoje API ključeve. Administratori mogu dodeliti različite modele za specifične zadatke, povezati MCP servere za pristup spoljnim alatima, i kontrolisati da li je web pretraga dostupna. Nakon što je konfiguracija na serveru sačuvana, korisnici su ograničeni na odobrene provajdere i modele – više ne mogu dodavati svoje ključeve ili menjati koji se model koristi. Saznaj više

Vi odlučujete da li se AI alati pojavljuju u vašem proizvodu. Verzija 10.0 daje vam dva nivoa kontrole:

• Po instanci editora: Koristite editorConfig.customization.ai sa disabled parametrom da sakrijete AI funkcije u specifičnoj konfiguraciji editora.
• Server-wide: Koristite aiSettings.enable serverske postavke da isključite AI funkcije i isključite AI Alate iz /plugins.json.

Ovo je zgodno ako služite različitim nivoima korisnika, ili ako neka implementacija treba da ostane bez AI iz razloga usklađenosti.

Modularne aplikacije

ONLYOFFICE Docs 10.0 uvodi modularne aplikacije – novi način da se proširi funkcionalnost editora bez promena u njihovom jezgru. Aplikacije kao što su AI agenti, Obrasci, Sobe, i Datoteke se integrišu u ONLYOFFICE Docs i dodaju novu funkcionalnost.

Za programere, to znači da možete omogućiti samo one mogućnosti koje vaši korisnici trebaju, zadržati ekvivalent vaših integracija i širiti se korak po korak kako se vaš proizvod razvija.

Poboljšanja sigurnosti i arhitekture

Verzija 10.0 pomera nekoliko zaštita na “uključeno po defaultu”, tako da nove integracije počinju sa sigurnijom osnovom.

• JWT uključeno po defaultu. JWT je sada uključen u default.json.
• Strože rukovanje tokenima. Ako je tajna prazna ili nije postavljena, uključujući tajne zakupca, ONLYOFFICE Docs sada odbacuje token umesto da ga verifikuje ili potpisuje.
• Scoped tokeni za servisne API-je. /converter, /docbuilder, i /command više ne prihvataju token iz konfiguracije editora. Novi operation polje u tokenu je opciono za ove zahteve i obavezno za /converter/from-file i /docbuilder/from-file.
• Provera integriteta za preuzete datoteke. Kada vaša integracija šalje zaglavlja integriteta, server proverava preuzete datoteke u odnosu na njih. Podržana zaglavlja uključuju Content-Digest, Repr-Digest, x-amz-checksum-*, i WOPI SHA256. Ovo se kontroliše pomoću services.CoAuthoring.requestDefaults.checksumVerification, što je true po defaultu.
• Eksplicitni WOPI hostovi. WOPI hostovi sada moraju biti dozvoljeni pravilom filtera IP adresa. Wildcard allow: * pravilo više nije dovoljno, pa bi svaki host trebalo eksplicitno navesti.
• Kontrole pristupa API-ju. Koristite services.CoAuthoring.server.convertServiceEnable i services.CoAuthoring.server.docbuilderEnable da isključite javne konverzije i Document Builder API-je. Obe su true po defaultu.
• Tajnija runtime konfiguracija. Sada se samo nivo logovanja log4js-a može promeniti putem runtime.json.

Pogledajte najnovije bezbednosne ispravke

Uređivanje PDF-a u Document Builder-u

Document Builder sada može uređivati PDF dokumente, što otvara vrata mnogim novim automatizovanim scenarijima:

• OpenFile pametno upravlja PDF-ovima. PDF obrasci kreirani u ONLYOFFICE-u otvaraju se u editoru dokumenata. Ostali PDF-ovi otvaraju se u PDF editoru sa punim pristupom PDF API.
• PDF-ovi zaštićeni lozinkom. Novi m_sPassword parametar u OpenFile omogućava vam da otvorite zaštićene datoteke.
• Stvaranje PDF obrazaca. Pozovite CreateFile sa pdf tipom za kreiranje PDF obrazaca.

Na strani servera, obrasci sačuvani kao obični PDF-ovi sada se potpisuju kada ih korisnici podnose. Ovo vam daje dodatni sloj poverenja u vaše tokove rada sa obrascima.

Alexander Trofimov, šef tima za razvoj editora u ONLYOFFICE-u:

Sa ONLYOFFICE Docs 10.0, učinili smo editore još sigurnijim za vaše integracije. Pored toga, ova verzija donosi sveobuhvatnu podršku za PDF u Document Builder-u, tako da programeri i krajnji korisnici mogu kreirati, uređivati i upravljati PDF-ovima direktno iz Builder-a bez oslanjanja na alternativne metode ili alate trećih strana.

Implementacija i ažuriranja administratora

Izvršavanje ONLYOFFICE Docs u produkciji je takođe postalo lakše:

• Administratorski panel se pokreće sa serverom. U komercijalnim izdanjima, Administratorski panel se sada automatski pokreće po defaultu. Takođe uključuje blokove za pregled tajne JWT i dugmadi za otvaranje i pokretanje ili zaustavljanje testnog primera.
• CLI za kreiranje administratora. Sada možete kreirati prvog administratora preko documentserver-admin host CLI-a, koristeći create-admin i reset-admin-password. Ovo zamenjuje staru web stranicu koja je zavisila od bootstrap logova.
• Automatsko ponovno uspostavljanje nesačuvanih promena. Ako server prestane sa radom, nesačuvana promena se automatski obnavlja u “zaboravljene datoteke”. Poseban changes2forgotten skript je uklonjen.
• Novi podrazumevani port. DEB i RPM instalacije sada koriste port 8083 po automatizmu. Ažurirajte vaša pravila za proxy i firewall ako je potrebno.
• Bolje praćenje. Nova coauth.connections metrika uključuje mode (edit, liveview, view) i replica oznake.
• Desktop ažuriranje zastavica. Na Windows-u, --prefer-alternate-url komandna zastavica omogućava Desktop Editorima da preuzimaju ažuriranja iz alternativnog izvora.
• Osvežena stranica dobrodošlice. Stranica dobrodošlice servera dobila je novi dizajn.

Podrška za nove formate datoteka

Verzija 10.0 dodaje dva ažuriranja formata koja vam pomažu da obradite više dokumenata uz manje prilagođenog rada:

• OFD pregled i konverzija. Možete otvoriti i pretvoriti ofd datoteke. Kao xps, one se otvaraju u režimu samo za pregled.
• Konverzija u XLS. Možete pretvoriti bilo koji format proračunske tabele u klasični xls format. Ovo je korisno kada vaši korisnici ili partneri i dalje zavise od nasleđenih sistema.

Višedelne krajnje tačke za direktno učitavanje datoteka

Do sada su usluge za konverziju i Document Builder preuzimale izvorne datoteke sa URL-a. To znači da ste morali hostovati datoteku negde gde server može da pristupi. Verzija 10.0 dodaje dve nove krajnje tačke koje uklanjaju ovaj korak:

• POST /converter/from-file
• POST /docbuilder/from-file

Obe prihvataju podatke u multipart/form-data formatu. Možete poslati datoteku ili skript direktno u zahtevu, tako da je ne morate izlagati putem privremenog URL-a.

Ovo je čišća opcija za mnoge tokove rada. Na primer, backend usluga može konvertovati korisničke uplode u hodu, ili pokrenuti Document Builder skript bez prethodnog upravljanja datotekama.

Primer zahteva: konvertovanje TXT u DOCX

curl -f -X POST "https://documentserver/converter/from-file" 
  -F 'params={"filetype":"txt","outputtype":"docx","title":"Naslov primera dokumenta.txt"}' 
  -F 'file=@example.txt' 
  -o "Naslov primera dokumenta.docx"

Modernizacija Plugin API-ja

Plugins i Macros API su dobili najveće osveženje u poslednje vreme.

Novi globalni Editor objekt

Metode se sada pozivaju kao regularne funkcije koje vraćaju Promise. Umesto da se svako pozivanje usmerava preko window.Asc.plugin.executeMethod, možete pisati čist asinhroni kod:

const text = await Editor.GetSelectedText();

Rezultat je kraći, lako čitljiv kod koji se prirodno uklapa u moderne JavaScript projekte.

nove metode i događaji

Verzija 10.0 takođe dodaje nove alate za izgradnju bogatijih dodataka:

• Metode: Editor.RunMacro, GetRestrictions, SetButtonDisabled, GetOFormRole
• Događaji: onFloatActionButtonClick, onSelectionEnd, onSelectionCancel

Na primer, događaji selekcije omogućavaju vašem dodatku da reaguje in trenutku kada korisnik završi ili otkaže selekciju.

Proverite potpunu listu izmena za Plugins API

Počnite sa izradom sa ONLYOFFICE 10.0

Verzija 10.0 pruža vam čistije API-je, veću automatizaciju i sigurnije podrazumevane postavke. Evo brzi plan da izvučete najviše od toga:

• Pregledajte promene u ponašanju. Proverite korišćenje tokena, WOPI pravila filtera IP, i novi podrazumevani port.
• Ažurirajte vaše dodatke. Pređite na globalni Editor objekat i zamenite sve preimenovane ili uklonjene metode.
• Isprobajte nove krajnje tačke. Testirajte /converter/from-file i /docbuilder/from-file u vašim tokovima rada za konverziju.
• Odaberite AI. Podesite editorConfig.customization.ai ili aiSettings.enable da odgovara potrebama vašeg proizvoda.

PREUZMITE PROGRAMERSKE VERZIJE

Radite sa cloud verzijom ONLYOFFICE Docs? Isprobajte Docs Connect za lakši način povezivanja editora sa spoljnim platformama i uslugama. Za razliku od samostalne verzije ONLYOFFICE Docs koja zahteva da implementirate i održavate editore na svojim serverima, Docs Connect preuzima hosting, održavanje, i redovna ažuriranja za vas.

Proverite potpunu evidenciju izmena za sve detalje, i podelite svoje povratne informacije na ONLYOFFICE forumu zajednice. Radujemo se da vidimo šta ćete izgraditi!