XMind

Tutorial Compiere

1. Introducción

   1. Ventajas

      1. Open Source

      2. Multiplataforma

         1. Java

            1. Desktop

            2. Web

      3. Multi base de datos

         1. Oracle

         2. PostgreSQL

         3. Db2

         4. SqlServer

      4. Multi lenguaje

      5. Multi moneda

      6. Multi impuesto

   2. Recorrido Breve

      1. Logeo

         1. Servidores

            1. Servidor de Aplicación (JBoss)

            2. Servidor de Base de Datos

         2. Variables Globales de Contexto

      2. SuperUser

         1. Menú principal

            1. Búsqueda

            2. Accesos directos

            3. Significado de los iconos

         2. Barra de Herramientas

            1. Información

               1. Socio de Negocio

               2. Producto

               3. Facturas

            2. Preferencias

               1. Preferencias

                  1. Personalizar la Interfaz de Usuario

                  2. Logeo Automático

                  3. Ocultar Pestañas

               2. Variables de Contexto

         3. Ventanas

            1. Filtro

               1. Básico

                  1. Campos específicos

                  2. Rango de fecha específico

                     1. Día

                     2. Semaña

                     3. Mes

                     4. Año

               2. Avanzado

                  1. Construir filtro

                  2. Conjunto de condiciones

            2. Tipo de vista

               1. Formulario

               2. Grilla o tabla

            3. Distribución

               1. Barra de botones en la parte superior

               2. Pestañas en el sector izquierdo

               3. Información den dos columnas

            4. Pestañas

               1. Niveles

               2. Tipos

                  1. Estándar

                  2. Traducción

                  3. Contables

      3. System

         1. Reglas del Sistema

            1. Lenguaje (Language)

            2. País, Región y Ciudad (Country, Region & City)

            3. Menu

         2. Diccionario de Aplicación

            1. Referencia (Reference)

            2. Regla de Validación (Validation Rules)

            3. Tabla y Columna (Table and Column)

            4. Reporte y Proceso (Report & Process)

            5. Ventana, Pestaña y Campo (Window, Tab & Field)

            6. Mensajes (Message)

         3. Impresiones

            1. Letra (Print Font)

            2. Papel (Print Paper)

            3. Forma (Print Form)

            4. Formato (Print Format)

2. Operativo

   1. Seguridad

      1. Usuario

         1. Está asociado a un socio de negocio

      2. Rol o Perfil

         1. Agrupa una serie de privilegios

         2. Da acceso a las ventanas, procesos, formas, etc.

      3. Histórico de Cambios

         1. Permite auditar los cambios en los registros

         2. Muestra el valor antiguo y el nuevo valor

         3. Indica la sesión que originó el cambio

   2. Mantenimientos

      1. Socio de Negocio

         1. Puede ser

            1. Cliente

            2. Proveedor

            3. Empleado

         2. Se establecen los valores a cargar en los flujos de compra / venta

      2. Lista de Precio

      3. Almacén / Localizador

      4. Producto

         1. Precio

         2. Proveedor

         3. Almacén

      5. Tasa de Cambio

         1. Establece la relación entre dos monedas para un rango de fechas

         2. Se utiliza factores (Factor multiplicativo y factor divisor)

      6. Tipo de Documento

         1. Secuencia de Documento

            1. Prefijo

            2. Correlativo

            3. Sufijo

         2. Documento Base

   3. Procesos

      1. Flujo de Venta

         1. Orden de Venta

         2. Factura / Boleta

         3. Entrega de Producto (Guia de Remisión)

      2. Flujo de Compra

         1. Requisición

         2. Orden de Compra

         3. Factura

         4. Recibo de Materiales

3. Desarrollo

   1. Introducción

      1. Interfaz Gráfica

         1. Administradas mediante el Diccionario de Aplicación (DA)

            1. Autogenera la Ventana

            2. Autogenera sentencias SQL

               1. Insert

               2. Update

               3. Delete

         2. Codificadas por los desarrolladores

      2. Código Fuente

         1. ad

            1. Clases Swing personalizadas para el Compiere

            2. Modelo Autogenerado

               1. Estándar: X_ + Nombre de Tabla

               2. Métodos getters y setters

            3. Clases Importantes

               1. org.compiere.framework.PO

                  1. Persistencia de Objeto

                  2. Genera DMLs

                  3. Administra los "Trigger"

               2. org.compiere.tools.GenerateModel

                  1. Genera clases con los métodos getters y setters

               3. org.compiere.util.Env

                  1. Maneja las variables de contexto

         2. base

            1. Modelos

               1. Estándar: M + Nombre de Tabla eliminando los _

               2. Programa

                  1. Trigger?

                     1. beforeSave

                     2. afterSave

                     3. beforeDelete

                     4. afterDelete

                  2. Flujo de Trabajo (WorkFlow)

                     1. Completar

                     2. Anular

                     3. Cerrar

            2. Callouts

               1. Se ejecuta cuando se cambia el valor de algún dato

               2. Sirve para incorporar cierta lógica de negocio

            3. Procesos

               1. Extiende de SvrProcess

               2. Métodos

                  1. 1.- prepare()

                     1. Captura los parámetros ingresados

                  2. 2.- doIt()

                     1. Programación del proceso en si

         3. client

            1. Clases Importantes

               1. org.compiere.apps.AcctViewerData

                  1. Muetra los asientos contables

               2. org.compiere.apps.ADialog

                  1. Reemplaza al JOptionPane

               3. org.compiere.apps.AMenu

                  1. Clase con el método main que inicia al Compiere

               4. org.compiere.apps.APanel

                  1. Administra los paneles autogenerados

                  2. Genera los Menus

                  3. Lógica de columnas específicas

                     1. DocAction

                     2. PaymentRule

            2. Formas

               1. Ventanas codificadas por los programadores

               2. No utiliza el Diccionario de Aplicación (DA)

            3. Consultas (Search / Info)

               1. org.compiere.apps.search.InfoBPartner

               2. org.compiere.apps.search.InfoProduct

               3. org.compiere.apps.search.InfoInvoice

            4. Componentes

               1. org.compiere.grid.ed.VLocation

               2. org.compiere.grid.ed.VLookup

                  1. Genera componentes específicos

                     1. createBPartner()

                     2. createProduct()

                     3. createUser()

                  2. Genera componenetes basados en el DA

                     1. Se apoya de la clase MLookup

               3. org.compiere.grid.ed.VDate

         4. serverRoot

            1. Administra la generación de asientos contables

            2. Clases Importantes

               1. org.compiere.acct.Doc

                  1. Centraliza la captura de la cuenta contable

                  2. getValidCombination_ID()

               2. org.compiere.acct.Fac

                  1. Administra la generación del asiento contable

                  2. createLine(...)

               3. org.compiere.acct.FacLine

                  1. El el asiento contable en si

                  2. Convierte el asiento contable a la moneda base del esquema contable

                  3. convert()

   2. Diccionario de Aplicación

      1. Tabla y Columna

         1. Tabla o vista (Table)

            1. Cambios de Log

               1. Activa el proceso de auditoria a la tabla

               2. Permite realizar el seguimiento de los cambios realizados en la data

            2. Volumen alto

               1. Activa la pantalla de filtro antes de ingresar

               2. Permite filtrar la data ingresada

            3. Registros eliminables

               1. Puede bloquear la eliminación de registros

            4. Permite crear columnas desde la BD

         2. Columnas (Column)

            1. Elemento (System Element)

               1. Centraliza la data general del campo

                  1. Nombre en la BD

                  2. Descripción (Tooltip)

                  3. Comentario o Ayuda

            2. Longitud (Length)

               1. Cantidad de caracteres en la BD

               2. Es utilizado para campos de texto

            3. Referencia (Reference)

               1. Establece el componente a mostrar en la UI

               2. Tipos

                  1. Account

                     1. Genera un componente personalizado del Compiere que permite ingresar una combinación de cuenta (elemento contable).

                  2. Button

                     1. Genera un botón

                     2. Se le puede asociar un proceso

                     3. Se le puede asociar una referencia

                  3. Date

                     1. Genera un componente tipo calendario

                  4. FileName

                     1. Genera un buscador de archivos

                  5. FilePath

                     1. Genera un buscador de directorios

                  6. ID

                     1. Se utiliza para identificar el PrimaryKey de la tabla

                     2. Establece el columna con el tipo Number(10)

                  7. List

                     1. Genera un ComboBox

                     2. Se asocia una referencia para cargar el ComboBox

                  8. Location (Address)

                     1. Genera un componente personalizado del Compiere para ingresar direcciones

                  9. Locator (WH)

                     1. Genera un componente personalizado del Compiere para ingresar ubicaciones

                  10. Numeric

                      1. Genera un componente numérico, permite ingresar números reales

                  11. Printer Name

                      1. Genera un ComboBox con todas las impresoras instaladas en la PC

                  12. Quantity

                      1. Genera un componente numérico, solo se ingresa números enteros

                  13. Search

                      1. Genera un componente de búsqueda

                      2. Asume que existe una tabla en la BD, para esto se quita los tres últimos caracteres al nombre del campo (_ID)

                  14. String

                      1. Genera un TextField

                  15. Table

                      1. Genera un ComboBox

                      2. Necesita que se indique la tabla con la que se va a cargar el ComboBox

                  16. Table Direct

                      1. Genera un ComboBox

                      2. Carga el ComboBox automáticamente

                      3. Asume que existe una tabla en la BD, para esto se quita los tres últimos caracteres al nombre del campo (_ID)

                      4. La campos que muestra en el ComboBox corresponden a los campos que sean Identificadores en la tabla

                  17. Text / Text Long

                      1. Genera un TextArea

                  18. Time

                      1. Genera un componente personalizado para ingresar la hora y los minutos

                  19. URL

                      1. Genera un campo de texto con un botón para validar la URL ingresada

                  20. Yes-No

                      1. Genera un CheckBox

            4. Validación Dinámica (Dynamic Validation)

               1. Asocia un filtro en la carga de los ComboBox generados

               2. Puede ser la cláusula WHERE de un SQL

            5. Valor de referencia (Reference Key)

               1. Permite la carga de los ComboBox generados

               2. Se puede asociar a la referencia del tipo Table o List

               3. Puede contener una lista "Hard-Code" (Código - Valor)

            6. Valor por defecto (Default Logic)

               1. Establece el valor por defecto del campo

               2. Variables de Contexto

                  1. Globales (@#...@)

                  2. Locales (@...@)

               3. Dato específico

            7. Obligatorio (Mandatory)

               1. Establece el campo como no nulo en la BD

            8. Obligatorio UI (Mandatory (UI)

               1. Pinta de otro color el campo, indicando su obligatoriedad

               2. NO implica un campo no nulo en la BD

            9. Lógica Obligatoria (Mandatory Logic)

               1. Establece las condiciones que se deben cumplir para que el campo sea obligatorio

               2. Se utiliza las variables de Contexto

               3. Se compara data utilizando el "leguaje Compiere" (&, |, !=, >, <, etc.)

            10. Actualizable

                1. Permite cambios bajo condiciones normales

            11. Siempre actualizable

                1. Siempre se puede modificar, aunque el registro esté inactivo, completado o bajo otra condición especial

            12. Lógica de solo lectura (Read Only Logic)

                1. Establece las condiciones que se deben cumplir para que el campo sea de solo lectura

                2. Se puede utilizar las variables de Contexto

                3. Se compara data utilizando el "leguaje Compiere" (&, |, !=, >, <, etc.)

            13. Callout

                1. Establece si el campo va a ejecutar algún código Java

                2. Se debe establecer la clase a invocar (paquete.clase.metodo)

                3. Se ejecuta cuando existe un cambio en la data

            14. Identificador (Identifier)

                1. Identifica a los campos que se van a mostrar cuando otra columna referencia a la tabla

                2. Se le debe de establecer la secuencia en la que se desea que aparezca los campos (Sequence)

      2. Ventana, Pestaña y Campo

         1. Ventana (Window)

            1. Tipo (WindowType)

               1. Consulta

               2. Mantenimiento

               3. Transaccional

            2. Imagen (Image)

               1. Icono representativo de la ventana

            3. Ancho (Window Weight)

            4. Alto (Window Height)

            5. Copiar Pestañas (Copy Window Tabs)

               1. Solicita la ventana que se desea duplicar

               2. Hace una replica de las pestañas de la ventana seleccionada

         2. Pestaña (Tab)

            1. Tabla (Table)

               1. Asocia una tabla a la pestaña

               2. Los campos a mostrar se van a basar en dicha tabla

            2. Secuencia (Sequence)

               1. Indica el orden o posición de la pestaña

               2. Número múlplite de 10 (10 = 1, 20 = 2, etc.)

            3. Nivel (Tab Level)

               1. Indica el indentado de la ventana

               2. Sirve para indicar pertenencia

               3. Relación: Pestaña padre (0) - Pestaña hija (1)

            4. Diseño de Hilera (Single Row Layout)

            5. Pestaña de Contabilidad (Accounting Tab)

            6. Pestaña de Traducción (Translation Tab)

            7. Proceso (Process)

            8. Lógica de Despliegue (Display Logic)

               1. Establece las condiciones que se deben cumplir para que el campo se muestre en la ventana

               2. Se utiliza las variables de Contexto

               3. Se compara data utilizando el "leguaje Compiere" (&, |, !=, >, <, etc.)

            9. Solo Lectura (Read Only)

               1. Establece las condiciones que se deben cumplir para que el campo sea de solo lectura

               2. Se utiliza las variables de Contexto

               3. Se compara data utilizando el "leguaje Compiere" (&, |, !=, >, <, etc.)

            10. Filtro (SQL Where)

            11. Ordenamiento (SQL Order By)

            12. Imagen (Image)

            13. Crear Campos (Crate Fields)

                1. Proceso que copia las columnas faltantes de la tabla

                2. Ubica los nuevos campos al final

            14. Copiar Pestaña (Copy Tab Fields)

         3. Campo (Field)

            1. Columna (Column)

               1. Asocia el campo a una columna de la tabla

            2. Grupo (Field Group)

            3. Solo Lectura (Read Only)

               1. Establece las condiciones que se deben cumplir para que el campo sea de solo lectura

               2. Se utiliza las variables de Contexto

               3. Se compara data utilizando el "leguaje Compiere" (&, |, !=, >, <, etc.)

            4. Longitud de Despliegue (Display Length)

               1. Según el valor, el componente puede utilizar la primera columna o ambas

            5. Secuencia (Sequence)

               1. Indica el orden o posición de la pestaña

               2. Número múlplite de 10 (10 = 1, 20 = 2, etc.)

            6. Misma Línea (Same Line)

               1. Ubica el componente al lado derecho

            7. Lógica de Despliegue (Display Logic)

               1. Establece las condiciones que se deben cumplir para que el campo se muestre en la ventana

               2. Se Utiliza las variables de Contexto

               3. Se compara data utilizando el "leguaje Compiere" (&, |, !=, >, <, etc.)

      3. Informe y Proceso (Report & Process)

         1. Informe y Proceso (Report & Process)

            1. Informe (Report)

               1. Indica si es un informe

               2. Habilita los campos para establecer el informe

            2. Nombre de Clase (Classname)

               1. Clase Java a ejecutar

               2. Se indica el paquete + la clase

            3. Procedimiento Almacenado (Procedure)

               1. Indica el procedimiento almacenado de la base de datos a ejecutar

            4. Flujo de Trabajo (Workflow)

            5. Vista del Informe (Report View)

            6. Impresión Directa (Direct Print)

               1. Indica si se pre visualiza el reporte

            7. Formato de Impresión (Print Format)

            8. Segundos Estadísticos (Statistic Second)

               1. Campo de lectura

               2. Sirve para hacer seguimiento del tiempo de demora

               3. Indica los segundos que se demoró en ejecutarse la última vez

         2. Parámetro (Parameter)

            1. Nombre en BD (DB Column Name)

            2. Elemento (System Element)

            3. Referencia (Reference)

               1. Establece el componente a mostrar en la UI

               2. Los tipos son iguales a los de la opción Tabla y Columna

            4. Valor de referencia (Reference Key)

               1. Permite la carga de los ComboBox generados

               2. Se puede asociar a la referencia del tipo Table o List

               3. Puede contener una lista "Hard-Code" (Código - Valor)

            5. Validación Dinámica (Dynamic Validation)

               1. Asocia un filtro en la carga de los ComboBox generados

               2. Puede ser la cláusula WHERE de un SQL

            6. Rango (Range)

               1. Crea dos componentes iguales

               2. Se utiliza para rangos de fecha

            7. Valores por defecto (Default Logic)

               1. Establece el valor por defecto del campo

               2. Se puede utilizar las variables de Contexto

      4. Forma

         1. UI personalizada, no autogenerada por el Diccionario de Aplicación

         2. Establece

            1. Nombre de Clase (Classname)

            2. URL del JSP (jsp URL)

      5. Menu

         1. Entidades acumuladas

         2. Tipo

            1. Ventana

            2. Proceso

            3. Reporte

            4. Forma