Realiza la llamada a un Objeto SQL, lo ejecuta y retorna el resultado en un fichero. El fichero es temporal si no se indica un nombre de fichero. Es obligatorio indicar una condición de selección y las variables si el Objeto SQL las tuviese.
El Objeto SQL se busca en las bases de datos de diccionarios (wic's) que tenga la base de datos de conexión. Por ejemplo si se indica la base de datos wic_icon, se busca en su diccionario wic; si se busca en una base de datos de empresa se busca en los diccionarios de su lista como wic_iges, wic_icon y los posibles diccionarios particulares.
El resultado varía en función del modo en que se desea la salida:
- ASC: formato estándar Ascii. Es el modo por defecto, ya que en la mayoría de los casos se ejecutará el Objeto SQL sin necesidad de obtener el resultado.
- HTML: formato HTML.
- PDF: formato en PDF.
- XLS: formato Microsoft Excel.
- CSV: formato CSV.
- DBF: formato Microsoft Access.
- XML: formato XML.
- RTF: formato Microsoft Word.
1 webapp.wic_jrep_object.call
<webapp.wic_jrep_object.call
code='code'
cond='cond'
file='file'
type='asc|htm|htm|pdf|xls|xlsx|csv|dbf|xml|rtf'
sep=',|;'
din='A3|A4|A5|B5'
ungroup='true|false'
background='true|false'
>
<vars> ?
<var name='name'> +
<value /> !
</var>
</vars>
</webapp.wic_jrep_object.call>
| Attributes | |||||
|---|---|---|---|---|---|
| Name | Type | Required | Default | Description | |
| Acode | string | Código del Objeto SQL. | |||
| Acond | string | Condición de selección del Objeto SQL. | |||
| Afile | string | Nombre del fichero donde se debe almacenar el resultado. Si no se indica se genera un fichero temporal. | |||
| Atype | string |
Tipo de formato de la salida (resultado de la ejecución).
|
|||
| Asep | string | , | Separador para el formato CSV. | ||
| Adin | string | A4 | Tamaño de la página. | ||
| Aungroup | boolean | false | Código del Objeto SQL. | ||
| Abackground | boolean | false | Indica si la ejecución se realizará en background. Si es así, la funció retorna el ID del proceso que ejecuta el objeto SQL en background. El resultado de la ejecución se podrá visualizar desde la herramienta "Caché y Tareas" una vez haya finalizado. | ||
| Arguments | |||||
|---|---|---|---|---|---|
| Name | Type | Required | Unique | Nullable | Description |
| Evars | |||||
| Evar | |||||
| Aname | string | Nombre de la variable. El nombre tiene que indicarse en mayúsculas. | |||
| Evalue | object | ||||
| Returns | |
|---|---|
| Type | Description |
| File | Un fichero (temporal si no se indica ninguno) con el resultado en el formato indicado (ASCII por defecto) de la ejecución del objeto SQL. |
Exceptions
required attribute 'code' not defined
No se ha especificado el nombre del Objeto SQL.
required attribute 'cond' not defined
No se ha indicado la condición del Objeto SQL.
database required
No se ha informado el nombre de la base de datos.
user must be set for operations
No se ha especificado el nombre de usuario.
UndefinedJRepObject: SQL object xxx is not defined.
El Objeto SQL no existe.
Example
Ejecutar un proceso y retornar el fichero generado.
Copy
<xsql-script name='webapp_wic_jrep_object_call_1'>
<body>
<return>
<file.bytes.read>
<webapp.wic_jrep_object.call
code='cerrauth_autoriza'
cond='1=1'
>
<vars>
<var name='TABORI'>gcompedh</var>
</vars>
</webapp.wic_jrep_object.call>
</file.bytes.read>
</return>
</body>
</xsql-script>
Example
Dejar en un fichero de SO el listado de diarios.
Copy
<xsql-script name='webapp_wic_jrep_object_call_2'>
<body>
<webapp.wic_jrep_object.call
code='cdiarios'
cond='1=1'
file='cdiarios.html'
type='html'
>
</webapp.wic_jrep_object.call>
</body>
</xsql-script>
Example
Ejecutar un objeto SQL en background. Retorna el identificador del proceso que ejecuta el objeto en background.
Copy
<xsql-script name='webapp_wic_jrep_object_call_3'>
<body>
<return>
<webapp.wic_jrep_object.call
code='cerrauth_autoriza'
cond='1=1'
background='true'
>
<vars>
<var name='TABORI'>gcompedh</var>
</vars>
</webapp.wic_jrep_object.call>
</return>
</body>
</xsql-script>