Nodo ACTION


Nodo donde se expondrán las acciones a realizar en los eventos definidos en nuestra aplicación.
El nombre de la acción define lo que va a realizar.


Consiste en asignarle un valor a una propiedad del objeto. Se pueden utilizar macros en el atributo value.

	<!-- Ponemos la ID de la empresa del usuario que se ha logueado en IDEMPRESA -->
	<action name="setval" field="IDEMPRESA" value="##ENTID##" />
 
	<!-- Se pueden utilizar MACROS, en este caso ##FLD_NOMBRE## que tendría el valor del campo NOMBRE del objeto actual 
	     OJO porque por ejemplo en un create esta macro NO TENDRIA VALOR -->
	<action name="setval" field="MAP_CUENTA" value="##FLD_NOMBRE##" />
 
	<!-- Ponemos la fecha actual del sistema y la ponemos en el campo FECHA -->
	<action name="setval" field="FECHA" value="##NOW##" />
 
	<!-- Cogemos el ID del usuario del sistema y lo ponemos en IDUSUARIO-->
	<action name="setval" field="IDUSUARIO" value="##USERID##" />
 
        <!-- Ponemos a 0 el campo EXECUTED y a 1 el campo IDCARGO -->
	<action name="setval" field="EXECUTED" value="0" />
	<action name="setval" field="IDCARGO" value="1" />


Atributo Descripción
name Nombre de la acción a ejecutar
field Campo que se va a actualizar
value Valor que se le va a asignar al campo

Ejecución de código XOneScript dentro de nuestra aplicación. En este caso, no tiene ningún atributo, pero sí un nodo donde se pondrá el script a ejecutar, como se muestra el ejemplo de más abajo.

	<!-- Cogemos el valor del campo MAP_SERIE y concatenamos con "/" y el campo NUMERO y lo ponemos en NUMCOMPLETO -->
	<action name="runscript">
 
	<!-- Si se desea pasar un parámetro en la llamada al nodo que ejecuta el script, se coloca antes de la etiqueta script -->
	<param name="opcion" /> 
 
		<script language="VBScript">
			This("NUMCOMPLETO")=This("MAP_SERIE") + "/" + CStr(This("NUMERO"))
		</script>
	</action>
 
	<!-- Podemos llamar a un fichero de scripts cuando lo necesitemos, la funcion EntrarN estara definida en funciones.vbs -->
	<action name="runscript">
		<include file="funciones.vbs" />
		<script language="VBScript">
			EntrarN
		</script>
	</action>
 
	<!-- Esto es en Javascript -->
	<action name="runscript">
		<script language="javascript">
			calculaTotal(self);
			ui.refresh("MAP_FTTIPOGASTO","@Gastos","MAP_TOTAL");
		</script>
	</action>	


Para coger un valor de un campo de la colección padre y ponerlo en un campo de la colección hija. Utilizado en los contents.

Aunque esta acción sigue funcionando, actualmente está en desuso puesto que prácticamente todo se hace por script. La instrucción para asignar/obtener un valor de tu colección “padre” es:

  1.- En vbscript:   this("NOMBRE")=this.OwnerCollection.ownerobject("MAP_DELPADRE") 
  2.- En javascript: self.NOMBRE=self.getOwnerCollection().getOwnerObject().MAP_DELPADRE;
	<!-- Cogemos el valor del ID de la colección padre y lo ponemos en el campo IDCLIENTE de la colección Contents -->
		<action name="setfldval" targetfld="IDCLIENTE" sourcefld="ID"/>


Atributo Descripción
name Nombre de la acción a ejecutar
targetfld Campo que se va a actualizar con el campo del padre
sourcefld Campo de la colección padre que va a dar valor al campo de esta colección

Buscamos un valor en otra colección y nos traemos el valor de algún campo.

	<!-- Buscamos en la colección Usuarios el registro cuyo ID sea el el usuario logueado actualmente 
	     y cogemos el valor del campo IDSERIE para ponerlo en el campo IDSERIE de la colección actual, es decir: 
	     IDSERIE = "SELECT IDSERIE FROM gen_usuarios WHERE ID=##USERID##". -->
	<action name="mapval" field="IDSERIE" targetfld="IDSERIE" coll="Usuarios" mapfld="ID" mapvalue="##USERID##" />
 
	<!-- Buscamos en la colección TiposUsuario el registro cuyo CODIGO = 4 
	     y cogemos el valor del campo ID para ponerlo en el campo IDTIPO de la colección actual, es decir: 
	     IDTIPO = "SELECT ID FROM gen_tiposusuario WHERE CODIGO=4"  -->
	<action name="mapval" field="IDTIPO" targetfld="ID" coll="TiposUsuario" mapfld="CODIGO" mapvalue="4" />
 
	<!-- Buscamos en la colección Usuarios el registro cuyo ID sea el el usuario logueado actualmente 
	     y cogemos el valor del campo LOGIN para ponerlo en el campo CODTECNICO de la colección actual, es decir: 
	     CODTECNICO = "SELECT LOGIN FROM gen_usuarios WHERE ID=##USERID##". -->
	     <action name="mapval" field="CODTECNICO" targetfld="LOGIN" coll="Usuarios" mapfld="ID" mapvalue="##USERID##" />


Atributo Descripción
name Nombre de la acción a ejecutar
field Campo que se va a actualizar
targetfld Nombre del campo que tiene el valor que va a ser asignado al campo field
coll Colección donde se va a realizar la busqueda del campo que tendrá el valor requerido
mapfld Campo de la colección que esta definida en el atributo coll, que es clave primera de la misma
mapvalue Valor del campo de la clave primera para rescatar el registro buscado

Para ejecutar una sentencia SQL, Insert, Update o Delete. No tiene sentido ejecutar un Select, porque la acción no devuelve ningún valor.

Muy utilizado en las colecciones de cabecera, cuando se está eliminando un registro, eliminar todas sus líneas asociadas.

	<!-- Se pueden utilizar MACROS -->
	<action name="executesql" sql="DELETE FROM ##PREF##DetParte WHERE IDPARTE=##ID##" />


Atributo Descripción
name Nombre de la acción a ejecutar.
sql Sentencia SQL que quiere ejecutar. Solo es válido la ejecución de Insert, Update o Delete.

Para actualizar el campo de enlace de una colección de detalles con la ID de la cabecera.

Utilizado EXCLUSIVAMENTE en el nodo INSERT de una colección de cabecera. Para enlazar las líneas de detalle de la colección CONTENTS cuando se está dando de alta al mismo tiempo la cabecera y los detalles, pues hasta que la cabecera no se graba, las líneas de detalle no saben cual es el ID de su padre.

Actualmente, aunque evidentemente sigue funcionando éste método para que automáticamente se actualice el IDENLACE con la cabecera en los detalles (contents, subgrid o como quiera llamarse…) una vez que se grabe la cabecera, este nodo está en desuso y prácticamente todo se controla por script y es el programador el que hace la asociación de datos, cabecera-detalles.

No obstante, el framework internamente sigue intentando buscar un campo de enlace entre los contents y la coleccion “cabecera” donde éstos estén incluidos. Para evitar este comportamiento, en la colección contents, a nivel de COLL, hay que especificar los atributos check-owner=“false” y dependent=“false”

<action name="link" coll="Detalles" field="IDDOCUMENTO" value="##ID##" />
 
<insert>
   <action name="link" coll="imagenes" field="IDINCIDENCIA" value="##ID##" />
</insert>


Atributo Descripción
name Nombre de la acción a ejecutar
coll Colección que se busca para actualizar el campo de enlace con esta colección Padre
field Nombre del campo de la colección con el nombre que está definido en el atributo coll y que es el enlace con esta colección Padre
value Valor que se le asigna al campo enlace entre la colección Padre y la colección hija

NODO BEFOREACTION

Nodo donde se expondrán las acciones a realizar en los eventos definidos en nuestra aplicación, pudiéndose ejecutar todos y cada uno de los tipos de acciones que dispone el nodo action.
Sin embargo, como punto importante a tener en cuenta, es que esta acción solo es válida para el evento Insert , y es utilizada para la validación de campos, en caso de que dé error, no se guardará el objeto, y se obliga al usuario a insertar un valor para el campo validado.