Campos Funcionales con OpenERP

En OpenERP un campo funcional es un campo cuyo valor no sera definido por el usuario sino el resultado de una funcion (estos campos no se guardan en base de datos ). En ocasiones, para aumentar la velocidad de consulta de OpenERP y facilitar las búsquedas, los campos funcionales también pueden ser guardados en la base de datos aunque siempre son calculados/actualizados por una o varias funciones y no por el usuario

.

La estructura de un campo funcional es la Siguiente:

fields.function(fnct, arg=None, fnct_inv=None, fnct_inv_arg=None, type="float, fnct_search=None, obj=None, method=False, store=False, multi=False,...)

Donde:

    • type es el tipo de campo devuelto por la función. Puede ser cualquiera excepto function. 

    • method indica si el campo se calcula mediante un método (de un objeto) o una función global. 

    • store y multi son mecanismos de optimización, para guardar los valores de los campos funcionales en la base de datos (store=True) aunque se seguirán calculando mediante una función Python o para calcular varios campos funcionales a la vez con el atributo multi. 

   •fnct es la función o método que calculará el valor del campo. Es un parámetro obligatorio. Debe haberse declarado antes de declarar el campo funcional.

Si method es verdadero (True), la signatura del método debe ser:

def fnct(self, cr, uid, ids, nombre_campo, arg, context)

en otro caso (si se trata de una función global), su signatura debe ser:

def fnct(cr, tabla, ids, nombre_campo, arg, context)

De cualquier manera, debe devolver un diccionario de valores de la forma {id'_1_': valor'_1_',id'_2_': valor'_2_',...}.

Los valores del diccionario devuelto deben ser del tipo indicado en el parámetro type de la declaración del campo. 

   •fnct_inv es la función o método que permitirá escribir valores en ese campo. Si method es verdadero (True), la signatura del método debe ser:

def fnct(self, cr, uid, ids, nombre_campo, valor_campo, arg, context)

en otro caso (si se trata de una función global), su signatura debe ser:

def fnct(cr, table, ids, nombre_campo, valor_campo, arg, context)

   •fnct_search permite definir el comportamiento de las búsquedas en ese campo. Si method es verdadero (True), la signatura del método debe ser:

def fnct(self, cr, uid, obj, name, args)

en otro caso (si se trata de una función global), su signatura debe ser:

def fnct(cr, uid, obj, name, args)

  Ejemplo de un campo funcional Supongamos que creamos un objeto contract (contrato) cuya definición es:

from osv import osv, fields

class almacen_almacen (osv.osv):   

   def calculate_price(self, cr, uid, ids, field_name, arg, context=None):
      records = self.browse(cr, uid, ids)
      res = {}
      for r in records:
         res[r.id] = r.cost * r.quantity
         print "RESULTADO", res
      return res

   _name = 'almacen.almacen'
   _columns = {
   'code' : fields.char     ('Codigo', 10, required = True),
   'name' : fields.integer  ('Nombre del Producto', required = True),
   'description' : fields.char     ('Descripción',60),
   'tipe_selection' : fields.selection([ ('1','Linea Blanca y Electronica'), ('2','Articulos Consumo Diario'), ('3','Otro'), ],'Tipo de artículo', required = True),
   'cost': fields.float('Costo', digits=(3,2)),
   'quantity': fields.integer('Cantidad'),
   'calculate_price' : fields.function (calculate_price, type = 'float', string = 'Total a Pagar'),
   }
almacen_almacen()

 En el ejemplo anterior obtendremos el total a pagar de un cliente en una compra simple de un almacen X, como podemos observar el campo calculado define como primer argumento el nombre de la función con la cual obtendremos el resultado, y en la misma función seria la formula con la cual obtendremos el resultado del campo.

Nota:

En la función mando un print que no se mostrara en OpenERP sino solamente en la terminal donde este ejecutándose nuestro servidor.

No se olviden Comentar....