Giunsa Pagsulat ang JavaScript Macros sa ONLYOFFICE Docs

Unsa ang ONLYOFFICE Docs?

Ang ONLYOFFICE Docs usa ka open-source ug self-hosted office suite nga gidesinyo para sa paghimo ug lokal nga kolaborasyon nga palibot sa Linux o Windows server.

Nagdala kini sa mga benepisyo sa real-time nga pag-edit sa dokumento ug pag-co-author sa daghang gidaghanon sa mga solusyon sa pagpaambit sa mga file, mga platform sa e-learning, ug mga sistema sa pagdumala sa dokumento.

Sa pagkakaron, nahiuyon kini sa Moodle, Drupal, ug uban pang software. Posible ang paghiusa pinaagi sa andam nga gamiton nga mga konektor nga magamit sa GitHub.

Gamit ang ONLYOFFICE Docs, makatrabaho ka sa tanan nga sikat nga klase sa mga file sa opisina, lakip ang mga dokumento sa teksto, mga spreadsheet, mga porma nga mapuno, mga slide, ug mga PDF.

ONLYOFFICE Docs' lumad nga format mao ang OOXML (DOCX, XLSX, PPTX), mao nga kini dali nga mopuli sa Microsoft Office sa Linux nga mga makina. Ang ubang popular nga mga format, sama sa ODF, gisuportahan pinaagi sa awtomatikong pagkakabig ngadto sa OOXML.

Dugang pa sa self-hosted nga bersyon niini, ang ONLYOFFICE Docs adunay libre nga cloud version para sa personal nga paggamit. Usab, adunay mga libre nga apps alang sa tanan nga sikat nga desktop ug mobile platform, lakip ang Windows, macOS, Linux, Android, ug iOS.

Kung bahin sa automation sa buluhaton, ang ONLYOFFICE Docs dili tugma sa mga VBA macro sa Microsoft. Gigamit niini ang mga macro sa JavaScript nga makahimo sa parehas nga mga operasyon sa labi ka luwas nga paagi.

Pagsugod sa Macros para sa ONLYOFFICE Docs

Ang usa ka macro usa ka gamay nga script nga nagpadali sa pagtrabaho sa lainlaing mga lahi sa mga dokumento pinaagi sa pag-automate sa usa ka piho nga buluhaton. Sa laing pagkasulti, kini usa ka piraso sa programming code nga adunay usa ka hugpong sa mga aksyon nga mahimo nimong daganan kanunay kung gusto nimo.

Pananglitan, mahimo nimong ipadagan ang katugbang nga macro aron ma-highlight ang mga duplicate sa napili nga lugar sa imong spreadsheet nga adunay lainlaing mga kolor.

Sa ONLYOFFICE Docs, ingon niini:

Unsa ang praktikal nga gamit niini nga macro? Kung nagtrabaho uban ang datos, mahimo nimong ipadagan ang na-save nga macro sulod sa mga segundo pinaagi sa pag-klik sa katugbang nga buton aron i-highlight ang mga doble nga kantidad sa daghang mga higayon nga kinahanglan nimo, nga makaluwas kanimo mga oras sa oras.

Sa ONLYOFFICE Docs, ang mga macro gibase sa JavaScript syntax ug sa API nga mga pamaagi sa ONLYOFFICE Document Builder. Adunay pipila ka klaro nga mga hinungdan ngano nga kini mas maayo kaysa VBA macros:

• ONLYOFFICE macros kay cross-platform – Dili sama sa Visual Basic, ang JavaScript kay mas komon nga programming language. Busa, ang JavaScript macros daling modagan sa Windows, Linux, ug macOS nga mga plataporma.
• ONLYOFFICE macros kay sayon-gamiton – Ang JavaScript kasagarang girekomendar para sa mga bag-ohan ug adunay paspas nga nagtubo nga komunidad. Daghang mga tawo ang mipili sa JavaScript isip ilang unang programming language tungod kay adunay daghang detalyado nga mga tutorial ug mga giya sa Internet.
• ONLYOFFICE macros luwas – Ang JavaScript code sa ONLYOFFICE macros modagan sa samang bintana sa mga editor. Busa, dili sila magamit sa pagkompromiso sa imong sistema sa mga tig-atake tungod kay wala silay access niini.

Ang ONLYOFFICE macro maoy kombinasyon sa JavaScript syntax ug mga pamaagi sa API sa ONLYOFFICE Document Builder.

Ang ONLYOFFICE Document Builder usa ka C++ library nga gigamit sa paghimo ug pag-edit sa Office Open XML nga mga file ingon man sa pag-save sa mga non-OOXML nga mga file sa DOCX, XSLX, PPTX, ug PDF nga mga format. Naglihok kini sa JavaScript API.

Adunay daghang mga pamaagi sa ONLYOFFICE API, ug lagmit dili nimo gamiton ang kadaghanan niini. Kini ang pipila ka praktikal nga mga pananglitan:

• Ang SetFillColor nga pamaagi gidesinyo sa pag-ilis sa kolor sa background sa kasamtangan nga cell range ngadto sa kolor sa usa ka butang nga gimugna kaniadto nga kolor.
• Ang GetValue nga pamaagi nagbalik sa bili sa gipiho nga range.
• Ang GetSlideByIndex nga pamaagi nagbalik sa slide sa posisyon niini sa presentasyon.
• Ug daghan pa.

Ang usa ka detalyado nga paghulagway sa tanan nga mga pamaagi sa ONLYOFFICE API ug kung unsa ang ilang gibuhat makita sa opisyal nga dokumentasyon.

Sa ONLYOFFICE Docs, ang mga macro mahimong mabuhat ug matangtang pinaagi sa usa ka espesyal nga plugin sa ibabaw nga toolbar. Aron ma-access kini, ablihi ang tab nga Plugins ug i-klik ang Macros button. Makita nimo ang usa ka bintana diin mahimo nimong isulat ang JavaScript code alang sa imong mga macro.

Gamit ang katugbang nga mga buton, makahimo ka og bag-ong mga macro ug tangtangon ang mga naa na. Gitugotan ka usab nga bag-ohon ang ngalan sa mga macro ug i-aktibo ang bahin sa Autostart.

Karon nga imong nasabtan kung giunsa ang ONLYOFFICE macros nagtrabaho, isulat nato ang usa. Sa dili pa kita magsugod, kinahanglan nga magdesisyon kung unsang buluhaton ang buhaton sa atong macro.

Magsugod ta sa usa ka butang nga yano ug hunahunaa nga kinahanglan naton usbon ang kolor sa background sa usa ka cell sa among worksheet sa Excel. Kini nga buluhaton usa ka piraso sa keyk apan ang macro nga atong buhaton maghimo niini nga mas simple.

Aron makasugod, adto sa tab nga Plugins ug i-klik ang Macros. Kung ablihan nimo kini nga bintana sa unang higayon, makit-an nimo ang nahimo na nga macro didto. Bisan pa, wala’y JavaScript code sa kini nga macro. Ang imong makita mao ang usa ka yano nga function wrapper:

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

Usba ang ngalan sa imong macro kung gikinahanglan.

Karon mahimo ka magsugod sa pagsulat sa imong code. Human sa pagkonsulta sa ONLYOFFICE Document Builder API nga dokumentasyon, nga nahisgotan na sa miaging kapitulo, mahibal-an nimo nga ang mosunod nga mga pamaagi kinahanglang gamiton para sa imong macro:

• Ang Api.GetActiveSheet nga pamaagi aron makuha ang aktibong sheet.
• Ang GetRange nga pamaagi aron itakda ang gikinahanglang range.
• Ang SetFillColor nga pamaagi aron itakda ang kolor sa background sa gikinahanglan nga cell.
• Ang Api.CreateColorFromRGB aron itakda ang gusto nga kolor.

Una, kinahanglan nimo nga makuha ang aktibo nga sheet ug itakda ang gikinahanglan nga range pinaagi sa pag-type sa katugbang nga mga pamaagi Atong target ang cell A2. Pagsugod sa pag-type sa mga ngalan sa mga pamaagi sa function wrapper, ug imong makita ang tanan nga magamit nga mga tooltip, nga sayon kaayo.

Dayon, kinahanglan nimo nga itakda ang kolor sa background sa kasamtangan nga selula. Aron mahimo kini, gamita ang SetFillColor nga pamaagi. Ang Api.CreateColorFromRGB nga pamaagi motugot kanimo sa pagtakda sa kolor nga imong gusto. Ang imong code kinahanglan nga ingon sa mosunod:

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

Karon na ang panahon sa pagpadagan sa macro ug tan-awa ang mga resulta. Human sa pag-klik sa Run button, imong makita nga ang cell A2 adunay kolor. Makadula ka og lain-laing mga kolor pinaagi sa pag-usab sa bili sa Api.CreateColorFromRGB nga pamaagi.

Kung dili nimo gusto nga makat-on sa mga sukaranan sa JavaScript coding aron makahimo ONLYOFFICE macros, mahimo nimo kanunay nga magamit ang andam nga mga pananglitan sa macro gikan sa opisyal nga website ug usbon kini sumala sa imong mga panginahanglan.

Sama sa imong nakita, ang paghimo og mga macro sa ONLYOFFICE Docs dili ingon kalisud sama sa una nga pagtan-aw. Siyempre, kinahanglan nimong mahibal-an ang sukaranan sa JavaScript coding aron makahimo mga komplikado nga macro nga adunay daghang mga linya sa code.

Bisan pa, ang paghimo og yano nga mga macro alang sa adlaw-adlaw nga rutina nga mga kalihokan wala magkinahanglan kanimo nga usa ka JavaScript guru. Mahimo nimong mahibal-an ang sukaranang mga prinsipyo samtang naningkamot sa paghimo sa imong kaugalingon nga mga plugin.

Importante, ang ONLYOFFICE office suite nag-uban sa detalyado nga dokumentasyon sa API ug andam-gamiton nga mga panig-ingnan aron mahimo ang proseso sa paghimo og mga macro nga yano kutob sa mahimo.