ONLYOFFICE Sənədlərində JavaScript Makrolarını Necə Yazmaq olar

Word sənədləri, Excel cədvəlləri və ya PowerPoint təqdimatları ilə işləməli və mürəkkəb tapşırıqları dəfələrlə təkrarlamalısınız? Məsələn, siz vərəqdə dublikat dəyərləri vurğulamaq və ya təqdimatın slaydlarından formaları silmək lazımdır.

Əgər belədirsə, bu, bir Linux istifadəçisi kimi sizin üçün çətin ola bilər. Bu cür işləri əl ilə yerinə yetirmək mənasızdır. Microsoft Office-də VBA makroları ilə bir çox müxtəlif əməliyyatlar asanlıqla avtomatik olaraq edilə bilər. Bununla belə, ciddi bir problem var - onlar yerli olaraq Linux maşınlarında işləmirlər.

Bununla belə, bu problemin dahiyanə həlli var. Siz monoton əməliyyatlar etmək üçün ONLYOFFICE Sənədlərində JavaScript makrolarını yazıb işlədə bilərsiniz.

Necə olduğunu öyrənmək üçün bu məqaləni oxuyun.

Mündəricat

ONLYOFFICE Sənədləri nədir?

ONLYOFFICE Sənədlər Linux və ya Windows serverində yerli əməkdaşlıq mühiti yaratmaq üçün nəzərdə tutulmuş açıq mənbəli və öz-özünə yerləşdirilən ofis dəstidir.

O, çoxlu sayda fayl paylaşma həllərinə, e-tədris platformalarına və sənəd idarəetmə sistemlərinə real vaxt rejimində sənəd redaktəsinin və birgə müəllifliyin üstünlüklərini gətirir.

Hazırda o, Moodle, Drupal və digər proqram təminatı ilə uyğun gəlir. İnteqrasiya GitHub-da mövcud olan istifadəyə hazır bağlayıcılar vasitəsilə mümkündür.

ONLYOFFICE Sənədlərindən istifadə edərək, siz mətn sənədləri, elektron cədvəllər, doldurula bilən formalar, slaydlar və PDF sənədləri daxil olmaqla, bütün məşhur ofis faylları ilə işləyə bilərsiniz.

ONLYOFFICE Sənədlərinin yerli formatı OOXML-dir (DOCX, XLSX, PPTX), ona görə də o, Microsoft Office-i Linux maşınlarında asanlıqla əvəz edə bilər. ODF kimi digər populyar formatlar OOXML-ə avtomatik çevrilmə vasitəsilə dəstəklənir.

ONLYOFFICE Sənədlər öz-özünə yerləşdirilən versiyasına əlavə olaraq şəxsi istifadə üçün pulsuz bulud versiyasına malikdir. Həmçinin, Windows, macOS, Linux, Android və iOS daxil olmaqla bütün məşhur masaüstü və mobil platformalar üçün pulsuz proqramlar mövcuddur.

Tapşırıqların avtomatlaşdırılmasına gəldikdə, ONLYOFFICE Sənədləri Microsoft-un VBA makroları ilə uyğun gəlmir. O, eyni əməliyyatları daha təhlükəsiz şəkildə yerinə yetirməyə qadir olan JavaScript makrolarından istifadə edir.

ONLYOFFICE Sənədləri üçün Makroslarla İşə Başlayın

Makro, müəyyən bir işi avtomatlaşdırmaqla müxtəlif növ sənədlərlə işləməyi asanlaşdıran kiçik bir skriptdir. Başqa sözlə, bu, istədiyiniz qədər yerinə yetirə biləcəyiniz bir sıra hərəkətləri ehtiva edən proqramlaşdırma kodunun bir parçasıdır.

Məsələn, cədvəlinizdə seçilmiş sahədə dublikatları müxtəlif rənglərlə vurğulamaq üçün müvafiq makronu işə sala bilərsiniz.

ONLYOFFICE Sənədlərində bu belə görünür:

Bu makronun praktik faydası nədir? Verilənlərlə işləyərkən, dublikat dəyərləri istədiyiniz qədər vurğulamaq üçün müvafiq düyməni sıxmaqla saniyələr ərzində saxlanmış makronu işə sala bilərsiniz ki, bu da sizə saatlarla vaxta qənaət edəcək.

ONLYOFFICE Sənədlərində makrolar JavaScript sintaksisinə və ONLYOFFICE Document Builder-in API metodlarına əsaslanır. Onların VBA makrolarından daha yaxşı olmasının bəzi açıq səbəbləri var:

  • ONLYOFFICE makroları çarpaz platformadır – Visual Basic-dən fərqli olaraq, JavaScript daha çox yayılmış proqramlaşdırma dilidir. Buna görə də, JavaScript makroları Windows, Linux və macOS platformalarında asanlıqla işləyə bilər.
  • ONLYOFFICE makrolarından istifadə etmək asandır – JavaScript tez-tez yeni başlayanlar üçün tövsiyə olunur və sürətlə böyüyən icmaya malikdir. Bir çox insanlar JavaScript-i ilk proqramlaşdırma dili kimi seçirlər, çünki İnternetdə çoxlu ətraflı təlimatlar və təlimatlar var.
  • ONLYOFFICE makroları təhlükəsizdir – ONLYOFFICE makrolarının JavaScript kodu redaktorlarla eyni pəncərədə işləyir. Buna görə də, onlar hücumçular tərəfindən sisteminizə zərər vermək üçün istifadə edilə bilməz, çünki onların sistemə girişi yoxdur.

ONLYOFFICE makrosu ONLYOFFICE Document Builder-in JavaScript sintaksisi və API metodlarının birləşməsidir.

ONLYOFFICE Document Builder Office Open XML fayllarını yaratmaq və redaktə etmək, həmçinin OOXML olmayan faylları DOCX, XSLX, PPTX və PDF formatlarında saxlamaq üçün istifadə olunan C++ kitabxanasıdır. JavaScript API ilə işləyir.

Çoxlu ONLYOFFICE API metodları var və siz onların əksəriyyətindən istifadə edə bilməyəcəksiniz. Bunlar bəzi praktik nümunələrdir:

  • SetFillColor metodu cari xana diapazonunun fon rəngini əvvəllər yaradılmış rəng obyektinin rənginə dəyişmək üçün nəzərdə tutulub.
  • GetValue metodu göstərilən aralığın dəyərini qaytarır.
  • GetSlideByIndex metodu slaydı təqdimatdakı mövqeyinə qaytarır.
  • Və daha çox.

Bütün ONLYOFFICE API metodlarının ətraflı təsviri və onların etdikləri rəsmi sənədlərdə tapıla bilər.

ONLYOFFICE Sənədlərində makrolar yuxarı alətlər panelindəki xüsusi plagin vasitəsilə yaradıla və silinə bilər. Ona daxil olmaq üçün Pluginlər sekmesini açın və Makrolar düyməsini basın. Siz makrolarınız üçün JavaScript kodu yaza biləcəyiniz bir pəncərə görəcəksiniz.

Müvafiq düymələrdən istifadə edərək yeni makrolar yarada və mövcud olanları silə bilərsiniz. Sizə həmçinin makroların adını dəyişməyə və hətta Autostart funksiyasını aktivləşdirməyə icazə verilir.

İndi ONLYOFFICE makrolarının necə işlədiyini başa düşdükdən sonra birini yazaq. Başlamazdan əvvəl makromuzla hansı tapşırığı yerinə yetirəcəyinə qərar verməliyik.

Sadə bir şeylə başlayaq və təsəvvür edək ki, Excel iş vərəqimizdəki hüceyrənin fon rəngini dəyişdirməliyik. Bu tapşırıq tort parçasıdır, lakin yaradacağımız makro onu çox sadələşdirəcək.

Başlamaq üçün Pluginlər sekmesine keçin və Makrolar üzərinə klikləyin. Bu pəncərəni ilk dəfə açsanız, orada artıq yaradılmış makronu tapacaqsınız. Bununla belə, bu makroda JavaScript kodu olmayacaq. Görəcəyiniz sadə bir funksiya sarğıdır:

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

Lazım gələrsə, makronuzun adını dəyişdirin.

İndi kodunuzu yazmağa başlaya bilərsiniz. Əvvəlki fəsildə qeyd olunmuş ONLYOFFICE Document Builder API sənədləri ilə məsləhətləşdikdən sonra, makronuz üçün aşağıdakı üsullardan istifadə edilməli olduğunu biləcəksiniz:

  • Aktiv vərəqi əldə etmək üçün Api.GetActiveSheet üsulu.
  • Tələb olunan diapazonu təyin etmək üçün GetRange metodu.
  • Tələb olunan xananın fon rəngini təyin etmək üçün SetFillColor metodu.
  • İstədiyiniz rəngi təyin etmək üçün Api.CreateColorFromRGB.

Əvvəlcə aktiv vərəqi əldə etməli və müvafiq metodları yazaraq tələb olunan diapazonu təyin etməlisiniz. Funksiya paketinə metodların adlarını yazmağa başlayın və siz bütün mövcud alət ipuçlarını görəcəksiniz ki, bu da çox rahatdır.

Sonra, cari xananın fon rəngini təyin etməlisiniz. Bunu etmək üçün SetFillColor metodundan istifadə edin. Api.CreateColorFromRGB metodu sizə bəyəndiyiniz rəngi təyin etməyə imkan verəcək. Kodunuz aşağıdakı kimi olmalıdır:

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

İndi makronuzu işə salmaq və nəticələri görmək vaxtıdır. Run düyməsini kliklədikdən sonra A2 xanasının rəngləndiyini görəcəksiniz. Siz Api.CreateColorFromRGB metodunda dəyəri dəyişdirərək müxtəlif rənglərlə oynaya bilərsiniz.

Əgər siz ONLYOFFICE makrolarını yaratmaq üçün JavaScript kodlaşdırmasının əsaslarını öyrənmək istəmirsinizsə, həmişə rəsmi internet saytından hazır makro nümunələrindən istifadə edə və onları ehtiyaclarınıza uyğun dəyişə bilərsiniz.

Gördüyünüz kimi, ONLYOFFICE Sənədlərində makro yaratmaq ilk baxışdan göründüyü qədər çətin deyil. Əlbəttə ki, onlarla kod sətirləri ilə mürəkkəb makrolar yaratmaq üçün JavaScript kodlaşdırmasının əsaslarını bilməlisiniz.

Bununla belə, gündəlik fəaliyyətlər üçün sadə makrolar yaratmaq sizin JavaScript gurusu olmağınızı tələb etmir. Öz plaginlərinizi yaratmağa çalışarkən əsas prinsipləri öyrənə bilərsiniz.

Əsas odur ki, ONLYOFFICE ofis dəsti, makroların yaradılması prosesini mümkün qədər sadə etmək üçün ətraflı API sənədləri və istifadəyə hazır nümunələrlə təmin edilir.