Cómo escribir macros en OnlyOffice Docs

¿Tiene que trabajar con documentos de Word, hojas de cálculo de Excel o presentaciones de PowerPoint y necesita repetir tareas complejas una y otra vez?? Por ejemplo, debe resaltar valores duplicados en una hoja o eliminar formas de las diapositivas de una presentación.

Si este es el caso, podría ser un desafío para usted como usuario de Linux. Realizar tales tareas manualmente no tiene sentido. Muchas operaciones diferentes se pueden hacer fácilmente automáticamente con Macros VBA en Microsoft Office. Sin embargo, hay un problema grave: no se ejecutan de forma nativa en las máquinas Linux.

Sin embargo, hay una solución ingeniosa a este problema. Puedes escribir y correr Javascript macros en Onlyfice Docs hacer operaciones monótonas.

Lea este artículo para averiguar cómo.

Tabla de contenido

1

• ¿Qué es solo Docs de Office??
• Comenzando con macros para OnlyOffice Docs
  • Las principales razones por las cuales Onlyfice Macros son buenas
  • Cómo funcionan las macros OnlyOffice
  • Cómo escribir una macro Onlyoffice
    • Conclusión

¿Qué es solo Docs de Office??

OnlyOffice Docs es una suite de oficina de código abierto y autohostado que está diseñado para crear un entorno de colaboración local en un servidor de Linux o Windows.

Lleva los beneficios de la edición de documentos en tiempo real y la coautoría a una gran cantidad de soluciones de intercambio de archivos, plataformas de aprendizaje electrónico y sistemas de gestión de documentos.

Onlyfice Docs

Actualmente, es compatible con NextCloud, OwnCloud, SeaFile, Plone, Confluence, Allesco, RedMine, WordPress, Chamilo, Moodle, Drupal y otro software. La integración es posible a través de conectores listos para usar que están disponibles en GitHub.

Usando Onlyfice Docs, Puede trabajar con todos los tipos populares de archivos de oficina, incluidos documentos de texto, hojas de cálculo, formularios más rellenos, diapositivas y PDFS.

El formato nativo de OnlyOffice Docs es OOXML (DOCX, XLSX, PPTX), por lo que puede reemplazar fácilmente a Microsoft Office en máquinas Linux. Otros formatos populares, como ODF, son compatibles con la conversión automática a OOXML.

Además de su versión autohostada, Onlyfice Docs tiene una versión de nube gratuita para uso personal. Además, hay aplicaciones gratuitas para todas las plataformas de escritorio y móviles populares, incluidos Windows, MacOS, Linux, Android e iOS.

Cuando se trata de la automatización de tareas, Onlyfice Docs no es compatible con las macros VBA de Microsoft. Utiliza macros JavaScript que son capaces de hacer las mismas operaciones de una manera mucho más segura.

Comenzando con macros para OnlyOffice Docs

A macro es un script pequeño que facilita trabajar con diferentes tipos de documentos mediante la automatización de una determinada tarea. En otras palabras, es una pieza de código de programación que contiene un conjunto de acciones que puede ejecutar tan a menudo como desee.

Por ejemplo, puede ejecutar la macro correspondiente para resaltar los duplicados en el área seleccionada en su hoja de cálculo con diferentes colores.

En Onlyfice Docs, se parece a esto:

Macros en OnlyOffice Docs

¿Cuál es la utilidad práctica de esta macro?? Al trabajar con datos, puede ejecutar la macro guardada en segundos haciendo clic en el botón correspondiente para resaltar los valores duplicados tantas veces como sea necesario, lo que le ahorrará horas de tiempo.

Las principales razones por las cuales Onlyfice Macros son buenas

En Onlyfice Docs, las macros se basan en el Javascript sintaxis y los métodos API de Onlyfice Document Builder. Hay algunas razones obvias por las que son mejores que las macros VBA:

• Las macros OnlyOffice son multiplataforma - A diferencia de Visual Basic, JavaScript es un lenguaje de programación más común. Por lo tanto, las macros JavaScript pueden ejecutarse fácilmente en las plataformas de Windows, Linux y MacOS.
• Las macros OnlyOffice son fáciles de usar - JavaScript a menudo se recomienda para principiantes y tiene una comunidad de rápido crecimiento. Muchas personas eligen a JavaScript como su primer lenguaje de programación porque hay muchos tutoriales y guías detallados en Internet.
• Las macros OnlyOffice son seguras - El código JavaScript de OnlyOffice Macros se ejecuta en la misma ventana que los editores. Por lo tanto, los atacantes no pueden utilizar para comprometer su sistema porque no tienen acceso a él.

Cómo funcionan las macros OnlyOffice

Un Onlyfice Macro es una combinación de la Javascript sintaxis y API métodos de Onlyfice Document Builder.

Onlyfice Document Builder es una biblioteca C ++ utilizada para crear y editar los archivos XML de Office, así como para guardar archivos no OOOXML en formatos DOCX, XSLX, PPTX y PDF. Funciona con la API JavaScript.

Hay una gran cantidad de API Onlyffice métodos, y no es probable que use la mayoría de ellos. Estos son algunos ejemplos prácticos:

• El Setfillcolor El método está diseñado para cambiar el color de fondo del rango de celdas actual al color de un objeto de color creado previamente.
• El Valiente El método devuelve el valor del rango especificado.
• El GetSlidebyIndex El método devuelve una diapositiva a su posición en la presentación.
• Y mucho más.

Una descripción detallada de todos API Onlyffice métodos y lo que hacen se pueden encontrar en la documentación oficial.

En Onlyfice Docs, Las macros se pueden crear y eliminar a través de un complemento especial en la barra de herramientas superior. Para acceder a él, abra el Complementos pestaña y haga clic en el Macros botón. Verá una ventana donde podrá escribir código JavaScript para sus macros.

Usando los botones correspondientes, puede crear nuevas macros y eliminar las existentes. También se le permite cambiar el nombre de las macros e incluso activar la función AutoStartt.

Crear macros en OnlyOffice Docs

Cómo escribir una macro Onlyoffice

Ahora que entiendes como Onlyfice Macros Trabajar, escribamos uno. Antes de comenzar, es necesario decidir qué tarea se hará con nuestra macro.

Comencemos con algo simple e imaginemos que necesitamos cambiar el color de fondo de una celda en nuestra Sobresalir hoja de cálculo. Esta tarea es un pastel, pero la macro que vamos a crear lo hará mucho más simple.

Para comenzar, ve al Complementos pestaña y haga clic Macros. Si abre esta ventana por primera vez, encontrará una macro ya creada allí. Sin embargo, no habrá código JavaScript en esta macro. Lo que verá es un envoltorio de función simple:

(function () // ... su código aquí ...) (); 

Cambie el nombre de su macro si es necesario.

Escribe macros en OnlyOffice Docs

Ahora puedes comenzar a escribir tu código. Después de consultar el API de constructor de documentos OnlyOffice La documentación, que ya se ha mencionado en el capítulo anterior, sabrá que los siguientes métodos deben usarse para su macro:

• El API.Hojas de getactives Método para obtener la hoja activa.
• El Rango Método para establecer el rango requerido.
• El Setfillcolor método para establecer el color de fondo de la celda requerida.
• El API.CreateColorFromRGB Para establecer el color deseado.

Primero, debe obtener la hoja activa y establecer el rango requerido escribiendo los métodos correspondientes A2. Comience a escribir los nombres de los métodos en el envoltorio de funciones, y verá todas las información sobre herramientas disponibles, que es muy conveniente.

Métodos de macros en OnlyOffice Docs

Luego, debe establecer el color de fondo de la celda actual. Para hacerlo, use el Setfillcolor método. El API.CreateColorFromRGB El método le permitirá establecer el color que desee. Su código debe ser el siguiente:

(function () // API.GetActivesheet ().GetRange ("A2").SetFillColor (API.CreateColorFromRGB (0, 0, 210)); ) (); 

Establecer fondo de macros en OnlyOffice Docs

Ahora es el momento de ejecutar la macro y ver los resultados. Después de hacer clic en el Correr botón, verás esa celda A2 es color. Puedes jugar con diferentes colores cambiando el valor en el API.CreateColorFromRGB método.

Ejecutar macros en OnlyOffice Docs

Si no quieres aprender los conceptos básicos de Javascript codificación para crear Onlyoffice macros, siempre puede usar ejemplos macro listos del sitio web oficial y modificarlos de acuerdo con sus necesidades.

Conclusión

Como puede ver, creando macros en Onlyfice Docs no es tan difícil como parece a primera vista. Por supuesto, debe conocer los fundamentos de la codificación de JavaScript para hacer macros complejas con docenas de líneas de código.

Sin embargo, crear macros simples para actividades de rutina diaria no requiere que seas un gurú de JavaScript. Puede aprender los principios básicos al intentar crear sus propios complementos.

Es importante destacar que el Onlyoffice Office Suite viene con documentación de API detallada y ejemplos listos para usar para que el proceso de crear macros sea lo más simple posible.