Integración de NetBeans con OpenOffice.org
Índice de contenido Licencia...1 Alcance...1 Antrecedentes...1 Instalación del módulo de desarrollo en NetBeans...2 Configurar...7 Creando una función para Calc...8 LICENCIA Se permite emplear este documento sin costo alguno solo para uso personal en el aprendizaje de OpenOffice.org o la enseñanza de la suite de oficina OpenOffice.org sin costo para el estudiante. Lo que implica que ningún centro educativo o de capacitación para el trabajo, podrá cobrar por ningún concepto mientras use esta guía para la enseñanza de OpenOffice.org. En caso de querer realizar una obra derivada de este manual, puede realizarlo bajo las siguientes condiciones: a) Debe reconocer y citar al autor original. b) No puede utilizar esta obra para fines comerciales. La información contenida en este documento y los derivados de éste se proporcionan tal cual son y los autores no asumirán responsabilidad alguna si el usuario o lector hace mal uso de éstos. Para utilizar esta información con fines comerciales, favor de ponerse en contacto con el autor. Las marcas a las que se hace referencia en este documento es solo con fines informativos y son propiedad de sus respectivos dueños. J. Eduardo Moreno S. emoreno@tokonhu.com México D.F. A 14 de octubre de 2007 1 / 19
ALCANCE El manual no busca enseñar Java, NetBeans u OpenOffice.org. Solo muestra la forma de integrar estos elementos para generar funcionen que sean añadidas a la hoja de calculo Calc. El ambiente gráfico en el que se configuran los programas es Windows XP Service Pack 2. Las extensiones generadas hasta el momento han sido probados en OpenOfFice.org 2.3 en ambiente Windows y en la versión Beta de Ubuntu 7.10. ANTECEDENTES Sun Microsystems es una empresa del área de las TI que libero el código de OpenOffice.org. También es la desarrolladora del lenguaje Java y uno de los mejores ambientes de desarrollo llamado NetBeans. Así, decidieron juntar estos tres excelentes productos de tal forma que se puedan desarrollar programas adicionales para OpenOffice.org y StarOffice en el ambiente NetBeans con el lenguaje Java, generando archivos con extensión.oxt, los cuales incluyen todo lo necesario para que el programa corra como parte integral de OpenOffice.org o StarOffice en forma de Menús, asistentes o funciones para Calc. En este manual veremos como generar una función para Calc. Se da por hecho que la persona que lee este manual conoce el lenguaje Java, el ambiente de desarrollo NetBeans y el uso de OpenOffice.org, así como los fundamentos del manejo de archivos en el ambiente gráfico MS Windows. Se requiere tener instalado: NetBeans (http://www.netbeans.info/downloads/index.php) Java (http://www.java.com/es/download/) Instalar OpenOffice.org (http://es.openoffice.org) Instalar OpenOffice.org SDK (http://download.openoffice.org/2.3.0/sdk.html) Debe considerarse que la versión de OpenOffice.org SDK a utilizar debe ser igual a la versión de OpenOffice.org que se utiliza para trabajar. Para este manual estamos utilizando la versión de Java 6 update 3, NetBeans 5.5.1 y OpenOffice.org 2.3 en español. 2 / 19
INSTALACIÓN DEL MÓDULO DE DESARROLLO EN NETBEANS Abrimos NetBeans y del menú Herramientas elegimos Centro de Actualización. Se requiere tener una conexión a Internet para poder descargar el modulo de integración de OpenOffice.org con NetBeans. Damos clic al botón Siguiente> Cuando termina de conectarse y buscar nos muestra la lista de módulos encontrados 3 / 19
En la sección Actualizaciones y nuevos Módulos disponibles: buscar y seleccionar OpenOffice.org API Plugin Damos clic al botón Agregar> 4 / 19
Damos clic al botón Siguiente> y vemos aparecer la licencia Damos clic al botón Aceptar para que inicie el proceso de descarga e instalación. 5 / 19
Cuando termina la descarga damos clic al botón Siguiente> Al dar clic en el botón Terminar estará listo el módulo para trabajar. 6 / 19
CONFIGURAR Ahora debemos activar las rutas donde se encuentra OpenOffice.org y el SDK. Desde el menú Herramientas elegimos Opciones Elegimos Miscelaneos y rellenamos con los datos correctos de nuestra configuración en la sección OpenOffice.org API Plugin Settings: 7 / 19
Al dar clic en el botón OK estaremos listos para generar nuestras funciones para Calc (Add-in), menús (Add-On) o aplicaciones externas. 8 / 19
CREANDO UNA FUNCIÓN PARA CALC En México tenemos un impuesto llamado IVA el cual puede ser del 10% o 15%, dependiendo de la zona donde se realice la transacción económica. El IVA se calcula en base a una cantidad. Podemos detectar dos parámetros: la cantidad a la cual le calcularemos el impuesto y la zona donde se aplicará. Del menú Archivo elegimos Nuevo Proyecto... y vemos un cuadro de diálogo del cual elegimos OpenOffice.org y del lado derecho OpenOffice.org Calc Add-in Damos clic al botón Siguiente> y tendremos un nuevo cuadro de diálogo pidiendo el nombre del proyecto y de la función. Como la función nos ayudara a calcular el IVA le llamaremos así. El paquete Java le llamaremos org.openoffice. Los directorios donde queremos que se genere el plug-in pueden cambiar. Si marcamos la casilla de verificación Create backward compatible Calc Add-in la función podrá ser compatible con versiones anteriores de OpenOffice.org 9 / 19
Damos clic al botón Siguiente> y nos pide que capturemos los datos de la función 10 / 19
Llenamos las propiedades con la información que nos pide. Name: Nombre que tendrá la función. Type: Tipo de valor que regresará la función. Category: Categoría en la que quedará clasificada la función. Se puede elegir Database (Base de datos), Date&time (Fecha y hora), Financial (Finanzas), Information (Información), Logical (Lógico), Mathematical (Matemáticas), Matrix (Matriz), Estatical (Estadística), Spreadsheet (Hoja), Text (Texto) y Add In. Dependerá de donde queremos que aparezca nuestra función mientras se ejecuta el piloto de funciones o el tipo de cálculo que realiza. Ya que nuestra función solo servirá en el idioma español, agregaremos el idioma desde el botón Add Languaje... y borramos el idioma Ingles con Delete Languaje... Rellenamos para que nuestra función proporcione la información necesaria cuando se ejecute desde el piloto de funciones. El nombre de la función como se va a desplegar (DisplayName) es IVA, La descripción que aparecera en el piloto de funciones (Description) es: Cálcula el I.V.A. (Impuesto al valor agregado) según el área geográfica. 11 / 19
El nombre compatible (CompatibilityName) se usa cuando la función esta en más de un idioma. También utilizamos IVA en este campo. Es momento de indicar los parámetros que tendrá nuestra función. Para ello ampliamos el árbol de la función y vemos que aparece el primer parámetro (parameter0) Name: Nombre con el que se identificará el parámetro. Type: Tipo de dato que aceptará el parámetro. DisplayName: Nombre con el que se conocerá el parámetro. Description: Descripción del tipo de información que se espera recibir como parámetro en la función. El nombre de nuestro parámetro es Cantidad, el tipo es double, el nombre a desplegar es Cantidad y la descripción es Cantidad a la que se quiere calcular el impuesto. 12 / 19
Como se comento, nuestra función requiere de dos parámetros. La cantidad y la zona donde se aplicará el impuesto. Para agregar otro parámetro usamos el botón Add Parameter. Este parámetro se llamará Zona, será del tipo entero y desplegara: Zona donde se aplicará el impuesto. 0 zona general. 1 zona fronteriza. 13 / 19
Al dar clic en el botón Terminar, tendremos nuestro proyecto listo para empezar a trabajar. Para capturar el código abrimos en el árbol la rama Paquetes de origen - org.openoffice y damos doble clic sobre la clase ivaimpl.java. Por supuesto, con otras funciones veremos que cambia el nombre de la clase. Al dar doble clic sobre la clase veremos del lado izquierdo el código. Buscamos al final del código un 14 / 19
método con el nombre de nuestra función. Como lenguaje Java que es, podemos usar superposición, de tal forma que el parámetro Zona sea opcional. El código utilizado se encuentra a continuación: public double iva(double Cantidad, int Zona) { double impuesto; if (Zona == 0) { impuesto = Cantidad * 0.15;} else { impuesto = Cantidad * 0.10;} return impuesto; } Para generar la extensión como archivo oxt damos un clic con el botón derecho del ratón sobre el paquete y del menú contextual elegimos Create OXT. 15 / 19
Cuando termina la compilación encontraremos dentro del directorio que definimos de trabajo, el directorio dist y dentro de él, el archivo iva.oxt. 16 / 19
Bastará con dar doble clic para activar la extensión y poder utilizarla. 17 / 19