Tipos de datos compuestos admitidos para fórmulas de informes electrónicos
Este artículo proporciona información sobre las entidades de datos compuestas que son compatibles con las expresiones de informes electrónicos (ER). Las entidades de datos compuestas son clase, contenedor, registro, lista de registro y objeto.
Clase
El tipo de datos clase se refiere a una clase de aplicación pública. En ER, se representa como un registro que contiene un campo separado para cada método público de la clase referenciada. Cuando se parametriza la llamada al método, también debe especificar los argumentos requeridos de los tipos apropiados en una expresión ER que está configurada para llamar al método.
En los componentes asignación y formato de ER, puede agregar la fuente de datos Clase que se presenta como una fuente de datos y que devuelve un valor de tipo clase. Esta fuente de datos expone métodos públicos de la clase que se pueden llamar en tiempo de ejecución.
Nota
Solo los métodos que devuelven un valor se pueden llamar desde expresiones ER.
Solo los métodos que tienen un rango de cero a ocho argumentos se pueden llamar desde expresiones ER.
El valor predeterminado de una clase es nulo.
La siguiente ilustración muestra cómo la fuente de datos Información del sistema (xInfo) del tipo Clase se agrega para hacer la instancia de la clase de aplicación xInfo y llamar a su método productName() para recibir el nombre de la aplicación actual. El nombre de la aplicación actual se obtiene en tiempo de ejecución mediante la ejecución del enlace xInfo.productName que se configuró para el campo Nombre del software (SoftwareName) del modelo de datos ER. Este enlace llama al método productName() de la clase de aplicación xInfo que se representa en la asignación del modelo actual como la fuente de datos Información del sistema (xInfo).
La siguiente ilustración muestra cómo se configura el formato ER para colocar el nombre de la aplicación proporcionada en los documentos generados. El campo Nombre del software (SoftwareName) del modelo de datos utilizado estaba vinculado al componente Cadena que está anidado bajo el elemento XML softwareUsed del formato ER. Por lo tanto, el nombre de la aplicación actual se coloca en tiempo de ejecución en el elemento XML softwareUsed de un documento generado en formato XML.
Contenedor
El tipo de datos contenedor contiene contenido binario. Un valor Contenedor se puede utilizar para pasar información específica del almacenamiento a un documento generado. En el marco de ER, este tipo de datos se utiliza con frecuencia para incluir contenido multimedia, como el logotipo de una empresa, en los documentos generados.
Nota
Aunque cada elemento multimedia se puede representar como un valor de contenedor, no todos los valores contenedor representan un elemento multimedia. Por lo tanto, si configura un formato ER para que utilice un contenedor para poner una imagen en los documentos generados, pero la referencia contenedor no devuelve contenido multimedia, se podría generar una excepción similar al siguiente ejemplo: "Error al ejecutar el código: Binario (objeto), método constructFromContainer llamado con parámetros no válidos".
El valor predeterminado de un contenedor es nulo.
La siguiente ilustración muestra cómo el campo Bitmap(Image) del tipo Contenedor está vinculado al campo de modelo de datos Logo del tipo Contenedor en la asignación de modelo de Factura de ventas. Este enlace hace que el logotipo de la empresa esté disponible para cualquier formato de ER que esté diseñado para la definición de raíz de SalesInvoice y que utiliza esta asignación de modelo en tiempo de ejecución.
Grabar
Un registro es una colección de campos con nombre, cada uno de los cuales está asociado con un valor de un tipo de datos primitivos o un tipo de datos compuestos. Por lo general, un registro se utiliza para representar un solo registro de una lista de registros. En este caso, cada elemento representa campos, métodos y relaciones individuales.
El valor predeterminado de un registro es vacío.
Nota
Cuando obtiene el valor de un campo de un registro vacío, se devuelve el valor predeterminado del tipo de datos apropiado.
Un registro se puede obtener utilizando las siguientes funciones:
Para obtener más información sobre la transformación de valores de registro, consule Lista de funciones de ER en la categoría de lista.
Lista de registros
Una lista de registros es una lista de elementos del tipo registro. Por lo general, una lista de registros se utiliza para representar la lista de registros que se ha obtenido de una tabla de base de datos.
De forma predeterminada, se accede a los registros de una lista de registros de forma secuencial. Para acceder a un registro específico, puede utilizar la función INDEX y especificar el índice entero.
El valor predeterminado de una lista de registro es vacío. Puedes usar la función ISEMPTY para evaluar si una lista de registros esta vacía.
Nota
Si una lista de registros está vacía, cualquier intento de obtener un valor de campo para un registro en él hace que se lance una excepción en tiempo de ejecución. Para saber cómo puede ayudar a prevenir excepciones de tiempo de ejecución de este tipo, consulte Consideración de casos de lista vacía.
Una lista de registro se puede iniciar utilizando las siguientes funciones:
Para obtener más información sobre la transformación de valores de lista de registro, consule Lista de funciones de ER en la categoría de lista. Para aprender a introducir los elementos de la lista de registros, rellénelos con datos de la aplicación y luego utilice los datos para generar documentos comerciales, consulte Diseño de una nueva solución de ER para imprimir un informe personalizado.
Objeto
Un objeto se refiere a una instancia con estado de una clase. Por lo general, un objeto se inicia en el código fuente. Luego se pasa a una asignación de modelo ER y proporciona detalles del contexto de ejecución.
El valor predeterminado de un objeto es nulo.
La siguiente ilustración muestra cómo la fuente de datos ReportDataContract del tipo Objeto se agrega para pasar información sobre una factura generada desde el código fuente a la asignación de modelo de Factura de proyecto. Por ejemplo, el texto de la instancia de factura se pasa como parte del contexto de ejecución. Este texto se toma del código fuente en tiempo de ejecución mediante la ejecución del enlace ReportDataContract.parmInvoiceInstanceText que se configuró para el campo Nota del modelo de datos ER. Este enlace llama al método parmInvoiceInstanceText() de la clase de aplicación PSAProjInvoiceContract que se representa en la asignación del modelo actual como la fuente de datos ReportDataContract.
Para aprender a pasar detalles del contexto de ejecución desde el código fuente a la solución ER en ejecución, consulte Desarrollar artefactos de aplicación para llamar al informe diseñado.