웹사이트 검색

ONLYOFFICE Docs에서 JavaScript 매크로를 작성하는 방법

Word 문서, Excel 스프레드시트 또는 PowerPoint 프레젠테이션으로 작업해야 하며 복잡한 작업을 계속해서 반복해야 합니까? 예를 들어 시트에서 중복된 값을 강조 표시하거나 프레젠테이션 슬라이드에서 도형을 제거해야 합니다.

이 경우 Linux 사용자로서 어려울 수 있습니다. 이러한 작업을 수동으로 수행하는 것은 의미가 없습니다. Microsoft Office의 VBA 매크로를 사용하면 다양한 작업을 자동으로 쉽게 수행할 수 있습니다. 그러나 심각한 문제가 있습니다. Linux 시스템에서는 기본적으로 실행되지 않습니다.

그러나 이 문제에 대한 독창적인 해결책이 있습니다. ONLYOFFICE Docs에서 JavaScript 매크로를 작성하고 실행하여 단조로운 작업을 수행할 수 있습니다.

방법을 알아보려면 이 기사를 읽어보세요.

ONLYOFFICE 문서란 무엇입니까?

ONLYOFFICE Docs는 Linux 또는 Windows 서버에서 로컬 공동 작업 환경을 생성하도록 설계된 오픈 소스 및 자체 호스팅 오피스 제품군입니다.

실시간 문서 편집 및 공동 작성의 이점을 수많은 파일 공유 솔루션, e-러닝 플랫폼 및 문서 관리 시스템에 제공합니다.

현재 Nextcloud, ownCloud, Seafile, Plone, Confluence, Alfresco, Redmine, WordPress, Chamilo, Moodle, Drupal 및 기타 소프트웨어와 호환됩니다. GitHub에서 제공되는 즉시 사용 가능한 커넥터를 통해 통합이 가능합니다.

ONLYOFFICE Docs를 사용하면 텍스트 문서, 스프레드시트, 채울 수 있는 양식, 슬라이드, PDF 등 널리 사용되는 모든 유형의 Office 파일로 작업할 수 있습니다.

ONLYOFFICE Docs의 기본 형식은 OOXML(DOCX, XLSX, PPTX)이므로 Linux 시스템에서 Microsoft Office를 쉽게 대체할 수 있습니다. ODF와 같은 다른 널리 사용되는 형식은 OOXML로의 자동 변환을 통해 지원됩니다.

자체 호스팅 버전 외에도 ONLYOFFICE Docs에는 개인용 무료 클라우드 버전이 있습니다. 또한 Windows, macOS, Linux, Android 및 iOS를 포함하여 널리 사용되는 모든 데스크톱 및 모바일 플랫폼을 위한 무료 앱이 있습니다.

작업 자동화의 경우 ONLYOFFICE Docs는 Microsoft의 VBA 매크로와 호환되지 않습니다. 훨씬 안전한 방식으로 동일한 작업을 수행할 수 있는 JavaScript 매크로를 사용합니다.

ONLYOFFICE Docs용 매크로 시작하기

매크로는 특정 작업을 자동화하여 다양한 유형의 문서 작업을 더 쉽게 해주는 작은 스크립트입니다. 즉, 원하는 만큼 자주 실행할 수 있는 일련의 작업이 포함된 프로그래밍 코드입니다.

예를 들어, 해당 매크로를 실행하여 스프레드시트의 선택한 영역에서 중복 항목을 다른 색상으로 강조 표시할 수 있습니다.

ONLYOFFICE 문서에서는 다음과 같습니다.

이 매크로의 실제적인 유용성은 무엇입니까? 데이터 작업 시 해당 버튼을 클릭하여 필요한 만큼 중복 값을 강조 표시함으로써 몇 초 내에 저장된 매크로를 실행할 수 있으므로 시간이 절약됩니다.

ONLYOFFICE 매크로가 좋은 주요 이유

ONLYOFFICE Docs에서 매크로는 JavaScript 구문과 ONLYOFFICE Document Builder의 API 메소드를 기반으로 합니다. VBA 매크로보다 나은 몇 가지 분명한 이유가 있습니다.

  • ONLYOFFICE 매크로는 크로스 플랫폼입니다 – Visual Basic과 달리 JavaScript는 더 일반적인 프로그래밍 언어입니다. 따라서 JavaScript 매크로는 Windows, Linux 및 macOS 플랫폼에서 쉽게 실행할 수 있습니다.
  • ONLYOFFICE 매크로는 사용하기 쉽습니다 – JavaScript는 초보자에게 권장되는 경우가 많으며 커뮤니티가 빠르게 성장하고 있습니다. 많은 사람들이 인터넷에 자세한 튜토리얼과 가이드가 많기 때문에 JavaScript를 첫 번째 프로그래밍 언어로 선택합니다.
  • ONLYOFFICE 매크로는 안전합니다 – ONLYOFFICE 매크로의 JavaScript 코드는 편집기와 동일한 창에서 실행됩니다. 따라서 공격자는 시스템에 액세스할 수 없기 때문에 시스템을 손상시키는 데 사용할 수 없습니다.

ONLYOFFICE 매크로 작동 방식

ONLYOFFICE 매크로는 JavaScript 구문과 ONLYOFFICE 문서 작성기의 API 방법의 조합입니다.

ONLYOFFICE 문서 작성기는 Office Open XML 파일을 생성 및 편집하고 OOXML이 아닌 파일을 DOCX, XSLX, PPTX 및 PDF 형식으로 저장하는 데 사용되는 C++ 라이브러리입니다. JavaScript API로 작동합니다.

ONLYOFFICE API 메소드는 많지만 대부분을 사용하지는 않을 것입니다. 다음은 몇 가지 실제 예입니다.

  • SetFillColor 메소드는 현재 셀 범위의 배경색을 이전에 생성된 색상 개체의 색상으로 변경하도록 설계되었습니다.
  • GetValue 메소드는 지정된 범위의 값을 반환합니다.
  • GetSlideByIndex 메소드는 슬라이드를 프레젠테이션의 해당 위치로 반환합니다.
  • 그리고 훨씬 더.

모든 ONLYOFFICE API 메소드와 그 기능에 대한 자세한 설명은 공식 문서에서 확인할 수 있습니다.

ONLYOFFICE Docs에서는 상단 툴바에 있는 특수 플러그인을 통해 매크로를 생성하고 삭제할 수 있습니다. 액세스하려면 플러그인 탭을 열고 매크로 버튼을 클릭하세요. 매크로용 JavaScript 코드를 작성할 수 있는 창이 표시됩니다.

해당 버튼을 사용하여 새 매크로를 생성하고 기존 매크로를 삭제할 수 있습니다. 또한 매크로 이름을 바꾸고 자동 시작 기능을 활성화할 수도 있습니다.

ONLYOFFICE 매크로를 작성하는 방법

이제 ONLYOFFICE 매크로의 작동 방식을 이해했으므로 매크로를 작성해 보겠습니다. 시작하기 전에 매크로로 어떤 작업을 수행할지 결정해야 합니다.

간단한 것부터 시작하여 Excel 워크시트에서 셀의 배경색을 변경해야 한다고 상상해 보겠습니다. 이 작업은 매우 간단하지만 우리가 만들 매크로를 사용하면 이 작업이 훨씬 간단해집니다.

시작하려면 플러그인 탭으로 이동하여 매크로를 클릭하세요. 이 창을 처음 열면 이미 생성된 매크로가 있습니다. 그러나 이 매크로에는 JavaScript 코드가 없습니다. 여러분이 보게 될 것은 간단한 함수 래퍼입니다:

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

필요한 경우 매크로 이름을 바꾸십시오.

이제 코드 작성을 시작할 수 있습니다. 이전 장에서 이미 언급한 ONLYOFFICE Document Builder API 문서를 참조한 후에는 매크로에 다음 방법을 사용해야 한다는 것을 알게 됩니다.

  • 활성 시트를 가져오는 Api.GetActiveSheet 메서드.
  • 필요한 범위를 설정하는 GetRange 메소드.
  • SetFillColor 메소드는 필수 셀의 배경색을 설정합니다.
  • 원하는 색상을 설정하는 Api.CreateColorFromRGB입니다.

먼저 활성 시트를 가져오고 해당 메서드를 입력하여 필요한 범위를 설정해야 합니다. Let's target cell A2. 함수 래퍼에 메서드 이름을 입력하기 시작하면 사용 가능한 모든 도구 설명이 표시되므로 매우 편리합니다.

그런 다음 현재 셀의 배경색을 설정해야 합니다. 그렇게 하려면 SetFillColor 메소드를 사용하세요. Api.CreateColorFromRGB 메소드를 사용하면 원하는 색상을 설정할 수 있습니다. 코드는 다음과 같아야 합니다.

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

이제 매크로를 실행하고 결과를 확인할 차례입니다. 실행 버튼을 클릭하면 A2 셀에 색상이 지정된 것을 볼 수 있습니다. Api.CreateColorFromRGB 메소드의 값을 변경하여 다양한 색상을 사용할 수 있습니다.

ONLYOFFICE 매크로를 만들기 위해 JavaScript 코딩의 기본 사항을 배우고 싶지 않다면 언제든지 공식 웹사이트에서 준비된 매크로 예제를 사용하고 필요에 따라 수정할 수 있습니다. .

결론

보시다시피 ONLYOFFICE Docs에서 매크로를 만드는 것은 언뜻 보기만큼 어렵지 않습니다. 물론, 수십줄의 코드라인으로 복잡한 매크로를 만들기 위해서는 자바스크립트 코딩의 기본을 알아야 합니다.

그러나 일상적인 활동을 위한 간단한 매크로를 만드는 데 JavaScript 전문가가 될 필요는 없습니다. 자신만의 플러그인을 만들면서 기본 원리를 배울 수 있습니다.

중요한 점은 ONLYOFFICE 오피스 제품군에는 자세한 API 문서와 바로 사용할 수 있는 예제가 함께 제공되어 매크로 생성 과정을 최대한 간단하게 만들어준다는 것입니다.