Cómo escribir macros de JavaScript en documentos de ONLYOFFICE

Aporta los beneficios de la edición y coautoría de documentos en tiempo real a una serie de soluciones para compartir archivos, plataformas de aprendizaje electrónico y sistemas de gestión de documentos.

Actualmente compatible con Nextcloud, ownCloud, Seafile, Plone, Confluence, Alfresco, Redmine, WordPress, Chamilo, Moodle, Drupal y otros programas. La integración es posible a través de conectores listos para usar disponibles en GitHub.

usar Documentación de ONLYOFFICEpuede trabajar con todos los tipos populares de documentos de oficina, incluidos documentos de texto, hojas de cálculo, formularios para completar, diapositivas y archivos PDF.

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 autohospedada, Documentación de ONLYOFFICE hay uno Versión gratuita en la nube para uso personalAdemás, hay aplicaciones gratuitas para todas las plataformas móviles y de escritorio populares, incluidas Windows, macOS, Linux, Android e iOS.

Hablando de automatización de tareas, Documentación de ONLYOFFICE Incompatible con las macros VBA de Microsoft. Utiliza macros de JavaScript que hacen lo mismo de una manera más segura.

Comience con macros para documentos de ONLYOFFICE

Una especie de la macro es un pequeño script que facilita el trabajo con diferentes tipos de documentos al automatizar ciertas tareas. En otras palabras, es una pieza de código de programación que contiene un conjunto de operaciones que puedes ejecutar cuando quieras.

Por ejemplo, puede ejecutar una macro para resaltar los duplicados en un rango seleccionado de su hoja de cálculo en un color diferente.

existe Documentación de ONLYOFFICEque se ve así:

¿Cuál es el uso real de esta macro? Al procesar datos, puede ejecutar macros guardadas en segundos haciendo clic en el botón correspondiente para resaltar valores duplicados tantas veces como sea necesario, lo que le ahorrará horas de tiempo.

La razón principal por la que las macros de ONLYOFFICE son buenas

existe Documentación de ONLYOFFICELa macro se basa en JavaScript La sintaxis y los métodos API para Generador de documentos ONLYOFFICEson mejores que las macros de VBA por algunas razones obvias:

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

Cómo funcionan las macros de ONLYOFFICE

una Macros de SOLO OFICINA sí combinación JavaScript gramática y API Métodos Generador de documentos ONLYOFFICE.

Generador de documentos ONLYOFFICE es una biblioteca de C++ para crear y editar archivos Office Open XML y guardar archivos que no sean OOXML en formatos DOCX, XSLX, PPTX y PDF. Se ejecuta utilizando la API de JavaScript.

Hay muchos API de SOLO OFICINA métodos, y es poco probable que utilice la mayoría de ellos. Estos son algunos ejemplos prácticos:

• este establecer color de relleno Método diseñado para cambiar el color de fondo del rango actual de celdas al color de un objeto de color creado previamente.
• este valor El método devuelve un valor dentro del rango especificado.
• este obtener índice de diapositivas El método devuelve la diapositiva a su posición en la presentación.
• y más.

todas las instrucciones detalladas API de SOLO OFICINA métodos y su papel se pueden encontrar en documento oficial.

existe Documentación de ONLYOFFICE, 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 enchufar pestaña y haga clic Macro botón. Verá una ventana donde puede escribir código JavaScript para la macro.

Usando los botones correspondientes, puede crear nuevas macros y eliminar las existentes. También puede cambiar el nombre de las macros e incluso activar el inicio automático.

Cómo escribir macros de ONLYOFFICE

ahora que entiendes Macros de SOLO OFICINA trabajo, vamos a escribir uno. Antes de comenzar, es necesario decidir qué tarea realizará nuestra macro.

Comencemos con algo simple, digamos que necesitamos cambiar el color de fondo de nuestra celda Sobresalir hoja de cálculo. Esta tarea es pan comido, pero las macros que vamos a crear lo harán mucho más fácil.

Para empezar, vaya a enchufar pestaña y haga clic MacroSi está abriendo esta ventana por primera vez, encontrará que ya hay una macro creada. Sin embargo, no habrá código JavaScript en esta macro. Verá un contenedor de función simple:

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

Cambie el nombre de su macro si es necesario.

Ahora puedes empezar a escribir código.después de consultar API del generador de documentos de ONLYOFFICE De la documentación ya mencionada en el capítulo anterior, sabrá que su macro debe usar los siguientes métodos:

• este interfaz.GetActiveSheet Método para obtener la hoja activa.
• este obtener alcance para establecer el rango deseado.
• este establecer color de relleno para establecer el color de fondo de la celda deseada.
• este API.CreateColorFromRGB Establezca el color deseado.

Primero, debe obtener la hoja activa y establecer el rango deseado escribiendo el método apropiado Localicemos la celda A2Comience a escribir el nombre del método en el envoltorio de la función y verá todas las informaciones sobre herramientas disponibles, muy útiles.

Luego, debe establecer el color de fondo de la celda actual.Para hacer esto, use establecer color de relleno método.este API.CreateColorFromRGB El método le permitirá establecer el color que desee. Su código debería verse así:

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

Ahora es el momento de ejecutar la macro y ver los resultados.después de hacer clic correr botón y verás esa celda A2 es de colorPuedes jugar con diferentes colores cambiando los valores en API.CreateColorFromRGB método.

Si no quieres aprender lo básico JavaScript creación de código SOLO OFICINA macro, siempre puedes usar Ejemplo de macro preparada desde el sitio oficial y modifíquelo según sus necesidades.

en conclusión

Como puede ver, la creación Macro existe Documentación de ONLYOFFICE No es tan difícil como podría parecer a primera vista. Por supuesto, debe conocer los conceptos básicos de la codificación de JavaScript para crear macros complejas con docenas de líneas de código.

Sin embargo, no es necesario ser un gurú de JavaScript para crear macros simples para las actividades cotidianas. Puede aprender los fundamentos mientras intenta crear sus propios complementos.

En tono rimbombante, SOLO OFICINA El paquete ofimático viene con documentación API detallada y ejemplos listos para usar para que el proceso de creación de macros sea lo más fácil posible.