Enlazar un informe a una entidad

Objetivo

Conectar un informe a una entidad de aplicaciones basadas en modelo —por ejemplo, una entidad Factura— para que el informe lea los registros de esa entidad de un entorno y disponga sus campos como columnas del informe.

Requisitos previos

• La entidad sobre la que quiere informar existe en el entorno sobre el que informa. Una tabla tiene sus datos detrás desde el momento en que se crea (consulte Qué ocurre al guardar una tabla).
• Tiene credenciales que conceden acceso de lectura para informes al entorno: o bien un registro de aplicación externa al que se ha concedido el ámbito reporting.read (o modelapps.read) (consulte Registrar una aplicación externa), o bien informa desde dentro del Shell de la plataforma, que proporciona el mismo acceso para la aplicación en la que está trabajando.
• Sabe qué entorno contiene los datos que quiere (los informes siempre leen los datos de exactamente un entorno).

Pasos

1. En la herramienta de informes, cree o abra un informe y agregue un origen de datos de Parsware.
2. Dirija el origen de datos a la dirección de informes del entorno de destino y proporcione las credenciales de informes de los requisitos previos.
3. Elija la entidad sobre la que informar en la lista de entidades enlazables. Aparecen todas las tablas de ese entorno; por ejemplo, Factura.
4. La herramienta carga las columnas enlazables de la entidad (la etiqueta y el tipo de datos de cada campo, con el campo principal de la entidad en primer lugar). Seleccione las columnas que quiere en el informe.
5. Si lo desea, agregue filtros y ordenaciones sobre esas columnas (por ejemplo, «Total es mayor que 50», las más recientes primero) y un tamaño de página.
6. Obtenga una vista previa del informe. La herramienta solicita una página de filas para las columnas seleccionadas y las representa. Guarde el informe.

Qué ocurre entre bastidores

Enlazar un informe crea una conexión de solo lectura a los datos de entidad de ese único entorno. El origen de datos de informes nunca escribe: puede enumerar las tablas del entorno, describir las columnas de una tabla y devolver páginas de filas para las columnas y los filtros que haya elegido. El acceso lo concede el ámbito de lectura para informes de sus credenciales y no un rol de aplicación, por eso una integración de informes no necesita permisos de escritura de creador ni de administrador. Cada solicitud lee solo el entorno al que dirigió el origen de datos: los datos de un entorno nunca pueden aparecer en un informe enlazado a otro.

Solución de problemas

• «Leer datos de informes requiere el ámbito 'reporting.read' o 'modelapps.read'.» — las credenciales del origen de datos no conceden acceso de lectura para informes. Use un registro de aplicación que tenga el ámbito reporting.read (o modelapps.read), o informe desde dentro del Shell.
• La entidad no está en la lista de entidades enlazables. — no existe en este entorno; probablemente dirigió el origen de datos a otro. Diríjalo al entorno que contiene la tabla, o importe la solución que la trae.
• Un filtro o una ordenación se rechaza por ser un campo desconocido. — el filtro o la ordenación nombra un campo que no está definido en la entidad. Elija una columna de la propia lista de campos de la entidad.

Escenarios relacionados

• Qué ocurre al guardar una tabla.
• Registrar una aplicación externa.
• Consultar datos de entidades para informes (desarrollador).