Kako napisati JavaScript makronaredbe u ONLYOFFICE dokumentima

Morate li raditi s Word dokumentima, Excel proračunskim tablicama ili PowerPoint prezentacijama i morate uvijek iznova ponavljati složene zadatke? Na primjer, trebate istaknuti duplicirane vrijednosti na listu ili ukloniti oblike sa slajdova prezentacije.

Ako je to slučaj, to bi moglo biti izazovno za vas kao korisnika Linuxa. Ručno obavljanje takvih zadataka je besmisleno. Puno različitih operacija može se lako izvesti automatski s VBA makronaredbama u Microsoft Officeu. Međutim, postoji ozbiljan problem - oni izvorno ne rade na Linux strojevima.

Međutim, postoji genijalno rješenje za ovaj problem. Možete pisati i pokretati JavaScript makronaredbe u ONLYOFFICE Dokumentima za obavljanje monotonih operacija.

Pročitajte ovaj članak da biste saznali kako.

Što je ONLYOFFICE Dokumenti?

ONLYOFFICE Docs je uredski paket otvorenog koda koji se samostalno hostira i dizajniran je za stvaranje lokalnog okruženja za suradnju na Linux ili Windows poslužitelju.

Donosi prednosti uređivanja dokumenata i suautorstva u stvarnom vremenu velikom broju rješenja za dijeljenje datoteka, platformi za e-učenje i sustava za upravljanje dokumentima.

Trenutno je kompatibilan s Nextcloudom, ownCloudom, Seafileom, Ploneom, Confluenceom, Alfrescom, Redmineom, WordPressom, Chamilom, Moodleom, Drupalom i drugim softverom. Integracija je moguća putem konektora spremnih za korištenje koji su dostupni na GitHubu.

Korištenjem ONLYOFFICE Docs možete raditi sa svim popularnim vrstama uredskih datoteka, uključujući tekstualne dokumente, proračunske tablice, obrasce koji se mogu ispuniti, slajdove i PDF-ove.

Izvorni format ONLYOFFICE Docs je OOXML (DOCX, XLSX, PPTX), tako da može lako zamijeniti Microsoft Office na Linux strojevima. Ostali popularni formati, poput ODF-a, podržani su putem automatske pretvorbe u OOXML.

Uz svoju inačicu s vlastitim hostom, ONLYOFFICE Docs ima besplatnu verziju u oblaku za osobnu upotrebu. Također, postoje besplatne aplikacije za sve popularne desktop i mobilne platforme, uključujući Windows, macOS, Linux, Android i iOS.

Kada je u pitanju automatizacija zadataka, ONLYOFFICE Docs nije kompatibilan s Microsoftovim VBA makronaredbama. Koristi JavaScript makronaredbe koje mogu izvesti iste operacije na puno sigurniji način.

Početak rada s makronaredbama za ONLYOFFICE Dokumente

Makro je mala skripta koja olakšava rad s različitim vrstama dokumenata automatiziranjem određenog zadatka. Drugim riječima, to je dio programskog koda koji sadrži skup radnji koje možete pokretati onoliko često koliko želite.

Na primjer, možete pokrenuti odgovarajuću makronaredbu kako biste različitim bojama označili duplikate u odabranom području u proračunskoj tablici.

U ONLYOFFICE Dokumentima to izgleda ovako:

Koja je praktična korisnost ovog makronaredbe? Kada radite s podacima, možete pokrenuti spremljenu makronaredbu u roku od nekoliko sekundi klikom na odgovarajući gumb za označavanje dupliciranih vrijednosti onoliko puta koliko je potrebno, što će vam uštedjeti sate vremena.

Glavni razlozi zašto su makronaredbe ONLYOFFICE dobre

U ONLYOFFICE Docs makronaredbe se temelje na JavaScript sintaksi i API metodama ONLYOFFICE Document Buildera. Postoji nekoliko očitih razloga zašto su bolji od VBA makronaredbi:

  • ONLYOFFICE makronaredbe su višeplatformske – Za razliku od Visual Basica, JavaScript je uobičajeniji programski jezik. Stoga se JavaScript makronaredbe mogu lako pokrenuti na Windows, Linux i macOS platformama.
  • ONLYOFFICE makronaredbe jednostavne su za korištenje – JavaScript se često preporučuje početnicima i ima zajednicu koja brzo raste. Mnogi ljudi odabiru JavaScript kao svoj prvi programski jezik jer na Internetu postoji mnogo detaljnih uputa i vodiča.
  • ONLYOFFICE makronaredbe su sigurne – JavaScript kôd ONLYOFFICE makronaredbi pokreće se u istom prozoru kao i uređivači. Stoga ih napadači ne mogu koristiti za kompromitiranje vašeg sustava jer mu nemaju pristup.

Kako rade makronaredbe ONLYOFFICE

ONLYOFFICE makro kombinacija je JavaScript sintakse i API metoda ONLYOFFICE Document Buildera.

ONLYOFFICE Document Builder je C++ biblioteka koja se koristi za stvaranje i uređivanje Office Open XML datoteka, kao i za spremanje ne-OOXML datoteka u DOCX, XSLX, PPTX i PDF formate. Radi s JavaScript API-jem.

Postoji mnogo metoda ONLYOFFICE API i vjerojatno nećete koristiti većinu njih. Ovo su neki praktični primjeri:

  • Metoda SetFillColor dizajnirana je za promjenu boje pozadine trenutnog raspona ćelija u boju prethodno stvorenog objekta u boji.
  • Metoda GetValue vraća vrijednost navedenog raspona.
  • Metoda GetSlideByIndex vraća slajd na njegovu poziciju u prezentaciji.
  • I mnogo više.

Detaljan opis svih metoda ONLYOFFICE API i onoga što one rade možete pronaći u službenoj dokumentaciji.

U ONLYOFFICE Dokumentima makronaredbe se mogu stvarati i brisati putem posebnog dodatka na gornjoj alatnoj traci. Da biste mu pristupili, otvorite karticu Dodaci i kliknite gumb Makronaredbe. Vidjet ćete prozor u kojem ćete moći napisati JavaScript kod za svoje makronaredbe.

Pomoću odgovarajućih gumba možete izraditi nove makronaredbe i izbrisati postojeće. Također vam je dopušteno preimenovati makronaredbe, pa čak i aktivirati značajku automatskog pokretanja.

Kako napisati ONLYOFFICE makronaredbu

Sada kada razumijete kako rade ONLYOFFICE makronaredbe, napišimo jednu. Prije nego što počnemo, potrebno je odlučiti koji će zadatak biti obavljen s našim makroom.

Počnimo s nečim jednostavnim i zamislimo da trebamo promijeniti boju pozadine ćelije u našem Excel radnom listu. Ovaj zadatak je jednostavan, ali makronaredba koju ćemo izraditi učinit će ga mnogo jednostavnijim.

Za početak idite na karticu Dodaci i kliknite Makronaredbe. Ako prvi put otvorite ovaj prozor, tamo ćete pronaći već kreiranu makronaredbu. Međutim, u ovoj makronaredbi neće biti JavaScript koda. Ono što ćete vidjeti je jednostavan omotač funkcije:

(function()
{
    // ... your code here ...
})();

Preimenujte svoju makronaredbu ako je potrebno.

Sada možete početi pisati svoj kod. Nakon konzultacije s dokumentacijom ONLYOFFICE Document Builder API-ja koja je već spomenuta u prethodnom poglavlju, znat ćete da se sljedeće metode trebaju koristiti za vašu makronaredbu:

  • Metoda Api.GetActiveSheet za dobivanje aktivnog lista.
  • Metoda GetRange za postavljanje potrebnog raspona.
  • Metoda SetFillColor za postavljanje boje pozadine potrebne ćelije.
  • Api.CreateColorFromRGB za postavljanje željene boje.

Najprije trebate nabaviti aktivni list i postaviti traženi raspon upisivanjem odgovarajućih metoda Let’s target cell A2. Počnite upisivati nazive metoda u ovoj funkciji i vidjet ćete sve dostupne opise alata, što je vrlo zgodno.

Zatim trebate postaviti boju pozadine trenutne ćelije. Da biste to učinili, upotrijebite metodu SetFillColor. Metoda Api.CreateColorFromRGB omogućit će vam da postavite boju koja vam se sviđa. Vaš kod bi trebao biti sljedeći:

(function()
{
    // Api.GetActiveSheet().GetRange("A2").SetFillColor(Api.CreateColorFromRGB(0, 0, 210));
})();

Sada je vrijeme da pokrenete makro i vidite rezultate. Nakon što kliknete gumb Pokreni, vidjet ćete da je ćelija A2 obojena. Možete se igrati s različitim bojama promjenom vrijednosti u metodi Api.CreateColorFromRGB.

Ako ne želite naučiti osnove JavaScript kodiranja za izradu ONLYOFFICE makronaredbi, uvijek možete koristiti gotove primjere makronaredbi sa službene web stranice i modificirati ih prema svojim potrebama .

Zaključak

Kao što vidite, stvaranje makronaredbi u ONLYOFFICE Dokumentima nije tako teško kao što se čini na prvi pogled. Naravno, trebate poznavati osnove JavaScript kodiranja da biste izradili složene makronaredbe s desecima linija koda.

Međutim, stvaranje jednostavnih makronaredbi za svakodnevne rutinske aktivnosti ne zahtijeva da budete JavaScript guru. Možete naučiti osnovne principe dok pokušavate izraditi vlastite dodatke.

Važno je da uredski paket ONLYOFFICE dolazi s detaljnom API dokumentacijom i primjerima spremnim za korištenje kako bi proces stvaranja makronaredbi bio što jednostavniji.