DEV AUXILIARES/ORIGEN - Historial de revisiones

Luciano Carou en 15:51 1 abr 2025

2025-04-01T15:51:08Z

Luciano Carou: /* */

2025-04-01T15:41:57Z

← Revisión anterior		Revisión del 17:41 1 abr 2025
Línea 62:		Línea 62:

	===<CAMPOS>===		===<CAMPOS>===
	~~Esta etiqueta~~		Los orígenes de datos permiten incorporar registros a cualquier tabla. En ocasiones tenemos que validar que no se inserten registros con claves duplicadas que fallarán al aplicarlos a la base de datos.









			Podemos lograr esto usando esta etiqueta que nos permite definir una lista de campos a validar, ejemplo:

			<pre>
			<CAMPOS>
			Campo1
			Campo2
			</CAMPOS>
			</pre>

			Definiendo una lista así el sistema va a verificar cada vez que vaya a ingresar un registro que no exista ninguno con los mismos valores en esos campos.

			Normalmente los campos definidos en esta lista pertenecen a la clave primaria de la tabla.

			===<TAG EMITE_AVISO>===
			Esta etiqueta se usa en conjunto con la etiqueta '''<CAMPOS>''' e indica al sistema que debe dar un mensaje de advertencia cada vez que se quiera insertar un registro cuyos campos se duplicarían.

			Si no usamos esta etiqueta el sistema no dará ningún mensaje y simplemente ignorará el registro duplicado.

			===<TAG IMPORTAR_PLANILLA>===
			Indica al sistema que la opción permite importar una planilla y activará esa funcionalidad.

	===<TAG TIPO>===		===<TAG TIPO>===

Luciano Carou en 15:34 1 abr 2025

2025-04-01T15:34:23Z

@@ Línea 18: / Línea 18: @@
 =Modo de operación=
-Cuando estamos en una pantalla y picamos sobre el botón de opciones la opción '''Opciones de la clase''' verificará si existen auxiliares de tipo '''OPCIONES''', si los hay los agregará al menú.
+Cuando estamos en una pantalla (normalmente un detalle) picamos sobre el botón de opciones, la opción '''Orígenes''' verificará la existencia de auxiliares de tipo '''ORIGEN''', si los hay los agregará al menú.
 Cada opción puede tener condiciones según las cuales se encuentre habilitada o deshabilitada.
-Picar sobre alguna de las opciones la ejecutará directamente.
+Picar sobre alguna de las opciones sugerirá los registros a importar, debemos elegir cuáles queremos antes de que sean insertados en la pantalla.
 =Etiquetas=
 Las etiquetas en uso son:
 ===<COMANDO>===
-Permite definir el comando a aplicar, el comando depende principalmente del tipo (descripto en la etiqueta anterior).
+Permite definir el comando que selecciona los registros que necesitamos.
 El comando puede ser cualquier SQL válido, sin limitaciones en su complejidad o tamaño.
 Cierra con </COMANDO>.
 ===<SELECT>===
 Si el comando necesita operar sobre un valor en particular, por ejemplo:
-*En una hipotética opción '''Asignar a usuario''' necesitamos asignar a un usuario en particular.
+*En una hipotética opción '''Copiar comprobante''' necesitamos seleccionar ese comprobante antes de elegir los registros a copiar.
 *Dentro de la etiqueta <SELECT> '''pondríamos los comandos SQL necesarios''' para seleccionar ese usuario.
@@ Línea 70: / Línea 53: @@
 </SELECT>
 </pre>
 ===<TAG CONREGISTROS>===

Luciano Carou: /* Descripción */

2025-04-01T15:14:52Z

Descripción

← Revisión anterior		Revisión del 17:14 1 abr 2025
Línea 2:		Línea 2:
	[[Category:MANUAL/DESARROLLADOR]]		[[Category:MANUAL/DESARROLLADOR]]
	[[Category:DEV AUXILIARES]]		[[Category:DEV AUXILIARES]]
	Los auxiliares de tipo '''ORIGEN''' permiten agregar orígenes de datos a las pantallas de edición~~. Estos~~ orígenes permiten importar datos de otras tablas del sistema a cualquier pantalla.		Los auxiliares de tipo '''ORIGEN''' permiten agregar orígenes de datos a las pantallas de edición, estos orígenes permiten importar datos de otras tablas del sistema a cualquier pantalla simplificando la carga y minimizando el error.

	Por ejemplo, en la pantalla de asientos contables podemos:		Por ejemplo, en la pantalla de asientos contables podemos:

Luciano Carou: /* Descripción */

2025-04-01T15:14:08Z

Descripción

@@ Línea 5: / Línea 5: @@
 Por ejemplo, en la pantalla de asientos contables podemos:
-opciones al menú local de cada pantalla. Estas opciones permiten aplicar cambios en la base de datos usando SQL, o simplemente seleccionar datos de una forma muy sencilla y normalmente operan sobre los datos presentes en la pantalla.
+Todas estas opciones se definieron en el sistema como auxiliares de tipo '''origen'''.
 Este tipo de auxiliar aplica a:
 *[[DEV CLASES|Clases (prxclases)]].
 =Modo de operación=

Luciano Carou: Página creada con «=Descripción= Category:MANUAL/DESARROLLADOR Category:DEV AUXILIARES Los auxiliares de tipo '''ORIGEN''' permiten agregar orígenes de datos a las pantallas de edición. Estos orígenes permiten importar datos de otras tablas del sistema a cualquier pantalla. Por ejemplo, en la pantalla de asientos contables podemos: opciones al menú local de cada pantalla. Estas opciones permiten aplicar cambios en la base de datos usando SQL, o simplemente seleccionar d…»

2025-04-01T15:11:10Z

Página creada con «=Descripción= Category:MANUAL/DESARROLLADOR Category:DEV AUXILIARES Los auxiliares de tipo '''ORIGEN''' permiten agregar orígenes de datos a las pantallas de edición. Estos orígenes permiten importar datos de otras tablas del sistema a cualquier pantalla. Por ejemplo, en la pantalla de asientos contables podemos: opciones al menú local de cada pantalla. Estas opciones permiten aplicar cambios en la base de datos usando SQL, o simplemente seleccionar d…»

Página nueva

=Descripción=
[[Category:MANUAL/DESARROLLADOR]]
[[Category:DEV AUXILIARES]]
Los auxiliares de tipo '''ORIGEN''' permiten agregar orígenes de datos a las pantallas de edición. Estos orígenes permiten importar datos de otras tablas del sistema a cualquier pantalla.

Por ejemplo, en la pantalla de asientos contables podemos:

opciones al menú local de cada pantalla. Estas opciones permiten aplicar cambios en la base de datos usando SQL, o simplemente seleccionar datos de una forma muy sencilla y normalmente operan sobre los datos presentes en la pantalla.

Por ejemplo:

[[Archivo:20250331 1637 OPCIONES DE UNA PANTALLA.png|miniaturadeimagen|no|Opciones de una pantalla.]]

Las opciones:
*Aprobar.
*Cambiar fecha de pago y aprobar.
*Cambiar fecha de pago sin aprobar.

Fueron agregadas con auxiliares de tipo '''OPCIONES'''.

Existen dos tipos de opciones:
*SQL_APLICAR: Aplica una sentencia SQL.
*SQL_SELECCIONAR: Sentencia SQL que muestra un resultado.

Las '''OPCIONES''' permiten agregar funcionalidad de una manera muy rápida.

Este tipo de auxiliar aplica a:
*[[DEV CLASES|Clases (prxclases)]].
*[[DEV CONSULTAS|Consultas (prxconsultas)]].

=Modo de operación=
Cuando estamos en una pantalla y picamos sobre el botón de opciones la opción '''Opciones de la clase''' verificará si existen auxiliares de tipo '''OPCIONES''', si los hay los agregará al menú.

Cada opción puede tener condiciones según las cuales se encuentre habilitada o deshabilitada.

Picar sobre alguna de las opciones la ejecutará directamente.

=Etiquetas=
Las etiquetas en uso son:

===<TAG TIPO>===
Indica de qué tipo es la opción:
*SQL_APLICAR: Aplica una sentencia SQL.
*SQL_SELECCIONAR: Ejecuta una sentencia SQL que muestra un resultado.

No tiene etiqueta de cierre.

===<COMANDO>===
Permite definir el comando a aplicar, el comando depende principalmente del tipo (descripto en la etiqueta anterior).

El comando puede ser cualquier SQL válido, sin limitaciones en su complejidad o tamaño.

Cierra con </COMANDO>.

===<CONDICION>===
Permite definir una condición para activar la opción. Si ésta retorna verdadero la opción está habilitada, si retorna falso la opción está deshabilitada.

Cierra con </CONDICION>

===<CONFIRMA>===
Permite indicar un mensaje de confirmación, solo si retornamos Ok se ejecutará la opción.

Cierra con </CONFIRMA>.

===<SELECT>===
Si el comando necesita operar sobre un valor en particular, por ejemplo:
*En una hipotética opción '''Asignar a usuario''' necesitamos asignar a un usuario en particular.
*Dentro de la etiqueta <SELECT> '''pondríamos los comandos SQL necesarios''' para seleccionar ese usuario.

Cierra con </SELECT>.

Existe un caso especial para cuando necesitamos seleccionar una fecha, simplemente debemos usar:

<pre>
<COMANDO>
DECLARE @FFECHAPAGO datetime

SET @FFECHAPAGO = <SELECTVALUE>

<SELECT>
DATE
</SELECT>
</pre>

===<TAG CONREGISTROS>===
Habilita la opción solo cuando hay registros.

===<TAG QUITARCOMILLAS>===
Quita las comillas al comando.

===<TAG REFRESCAR>===
Refresca la consulta al aplicar la opción. Esta opción es particularmente útil cuando estamos consultando datos que se modifican una vez que ejecutamos una opción, por ejemplo, aprobar un comprobante.

===<TAG SEPARADOR>===
Agrega un separador al menú antes de la opción.

===<TAG SERVICIOWEB>===
La opción llama a un servicio web. Cuando incluimos esta etiqueta debemos informar el sitio web dentro de las etiquetas <COMANDO> y </COMANDO>, por ejemplo:

<pre>
<COMANDO>
http://192.168.1.254/facturaelectronica/test.php
GO
</COMANDO>
</pre>

También podemos usar comandos FBN para tomar valores de la pantalla:

<pre>
<COMANDO>
http://192.168.1.254/facturaelectronica/retenciones.php?empresa=FBN(FDB)&clave=FBN(FCLAVE)
GO
</COMANDO>
</pre>

=Ejemplo=
Este auxiliar corresponde a la pantalla FCCAB_PENDIENTES_APROBACION_Consulta, opción 01-REASIGNAR USUARIO.

Esta consulta es usada por quienes tienen asignadas facturas de compra para su aprobación, a través de este auxiliar pueden resignar la factura a otro usuario con permisos equivalentes.

El comando completo del auxiliar es:

<pre>
<TAG TIPO>SQL_APLICAR
<TAG CONREGISTROS>
<TAG REFRESCAR>
<COMANDO>
DECLARE @FUSUARIO VARCHAR(24)

SET @FUSUARIO = <SELECTVALUE>
<SELECT>
/* Usuarios que pueden aprobar... */

SELECT
Usuario = wflPASOS_FIRMAS.FUSUARIO
, Nombre = USUARIO.FNOMBRE
FROM wflPASOS, wflPASOS_FIRMAS, USUARIO WHERE
wflPASOS.FFAMILIA = 'FC'
AND wflPASOS.FCODIGO =
(
/* Paso mínimo con firmas... */

SELECT MIN(PASOMIN.FCODIGO) FROM wflPASOS PASOMIN WHERE
PASOMIN.FFAMILIA = wflPASOS.FFAMILIA
AND PASOMIN.FFIRMAS > 0
)
AND wflPASOS.FFIRMAS > 0
AND wflPASOS_FIRMAS.FFAMILIA = wflPASOS.FFAMILIA
AND wflPASOS_FIRMAS.FPASO = wflPASOS.FCODIGO
AND wflPASOS_FIRMAS.FACTIVO = 1
AND USUARIO.FCODIGO = wflPASOS_FIRMAS.FUSUARIO
AND
(
EXISTS (SELECT * FROM wflASIGNACION WHERE wflASIGNACION.FFAMILIA = wflPASOS.FFAMILIA AND wflASIGNACION.FUSUARIO = SYSTEM_USER AND wflASIGNACION.FACTIVO = 1)
OR EXISTS (SELECT * FROM wflPASOS_FIRMAS WHERE wflPASOS_FIRMAS.FFAMILIA = wflPASOS.FFAMILIA AND wflPASOS_FIRMAS.FPASO = wflPASOS.FCODIGO AND wflPASOS_FIRMAS.FUSUARIO = SYSTEM_USER AND wflPASOS_FIRMAS.FACTIVO = 1)
)
AND NOT EXISTS
(
SELECT X.* FROM wflFIRMASX X WHERE
X.FCOMPROBANTE = FBN(FCOMPROBANTE)
AND X.FUSUARIO = wflPASOS_FIRMAS.FUSUARIO
)
</SELECT>
UPDATE wflFIRMASX SET
FUSUARIO = @FUSUARIO
, FTS = getdate()
WHERE
FCOMPROBANTE = FBN(FCOMPROBANTE)
GO
</COMANDO>
</pre>

Las etiquetas incluidas son:

===<TAG TIPO>SQL_APLICAR===
Indica que el auxiliar contiene una sentencia SQL que se aplica en la base de datos.

===<TAG CONREGISTROS>===
Indica que el auxiliar solo se usa si existen registros en la consulta sobre el que aplica, es decir que no tendría ningún sentido aplicar el auxiliar si no hay registros sobre los que hacerlo.

===<TAG REFRESCAR>===
Indica que una vez que se ha ejecutado el auxiliar debe refrescarse la consulta sobre el que aplica, normalmente porque su resultado puede variar tras haber aplicado el auxiliar.

===<COMANDO>===
Dentro de esta etiqueta (y su cierre </COMANDO>) se incluye el comando a aplicar.

===<SELECT>===
Esta etiqueta, y su cierre </SELECT>, deben ubicarse dentro de <COMANDO> y </COMANDO> y se usa para definir un valor antes de aplicar el comando. En este caso tenemos que elegir el usuario al que reasignaremos la factura.

El <SELECT> es normalmente un comando SQL que elegirá un valor y lo asignará a la variable que contenga el texto '''<SELECTVALUE>''', por ejemplo al inicio de <COMANDO> encontraremos:

<pre>
DECLARE @FUSUARIO VARCHAR(24)

SET @FUSUARIO = <SELECTVALUE>
</pre>

Cuando seleccionemos un valor usando el <SELECT> ese valor se asignará a la variable @FUSUARIO y la variable podrá usarse dentro del <COMANDO>.