Customización en ADempiere OFB Consulting Ltda. Customización en ADempiere Dictado por: Fabian Aguilera Fuentes

Contenido Introducción Requisitos Conceptos Básicos Preparar Entorno Estructura de clase Métodos a Considerar Tipos de Clase

Introducción Este curso está orientado a preparar al alumno a una mayor comprensión del funcionamiento de Adempiere (ERP open Source), permitiéndole al final del curso estar capacitado a realizar pequeñas o medianas mejoras a dicho sistema, en base a los conocimientos de programación previos al curso y a los adquiridos durante el transcurso del mismo.

Requisitos Conocimientos Previos Instalación de Aplicaciones Fuentes Uso de Adempiere a nivel SuperUser Programación orientada a objeto (Java) Eclipse 4.x Java SDK 1.6 Postgres 9.x (tambien puede ser oracle) Adempiere 360 Base de Datos limpia

Conceptos básicos Tablas Objeto Posee atributos que pueden tomar un valor de un documento(Valor) Puede tener un comportamiento (Método) Tablas Todas tienen una estructura en Java Cada una tiene por lo menos 3 clases Java de las cuales depende su funcionamiento

Conceptos básicos Ejemplo de Tabla TABLA Clases Manager C_invoice I_C_Invoice M_Invoice   Estas son de tipo interface, define los métodos SET y GET Programación + comportamiento de la tabla, esto se puede comparar con un trigger. SET: Setea un valor de un campo GET: Obtiene el valor de un campo X_C_Invoice Aquí se realiza la programacion

Conceptos básicos CallOut Es una función en Java del sistema la cual trae información a un campo según ciertos parámetros. La información que trae puede ser un dato de cualquier tipo y formato. Es independiente de la base de dato. También tiene la capacidad de hacer cálculos para el campo requerido. El equivalente a un disparador (trigger) en base de datos, pero la diferencia de este es que trabaja con objetos y no solo con datos de 1 solo formato.

Preparar Entorno Primero e se debe instalar un IDE que soporte las fuentes de Adempiere, para nuestro ejemplo se usará Eclipse 4.1 Debemos reestructurar una base de datos limpia de adempiere 360 para que comencemos a trabajar en el, esto se hace entrando a la carpeta de las fuentes luego en utils_dev y dentro ejecutar el archivo run_build.dat (o .sh) el cual nos creará la base de datos solicitada. Luego ejecutar una línea de comando dentro de la carpeta C:\Program Files\PostgreSQL\9.2\bin esta lina es: psql –U Adempiere –d Limpia –F c:\adempiere\data\Adempiere_pg.dmp >> dump_errors.log.

Preparar Entorno Eclipse Realizar un nuevo proyecto en el IDE:

Preparar Entorno Eclipse Luego debemos indicar el directorio donde están las fuentes nativas de Adempiere y darle un nombre:

Preparar Entorno Eclipse Luego debemos indicar el directorio donde están las fuentes nativas de Adempiere y darle un nombre:

Preparar Entorno Eclipse Pinchamos en next, y cuando termine de configurar la aplicación presionamos Finish, a lo cual se no agregara el proyecto a eclipse:

Preparar Entorno Eclipse Ahora debemos crear un nuevo proyecto Java para trabajar en este y no en el proyecto fuente, esto para mantener la integridad del aplicativo

Preparar Entorno Eclipse Por ultimo para poder ejecutar el aplicativo se debe especificar la clase principal (Main) para que sea la que se ejecute.

Base Client Process Estructuras de Clases Source Folder que almacena todos los procesos y reglas de negocio. Su package principal es Model Base Source Folder que dibuja todas las ventanas de java (crear desde, asignación, etc.) Client Contiene los procesos de Adempiere llamados por un botón. ej: procesos de importación, crear combinaciones, etc Process

Métodos a considerar Métodos de documentos Nombre Descripción processIt Este método no debe ser modificado, ya que llama al workflow definido en adempiere. prepareIt Este método hace las validaciones respectivas cuando se procesa(completa) un documento. En este método van y se pueden agregar las validaciones respectivas. completeIt Este método generalmente llama al método prepareIt y realiza el proceso en el documento voidIt Este método es llamado cuando se anula un documento before Save Realiza acciones antes de guardar el registro. afterSave Realiza acciones después de guardar el registro beforeDelete Realiza acciones antes de borrar el registro. afterDelete Realiza acciones después de borrar el registro.

Métodos a considerar Métodos de procesos prepare doIt Este método es el encargado de leer los parámetros del proceso doIt Es el proceso que realiza las acciones

Tipos de Clase Package Model Clase tipo I Clase tipo X Clase tipo M Estas clases son clases de tipo interfaz, las cuales son definiciones de lo que se debe hacer. Todas las tablas de ADempiere, poseen una clase X, en las cuales se almacenan todos los métodos get y set de esta Toda tabla en ADempiere posee una tabla tipo M, las cuales son hijas de sus respectivas a las tipo X.

Gracias