Diferencia entre revisiones de «DEV AUXILIARES/ASIGNACION»

De Pragma Wiki
Ir a la navegación Ir a la búsqueda
VisualWikitexto
(Página creada con «=Descripción= Category:MANUAL/DESARROLLADOR Category:DEV AUXILIARES Los auxiliares de tipo '''ASIGNACION''' permiten asignar valores a campos de la pantalla que se está editando. Las evaluaciones se usan en las pantallas de edición de datos. Este tipo de auxiliar aplica a: *Campos de clases (prxcampos). *Argumentos de consultas (prxconsultasA). =Modo de operación= Cuando estamos en una pantalla de edici…»)
 
 
(No se muestran 2 ediciones intermedias del mismo usuario)
Línea 16: Línea 16:
Las etiquetas en uso son:
Las etiquetas en uso son:


===<COMANDO>===
Define el comando que asigna el valor, cierra con </COMANDO>.


===<TAG DETONADOR>===
Indica qué campo detona la asignación.


---------------------------------------------------------------------
===<TAG ESTADISTICA>===
---------------------------------------------------------------------
Indica si el campo se asigna según valores estadísticos, es decir, el valor más usado en ese campo.
---------------------------------------------------------------------
---------------------------------------------------------------------


===<MENSAJE>===
===<TAG EVENTO>===
Permite definir un mensaje para retornar al usuario.
Indica qué evento que gatilla la asignación, los valores posibles son:
*ONENTER: Ejecuta al ingresar al campo.
*ONEXIT: Ejecuta al salir del campo.


Cierra con </MENSAJE>.
===<TAG ONPOST>===
Indica que el valor del campo se debe refrescar al postear los cambios (cuando se presiona Aplicar en la pantalla).


===<SELECT>===
===<TAG PORCENTAJE100>===
Permite definir el SQL que hace la evaluación, este SQL pude ser tan complejo y extenso como se necesite y puede consultar cualquier objeto presente en el sistema.
Esta etiqueta indica al sistema que al asignar valores a un campo hay que adicionalmente verificar que no exceda un porcentaje de 100%, no está en uso.


El valor de retorno debe ser de tipo [[BIT|BIT]].
===<TAG VALORNULO>===
Esta etiqueta indica que solo debe asignarse valor al campo cuando su valor (previo a la asignación) es NULO.


Cierra con </SELECT>.
=Uso del auxiliar=
El auxiliar es ejecutado automáticamente desde dentro de la aplicación y solamente cuando la pantalla está en inserción o en edición.


===<TAG TIPO>===
=Ejemplos=
Permite dos valores:
*ADVERTENCIA: Retorna un mensaje de advertencia.
*ERROR: Retorna un mensaje de error.


En la operación del sistema:
===Ejemplo de una asignación estadística===
*Ambos tipos retornan una pantalla indicando el tipo de situación y la leyenda asociada.
La asignación estadística asigna a un campo el valor más usado (para ese campo) entre todos los registros de la tabla, el siguiente ejemplo asigna el campo FIMPUTATIPO de la tabla de [[ASIENTOS CONTALES/DETALLE]] con el valor estadístico:
*Los mensajes de advertencia permiten continuar con el ingreso de datos.
*Los mensajes de error no permiten seguir con el ingreso de datos hasta resolver la situación a la que refiere el mensaje.
 
No tiene etiqueta de cierre, la sintaxis es:
<pre>
<pre>
<TAG TIPO>ADVERTENCIA
<TAG EVENTO>ONENTER
<TAG DETONADOR>FIMPUTATIPO
<TAG VALORNULO>
<TAG ESTADISTICA>
</pre>
</pre>


O:
*La etiqueta <TAG EVENTO>ONENTER indica que el auxiliar se ejecuta al ingresar al campo.
*La etiqueta <TAG DETONADOR>FIMPUTATIPO indica que el campo es FIMPUTATIPO, por lo tanto, el auxiliar se ejecutará al ingresar al campo FIMPUTATIPO.
*La etiqueta <TAG VALORNULO> indica que la asignación se hará exclusivamente si el valor del campo, previo a la asignación, es NULO.
*La etiqueta <TAG ESTADISTICA> indica que el tipo de asignación es estadística, por lo que el sistema le asignará el valor más usado en ese mismo campo, pero en todos los registros de la tabla.


<pre>
===Ejemplo de una asignación con SQL===
<TAG TIPO>ERROR
La siguiente asignación usa un comando SQL que si bien opera sobre valores internos usando FBN, puede reemplazarse por cualquier SQL válido. El auxiliar opera en el detalle de [[ASIENTOS CONTABLES/DETALLE]] asignando el valor al campo FCANTIDAD como la diferencia entre débitos y créditos.
</pre>
 
=Ejemplo=
Existe una evaluación sobre la tabla de artículos (ART) que verifica que el artículo esté activo, en pantalla se ve de la siguiente manera:
 
[[Archivo:20250331 1600 DEFINIR UNA EVALUACION.png|miniaturadeimagen|no|Definición de una evaluación:]]
 
Internamente (en [[DEV AUXILIARES/DETALLE]]) se guarda de la siguiente manera:


Los comandos son:
<pre>
<pre>
<TAG TIPO>ERROR
<TAG EVENTO>ONENTER
<SELECT>
<TAG DETONADOR>FCANTIDAD
SELECT FBN(FACTIVO)
<TAG VALORNULO>
</SELECT>
<COMANDO>
<MENSAJE>
SELECT CASE
El artículo ha sido marcado como no activo y no debería usarse, consulte con quienes administran los artículos para mayor información.
WHEN
</MENSAJE>
ISNULL(FBN(master.FDEBITOS),0) > ISNULL(FBN(master.FCREDITOS),0)
</pre>
AND FBN(FTIPOIMPORTE) = 'Crédito'
THEN ISNULL(FBN(master.FDEBITOS),0) - ISNULL(FBN(master.FCREDITOS),0)


La etiqueta '''<TAG TIPO>''' indica que es un mensaje de error.
WHEN
ISNULL(FBN(master.FDEBITOS),0) < ISNULL(FBN(master.FCREDITOS),0)
AND FBN(FTIPOIMPORTE) = 'Débito'
THEN ISNULL(FBN(master.FCREDITOS),0) - ISNULL(FBN(master.FDEBITOS),0)


Los comandos dentro del '''<SELECT>''' y '''</SELECT>''' operan en este caso directamente sobre la tabla ART retornando el valor del campo FACTIVO (El comando FBN, FieldByName retorna el valor del campo cuyo nombre se indica dentro de los paréntesis). El comando podría ser cualquier otra cosa, por ejemplo:
ELSE NULL
 
END
<pre>
</COMANDO>
SELECT RESULTADO = CASE WHEN EXISTS (SELECT * FROM ART WHERE FCODIGO = 'LBEN' AND FACTIVO = 1) THEN 1 ELSE 0 END
</pre>
</pre>


=Uso del auxiliar=
*La etiqueta <TAG EVENTO>ONENTER indica que el auxiliar se ejecuta al ingresar al campo.
Este auxiliar define las evaluaciones, éstas deben ser posteriormente suscriptas por campos definidos en el sistema.
*La etiqueta <TAG DETONADOR>FCANTIDAD indica que el campo es FCANTIDAD, por lo tanto, el auxiliar se ejecutará al ingresar al campo FCANTIDAD.
 
*La etiqueta <TAG VALORNULO> indica que la asignación se hará exclusivamente si el valor del campo, previo a la asignación, es NULO.
Por ejemplo, si definimos un auxiliar que evalúa si un artículo está activo podemos usarlo desde cualquier clase (tabla) que define un campo de tipo artículo.
*Los comandos entre las etiquetas <COMANDO> y </COMANDO> se ejecutan para asignar el valor. El SQL puede tener la complejidad y longitud que sea necesaria sin limitaciones. No es necesario que el resultado tenga un nombre de campo (este caso no lo tiene) ya que la aplicación asigna el valor del primer campo del resultado.
 
Para suscribir la evaluación tenemos que ir a la definición del campo y seleccionar las opciones picando en el botón cuyo texto es "AtributoUDT"::
 
[[Archivo:20250331 1607 SUSCRIBIR UNA EVALUACION.png|miniaturadeimagen|no|Seleccionar la opción de suscribir evaluación.]]
 
Una vez seleccionada la opción de suscribir evaluaciones veremos la lista de evaluaciones asociadas a ese atributo donde podremos seleccionar las que necesitemos.
 
[[Archivo:20250331 1609 SUSCRIBIR UNA EVALUACION II.png|miniaturadeimagen|no|Suscripción de evaluaciones.]]
 
Cada vez que ingresemos un código de artículo en la tabla que suscribe, al salir del campo el sistema va a cargar el registro correspondiente al valor ingresado y aplicará las evaluaciones suscriptas. La operación del sistema seguirá según el resultado de esa evaluación.

Revisión actual - 17:54 3 abr 2025

Descripción

Los auxiliares de tipo ASIGNACION permiten asignar valores a campos de la pantalla que se está editando.

Las evaluaciones se usan en las pantallas de edición de datos.

Este tipo de auxiliar aplica a:

Modo de operación

Cuando estamos en una pantalla de edición, y ante un evento definido en cada auxiliar, éste asignará un valor al campo al que está asociado. La pantalla debe estar en inserción o en edición.

Etiquetas

Las etiquetas en uso son:

<COMANDO>

Define el comando que asigna el valor, cierra con </COMANDO>.

<TAG DETONADOR>

Indica qué campo detona la asignación.

<TAG ESTADISTICA>

Indica si el campo se asigna según valores estadísticos, es decir, el valor más usado en ese campo.

<TAG EVENTO>

Indica qué evento que gatilla la asignación, los valores posibles son:

  • ONENTER: Ejecuta al ingresar al campo.
  • ONEXIT: Ejecuta al salir del campo.

<TAG ONPOST>

Indica que el valor del campo se debe refrescar al postear los cambios (cuando se presiona Aplicar en la pantalla).

<TAG PORCENTAJE100>

Esta etiqueta indica al sistema que al asignar valores a un campo hay que adicionalmente verificar que no exceda un porcentaje de 100%, no está en uso.

<TAG VALORNULO>

Esta etiqueta indica que solo debe asignarse valor al campo cuando su valor (previo a la asignación) es NULO.

Uso del auxiliar

El auxiliar es ejecutado automáticamente desde dentro de la aplicación y solamente cuando la pantalla está en inserción o en edición.

Ejemplos

Ejemplo de una asignación estadística

La asignación estadística asigna a un campo el valor más usado (para ese campo) entre todos los registros de la tabla, el siguiente ejemplo asigna el campo FIMPUTATIPO de la tabla de ASIENTOS CONTALES/DETALLE con el valor estadístico: 

<TAG EVENTO>ONENTER
<TAG DETONADOR>FIMPUTATIPO
<TAG VALORNULO>
<TAG ESTADISTICA>
  • La etiqueta <TAG EVENTO>ONENTER indica que el auxiliar se ejecuta al ingresar al campo.
  • La etiqueta <TAG DETONADOR>FIMPUTATIPO indica que el campo es FIMPUTATIPO, por lo tanto, el auxiliar se ejecutará al ingresar al campo FIMPUTATIPO.
  • La etiqueta <TAG VALORNULO> indica que la asignación se hará exclusivamente si el valor del campo, previo a la asignación, es NULO.
  • La etiqueta <TAG ESTADISTICA> indica que el tipo de asignación es estadística, por lo que el sistema le asignará el valor más usado en ese mismo campo, pero en todos los registros de la tabla.

Ejemplo de una asignación con SQL

La siguiente asignación usa un comando SQL que si bien opera sobre valores internos usando FBN, puede reemplazarse por cualquier SQL válido. El auxiliar opera en el detalle de ASIENTOS CONTABLES/DETALLE asignando el valor al campo FCANTIDAD como la diferencia entre débitos y créditos.

Los comandos son: 

<TAG EVENTO>ONENTER
<TAG DETONADOR>FCANTIDAD
<TAG VALORNULO>
<COMANDO>
SELECT CASE
WHEN
ISNULL(FBN(master.FDEBITOS),0) > ISNULL(FBN(master.FCREDITOS),0)
AND FBN(FTIPOIMPORTE) = 'Crédito'
THEN ISNULL(FBN(master.FDEBITOS),0) - ISNULL(FBN(master.FCREDITOS),0)

WHEN
ISNULL(FBN(master.FDEBITOS),0) < ISNULL(FBN(master.FCREDITOS),0)
AND FBN(FTIPOIMPORTE) = 'Débito'
THEN ISNULL(FBN(master.FCREDITOS),0) - ISNULL(FBN(master.FDEBITOS),0)

ELSE NULL
END
</COMANDO>
  • La etiqueta <TAG EVENTO>ONENTER indica que el auxiliar se ejecuta al ingresar al campo.
  • La etiqueta <TAG DETONADOR>FCANTIDAD indica que el campo es FCANTIDAD, por lo tanto, el auxiliar se ejecutará al ingresar al campo FCANTIDAD.
  • La etiqueta <TAG VALORNULO> indica que la asignación se hará exclusivamente si el valor del campo, previo a la asignación, es NULO.
  • Los comandos entre las etiquetas <COMANDO> y </COMANDO> se ejecutan para asignar el valor. El SQL puede tener la complejidad y longitud que sea necesaria sin limitaciones. No es necesario que el resultado tenga un nombre de campo (este caso no lo tiene) ya que la aplicación asigna el valor del primer campo del resultado.
Obtenido de «https://documentacion.conarpesa.com.ar/index.php?title=DEV_AUXILIARES/ASIGNACION&oldid=3923»