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.
SETVAL
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 |
RUNSCRIPT
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>
SETFLDVAL
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 |
MAPVAL
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 |
EXECUTESQL
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. |
LINK
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.