Kif Tikteb Macros JavaScript fid-Dokumenti ONLYOFFICE


Għandek taħdem ma 'dokumenti Word, spreadsheets Excel, jew preżentazzjonijiet bil-PowerPoint u għandek bżonn tirrepeti ħidmiet kumplessi għal darb'oħra? Pereżempju, trid tenfasizza valuri duplikati f'folja jew tneħħi forom mill-pjastri ta' preżentazzjoni.

Jekk dan huwa l-każ, jista 'jkun ta' sfida għalik bħala utent tal-Linux. It-twettiq ta' dawn il-kompiti manwalment huwa bla sens. Ħafna operazzjonijiet differenti jistgħu jsiru faċilment b'mod awtomatiku b'VBA macros fil-Microsoft Office. Madankollu, hemm problema serja - ma jaħdmux b'mod nattiv fuq magni Linux.

Madankollu, hemm soluzzjoni inġenjuża għal din il-problema. Tista' tikteb u tħaddem macros JavaScript f'ONLYOFFICE Docs biex tagħmel operazzjonijiet monotoni.

Aqra dan l-artikolu biex issir taf kif.

Werrej

X'inhu ONLYOFFICE Docs?

ONLYOFFICE Docs hija suite ta' uffiċċji open source u self-hosted li hija mfassla biex toħloq ambjent kollaborattiv lokali fuq server Linux jew Windows.

Iġġib il-benefiċċji ta 'editjar ta' dokumenti f'ħin reali u ko-awtur għal numru kbir ta 'soluzzjonijiet ta' qsim ta 'fajls, pjattaformi ta' tagħlim elettroniku, u sistemi ta 'ġestjoni tad-dokumenti.

Bħalissa, huwa kompatibbli ma 'Moodle, Drupal, u softwer ieħor. L-integrazzjoni hija possibbli permezz ta' konnetturi lesti għall-użu li huma disponibbli fuq GitHub.

Bl-użu ta’ ONLYOFFICE Docs, tista’ taħdem mat-tipi kollha popolari ta’ fajls tal-uffiċċju, inklużi dokumenti ta’ test, spreadsheets, formoli li jistgħu jimtlew, slides, u PDFs.

Il-format nattiv ta’ ONLYOFFICE Docs huwa OOXML (DOCX, XLSX, PPTX), u għalhekk jista’ faċilment jissostitwixxi l-Microsoft Office fuq magni Linux. Formati popolari oħra, bħal ODF, huma appoġġjati permezz ta 'konverżjoni awtomatika għal OOXML.

Minbarra l-verżjoni self-hosted tiegħu, ONLYOFFICE Docs għandu verżjoni cloud b'xejn għall-użu personali. Ukoll, hemm apps b'xejn għall-pjattaformi popolari kollha tad-desktop u mobbli, inklużi Windows, macOS, Linux, Android, u iOS.

Fejn tidħol l-awtomazzjoni tal-kompiti, ONLYOFFICE Docs mhuwiex kompatibbli mal-macros VBA ta 'Microsoft. Juża macros JavaScript li huma kapaċi jagħmlu l-istess operazzjonijiet b'mod ħafna aktar sigur.

Nibdew bil-Macros għal ONLYOFFICE Docs

Makro huwa skript żgħir li jagħmilha aktar faċli biex taħdem ma 'tipi differenti ta' dokumenti billi awtomatizza ċertu xogħol. Fi kliem ieħor, hija biċċa kodiċi ta 'programmazzjoni li fiha sett ta' azzjonijiet li tista 'tmexxi kemm-il darba trid.

Per eżempju, tista 'tħaddem il-makro korrispondenti biex tenfasizza duplikati fiż-żona magħżula fl-ispreadsheet tiegħek b'kuluri differenti.

F'ONLYOFFICE Docs, jidher bħal dan:

X'inhi l-utilità prattika ta 'dan il-makro? Meta taħdem mad-dejta, tista 'taħdem il-makro ffrankat fi ftit sekondi billi tikklikkja l-buttuna korrispondenti biex tenfasizza valuri duplikati kemm-il darba għandek bżonn, li se jiffrankaw sigħat ta' ħin.

F'ONLYOFFICE Docs, il-macros huma bbażati fuq is-sintassi JavaScript u l-metodi API ta' ONLYOFFICE Document Builder. Hemm xi raġunijiet ovvji għaliex huma aħjar minn macros VBA:

  • Il-makros ta' ONLYOFFICE huma multi-pjattaformi – B'differenza mill-Visual Basic, JavaScript huwa lingwa ta' programmar aktar komuni. Għalhekk, macros JavaScript jistgħu faċilment jaħdmu fuq pjattaformi Windows, Linux, u macOS.
  • Il-macros ONLYOFFICE huma faċli biex jintużaw – JavaScript huwa spiss rakkomandat għal dawk li jibdew u għandu komunità li qed tikber malajr. Ħafna nies jagħżlu JavaScript bħala l-ewwel lingwa ta' programmar tagħhom minħabba li hemm ħafna tutorials u gwidi dettaljati fuq l-Internet.
  • Il-makros ONLYOFFICE huma sikuri – Il-kodiċi JavaScript tal-makros ONLYOFFICE jaħdem fl-istess tieqa bħall-edituri. Għalhekk, ma jistgħux jintużaw biex jikkompromettu s-sistema tiegħek minn attakkanti minħabba li m'għandhomx aċċess għaliha.

Makro ONLYOFFICE hija taħlita tas-sintassi JavaScript u l-metodi API ta’ ONLYOFFICE Document Builder.

ONLYOFFICE Document Builder hija librerija C++ użata biex toħloq u teditja fajls Office Open XML kif ukoll issalva fajls mhux OOXML f'formati DOCX, XSLX, PPTX, u PDF. Jopera bl-API JavaScript.

Hemm ħafna metodi ONLYOFFICE API, u mhux probabbli li tuża ħafna minnhom. Dawn huma xi eżempji prattiċi:

  • Il-metodu SetFillColor huwa ddisinjat biex jibdel il-kulur fl-isfond tal-firxa taċ-ċelluli attwali għall-kulur ta' oġġett tal-kulur maħluq qabel.
  • Il-metodu GetValue jirritorna l-valur tal-firxa speċifikata.
  • Il-metodu GetSlideByIndex jirritorna slide fil-pożizzjoni tagħha fil-preżentazzjoni.
  • U ħafna aktar.

Deskrizzjoni dettaljata tal-metodi kollha tal-API ONLYOFFICE u x'jagħmlu tista' tinstab fid-dokumentazzjoni uffiċjali.

F'ONLYOFFICE Docs, macros jistgħu jinħolqu u jitħassru permezz ta' plugin speċjali fuq l-għodda ta' fuq. Biex taċċessaha, iftaħ it-tab tal-Plugins u kklikkja l-buttuna Macros. Se tara tieqa fejn tkun tista' tikteb kodiċi JavaScript għall-macros tiegħek.

Bl-użu tal-buttuni korrispondenti, tista 'toħloq macros ġodda u tħassar dawk eżistenti. Inti permess ukoll li tibdel l-isem tal-macros u anke tattiva l-karatteristika Autostart.

Issa li tifhem kif jaħdmu ONLYOFFICE macros, ejja niktbu waħda. Qabel ma nibdew, huwa meħtieġ li niddeċiedu liema kompitu se jsir bil-makro tagħna.

Nibdew b'xi ħaġa sempliċi u nimmaġinaw li għandna bżonn nibdlu l-kulur tal-isfond ta 'ċellula fil-worksheet tagħna ta' Excel. Dan il-kompitu huwa biċċa biċċa iżda l-makro li se noħolqu se jagħmilha ferm aktar sempliċi.

Biex tibda, mur fit-tab Plugins u kklikkja Makros. Jekk tiftaħ din it-tieqa għall-ewwel darba, issib makro diġà maħluqa hemmhekk. Madankollu, mhux se jkun hemm kodiċi JavaScript f'din il-makro. Dak li se tara huwa tgeżwir ta 'funzjoni sempliċi:

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

Semmi mill-ġdid il-makro tiegħek jekk meħtieġ.

Issa tista 'tibda tikteb il-kodiċi tiegħek. Wara li tikkonsulta d-dokumentazzjoni tal-API ta' ONLYOFFICE Document Builder, li diġà ssemmiet fil-kapitolu preċedenti, tkun taf li l-metodi li ġejjin għandhom jintużaw għall-makro tiegħek:

  • Il-metodu Api.GetActiveSheet biex tikseb il-folja attiva.
  • Il-metodu GetRange biex tissettja l-firxa meħtieġa.
  • Il-metodu SetFillColor biex jiġi stabbilit il-kulur fl-isfond taċ-ċellula meħtieġa.
  • Il-Api.CreateColorFromRGB biex tissettja l-kulur mixtieq.

L-ewwel, għandek bżonn tikseb il-folja attiva u tistabbilixxi l-firxa meħtieġa billi ttajpja l-metodi korrispondenti Ejja nimmiraw iċ-ċellula A2. Ibda ttajpja l-ismijiet tal-metodi fit-tgeżwir tal-funzjoni, u se tara l-għodda kollha disponibbli, li hija konvenjenti ħafna.

Imbagħad, għandek bżonn tissettja l-kulur fl-isfond taċ-ċellula attwali. Biex tagħmel dan, uża l-metodu SetFillColor. Il-metodu Api.CreateColorFromRGB jippermettilek li tissettja l-kulur li tixtieq. Il-kodiċi tiegħek għandu jkun kif ġej:

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

Issa wasal iż-żmien li tħaddem il-makro u tara r-riżultati. Wara li tikklikkja l-buttuna Mexxi, tara li ċ-ċellula A2 hija kkulurita. Tista' tilgħab b'kuluri differenti billi tibdel il-valur fil-metodu Api.CreateColorFromRGB.

Jekk ma tridx titgħallem l-affarijiet bażiċi tal-kodifikazzjoni JavaScript biex toħloq macros ONLYOFFICE, dejjem tista 'tuża eżempji makro lesti mill-websajt uffiċjali u timmodifikahom skont il-bżonnijiet tiegħek.

Kif tistgħu taraw, il-ħolqien ta' macros f'ONLYOFFICE Docs mhuwiex diffiċli daqs kemm jidher mal-ewwel daqqa t'għajn. Naturalment, trid tkun taf il-prinċipji fundamentali tal-kodifikazzjoni JavaScript biex tagħmel macros kumplessi b'għexieren ta 'linji ta' kodiċi.

Madankollu, il-ħolqien ta 'makros sempliċi għal attivitajiet ta' rutina ta 'kuljum ma jeħtieġx li tkun guru JavaScript. Tista 'titgħallem il-prinċipji bażiċi waqt li tipprova toħloq il-plugins tiegħek stess.

Importanti, is-suite tal-uffiċċju ONLYOFFICE tiġi flimkien ma 'dokumentazzjoni dettaljata tal-API u eżempji lesti biex jintużaw biex il-proċess tal-ħolqien ta' macros ikun sempliċi kemm jista 'jkun.