ONLYOFFICE Docs 9.0 za programere: API ažuriranja

2 July 2025By Marko Todorovic

Najnovije izdanje ONLYOFFICE Docs je ovde, ispunjeno ažuriranjima koja donose više funkcionalnosti, bolju prilagodljivost i poboljšane performanse. Ako ste developer ili integrator koji želi da iskoristi unapređene API-je, ima puno toga za istraživanje u ovoj verziji. Pogledajte sve detalje u nastavku.

ONLYOFFICE Docs 9.0 for developers: API updates

Pregled dijagrama

Novi Pregled dijagrama je dostupan za web, desktop i mobilne platforme. Omogućava otvaranje datoteka dijagrama bez potrebe za bilo kojim aplikacijama trećih strana.

Gde pronaći u API-u: dijagram tip dokumenta je dodat u documentType parametar.

Podrška za nove formate fajlova

ONLYOFFICE nastavlja da proširuje svoju upotrebljivost podržavajući dodatne formate datoteka. U verziji 9.0, moguće je otvoriti Markdown i OpenDocument grafičke datoteke za pregled.

Gde pronaći u API-ju: dodato otvaranje za odg i md formate.

Pored toga, sa pokretanjem Diagram Viewer-a, dodali smo konverziju iz vsdm, vsdx, vssm, vssx, vstm i vstx formata. . Proverite API.

ONLYOFFICE Docs 9.0 for developers: API updates

Proširene opcije prilagođavanja

Prilagodljivost je dostigla nove visine u verziji 9.0, osnažujući vaše krajnje korisnike da prilagode svoje ONLYOFFICE iskustvo baš onako kako im treba.

Nove UI teme

Predstavljene su dve nove teme, Modern Light i Modern Dark, kako bi se optimizovao izgled i osećaj svakog urednika.

Gde pronaći u API-ju: id-ovi tema theme-white i theme-night su dodati editorConfig.customization.uiTheme parametru.

const config = {
  editorConfig: {
    customization: {
...
      uiTheme: "theme-white",
...

ONLYOFFICE Docs 9.0 for developers: API updates

Izbor veličine fonta za pojednostavljeni kineski interfejs

Novi parametar obezbeđuje tačno veličinu fonta u pojednostavljenim kineskim rasporedima, nudeći fleksibilnost da se koriste bilo koji zapadni ili tradicionalni kineski stilovi.

Gde pronaći u API-ju: editorConfig.customization.forceWesternFontSize parametar, podrazumevana vrednost je lažna.

const config = {
  editorConfig: {
    customization: {
....
 forceWesternFontSize: false,
...

Skrivanje avatara korisnika

Novi parametar vam omogućava da uključite ili isključite avatare korisnika u zaglavlju uređivača, čime se pomaže u stvaranju čistog interfejsa, bez smetnji.

Gde pronaći u API-ju: editorConfig.customization.layout.header.user parametar, podrazumevana vrednost je tačna.

const config = {
  editorConfig: {
    customization: {
...
layout: {
        header: {
          editMode: true,
          save: true,
          user: true,
          users: true,
        },

Povećanje performansi sa preučitavanjem

Počevši od verzije 9.0, možete unapred učitati statičke resurse (HTML, CSS, JS, fontove) u keš pretraživača pre nego što otvorite datoteku kako biste ubrzali inicijalno učitavanje uređivača dokumenata. Proverite API

Dve opcije su dostupne:

1) Koristeći ?preload=placeholder parametar

<div id="placeholder"></div>

<script type="text/javascript" src="https://documentserver/web-apps/apps/api/documents/api.js?preload=placeholder"></script>

2) Ručno umetanje preloader iframe-a

<iframe src="https://documentserver/web-apps/apps/api/documents/preload.html" style="display:none;"></iframe>

Preuzmite najnoviju verziju ONLYOFFICE Docs Developer:

PREUZMITE SADA

API unapređenja za pluginove i makroe

Prilagođeni dugmići za Kontrole sadržaja. Koristite Asc.ButtonContentControl klasu za kreiranje jedinstvenih dugmića za vaše plugine. Definišite radnje koristeći attachOnClick metodu i dodajte svoje ikone za poboljšanje funkcionalnosti. Proverite API

(function(window){
  window.Asc.plugin.init = function()
  {
    let button = new Asc.ButtonContentControl();
    button.icons = '/resources/check%scale%(default).png';
    button.attachOnClick(function(contentControlId){
      Asc.plugin.executeMethod("RemoveContentControl", [contentControlId]);
    });
 
    button = new Asc.ButtonContentControl();
    button.icons = '/resources/close%scale%(default).png';
    button.attachOnClick(function(contentControlId){
      Asc.plugin.executeMethod("RemoveContentControls", [[{"InternalId": contentControlId}]]);
    });
  }
})(window);

Postavljanje aktivnog slajda prema njegovom indeksu. Lako pređite na bilo koji slajd unutar prezentacija koristeći novu GoToSlide metodu.

expression.GoToSlide(slideNumber);

Element liste kontrole sadržaja. Uvođenje enumeracije ContentControlListElement čini upravljanje kontrolama sadržaja unutar dokumenata još jednostavnijim.

Asinhroni proračuni. Upravljajte svakim zahtevom unutar tela prilagođene funkcije kreirane pomoću makrosa.

(function () {
  /**
   * World Bank indicator value for a specific year.
   * @customfunction

   * @param   {string} country   ISO-3 code, e.g. "TUR"
   * @param   {string} indicator Indicator code, e.g. "SP.POP.TOTL"
   * @param   {number} year      Four-digit year, e.g. 2024
   * @returns {any}             Numeric value or #N/A
   *
   * @example =WB("TUR","SP.POP.TOTL",2024)
   */
  async function WB(country, indicator, year) {
    // Build URL (World Bank allows CORS)
    const url =
      `https://api.worldbank.org/v2/country/${country}/indicator/${indicator}` +
      `?format=json&per_page=20000`;

    try {
      const r = await fetch(url);
      const [meta, data] = await r.json();

      // Find the row for the requested year
      const row = data.find((v) => v.date === year.toString());
      if (!row || row.value == null) return "#N/A";

      return row.value;               // resolves the Promise
    } catch (e) {
      return "#ERROR";
    }
  }

  // Register the function so it becomes a sheet formula
  Api.AddCustomFunction(WB);
})();

Novi uzorci

Sa najnovijim ažuriranjem API dokumentacije, uključili smo još više gotovih primera za Document Builder i makroe, čineći vaš proces razvoja lakšim i efikasnijim.