Download Manual de generación de funciones con NetBeans para OpenOffice

Integración de
NetBeans con
OpenOffice.org
Netbeans y OpenOffice.org
TOKONHU de México
Í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
Netbeans y OpenOffice.org
TOKONHU de México
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
Netbeans y OpenOffice.org
INSTALACIÓN
DEL MÓDULO DE DESARROLLO EN
TOKONHU de México
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
Netbeans y OpenOffice.org
En la sección Actualizaciones
OpenOffice.org API Plugin
TOKONHU de México
y
nuevos
Damos clic al botón Agregar>
4 / 19
Módulos
disponibles:
buscar
y
seleccionar
Netbeans y OpenOffice.org
TOKONHU de México
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
Netbeans y OpenOffice.org
TOKONHU de México
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
Netbeans y OpenOffice.org
TOKONHU de México
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
Netbeans y OpenOffice.org
TOKONHU de México
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
Netbeans y OpenOffice.org
CREANDO
UNA FUNCIÓN PARA
TOKONHU de México
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
Netbeans y OpenOffice.org
TOKONHU de México
Damos clic al botón Siguiente> y nos pide que capturemos los datos de la función
10 / 19
Netbeans y OpenOffice.org
TOKONHU de México
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
Netbeans y OpenOffice.org
TOKONHU de México
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
Netbeans y OpenOffice.org
TOKONHU de México
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
Netbeans y OpenOffice.org
TOKONHU de México
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
Netbeans y OpenOffice.org
TOKONHU de México
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
Netbeans y OpenOffice.org
TOKONHU de México
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
Netbeans y OpenOffice.org
TOKONHU de México
Bastará con dar doble clic para activar la extensión y poder utilizarla.
17 / 19