JavaScript-makrojen kirjoittaminen ONLYOFFICE Docsissa


Onko sinun työskenneltävä Word-asiakirjojen, Excel-laskentataulukoiden tai PowerPoint-esitysten kanssa ja sinun on toistettava monimutkaisia tehtäviä yhä uudelleen? Sinun on esimerkiksi korostettava arkin päällekkäisiä arvoja tai poistettava muotoja esityksen dioista.

Jos näin on, se voi olla haastavaa sinulle Linux-käyttäjänä. Tällaisten tehtävien suorittaminen manuaalisesti on merkityksetöntä. Monia erilaisia toimintoja voidaan helposti tehdä automaattisesti VBA-makroilla Microsoft Officessa. On kuitenkin olemassa vakava ongelma - ne eivät toimi alkuperäisesti Linux-koneissa.

Tähän ongelmaan on kuitenkin nerokas ratkaisu. Voit kirjoittaa ja suorittaa JavaScript-makroja ONLYOFFICE Docsissa tehdäksesi yksitoikkoisia toimintoja.

Lue tämä artikkeli saadaksesi selville, miten.

Mikä on ONLYOFFICE Docs?

ONLYOFFICE Docs on avoimen lähdekoodin itseisännöity toimistopaketti, joka on suunniteltu paikallisen yhteistyöympäristön luomiseen Linux- tai Windows-palvelimelle.

Se tuo reaaliaikaisen asiakirjojen muokkauksen ja yhteismuokkauksen edut useisiin tiedostonjakoratkaisuihin, e-oppimisalustoihin ja asiakirjanhallintajärjestelmiin.

Tällä hetkellä se on yhteensopiva Nextcloudin, ownCloudin, Seafilen, Plonen, Confluencen, Alfrescon, Redminen, WordPressin, Chamilon, Moodlen, Drupalin ja muiden ohjelmistojen kanssa. Integrointi on mahdollista GitHubissa saatavilla olevien käyttövalmiiden liittimien kautta.

ONLYOFFICE Docsin avulla voit työskennellä kaikkien suosittujen Office-tiedostotyyppien kanssa, mukaan lukien tekstiasiakirjat, laskentataulukot, täytettävät lomakkeet, dioja ja PDF-tiedostoja.

ONLYOFFICE Docsin alkuperäinen muoto on OOXML (DOCX, XLSX, PPTX), joten se voi helposti korvata Microsoft Officen Linux-koneissa. Muita suosittuja muotoja, kuten ODF, tuetaan automaattisella muuntamisella OOXML:ksi.

Itseisännöidyn versionsa lisäksi ONLYOFFICE Docsissa on ilmainen pilviversio henkilökohtaiseen käyttöön. Lisäksi on ilmaisia sovelluksia kaikille suosituille työpöytä- ja mobiilialustoille, mukaan lukien Windows, macOS, Linux, Android ja iOS.

Tehtävien automatisoinnin osalta ONLYOFFICE Docs ei ole yhteensopiva Microsoftin VBA-makrojen kanssa. Se käyttää JavaScript-makroja, jotka pystyvät suorittamaan samat toiminnot paljon turvallisemmalla tavalla.

ONLYOFFICE Docsin makrojen käytön aloittaminen

Makro on pieni komentosarja, joka helpottaa erityyppisten asiakirjojen käsittelyä automatisoimalla tietyn tehtävän. Toisin sanoen se on osa ohjelmointikoodia, joka sisältää joukon toimintoja, joita voit suorittaa niin usein kuin haluat.

Voit esimerkiksi suorittaa vastaavan makron korostaaksesi kaksoiskappaleet valitulla alueella laskentataulukossa eri väreillä.

ONLYOFFICE Docsissa se näyttää tältä:

Mitä hyötyä tästä makrosta on käytännössä? Kun työskentelet tietojen kanssa, voit suorittaa tallennetun makron sekunneissa napsauttamalla vastaavaa painiketta korostaaksesi päällekkäisiä arvoja niin monta kertaa kuin tarvitset, mikä säästää tunteja.

Tärkeimmät syyt, miksi ONLYOFFICE-makrot ovat hyviä

ONLYOFFICE Docsissa makrot perustuvat JavaScript-syntaksiin ja ONLYOFFICE Document Builderin API-menetelmiin. On joitain ilmeisiä syitä, miksi ne ovat parempia kuin VBA-makrot:

  • ONLYOFFICE-makrot ovat monialustaisia – Toisin kuin Visual Basic, JavaScript on yleisempi ohjelmointikieli. Siksi JavaScript-makroja voidaan käyttää helposti Windows-, Linux- ja macOS-alustoilla.
  • ONLYOFFICE-makrot ovat helppokäyttöisiä – JavaScriptiä suositellaan usein aloittelijoille, ja sillä on nopeasti kasvava yhteisö. Monet ihmiset valitsevat JavaScriptin ensimmäiseksi ohjelmointikielekseen, koska Internetissä on paljon yksityiskohtaisia opetusohjelmia ja oppaita.
  • ONLYOFFICE-makrot ovat turvallisia – ONLYOFFICE-makrojen JavaScript-koodi suoritetaan samassa ikkunassa kuin editorit. Siksi hyökkääjät eivät voi käyttää niitä järjestelmääsi vaarantamiseen, koska heillä ei ole pääsyä siihen.

Kuinka ONLYOFFICE-makrot toimivat

ONLYOFFICE-makro on ONLYOFFICE Document Builderin -syntaksin ja API-menetelmien yhdistelmä.

ONLYOFFICE Document Builder on C++-kirjasto, jota käytetään Office Open XML -tiedostojen luomiseen ja muokkaamiseen sekä muiden kuin OOXML-tiedostojen tallentamiseen DOCX-, XSLX-, PPTX- ja PDF-muotoihin. Se toimii JavaScript API:n kanssa.

ONLYOFFICE API -menetelmiä on paljon, etkä todennäköisesti käytä useimpia niistä. Tässä muutamia käytännön esimerkkejä:

  • SetFillColor-menetelmä on suunniteltu muuttamaan nykyisen solualueen taustaväri aiemmin luodun väriobjektin väriksi.
  • GetValue-menetelmä palauttaa määritetyn alueen arvon.
  • GetSlideByIndex-menetelmä palauttaa dian esityksen paikkaansa.
  • Ja paljon enemmän.

Yksityiskohtainen kuvaus kaikista ONLYOFFICE API -menetelmistä ja niiden toiminnasta löytyy virallisesta dokumentaatiosta.

ONLYOFFICE Docsissa makroja voidaan luoda ja poistaa ylätyökalupalkin erityisen laajennuksen avulla. Pääset siihen avaamalla Lisäosat-välilehden ja napsauttamalla Makrot-painiketta. Näet ikkunan, johon voit kirjoittaa JavaScript-koodin makroillesi.

Vastaavilla painikkeilla voit luoda uusia makroja ja poistaa olemassa olevia. Voit myös nimetä uudelleen makroja ja jopa aktivoida Autostart-ominaisuuden.

Kuinka kirjoittaa ONLYOFFICE-makro

Nyt kun ymmärrät, miten ONLYOFFICE-makrot toimivat, kirjoitetaan yksi. Ennen kuin aloitamme, on välttämätöntä päättää, mitä tehtävää se aikoo tehdä makrollamme.

Aloitetaan jostain yksinkertaisesta ja kuvitellaan, että meidän on vaihdettava Excel-laskentataulukon solun taustaväri. Tämä tehtävä on pala kakkua, mutta luomamme makro tekee siitä paljon yksinkertaisempaa.

Aloita siirtymällä Lisäosat-välilehteen ja valitsemalla Makrot. Jos avaat tämän ikkunan ensimmäistä kertaa, löydät sieltä jo luodun makron. Tässä makrossa ei kuitenkaan ole JavaScript-koodia. Näet yksinkertaisen toimintokääreen:

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

Nimeä makro uudelleen tarvittaessa.

Nyt voit aloittaa koodin kirjoittamisen. Tutustuttuasi ONLYOFFICE Document Builder -sovellusliittymän dokumentaatioon, joka on jo mainittu edellisessä luvussa, tiedät, että makrossasi tulisi käyttää seuraavia menetelmiä:

  • Api.GetActiveSheet -menetelmä aktiivisen taulukon saamiseksi.
  • GetRange-menetelmä vaaditun alueen määrittämiseksi.
  • SetFillColor-menetelmä, jolla määritetään vaaditun solun taustaväri.
  • Api.CreateColorFromRGB määrittääksesi haluamasi värin.

Ensin sinun on hankittava aktiivinen taulukko ja asetettava vaadittu alue kirjoittamalla vastaavat menetelmät Kohdistamme soluun A2. Aloita menetelmien nimien kirjoittaminen funktion kääreeseen, niin näet kaikki käytettävissä olevat työkaluvihjeet, mikä on erittäin kätevää.

Sitten sinun on asetettava nykyisen solun taustaväri. Käytä tätä varten SetFillColor-menetelmää. Api.CreateColorFromRGB-menetelmän avulla voit määrittää haluamasi värin. Koodisi tulee olla seuraava:

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

Nyt on aika ajaa makro ja nähdä tulokset. Kun olet napsauttanut Suorita-painiketta, näet, että solu A2 on värillinen. Voit pelata eri väreillä muuttamalla arvoa Api.CreateColorFromRGB-menetelmässä.

Jos et halua oppia JavaScript-koodauksen perusteita ONLYOFFICE-makrojen luomiseen, voit aina käyttää valmiita makroesimerkkejä viralliselta verkkosivustolta ja muokata niitä tarpeidesi mukaan. .

Johtopäätös

Kuten näet, makrojen luominen ONLYOFFICE Docsissa ei ole niin vaikeaa kuin miltä ensi silmäyksellä näyttää. Tietenkin sinun on tiedettävä JavaScript-koodauksen perusteet, jotta voit tehdä monimutkaisia makroja, joissa on kymmeniä koodirivejä.

Yksinkertaisten makrojen luominen päivittäisiä rutiinitoimintoja varten ei kuitenkaan edellytä JavaScript-gurua. Voit oppia perusperiaatteet yrittäessäsi luoda omia laajennuksiasi.

Tärkeää on, että ONLYOFFICE-toimistopaketti sisältää yksityiskohtaisen API-dokumentaation ja käyttövalmiita esimerkkejä, jotta makrojen luontiprosessi on mahdollisimman yksinkertainen.