Obtener datos para validaciones adicionales

¡Hola a todos los seguidores del blog! Vuelvo para contarles que, a fines de mayo pasado, estuvimos encontrándonos en CABA para repasar las novedades de este año. También descubrimos las nuevas posibilidades que brinda CAPATAZ BPM y aprovechamos para hacer un taller acerca de cómo añadir código para recibir algún dato por parte del usuario, cuando de manera estándar la interfaz de CAPATAZ no lo proporcione.

Para esto último, elegí enfocarme en tres posibilidades:

Apertura de inicio de formularios

Todos los formularios de CAPATAZ cuentan con la posibilidad de añadir código VFP que se ejecute al inicio del mismo, entonces podremos pedirle al usuario que ingrese lo que buscamos ofreciéndole mediante una caja de ingreso de datos que lo haga, por ejemplo:

If LEFT(m.fo.caption,8) = “Modifica”
    m.ingreso=INPUTBOX("Habilita cambios en precios","Ingrese Si o No", "Si")
    informa(m.ingreso)
Endif

Para poder escribir código habremos dado previamente click con el botón derecho (rigt-click.

Apertura de botones

De igual manera, podemos añadir código en el botón Aceptar de los formularios de CAPATAZ, los cuales generalmente se usan para validaciones adicionales a algunos campos.
Para conocer los nombres de los campos de los formularios, podemos apoyarnos en la denominación asignada en la pantalla de Apertura de controles:

A la parte contenida dentro del cuadrante le antepondremos la referencia al Formulario al final la propiedad que necesitemos leer/escribir:

LPARAMETERS m.fo AS Form, m.cantidad as integer
LOCAL m.vf AS Boolean
m.cantidad = m.fo.CZ_TXTM_CANT_MONE.value
if m.cantidad > 100 
* sigue el código …

Obtener valores en celdas de grillas

 LOCAL m.grilla AS DXDBGRIDLib.dxDBGrid, m.rs_grilla AS ADODB.Recordset
    m.grilla = m.cb.grilla
    m.rs_grilla = m.grilla.DataSource
    m.rs_grilla.Filter = m.cb.filtra_x_entidad(m.id_ent)
ENDIF
m.valor = m.rs_grilla.fields("Cod_tarea").value
informa(m.valor)

Resaltamos esta parte del código porque el resto ya viene proporcionado por CAPATAZ, en forma de plantilla para ayudarle.
Para complementar, anteriormente ya fue publicada la nota «Personalizaciones: Botón Aceptar de Formularios«, escrita por Daniel Villarreal. Este escrito aporta otras maneras similares de apoyarse en estas herramientas.
¡Gracias por su tiempo de lectura y será hasta la próxima!