Si të shkruani makro JavaScript në ONLYOFFICE Docs

A duhet të punoni me dokumente Word, spreadsheets Excel ose prezantime në PowerPoint dhe keni nevojë të përsërisni detyra komplekse pa pushim? Për shembull, duhet të nënvizoni vlerat e dyfishta në një fletë ose të hiqni forma nga sllajdet e një prezantimi.

Nëse është kështu, mund të jetë sfiduese për ju si përdorues Linux. Kryerja e detyrave të tilla me dorë është e pakuptimtë. Shumë operacione të ndryshme mund të bëhen lehtësisht automatikisht me makrot VBA në Microsoft Office. Sidoqoftë, ekziston një problem serioz - ato nuk funksionojnë në mënyrë origjinale në makinat Linux.

Megjithatë, ekziston një zgjidhje e zgjuar për këtë problem. Mund të shkruani dhe të ekzekutoni makro JavaScript në DOKUMENTET ONLYOFFICE për të kryer operacione monotone.

Lexoni këtë artikull për të mësuar se si.

Çfarë është ONLYOFFICE Docs?

ONLYOFFICE Docs është një paketë zyrash me burim të hapur dhe vetë-strehuar që është krijuar për krijimin e një mjedisi lokal bashkëpunues në një server Linux ose Windows.

Ai sjell përfitimet e redaktimit të dokumenteve në kohë reale dhe të bashkëautorit në një numër të madh zgjidhjesh për ndarjen e skedarëve, platforma të mësimit elektronik dhe sisteme të menaxhimit të dokumenteve.

Aktualisht, është në përputhje me Moodle, Drupal dhe softuer të tjerë. Integrimi është i mundur përmes lidhësve të gatshëm për përdorim që janë të disponueshëm në GitHub.

Duke përdorur ONLYOFFICE Docs, mund të punoni me të gjitha llojet e njohura të skedarëve të zyrës, duke përfshirë dokumente teksti, fletëllogaritëse, formularë të plotësueshëm, rrëshqitje dhe PDF.

Formati origjinal i ONLYOFFICE Docs është OOXML (DOCX, XLSX, PPTX), kështu që mund të zëvendësojë lehtësisht Microsoft Office në makinat Linux. Formate të tjera të njohura, si ODF, mbështeten përmes konvertimit automatik në OOXML.

Përveç versionit të vetë-strehuar, ONLYOFFICE Docs ka një version falas të resë kompjuterike për përdorim personal. Gjithashtu, ka aplikacione falas për të gjitha platformat e njohura desktop dhe celular, duke përfshirë Windows, macOS, Linux, Android dhe iOS.

Kur bëhet fjalë për automatizimin e detyrave, ONLYOFFICE Docs nuk është në përputhje me makrot VBA të Microsoft. Ai përdor makro JavaScript që janë në gjendje të bëjnë të njëjtat operacione në një mënyrë shumë më të sigurt.

Fillimi me makro për ONLYOFFICE Docs

Një makro është një skrip i vogël që e bën më të lehtë punën me lloje të ndryshme dokumentesh duke automatizuar një detyrë të caktuar. Me fjalë të tjera, është një pjesë e kodit programues që përmban një sërë veprimesh që mund t'i ekzekutoni sa herë të dëshironi.

Për shembull, mund të ekzekutoni makronë përkatëse për të nënvizuar dublikatat në zonën e zgjedhur në tabelën tuaj me ngjyra të ndryshme.

Në ONLYOFFICE Docs, duket kështu:

Cila është dobia praktike e kësaj makro? Kur punoni me të dhëna, mund të ekzekutoni makronë e ruajtur brenda sekondave duke klikuar butonin përkatës për të nxjerrë në pah vlerat e kopjuara aq herë sa të keni nevojë, gjë që do t'ju kursejë orë kohë.

Arsyet kryesore pse Macrot e ONLYOFFICE janë të mira

Në ONLYOFFICE Docs, makrot bazohen në sintaksën JavaScript dhe metodat API të ONLYOFFICE Document Builder. Ka disa arsye të dukshme pse ato janë më të mira se makrot VBA:

Makrot ONLYOFFICE janë ndër-platformë – Ndryshe nga Visual Basic, JavaScript është një gjuhë programimi më e zakonshme. Prandaj, makrot JavaScript mund të ekzekutohen lehtësisht në platformat Windows, Linux dhe macOS.
Makrot ONLYOFFICE janë të lehta për t'u përdorur – JavaScript rekomandohet shpesh për fillestarët dhe ka një komunitet me rritje të shpejtë. Shumë njerëz zgjedhin JavaScript si gjuhën e tyre të parë të programimit sepse ka shumë udhëzime dhe udhëzues të detajuar në internet.
Makrot ONLYOFFICE janë të sigurta – Kodi JavaScript i makrove ONLYOFFICE funksionon në të njëjtën dritare me redaktorët. Prandaj, ata nuk mund të përdoren për të komprometuar sistemin tuaj nga sulmuesit sepse ata nuk kanë qasje në të.

Si funksionojnë makro ONLYOFFICE

Një Makro ONLYOFFICE është një kombinim i sintaksës JavaScript dhe metodave API të ONLYOFFICE Document Builder.

ONLYOFFICE Document Builder është një bibliotekë C++ që përdoret për të krijuar dhe modifikuar skedarët XML të Open Office, si dhe për të ruajtur skedarët jo-OOXML në formatet DOCX, XSLX, PPTX dhe PDF. Ai funksionon me API JavaScript.

Ka shumë metoda ONLYOFFICE API dhe nuk ka të ngjarë të përdorni shumicën e tyre. Këta janë disa shembuj praktikë:

Metoda SetFillColor është projektuar për të ndryshuar ngjyrën e sfondit të gamës aktuale të qelizave në ngjyrën e një objekti me ngjyra të krijuar më parë.
Metoda GetValue kthen vlerën e diapazonit të specifikuar.
Metoda GetSlideByIndex kthen një rrëshqitje në pozicionin e tij në prezantim.
Dhe shumë më tepër.

Një përshkrim i detajuar i të gjitha metodave ONLYOFFICE API dhe çfarë bëjnë ato mund të gjenden në dokumentacionin zyrtar.

Në ONLYOFFICE Docs, makro mund të krijohen dhe fshihen nëpërmjet një plugin-i të veçantë në shiritin e sipërm të veglave. Për të hyrë në të, hapni skedën Plugins dhe kliko butonin Macros. Do të shihni një dritare ku do të jeni në gjendje të shkruani kodin JavaScript për makrot tuaja.

Duke përdorur butonat përkatës, mund të krijoni makro të reja dhe të fshini ato ekzistuese. Gjithashtu ju lejohet të riemërtoni makro dhe madje të aktivizoni veçorinë Autostart.

Si të shkruani një makro ONLYOFFICE

Tani që e kuptoni se si funksionojnë makrot e ONLYOFFICE, le të shkruajmë një. Para se të fillojmë, është e nevojshme të vendosim se çfarë detyre do të bëhet me makro tonë.

Le të fillojmë me diçka të thjeshtë dhe të imagjinojmë se duhet të ndryshojmë ngjyrën e sfondit të një qelize në fletën tonë të punës Excel. Kjo detyrë është një copë tortë, por makroja që do të krijojmë do ta bëjë atë shumë më të thjeshtë.

Për të filluar, shkoni te skeda Plugins dhe kliko Macros. Nëse e hapni këtë dritare për herë të parë, do të gjeni një makro të krijuar tashmë atje. Megjithatë, nuk do të ketë asnjë kod JavaScript në këtë makro. Ajo që do të shihni është një mbështjellës i thjeshtë funksioni:

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

Riemërtoni makronë tuaj nëse është e nevojshme.

Tani mund të filloni të shkruani kodin tuaj. Pasi të konsultoheni me dokumentacionin e ONLYOFFICE Document Builder API, i cili është përmendur tashmë në kapitullin e mëparshëm, do të dini se metodat e mëposhtme duhet të përdoren për makro:

Metoda Api.GetActiveSheet për të marrë fletën aktive.
Metoda GetRange për të vendosur diapazonin e kërkuar.
Metoda SetFillColor për të vendosur ngjyrën e sfondit të qelizës së kërkuar.
Api.CreateColorFromRGB për të vendosur ngjyrën e dëshiruar.

Së pari, duhet të marrësh fletën aktive dhe të caktosh gamën e kërkuar duke shtypur metodat përkatëse Le të synojmë qelizën A2. Filloni të shkruani emrat e metodave në mbështjellësin e funksioneve dhe do të shihni të gjitha këshillat e disponueshme të veglave, gjë që është shumë e përshtatshme.

Pastaj, duhet të vendosni ngjyrën e sfondit të qelizës aktuale. Për ta bërë këtë, përdorni metodën SetFillColor. Metoda Api.CreateColorFromRGB do t'ju lejojë të vendosni ngjyrën që ju pëlqen. Kodi juaj duhet të jetë si më poshtë:

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

Tani është koha për të ekzekutuar makro dhe për të parë rezultatet. Pasi të klikoni butonin Run, do të shihni se qeliza A2 është me ngjyrë. Mund të luani me ngjyra të ndryshme duke ndryshuar vlerën në metodën Api.CreateColorFromRGB.

Nëse nuk dëshironi të mësoni bazat e kodimit JavaScript për të krijuar makro ONLYOFFICE, mund të përdorni gjithmonë shembuj makro të gatshëm nga faqja zyrtare e internetit dhe t'i modifikoni ato sipas nevojave tuaja .

konkluzioni

Siç mund ta shihni, krijimi i makrove në Dokumentet ONLYOFFICE nuk është aq i vështirë sa duket në shikim të parë. Sigurisht, ju duhet të dini bazat e kodimit JavaScript për të bërë makro komplekse me dhjetëra rreshta kodi.

Sidoqoftë, krijimi i makrove të thjeshta për aktivitetet rutinë të përditshme nuk kërkon që ju të jeni një guru i JavaScript. Ju mund të mësoni parimet bazë ndërsa përpiqeni të krijoni shtojcat tuaja.

E rëndësishmja, paketa e zyrës ONLYOFFICE vjen me dokumentacion të detajuar API dhe shembuj të gatshëm për përdorim për ta bërë procesin e krijimit të makrove sa më të thjeshtë.