Jak pisać makra w Dokumentach OnlyOffice

Jak pisać makra w Dokumentach OnlyOffice

Czy musisz pracować z dokumentami słów, arkuszami kalkulacyjnymi Excel lub prezentacjami PowerPoint i musisz powtarzać złożone zadania w kółko? Na przykład musisz podświetlić zduplikowane wartości w arkuszu lub usunąć kształty z slajdów prezentacji.

Jeśli tak jest, może być dla Ciebie trudne jako użytkownik Linux. Ręczne wykonywanie takich zadań jest bez znaczenia. Wiele różnych operacji można łatwo wykonać automatycznie za pomocą makr VBA w Microsoft Office. Jest jednak poważny problem - nie działają natywnie na maszynach Linux.

Istnieje jednak genialne rozwiązanie tego problemu. Możesz pisać i uruchomić JavaScript makra w Dokumenty OnlyOffice wykonywać monotonne operacje.

Przeczytaj ten artykuł, aby dowiedzieć się, jak.

Spis treści

1
  • Co to jest Dokumenty OnlyOffice?
  • Pierwsze kroki z makrami dla Doktorów OnlyOffice
    • Główne powody, dla których makr makrowy są dobre
    • Jak działają tylko makra
    • Jak napisać makro OnlyOffice
      • Wniosek

Co to jest Dokumenty OnlyOffice?

OnlyOffice Docs to apartament biurowy typu open source i samowystarczalny, który jest przeznaczony do tworzenia lokalnego środowiska współpracy na serwerze Linux lub Windows Server.

Zapewnia korzyści płynące z edycji dokumentów w czasie rzeczywistym i współautor do dużej liczby rozwiązań do udostępniania plików, platform e-learningowych i systemów zarządzania dokumentami.

Dokumenty OnlyOffice

Obecnie jest kompatybilny z NextCloud, OwnCloud, Seafile, Plone, Confluence, Alfresco, Redmine, WordPress, Chamilo, Moodle, Drupal i inne oprogramowanie. Integracja jest możliwa poprzez gotowe do użycia złącza, które są dostępne w GitHub.

Za pomocą Dokumenty OnlyOffice, Możesz pracować ze wszystkimi popularnymi typami plików biurowych, w tym dokumentami tekstowymi, arkuszami kalkulacyjnymi, formularzami wypełniającymi, slajdami i pdfs.

Natywny format Doktorów OnlyOffice to OOXML (DOCX, XLSX, PPTX), dzięki czemu może łatwo wymienić Microsoft Office na maszynach Linux. Inne popularne formaty, takie jak ODF, są obsługiwane poprzez automatyczną konwersję na OOXML.

Oprócz samozwańczej wersji, Dokumenty OnlyOffice ma bezpłatną wersję w chmurze do użytku osobistego. Istnieją również bezpłatne aplikacje dla wszystkich popularnych platform stacjonarnych i mobilnych, w tym system Windows, MacOS, Linux, Android i iOS.

Jeśli chodzi o automatyzację zadań, Dokumenty OnlyOffice nie jest kompatybilny z makrami VBA Microsoft. Używa makr JavaScript, które są w stanie wykonywać te same operacje w znacznie bezpieczniej.

Pierwsze kroki z makrami dla Doktorów OnlyOffice

A makro to mały skrypt, który ułatwia pracę z różnymi rodzajami dokumentów poprzez automatyzację określonego zadania. Innymi słowy, jest to kawałek kodu programowania, który zawiera zestaw działań, które możesz działać tak często, jak chcesz.

Na przykład możesz uruchomić odpowiednie makro, aby wyróżnić duplikaty w wybranym obszarze w arkuszu kalkulacyjnym z różnymi kolorami.

W Dokumenty OnlyOffice, To wygląda tak:

Makra w Doktorach OnlyOffice

Jaka jest praktyczna użyteczność tego makra? Podczas pracy z danymi możesz uruchomić zapisane makro w ciągu kilku sekund, klikając odpowiedni przycisk, aby wyróżnić zduplikowane wartości tyle razy, ile potrzebujesz, co pozwoli Ci zaoszczędzić godzinę czasu.

Główne powody, dla których makr makrowy są dobre

W Dokumenty OnlyOffice, Makra są oparte na JavaScript Składnia i metody API OnlyOffice Dokument Builder. Istnieją oczywiste powody, dla których są lepsze niż makra VBA:

  • Makra OnlyOffice są platformami krzyżowymi - W przeciwieństwie do Visual Basic, JavaScript jest bardziej powszechnym językiem programowania. Dlatego makra JavaScript mogą łatwo działać na platformach Windows, Linux i MacOS.
  • Makra OnlyOffice są łatwe w użyciu - JavaScript jest często zalecany dla początkujących i ma szybko rozwijającą się społeczność. Wiele osób wybiera JavaScript jako swój pierwszy język programowania, ponieważ w Internecie jest wiele szczegółowych samouczków i przewodników.
  • Makra OnlyOffice są bezpieczne - Kod JavaScript Macrose Macros działa w tym samym oknie, co redaktorzy. Dlatego nie można ich użyć do naruszenia systemu przez atakujących, ponieważ nie mają do niego dostępu.

Jak działają tylko makra

Jakiś Tylko makro to połączenie JavaScript składnia i API metody OnlyOffice Dokument Builder.

OnlyOffice Dokument Builder to biblioteka C ++ używana do tworzenia i edytowania biurowych plików XML, a także zapisywanie formatów nie-OOXML na formaty DOCX, XSLX, PPTX i PDF. Działa z API JavaScript API.

Jest dużo API OnlyOffice metody i prawdopodobnie nie będziesz ich używać większości z nich. To są praktyczne przykłady:

  • SetfillColor Metoda jest przeznaczona do zmiany koloru tła obecnego zakresu ogniwa na kolor wcześniej utworzonego obiektu kolorów.
  • GetValue Metoda zwraca wartość określonego zakresu.
  • GetlidebyIndex Metoda zwraca slajd do swojej pozycji w prezentacji.
  • I wiele więcej.

Szczegółowy opis wszystkich API OnlyOffice Metody i to, co robią, można znaleźć w oficjalnej dokumentacji.

W Dokumenty OnlyOffice, Makra można tworzyć i usuwać za pomocą specjalnej wtyczki na górnym pasku narzędzi. Aby uzyskać do niego dostęp, otwórz Wtyczki zakładka i kliknij Makra przycisk. Zobaczysz okno, w którym będziesz mógł napisać kod JavaScript dla swoich makr.

Za pomocą odpowiednich przycisków możesz tworzyć nowe makra i usunąć istniejące. Możesz również zmienić nazwę makr, a nawet aktywować funkcję Autostart.

Utwórz makr w Dokumentach OnlyOffice

Jak napisać makro OnlyOffice

Teraz, gdy rozumiesz, jak Makra OnlyOffice Pracuj, napiszmy jeden. Zanim zaczniemy, należy zdecydować, jakie zadanie zostanie wykonane z naszym makro.

Zacznijmy od czegoś prostego i wyobraź sobie, że musimy zmienić kolor tła komórki w naszym Przewyższać arkusz roboczy. To zadanie jest kawałkiem ciasta, ale makro, które zamierzamy stworzyć.

Aby zacząć, idź do Wtyczki Zakładka i kliknij Makra. Jeśli otworzysz to okno po raz pierwszy, znajdziesz tam już utworzone makro. Jednak w tym makro nie będzie kodu JavaScript. To, co zobaczysz, to proste opakowanie funkcji:

(function () //… Twój kod tutaj…) (); 

W razie potrzeby zmień nazwę makra.

Napisz makr w Dokumentach OnlyOffice

Teraz możesz zacząć pisać swój kod. Po konsultacji API Builder Dokument Document Builder Dokumentacja, o której wspomniano już w poprzednim rozdziale, będziesz wiedział, że na makro należy użyć następujących metod:

  • API.GetactiveSheet metoda uzyskania aktywnego arkusza.
  • GetRange Metoda ustawienia wymaganego zakresu.
  • SetfillColor metoda ustawienia koloru tła wymaganej komórki.
  • API.CreateColorfromrgb Aby ustawić pożądany kolor.

Najpierw musisz uzyskać aktywny arkusz i ustawić wymagany zakres, wpisując odpowiednie metody komórka docelowa A2. Zacznij pisać nazwy metod w opakowaniu funkcji, a zobaczysz wszystkie dostępne podpowiedzi, co jest bardzo wygodne.

Metody makr w Dokumentach OnlyOffice

Następnie musisz ustawić kolor tła obecnej komórki. Aby to zrobić, użyj SetfillColor metoda. API.CreateColorfromrgb Metoda pozwoli ci ustawić kolor, który lubisz. Twój kod powinien być następujący:

(funkcja () // API.GetactiveSheet ().GetRange („a2”).SetfillColor (API.CreateColorfromrgb (0, 0, 210)); ) (); 
Ustaw tło makr w Dokumentach OnlyOffice

Teraz nadszedł czas, aby uruchomić makro i zobaczyć wyniki. Po kliknięciu Uruchomić przycisk, zobaczysz tę komórkę A2 jest kolorowy. Możesz grać różnymi kolorami, zmieniając wartość w API.CreateColorfromrgb metoda.

Uruchom makra w Dokumentach OnlyOffice

Jeśli nie chcesz nauczyć się podstaw JavaScript kodowanie do tworzenia OnlyOffice makra, zawsze możesz używać gotowych przykładów makro z oficjalnej strony internetowej i zmodyfikować je zgodnie z Twoimi potrzebami.

Wniosek

Jak widać, tworzenie makra W Dokumenty OnlyOffice nie jest tak trudne, jak się wydaje od pierwszego wejrzenia. Oczywiście musisz znać podstawy kodowania JavaScript, aby tworzyć złożone makra z dziesiątkami linii kodu.

Jednak tworzenie prostych makr do codziennych rutynowych czynności nie wymaga guru JavaScript. Możesz nauczyć się podstawowych zasad, próbując tworzyć własne wtyczki.

Co ważne, OnlyOffice Office Suite zawiera szczegółową dokumentację interfejsu API i gotowe do użycia przykłady, aby proces tworzenia makr był tak prosty, jak to możliwe.