Realiza la llamada a un report definido en wic_obj_report, 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:
- HTML: formato HTML.
- PDF: formato en PDF.
- XLS: formato Microsoft Excel.
- CSV: formato CSV.
- JSON: formato JSON.
1 webapp.wic_obj_report.call
<webapp.wic_obj_report.call
code='code'
file='file'
sort='sort'
meta='meta'
type='htm|pdf|xlsx|json'
>
<qbeparams> ?
<param name='name'> +
<value /> !
</param>
</qbeparams>
<vars> ?
<var name='name'> +
<value /> !
</var>
</vars>
</webapp.wic_obj_report.call>
| Attributes | |||||
|---|---|---|---|---|---|
| Name | Type | Required | Default | Description | |
| Acode | string | Código del Objeto SQL. | |||
| Afile | string | Nombre del fichero donde se debe almacenar el resultado. Si no se indica se genera un fichero temporal. | |||
| Asort | string | Nombre de la columna por la que ordenar el report. Si no se especifica se aplicará la ordenación por defecto del report | |||
| Ameta | string | Código de la meta query definida en wic_obj_inputsql | |||
| Atype | string |
Tipo de formato de la salida (resultado de la ejecución).
|
|||
| Arguments | |||||
|---|---|---|---|---|---|
| Name | Type | Required | Unique | Nullable | Description |
| Eqbeparams | Mapa de inputs del report, el tanto el valor como la key del mapa deben ser strings. El valor debe estar definido en formato máquina (*) y acepta metacaracteres format and can use metachars. Se debe informar del mismo modo en que se informa en la página de input del QBE de los reports. | ||||
| Eparam | |||||
| Aname | string | Nombre del input. | |||
| Evalue | string | ||||
| 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. |
(*) Machine informat in Axional Studio environment reference the use of '.' charcter for decimal separator and the ISO 8601 format for dates and date times.
Exceptions
required attribute 'code' not defined
No se ha especificado el nombre 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>
<body>
<return>
<file.bytes.read>
<webapp.wic_obj_report.call code='studio_report_simple' type='html' sort="studio_employees.first_name ASC" >
<qbeparams>
<param name="studio_employees.first_name">B*</param>
</qbeparams>
<vars>
<var name='INTVAR1'>15</var>
<var name='DECVAR1'>17.1</var>
</vars>
</webapp.wic_obj_report.call>
</file.bytes.read>
</return>
</body>
</xsql-script>