DEV AUXILIARES/ASIGNACION - Historial de revisiones

Luciano Carou: /* Descripción */

2025-07-29T19:18:22Z

Descripción

← Revisión anterior		Revisión del 21:18 29 jul 2025
Línea 3:		Línea 3:
	[[Category:DEV AUXILIARES]]		[[Category:DEV AUXILIARES]]
	Los auxiliares de tipo '''ASIGNACION''' permiten asignar valores a campos de la pantalla que se está editando.		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:		Este tipo de auxiliar aplica a:

Luciano Carou: /* Ejemplo de una asignación con SQL */

2025-04-03T15:54:02Z

Ejemplo de una asignación con SQL

← Revisión anterior		Revisión del 17:54 3 abr 2025
Línea 86:		Línea 86:
	*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 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.		*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> ~~son lo que~~ se ~~ejecutará~~ para asignar el valor~~, el~~ SQL puede tener la complejidad y longitud que sea necesaria sin limitaciones~~, y tampoco~~ es necesario que el resultado tenga un ~~valor~~ de campo ya que la aplicación asigna el valor del primer campo del resultado.		*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.

Luciano Carou en 15:38 3 abr 2025

2025-04-03T15:38:40Z

← Revisión anterior		Revisión del 17:38 3 abr 2025
Línea 57:		Línea 57:
	*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 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.		*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:
			<pre>
			<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>
			</pre>

			*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> son lo que se ejecutará para asignar el valor, el SQL puede tener la complejidad y longitud que sea necesaria sin limitaciones, y tampoco es necesario que el resultado tenga un valor de campo ya que la aplicación asigna el valor del primer campo del resultado.

Luciano Carou en 15:29 3 abr 2025

2025-04-03T15:29:33Z

@@ Línea 16: / Línea 16: @@
 Las etiquetas en uso son:
----------------------------------------------------------------------
+===<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:
-Cierra con </MENSAJE>.
+===<TAG ONPOST>===
-===<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>===
-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.
-La etiqueta '''<TAG TIPO>''' indica que es un mensaje de error.
+=Ejemplos=
 <pre>
-SELECT RESULTADO = CASE WHEN EXISTS (SELECT * FROM ART WHERE FCODIGO = 'LBEN' AND FACTIVO = 1) THEN 1 ELSE 0 END
+<TAG EVENTO>ONENTER
 </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>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.
-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.
+*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.

Luciano Carou: 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…»

2025-04-03T15:17:21Z

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…»

Página nueva

=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:
*[[DEV CLASES/CAMPOS|Campos de clases (prxcampos)]].
*[[DEV CONSULTAS/ARGUMENTOS|Argumentos de consultas (prxconsultasA)]].

=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:

---------------------------------------------------------------------
---------------------------------------------------------------------
---------------------------------------------------------------------
---------------------------------------------------------------------

===<MENSAJE>===
Permite definir un mensaje para retornar al usuario.

Cierra con </MENSAJE>.

===<SELECT>===
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.

El valor de retorno debe ser de tipo [[BIT|BIT]].

Cierra con </SELECT>.

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

En la operación del sistema:
*Ambos tipos retornan una pantalla indicando el tipo de situación y la leyenda asociada.
*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>
<TAG TIPO>ADVERTENCIA
</pre>

O:

<pre>
<TAG TIPO>ERROR
</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:

<pre>
<TAG TIPO>ERROR
<SELECT>
SELECT FBN(FACTIVO)
</SELECT>
<MENSAJE>
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.
</MENSAJE>
</pre>

La etiqueta '''<TAG TIPO>''' indica que es un mensaje de error.

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:

<pre>
SELECT RESULTADO = CASE WHEN EXISTS (SELECT * FROM ART WHERE FCODIGO = 'LBEN' AND FACTIVO = 1) THEN 1 ELSE 0 END
</pre>

=Uso del auxiliar=
Este auxiliar define las evaluaciones, éstas deben ser posteriormente suscriptas por campos definidos en el sistema.

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.

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.