Manual de Instalación de SAP Crystal Reports Papa Visual Studio Para Programadores

8/15/2019 Manual de Instalación de SAP Crystal Reports Papa Visual Studio Para Programadores
http://slidepdf.com/reader/full/manual-de-instalacion-de-sap-crystal-reports-papa-visual-studio-para-programadores 1/967
SAP Crystal Reports, versión para programadores de Microsoft Visual Studio Versión del documento: Support Package 13 - 2015-01-24
Manual del desarrollador del SDK .Net de SAP Crystal Reports para Visual Studio
Contenido
1 Manual del desarrollador del SDK de SAP Crystal Reports .Net . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.1 Inicio. . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
¿Qué es SAP Crystal Reports, versión para programadores de Microsoft Visual Studio?. . . . . . . . . . .4 Migrar la aplicación SAP Crystal Reports .Net. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
1.2 Configurar elentorno de desarrollo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Configuración del sistema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Configuración de proyectos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
1.3 Aspectos fundamentales del SDK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 Arquitectura. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 Control CrystalReportViewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42 ¿Cuál es el enfoque de persistencia que se debe usar con SAP Crystal Reports?. . . . . . . . . . . . . . .53 Escalar la aplicación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63 Usar SAP Crystal Reports en una matriz de servidores o de procesos Web. . . . . . . . . . . . . . . . . . . .74 Trabajar con Crystal Reports como servicio web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80 Consideraciones sobre la seguridad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
1.4 Uso del SDK.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110
Imprimir un informe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111 Exportar un informe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120 Filtrar datos con parámetros o fórmulas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132 Establecer el origen de datos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147 Visualizar un informe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159 Personalizar el control CrystalReportViewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218 Uso de los informes de sólo lectura de SAP Crystal Reports (RPTR). . . . . . . . . . . . . . . . . . . . . . .235
1.5 Tutoriales. . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236 Tutoriales del modelo de objeto CrystalReportViewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236 Tutoriales del modelo de objetos ReportDocument. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327 Tutoriales de código reducido en Visual Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .483 Tutoriales de conectividad de datos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .523 Otros tutoriales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .560
1.6 Implementación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .588 Componentes de implementación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .588 Implementación para Visual Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .599
1.7 Crear informes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .617 Usar SAPCrystal Reports Designer incrustado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .618 Referencia de fórmulas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .751 Referencia de interfaz de usuario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .817
2 © 2015 SAP SE o una empresa filial de SAP. Reservados todos los derechos.
Manual del desarrollador del SDK .Net de SAP Crystal Reports para Visual Studio Contenido
1.8 Glosario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .966
Manual del desarrollador del SDK .Net de SAP Crystal Reports para Visual Studio Contenido
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los derechos. 3
1 Manual del desarrollador del SDK de SAP Crystal Reports .Net
1.1 Inicio
Esta ayuda en pantalla está diseñada para ayudarle a desarrollar su propia aplicación Web o para Windows con el SDK de SAP Crystal Reports .NET. Incluye tutoriales y referencias de programación que puede usar para implementar el SDK de SAP Crystal Reports .NET.
1.1.1 ¿Qué es SAP Crystal Reports, versión para programadores de Microsoft Visual Studio?
SAP Crystal Reports, versión para programadores de Microsoft Visual Studio permite crear informes complejos y profesionales en un programa basado en GUI. Después puede conectar el informe a casi todos los orígenes de base de datos, así como a datos proxy, como un conjunto de resultados (por ejemplo, un ADO.NET DataSet). Los asistentes del diseñador de GUI le permiten establecer los criterios de formato, agrupamiento y gráficos, etc.
Puede almacenar el informe en una aplicación Web o para Windows, con uno de los controles de visores deSAPCrystal Reports. La presentación de informes, tanto en clientes Windows como en HTML 4.0 es muy interactiva y proporciona funciones como la profundización en gráficos, la exploración de informes y la búsqueda de texto.
SAP Crystal Reports, versión para programadores de Microsoft Visual Studio incluye un SDK extenso. Puede utilizarlo para interactuar con el informe mediante programación en tiempo de ejecución, usando uno de los cuatro modelos de objetos posibles: CrystalReportViewer, el modelo de objetos más sencillo. ReportDocument, el modelo de objetos más completo. ReportClientDocument, el modelo de objetos más completo. Este modelo de objetos está disponible con un
servidor RAS. InfoObject, un modelo de objetos muy eficaz para la programación y configuración de informes en el marco
de SAP Crystal Reports Server o la plataforma SAP BusinessObjects Business Intelligence.
Nota
Los modelos de objetos CrystalReportViewer yReportDocument están disponibles con todas las versiones de SAP Crystal Reports, versión para programadores de Microsoft Visual Studio. Los modelos de objetos ReportClientDocument e InfoObject requieren una licencia actualizada. VeaSoluciones de elaboración de informes de SAP BusinessObjects Business Intelligence [página 64].
Los informes se pueden relacionar con el proyecto de Visual Studio de muchas formas: Incruste los informes directamente en el proyecto. Obtenga acceso a sus informes desde un directorio de archivos.
Manual del desarrollador del SDK .Net de SAP Crystal Reports para Visual Studio Manual del desarrollador del SDK de SAP Crystal Reports .Net
Obtenga acceso a sus informes como servicio Web de informes desde un servidor remoto. Conecte sus informes como Crystal Services. Mediante la actualización a SAP Crystal Reports Server puede tener acceso a sus informes a través del
servidor RAS. Mediante la actualización a la plataforma SAP BusinessObjects Business Intelligence, puede tener acceso a
sus informes a través de Page Server o del servidor RAS incluidos en el marco de la plataforma SAP BusinessObjects Business Intelligence.
1.1.1.1 Funciones disponibles en SAP Crystal Reports Designer
SAP Crystal Reports Designer proporciona varias funciones que no están disponibles con SAP Crystal Reports, versión para programadores de Microsoft Visual Studio:
Función Descripción
Miembros calculados en gráficos de tabla de referencias cruzadas
Puede agregar filas o columnas a un gráfico de tabla de referencias cruzadas insertando un miembro calculado. Estas filas o columnas pueden contener cálculos personalizados (por ejemplo, la diferencia en las ventas entre dos regiones) o se pueden usar en conjunto para tareas de formato (por ejemplo, insertar una fila en blanco cada tres
líneas para mejorar la legibilidad). Tiene total flexibilidad paradiseñar sus propias fórmulas de cálculo y puede elegir si deben aparecer solamente una vez o repetirse regularmente en la tabla de referencias cruzadas.
Objetos Flash incrustados Puede incrustar un objeto Flash o crear un vínculo a un objeto Flash en cualquier sección de un informe de SAP Crystal Reports.
Resúmenes incrustados en tablas de referencias cruzadas Puede agregar un cálculo adicional a un gráfico de tabla de referencias cruzadas insertando un resumen incrustado. Los resúmenes incrustados no agregan filas ni columnas a la
tabla de referencias cruzadas. En lugar de ello, hacen que aparezcan cálculos adicionales en cada celda de la tabla de referencias cruzadas. Por ejemplo, en un informe que muestra las ventas regionales, podría insertar un cálculo para cada región que mostrase el porcentaje de ventas totales del país.
Vista previa editable Con SAP Crystal Reports Designer puede visualizar un informe en la ficha de diseño o la ficha de vista previa. En la ficha Vista previa dispone de las mismas opciones de formato que en la ficha Diseño. Sin embargo, en la ficha Vista previa trabaja con los datos reales. En lugar de un marco de
informe se muestran los valores reales.
Códigos de barras con formato SAP Crystal Reports Designer incluye las fórmulas y fuentes necesarias para admitir códigos de barras Code39. Puede usar la opción Dar formato al campo para cambiar el aspecto de un código de barras.
Existen varias razones para cambiar el aspecto de un código de barras, como:
Para cambiar el tamaño de modo que el código de barras no sea demasiado grande o pequeño como para leerlo con un escáner.
Para mostrar el código de barras en un color diferente.
Ordenación de campos interactiva Puede diseñar el informe de modo que los usuarios puedan modificar un campo o una dirección de ordenación sin necesidad de actualizar la información de la base de datos. Puede hacerlo agregando un Control de ordenación al informe.
UnControl de ordenación es especialmente útil por diversos motivos:
Permite que los usuarios ordenen los datos de un
informe para analizarlos sin necesidad de abandonar ellienzo del informe. Elimina demanda de procesamiento en la base de datos. Reduce el tiempo que los usuarios deben esperar a que
se ordenen los datos. Permite que los usuarios ordenen los campos del
informe aunque no dispongan de conexión o derechos para acceder a la base de datos en el momento de la visualización.
Workbench En Workbench puede crear proyectos que contengan uno o varios informes. Con las opciones de la barra de herramientas puede agregar, eliminar o cambiar el nombre de carpetas, informes y paquetes de objetos. Puede reorganizar los archivos en una o varias carpetas arrastrándolos y colocándolos donde desee que se muestren. También puede arrastrar archivos de informes desde Windows Explorer y colocarlos en la carpeta que desee en Workbench.
1.1.2 Migrar la aplicación SAP Crystal Reports .Net
En esta sección se ofrece información sobre la migración de la aplicación SAP Crystal Reports .Net a SAP CrystalReports, versión para programadores de Microsoft Visual Studio.
Nota
SAP Crystal Reports, versión para programadores de Microsoft Visual Studio contiene un completo conjunto de funciones, y está disponible como una descarga gratuita que se integra con Visual Studio 2010 o posterior. SAP Crystal Reports, versión para programadores de Microsoft Visual Studio no se incluye en la aplicación SAP Crystal Reports Designer.
Migrar a SAP Crystal Reports, versión para programadores de Microsoft Visual Studio
SAP Crystal Reports, versión para programadores de Microsoft Visual Studio actualiza automáticamente los proyectos anteriores a la versión actual. Si un proyecto incluye referencias a componentes anteriores, se solicita al usuario que realice una actualización.
Al hacer clic en el botón Sí, los proyectos y sus archivos se actualizan a la versión actual de SAP Crystal Reports. Si se hace clic en el botón No, se ajusta el proyecto de modo que se utilicen las referencias originales. Algunas de las funciones anteriores se deshabilitan debido a que los componentes anteriores no tendrán esa funcionalidad determinada.
Nota
Si están bloqueados el archivo de proyecto, cualquier archivo ASPX que incluya componentes de SAP Crystal Reports o el archivo web.config, no se podrá llevar a cabo la actualización o la aplicación de soluciones.
Información relacionada
Soluciones de elaboración de informes de SAP BusinessObjects Business Intelligence [página 64]
1.1.2.1 Problemas de migración Un informe basado en una fuente de datos ADO.NET no funcionará si el proyecto tiene como destino el .NET 4.x Framework
Los informes basados en una fuente de datos ADO.NET no funcionarán si el proyecto tiene como destino .NET 4.x Framework. Se produce el siguiente error: "Información adicional: se ha creado un conjunto de modo combinado frente a la versión 'v2.0.50727' del tiempo de ejecución y no puede cargarse en el tiempo de ejecución 4.x sin información de configuración adicional."
Este problema puede solucionarse actualizando el archivo .config de los proyectos. Agregue las siguienteslíneas de código a la sección<configuration></configuration> del archivo:
<startup useLegacyV2RuntimeActivationPolicy="true"> <supportedRuntime version="v4.x"/> </startup>
1.1.2.2 Limitaciones de 64 bits
SAP Crystal Reports, versión para programadores de Microsoft Visual Studio8 x64 (AMD64) admite la arquitectura de 64 bits. Sin embargo, actualmente no se admite la arquitectura de IA64 (Itanium).
Funciones que no se admiten actualmente en escenarios de 64 bits: Exportar informes al formato HTML. Componentes de correspondencia geográfica. Componentes de fuente de código de barras Azalea.
1.2 Configurar el entorno de desarrollo
En esta sección se ofrecen instrucciones detalladas sobre cómo instalar y configurar el entorno de implementación y cómo crear un sitio Web o proyecto Windows en SAP Crystal Reports, versión para programadores de Microsoft Visual Studio.
1.2.1 Configuración del sistema
En esta sección se proporciona una vista general de cómo configurar el entorno de desarrollo para probar y desarrollar aplicaciones para Windows o sitios Web que usen el SDK de SAP Crystal Reports .Net.
1.2.1.1 Instalaciones necesarias
Necesita instalar SAP Crystal Reports, versión para programadores de Microsoft Visual Studio para poder crear aplicaciones Web o para Windows que usen SAP Crystal Reports.
1.2.1.1.1 Versiones compatibles de Visual Studio
Si desea utilizar SAP Crystal Reports, versión para programadores de Microsoft Visual Studio, deberá verificar que la versión de Visual Studio instalada admite SAP Crystal Reports.
Las ediciones Ultimate, Premium y Professional de Visual Studio se admiten en Visual Studio 2010 y versiones superiores. SAP Crystal Reports no admite las ediciones Express de Visual Studio.
Soluciones de elaboración de informes de SAP BusinessObjects Business Intelligence [página 64]
1.2.1.1.2 Versiones de SAP Crystal Reports
Hay disponibles numerosas versiones de SAP Crystal Reports. Muchos de los procedimientos incluidos en estedocumento son específicos de versión. Para obtener el máximo partido de este documento, determine en primer lugar qué versión de SAP Crystal Reports tiene instalada.
1.2.1.1.2.1 Para determinar qué versión de SAP Crystal Reports está ejecutando:
Procedimiento
1. Vaya a GAC (caché de ensamblados global) enC:\WINNT\Assembly o C:\Windows\Assembly . 2. Busque el archivo CrystalDecisions.CrystalReports.Engine.
Nota
Si ha instalado más de una versión de SAP Crystal Reports, tendrá varias versiones de estos archivos en la caché de ensamblados global. El archivo CrystalDecisions.CrystalReports.Engine se selecciona, ya que dicho archivo se incluye en todas las versiones de SAP Crystal Reports.
3. Observe la columnaVersión que aparece en la ventana.
Ésta es la "versión de ensamblado". 4. Busque el número más alto de un ensamblado determinado. 5. Compare la versión del ensamblado con el número de versión en el gráfico de versiones de SAP Crystal
Reports.
Producto Versión de ensamblado
SAP Crystal Reports, versión para programadores de Microsoft Visual Studio (.NET 4.0 Framework)
13.0.2000.0
SAP Crystal Reports XI Release 2 11.5.3300.0
SAP Crystal Reports XI Release 1 11.0.3300.0
SAP Crystal Reports Basic para Visual Studio 2008 10.5.3600.0
SAP Crystal Reports para Visual Studio 2005 10.2.3600.0
SAP Crystal Reports 10 10.0.3300.0
SAP Crystal Reports para Visual Studio 2003 9.1.5000
SAP Crystal Reports 2008 y SAP Crystal Reports 2008 SP1 usan el mismo número de versión de ensamblado. Para comprobar si tiene instalado SAP Crystal Reports 2008 SP1, compruebe que la versión de archivo empieza por 12.1, y no por 12.0.
1.2.1.1.3 Instalar el Servicio de actualizaciones de SAP Crystal Reports
Contexto
SAP Crystal Reports, versión para programadores de Microsoft Visual Studio dispone ahora de un servicio opcional de actualizaciones de SAP Crystal Reports que busca actualizaciones, soluciones y revisiones de SAP Crystal Reports.
El servicio de actualizaciones de SAP Crystal Reports, versión para programadores de Microsoft Visual Studio no forma parte del instalador. Deberá descargar e instalar el Servicio de actualizaciones por separado.
Procedimiento
1. Tras instalar SAP Crystal Reports, versión para programadores de Microsoft Visual Studio, abra Visual Studio y cree un sitio Web o un proyecto para Windows.
2. En Explorador de soluciones haga clic con el botón derecho en el nombre de proyecto en negrita y haga clic en Agregar Nuevo elemento .
3. En el cuadro de diálogo Agregar nuevo elemento , seleccione Crystal Reports . 4. En el campoNombre , especifiqueTest.rpt y, a continuación, haga clic en Agregar .
Nota
Si es la primera vez que usa SAP Crystal Reports Designer incrustado, se le pedirá que acepte el Contrato de licencia para el usuario final. Después de esto, se abrirá el cuadro de diálogo Servicio de actualizaciones. Si ha abierto antes SAP Crystal Reports Designer incrustado, deberá abrir manualmente el cuadro de diálogo Servicio de actualizaciones.
Se abrirá SAP Crystal Reports Designer incrustado y mostrará el nuevo informe. 5. Si no aparece el cuadro de diálogoServicio de actualizaciones , en el menú Crystal Reports , haga clic en
Comprobar actualizaciones .
Si no está instalado el Servicio de actualizaciones de SAP Crystal Reports, se le preguntará si desea instalarlo. 6. En el cuadro de diálogoServicio de actualizaciones , haga clic enSí .
Se cargará el sitio Web del Servicio de actualizaciones de SAP Crystal Reports, que dispone de un vínculo para descargar el servicio de actualizaciones.
7. Descargue e instale el Servicio de actualizaciones de SAP Crystal Reports.
8. Inicie de nuevo Visual Studio. 9. AbraTest.rpt .
Se iniciará SAP Crystal Reports Designer incrustado y mostrará el informe. 10. En el menúCrystal Reports , haga clic enComprobar actualizaciones .
Se abrirá el Servicio de actualizaciones y buscará actualizaciones. Puede aceptar o rechazar las actualizaciones disponibles.
1.2.1.1.4 Código de clave de producto de SAP CrystalReports
El código de clave de producto es una cadena alfanumérica con una longitud de 19 dígitos o caracteres. En SAP Crystal Reports, versión para programadores de Microsoft Visual Studio, al crear proyectos de implementación que usen Windows Installer, es posible que necesite un código de clave de producto para validar la licencia de las aplicaciones Web o para Windows.
1.2.1.2 Comprobaciones necesarias
Para desarrollar un sitio Web o aplicación de Windows que use el SDK de SAP Crystal Reports .NET, tendrá que comprobar que los componentes del desarrollador de Crystal Reports se han instalado correctamente y se han integrado con Visual Studio. Para desarrollar un sitio Web, tendrá que llevar a cabo un paso adicional: comprobar que el directorio virtual de los visores se ha instalado correctamente en los servidores de desarrollo, implementación y Web.
En esta sección se explica la configuración que tendrá que comprobar antes de crear una aplicación de SAP Crystal Reports .NET.
Versiones compatibles de Visual Studio [página 10]
Contexto
Para verificar que el componente SAP Crystal Reports de Visual Studio está instalado, asegúrese de que SAP Crystal Reports aparece en el cuadro de diálogo Agregar nuevo elemento de Visual Studio.
Procedimiento
1. Inicie Visual Studio. 2. Cree un nuevo proyecto Web o de Windows (en cualquier lenguaje) o abra uno ya existente. 3. En el menúProyecto , haga clic en Agregar nuevo elemento .
Nota
Los nuevos archivos de informe se deben agregar directamente a un proyecto. No se puede crear un nuevo informe de Crystal en Visual Studio mediante el menú Archivo .
4. Cuando aparezca el cuadro de diálogo Agregar nuevo elemento , desplácese en éste y compruebe que Crystal Reports es uno de los elementos disponibles.
1.2.1.2.2 Directorio de visores
SAP Crystal Reports se basa en un directorio virtual para obtener acceso a los visores a fin de mostrarlos. Dicho directorio virtual y la ruta de archivos subyacente son exclusivos en cada una de las versiones de SAP Crystal Reports; de esta forma, las versiones subsiguientes de SAP Crystal Reports instaladas en un mismo equipo funcionarán sin conflictos.
1.2.1.2.2.1 Ubicación predeterminada del directorio de visores
Si ha instalado SAP Crystal Reports usando la configuración y las rutas de archivos predeterminadas, el directorio virtual de visores estará configurado de la siguiente forma:
Versión Framework Ruta de archivos
SAP Crystal Reports, versión para programa dores de Microsoft Vi sual Studio
4.x Framework Directorio de archivos al usar ASP.NET Development Server:
\Windows\Microsoft.NET\Framework \v4.0.30319\ASP.NETClientFiles \crystalreportviewers13
Directorio de archivos al usar IIS:
\inetpub\wwwroot\aspnet_client\system_web \4_0_30319\crystalreportviewers13
SAP Crystal Reports, versión para programa
dores de Microsoft Visual Studio
2,0 Framework Directorio de archivos al usar ASP.NET Development Server:
\Windows\Microsoft.NET\Framework \v2.0.50727\ASP.NETClientFiles \crystalreportviewers13
Directorio de archivos al usar IIS:
\inetpub\wwwroot\aspnet_client\system_web \2_0_50727\crystalreportviewers13
1.2.1.2.2.2 Para encontrar el directorio de visores
Procedimiento
1. En el Panel de control, haga doble clic enHerramientas administrativas y, a continuación, haga doble clic en Internet Information Services .
2. En el cuadro de diálogoInternet Information Services , expanda el nodoSitios Web y, a continuación, el nodo Sitio Web predeterminado .
3. Busque todas las carpetas que contengan una carpeta crystalreportsviewers13 . 4. Haga clic con el botón derecho en cada carpetacrystalreportsviewers13 y seleccionePropiedades .
5. En el cuadro de diálogoPropiedades , confirme que laruta local está configurada correctamente para su versión de SAP Crystal Reports para Visual Studio.
1.2.1.2.3 Directorio de informes de muestra
Algunos de los ejemplos de las funciones, casos de enlace de informes y manuales se basan en informes de muestra disponibles en SAP Crystal Reports.
Los informes de muestra pueden descargarse de http://www.sdn.sap.com/irj/boc/downloads .
1.2.2 Configuración de proyectos
Esta sección constituye un punto de aprendizaje clave tanto para programadores de nivel avanzado comointermedio. Aquí se muestran las mejores prácticas recomendadas para continuar con la creación y la configuración de un nuevo proyecto para Windows o un proyecto/sitio Web con SAP Crystal Reports, versión para programadores de Microsoft Visual Studio.
El proyecto nuevo que se crea sirve también como requisito previo para los tutoriales suministrados junto con esta ayuda en línea.
1.2.2.1 Configuración de sitios Web en Visual Studio
En esta sección se describe la configuración de sitios Web en Visual Studio. Este sitio web que se crea sirve también como requisito previo para los tutoriales de codificación suministrados junto con esta ayuda en línea.
1.2.2.1.1 Crear un nuevo sitio Web en Visual Studio
Procedimiento
1. Inicie Visual Studio. 2. En el menú Archivo , haga clic enNuevo sitio Web . 3. En el cuadro de diálogoNuevo sitio Web , haga clic enSitio Web ASP.NET . 4. En la lista desplegableUbicación , seleccione Sistema de archivos . 5. En la lista desplegableIdioma , seleccione el idioma de codificación que desea usar. 6. En el campo de textoUbicación indique la ruta de directorioC:\WebSites\ , seguida del nombre del
proyecto.
1.2.2.1.2 Preparar el formulario Web Form
1.2.2.1.2.1 Para crear el formulario Web Form
Contexto
En esta sección puede configurar la clase de código subyacente del formulario Web Form.
Procedimiento
1. En el Explorador de soluciones, haga doble clic en Default.aspx para abrir el formulario Web Form. 2. En el menúVer , haga clic enCódigo .
Se abrirá la clase de código subyacente. La clase se denomina _Default. El archivo de la clase se llama Default.aspx.cs o Default.aspx.vb.
Nota
Si su página Default.aspx predeterminada se creó con código en línea, no coloque dicho código en un archivo independiente. En tal caso, elimine la página ASPX y vuelva a crearla. Al crear la página ASPX, active la casilla de verificación "Colocar código en archivo independiente".
3. Si utiliza Visual Basic para escribir la clase, escriba "Option Strict On" en la parte superior de la clase.
Nota
Como práctica recomendada, se sugiere establecer Option Strict On al comienzo de cualquier clase de Visual Basic del sitio Web. Cuando se escribe código, se impone el uso de las prácticas más
recomendables, con declaraciones de variables con tipos declarados y una proyección válida. Ambos se comprueban durante la compilación. Las comprobaciones de cumplimiento estricto realizadas durante la compilación pueden reducir las excepciones en tiempo de ejecución.
1.2.2.1.2.2 Para agregar instrucciones Imports/Using a los espacios de nombres de referencia
Procedimiento
1. Abra la página Default.aspx. 2. En el menúVer , haga clic enCódigo .
Aparece la clase de código subyacente del formulario Web Form. 3. Sobre la firma de clase, agregue una declaración "Imports " [Visual Basic] o "using " [C#] a la parte superior
de la clase que contenga los siguientes espacios de nombres de SAP Crystal Reports.
Imports CrystalDecisions.CrystalReports.Engine Imports CrystalDecisions.Shared
using CrystalDecisions.CrystalReports.Engine; using CrystalDecisions.Shared;
Nota
Las clases de estos dos ensamblados se usan habitualmente en todos los tutoriales. Si hay ensamblados
adicionales que pueda necesitar ocasionalmente en tutoriales específicos, se le indicará que los agregue durante dicho tutorial.
1.2.2.1.2.3 Para agregar un método de ayuda privado para el código de configuración de SAP Crystal Reports
Procedimiento
En la clase, agregue un nuevo método de ayuda de ámbito privado sin valor de devolución, denominado ConfigureCrystalReports() .
Private Sub ConfigureCrystalReports() End Sub
private void ConfigureCrystalReports() { }
El método ConfigureCrystalReports() permite a los usuarios interactuar con el informe en tiempo de
ejecución. Además, controla la interacción mediante programación con el informe.
Pasos siguientes
A continuación, agregue un controlador de eventosPage_Init desde el que se llamará al método ConfigureCrystalReports() . Si se llama al métodoConfigureCrystalReports() desde este controlador de eventos, se garantiza que el código de configuración de informes de Crystal se ejecute durante el evento de inicialización de páginas.
1.2.2.1.2.4 Para agregar un controlador de eventos Page_Init a la clase de código subyacente
Contexto
Normalmente el controlador de eventos Page_Load se usa para especificar código de configuración de Web Forms en una aplicación Web de ASP.NET para que el código se llame durante el eventoPage.Load . Sin embargo, el código de configuración del informe de Crystal se debe llamar antes durante el eventoPage.Init .
automáticamente al archivo Web.Config cuando se agrega el control CrystalReportViewer al sitio Web. Esto corresponde a la clase CrystalImageCleaner .
CrystalImageCleaner-Sleep inicializa el período de tiempo en milisegundos que el sistema de limpieza de imágenes permanece inactivo antes de buscar y limpiar los archivos de imagen del directorio de imágenes dinámicas.
CrystalImageCleaner-Age inicializa la duración mínima en milisegundos de un archivo antes de que se elimine.
CrystalImageCleaner-AutoStart controla el proceso CrystalImageCleaner. El sistema de limpieza de imágenes limpia las imágenes temporales que se han creado al visualizar un informe.
Nota
Sólo se puede iniciar un sistema de limpieza en un único proceso de trabajo ASP.NET.
<appSettings> <add key="CrystalImageCleaner-AutoStart" value="true" /> <add key="CrystalImageCleaner-Sleep" value="60000" /> <add key="CrystalImageCleaner-Age" value="120000" /> </appSettings>
CrystalImageHandler
El elementoCrystalImageHandler muestra todas las imágenes dinámicas en el control CrystalReportViewer. Este ajuste configura el proceso de trabajo de ASP.NET para redirigir las solicitudes efectuadas a CrystalImageHandler.aspx a una clase interna de controlador de imágenes solamente. Si no tiene la configuración CrystalImageHandler en el archivo Web.Config, no se mostrarán las imágenes del sitio web. Este elemento se agrega automáticamente al archivo Web.Config cuando se agrega el control CrystalReportViewer al sitio Web.
<system.web> <httpHandlers> <add verb="GET" path="CrystalImageHandler.aspx" type="CrystalDecisions.Web.CrystalImageHandler, CrystalDecisions.Web, Version=13.0.2000.0, Culture=neutral, PublicKeyToken=692fbea5521e1304"/> </httpHandlers> </system.web>
documentView
El elementodocumentView controla el aspecto del informe en el lienzo de informes. Hay dos configuraciones disponibles: Si se establece el valor aprintlayout se muestra un borde gris alrededor del informe y una sombra en el
lienzo. Este es el valor predeterminado. Si el valor se establece en weblayout , el lienzo se rellenará con el informe.
<configSections> <sectionGroup name="businessObjects">
</sectionGroup> </configSections> <businessObjects> <crystalReports> <crystalReportViewer> <add key="documentView" value="weblayout"/> </crystalReportViewer> </crystalReports> </businessObjects>
EnableTextClipping
El elementoEnableTextClipping controla si el texto del campo está cortado. Si está definido como verdadero , el texto de un campo dado no superpondrá el texto del campo contiguo.
<configSections> <sectionGroup name="businessObjects"> <sectionGroup name="crystalReports"> <section name="crystalReportViewer" type="System.Configuration.NameValueSectionHandler" /> </sectionGroup> </sectionGroup> </configSections> <businessObjects> <crystalReports>
<crystalReportViewer> <add key="EnableTextClipping" value="true"/> </crystalReportViewer> </crystalReports> </businessObjects>
globalResourcePath
El elementoglobalResourcePath es la referencia a la ruta del directorio de archivos para los recursos globales. Este directorio de archivos contiene los recursos de idioma personalizados en una ubicación central y se puede compartir entre varias aplicaciones Web. Este ajuste permite acceder a los recursos globales de un sitio Web específico. En SAP CrystalReports.NET, los archivos de recursos predeterminados no se incluyen en la instalación del producto, pero pueden descargarse desde el sitio Web de asistencia técnica de SAP BusinessObjects: http:// help.sap.com. Este elemento se tiene que agregar manualmente al archivo Web.Config del sitio Web.
<appSettings> <add key="globalResourcePath" value="c:\CrystalReportViewer_resource_files\"/> </appSettings>
maxNumberListOfValues
maxNumberListOfValues controla el número de elementos de LOV que se enviarán al cliente. Esto controla el número de valores que se muestran en el panel de parámetros. Cuando se establece este valor, sólo aparecerán los primeros n valores en una lista de valores. Podrá consultar los diferentes conjuntos de valores en el cuadro de diálogo Avanzado en función del tamaño de su lista y del valor del elementomaxNumberListOfValues . Por ejemplo, si dispone de 180 valores, y establece el elementomaxNumberListOfValues en 50, podrá ver los primeros 50 valores enumerados en el panel de parámetros. Podrá consultar los 180 valores en el cuadro de diálogo Avanzado, donde se mostrarán los tres grupos de 50 valores, y un grupo de 30.
Se recomienda que este valor siempre sea mayor que 0. El valor predeterminado es 200.
<configSections> <sectionGroup name="businessObjects"> <sectionGroup name="crystalReports"> <section name="crystalReportViewer" type="System.Configuration.NameValueSectionHandler" /> </sectionGroup> </sectionGroup> </configSections> <businessObjects> <crystalReports> <crystalReportViewer> <add key="maxNumberListOfValues" value="50"/> </crystalReportViewer> </crystalReports> </businessObjects>
printControl
El elementoprintControl permite imprimir el informe directamente en la impresora local. El directorio de instalación predeterminado es C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Common\Crystal Reports 2011\crystalreportviewers .
Esta configuración hace que el archivo .cab esté visible para el sitio Web de SAP Crystal Reports .NET. Este elemento se tiene que agregar manualmente al archivo Web.Config del sitio Web.
<configSections> <sectionGroup name="businessObjects">
<sectionGroup name="crystalReports"> <section name="printControl" type="System.Configuration.NameValueSectionHandler" /> </sectionGroup> </sectionGroup> </configSections> <businessObjects> <crystalReports> <printControl> <add key="url" value="http://localhost/PrintControl.cab" /> </printControl> </crystalReports> </businessObjects>
processingIndicatorDelay
El elementoprocessingIndicatorDelay controla el tiempo que transcurre antes de que aparezca el indicadorde procesamiento de informes. Este valor se indica en milisegundos. Si se establece este valor en 0, se deshabilitará el indicador de procesamiento de informes. El valor predeterminado es 200 milisegundos.
<configSections> <sectionGroup name="businessObjects"> <sectionGroup name="crystalReports"> <section name="crystalReportViewer" type="System.Configuration.NameValueSectionHandler" /> </sectionGroup> </sectionGroup> </configSections> <businessObjects> <crystalReports> <crystalReportViewer> <add key="processingIndicatorDelay" value="20"/> </crystalReportViewer> </crystalReports> </businessObjects>
processingIndicatorText
El elementoprocessingIndicatorText controla el texto que se muestra en el indicador de procesamiento de informes. El texto predeterminado es: Espere mientras el documento se procesa.
<configSections> <sectionGroup name="businessObjects"> <sectionGroup name="crystalReports"> <section name="crystalReportViewer" type="System.Configuration.NameValueSectionHandler" /> </sectionGroup> </sectionGroup> </configSections> <businessObjects> <crystalReports> <crystalReportViewer> <add key="processingIndicatorText" value="Thank you for waiting."/> </crystalReportViewer> </crystalReports>
</businessObjects>
reportMappings
El elemento reportMappings actualiza los sitios Web creados en Visual Studio 2003 que utilizan informes incrustados a sitios Web no incrustados cuando se abren en Visual Studio 2005 o posterior. Esta configuración convierte el archivo .dll creado en Visual Studio 2003 en un archivo de disco. Visual Studio 2005 y 2008 no admiten sitios Web incrustados y debe modificar el archivo Web.Config para garantizar que sigue siendo funcional con la versión más reciente de Visual Studio. Este elemento se tiene que agregar manualmente al archivo Web.Config del sitio Web. La configuraciónreportMappings requiere una ruta absoluta.
Nota
Este elemento sólo es válido para Visual Studio 2005 y Visual Studio 2008.
<configSections> <sectionGroup name="businessObjects"> <sectionGroup name="crystalReports"> <section name="reportMappings" type="CrystalDecisions.Shared.ReportMappingHandler" /> </sectionGroup> </sectionGroup> </configSections>
<businessObjects> <crystalReports> <reportMappings> <add reportName="World Sales Report.rpt" path="C:\Report\World Sales
Report.rpt" /> </reportMappings> </crystalReports> </businessObjects>
<configSections> <sectionGroup name="businessObjects"> <sectionGroup name="crystalReports"> <section name="crystalReportViewer" type="System.Configuration.NameValueSectionHandler" /> </sectionGroup> </sectionGroup> </configSections> <businessObjects> <crystalReports> <crystalReportViewer> <add key="resourceURI" value="~/crystalreportviewers12" /> </crystalReportViewer> </crystalReports> </businessObjects>
serverFileReportManager
El elemento serverFileReportManager es un servicio Web que enumera los archivos del servidor en el equipo del servidor. Este ajuste permite obtener una lista de objetos (carpetas e informes) desde un equipo remoto. Este ajuste asigna la raíz del directorio de archivos para el servidor. En este ejemplo, la raíz se establece enc:
\inetpub\wwroot . Este elemento se tiene que agregar manualmente al archivo Web.Config del sitio Web.
<configSections> <sectionGroup name="crystalDecisions"> <section name="serverFileReportManager" type="System.Configuration.NameValueSectionHandler" /> </sectionGroup> </configSections> <crystalDecisions> <serverFileReportManager> <add key="rootDirectory" value="c:\inetpub\wwwroot" /> </serverFileReportManager> </crystalDecisions>
UseAsynchronousRequests
De forma predeterminada, se permiten las solicitudes asíncronas dentro del visor de DHTML. Si desea habilitar el botón Atrás en el navegador del usuario para que funcione con el visor DHTML, deberá deshabilitar las solicitudes asíncronas estableciendo este parámetro a false .
Nota
No se recomienda establecer el elemento UseAsynchronousRequests en false . Si lo hace, se deshabilitará el cuadro de diálogo Avanzado en el panel de parámetros, así como algunas mejoras de rendimiento del visor y funciones de aspecto mejoradas.
<context-param> <param-name>crystal_use_asynchronous_requests</param-name> <param-value>false</param-value> </context-param>
UseBrowserLocale
El elementoUseBrowserLocale recupera la configuración de idioma del explorador para el control CrystalReportViewer. Cuando se establece en true, este ajuste configura el control CrystalReportViewer para observar la configuración regional del explorador. Cuando se establece en false, este ajuste restringe la configuración regional que se muestra página a página. Este elemento se tiene que agregar manualmente al archivo Web.Config del sitio Web.
<configSections> <sectionGroup name="businessObjects"> <sectionGroup name="crystalReports"> <section name="crystalReportViewer" type="System.Configuration.NameValueSectionHandler" /> </sectionGroup> </sectionGroup>
</configSections> <businessObjects>
</crystalReports> </businessObjects>
<add verb="GET" path="CrystalImageHandler.aspx"type="CrystalDecisions.Web.CrystalImageHandler, CrystalDecisions.Web, Version=12.1.2000.0, Culture=neutral, PublicKeyToken=692fbea5521e1304"/> </httpHandlers> </system.web> </configuration>
Imprimir
Web: configurar la localización basada en el explorador Web configurar recursos personalizados globales o locales Cómo agregar o eliminar referencias en Visual Studio Versiones de SAP Crystal Reports
1.2.2.2 Configuración de proyectos de Windows en Visual Studio
Esta sección constituye un punto de aprendizaje clave tanto para programadores de nivel avanzado como intermedio. Aquí se muestran las mejores prácticas recomendadas para continuar con la creación y la
configuración de un nuevo proyecto de Windows con SAP Crystal Reports, versión para programadores de Microsoft Visual Studio.
En esta sección se muestra la configuración de un proyecto de Windows mediante un modelo de codificación. Como parte de esta configuración, se tendrá acceso a la clase Form1 y se escribirá código. Este proyecto de Windows basado en código que se crea sirve también como requisito previo para los tutoriales de codificación suministrados junto con esta ayuda en línea.
1.2.2.2.1 Crear un nuevo proyecto de Windows en Visual Studio
Procedimiento
1. Inicie Visual Studio. 2. En el menú Archivo , seleccione Nuevo y, a continuación, haga clic enProyecto . 3. En el cuadro de diálogoNuevo proyecto , seleccione una carpeta de lenguaje para C# o Visual Basic en la lista
Tipos de proyecto . 4. En la listaPlantillas , haga clic en Aplicación para Windows Forms . 5. En el campoNombre , sustituya el nombre de proyecto predeterminado por el nombre de su proyecto.
Utilice la convención de nomenclatura Pascal, donde se escribe la primera letra del nombre del proyecto en mayúsculas, ya que el nombre del proyecto también se utilizará como nombre del espacio de nombres para el
ensamblado generado a partir del proyecto. 6. Haga clic en Aceptar .
1.2.2.2.2 Aplicar la configuración de proyecto Visual Basic estándar (opcional)
Contexto
Si desea configurar el proyecto de forma que se pueda utilizar con los tutoriales incluidos en esta documentación, es necesario realizar una pequeña modificación en la configuración del mismo.
Procedimiento
1. En Explorador de soluciones , haga clic con el botón derecho en el nombre de proyecto en negrita bajo del nombre de solución y, a continuación, seleccionePropiedades .
2. En la vistaPropiedades , haga clic en la fichaCompilar . 3. En la listaOptionStrict , haga clic en Activada .
4. Cierre la vistaPropiedades . 5. En el menú Archivo , haga clic enGuardar todo .
Nota Como práctica recomendada, se sugiere habilitar OptionStrict al comienzo de cualquier proyecto de Visual Basic. Cuando se escribe código, se impone el uso de las prácticas más recomendables, con declaraciones de variables con tipos declarados y una proyección válida. Ambos se comprueban durante la compilación. Las comprobaciones de cumplimiento estricto realizadas durante la compilación pueden reducir las excepciones en tiempo de ejecución.
1.2.2.2.3 Preparar el formulario Windows Form en Visual
1.2.2.2.3.1 Para crear el formulario de Windows Form
Contexto
Por lo general, en las aplicaciones para Windows de Visual Basic 6, un formulario predeterminado se define con el nombre Form1. Siguiendo este modelo, en un proyecto de Windows se utiliza el mismo nombre predeterminado de formulario, Form1, con la extensión cs o vb, en función del lenguaje que se utilice.
Procedimiento
1. Si Form1 no aparece en la ventana principal, haga doble clic enForm1 en elExplorador de soluciones para abrirlo en la vista Diseño.
Form1 se abrirá en Designer. 2. En el menúVer , haga clic enCódigo .
Aparece la vista Código de la clase Form1. La presentación de esta clase depende de si la aplicación para Windows se codifica en Visual Basic o C#.
En C#, la clase Form1 muestra lo siguiente: La firma de clase. Un constructor (Form1).
En Visual Basic, la clase Form1 muestra lo siguiente: La firma de clase (una clase Form1).
Nota
Una clase "partial" independiente contiene métodos y variables adicionales de la clase Form1. (Esto es cierto para C# y Visual Basic). Las clases parciales se explican posteriormente en Configuración de
proyectos de Windows.
1.2.2.2.3.2 Para agregar un método de ayuda privado para el código de configuración de SAP Crystal Reports
Procedimiento
1. Agregue a esta clase Form1 un nuevo método auxiliar de ámbito privado sin valor devuelto, denominado ConfigureCrystalReports() .
Private Sub ConfigureCrystalReports() End Sub
private void ConfigureCrystalReports() { }
A continuación, agregue un controlador de eventosForm_Load y una llamada a ConfigureCrystalReports() en el controlador de eventos Form_Load . De este modo, el método ConfigureCrystalReports() se ejecutará automáticamente al cargar el formulario.
2. En el menúVer , haga clic enDiseñador . 3. Haga doble clic enForm1 .
Regresará a la vista Código. Como hizo doble clic enForm1 , se generará automáticamente un controlador de eventos Form1_Load en la clase Form1 .
4. En el control de eventosForm1_Load , escriba una llamada al método ConfigureCrystalReports() .
ConfigureCrystalReports()
ConfigureCrystalReports();
1.2.2.2.4 Agregar un control CrystalReportViewer
1.2.2.2.4.1 Para agregar un control de CrystalReportViewer a una aplicación de Windows
Procedimiento
1. Abra un formulario de Windows Form en la vista Diseño. 2. En elCuadro de herramientas , abra el nodo Informes para buscar el control CrystalReportViewer .
Nota
Crystal Reports .
3. Arrastre y suelte el controlCrystalReportViewer en el formulario. 4. En el menú Archivo , haga clic enGuardar todo .
Resultados
Cuando se agrega un control CrystalReportViewer a su aplicación, se agregarán de forma automática a su proyecto referencias a los ensamblados de SAP Crystal Reports.
1.2.2.2.4.2 Para agregar instrucciones Imports/Using a los
espacios de nombres de referencia Procedimiento
1. Si la carpeta Referencias no está visible en Explorador de soluciones, en la barra de herramientas Explorador de soluciones, haga clic en Mostrar todos los archivos para mostrar todos los archivos de proyecto.
2. En Explorador de soluciones, expanda la carpeta Referencias. 3. Verifique que se han agregado los siguientes ensamblados de SAP Crystal Reports:
CrystalDecisions.CrystalReports.Engine CrystalDecisions.Shared
4. Seleccione Form1 y, a continuación, en el menúVer , haga clic enCódigo . 5. Sobre la firma de clase, agregue una declaración "Imports " [Visual Basic] o "using " [C#] a la parte superior
de la clase que contenga los siguientes espacios de nombres de SAP Crystal Reports.
Imports CrystalDecisions.CrystalReports.Engine Imports CrystalDecisions.Shared
using CrystalDecisions.CrystalReports.Engine; using CrystalDecisions.Shared;
1.3.1 Arquitectura
1.3.1.1 Elegir el modelo de objetos correcto para el proyecto
Para elegir el modelo de objetos correcto para el proyecto, debe comprender los métodos prácticos para trabajar con el control CrystalReportViewer y saber cómo interactúa este control con el resto de los modelos de objetos.
Nota
En esta documentación, un modelo de objetos hace referencia a una clase básica y las clases que la rodean,
que forman un modelo de programación. En SAP Crystal Reports estos modelos de objetos se basan en una clase básica que encapsula un archivo de definición de informes. Esa clase básica y el modelo de objetos que la rodea permiten la interacción mediante programación con el informe.
Método práctico para trabajar con el control CrystalReportViewer
Una aplicación Web eficaz diferencia claramente su nivel de presentación de la lógica de negocios subyacente.
El diseño del control ASP.NET promueve de forma natural este modelo. Encapsula la información de presentación en el control y, a continuación, lo enlaza a un objeto subyacente o a un modelo de objetos que lleva a cabo la lógica de negocios.
CrystalReportViewer es un control .NET que sigue esta arquitectura. Funciona como objeto de presentación de Web Form o Windows Form (el nivel de presentación), y se puede enlazar a cualquiera de los siguientes modelos de objetos: Modelo de objetos ReportDocument Modelo de objetos ReportClientDocument (Report Application Server) Modelo de objeto InfoObject (SAP Crystal Reports Server o plataforma SAP BusinessObjects Business
Intelligence)
En un caso de método práctico, el control CrystalReportViewer enlaza a uno de los modelos de objetos que lleva acabo la lógica de negocios, normalmente para la manipulación del informe.
En este caso, el control CrystalReportViewer limita su interacción mediante programación para modificar sólo la configuración de presentación; por ejemplo, ocultar o mostrar la barra de herramientas del visor o un botón de esa barra de herramientas.
Modelo de objetos CrystalReportViewer
El control CrystalReportViewer contiene propiedades y métodos que permiten la interacción con la presentación de los informes. Asimismo tiene unas pocas propiedades y métodos para interactuar con los informes enlazados al control. Estas propiedades y métodos constituyen un modelo de objetos limitado.
Algunos casos de enlaces de informes se basan en el modelo de objetos CrystalReportViewer. En estos casos, el control CrystalReportViewer se enlaza directamente a un informe (por ejemplo, se pasa una cadena de ruta al informe de un directorio de archivos), sin encapsular primero el informe en ningún modelo de objetos. En dichos casos, puesto que el control CrystalReportViewer encapsula el informe directamente, se debe basar en el modelo de objetos limitado del control para interactuar con el informe mediante programación.
Pero en la mayoría de los casos de enlace, es desalentador utilizar CrystalReportViewer como modelo de objetos. En su lugar, utilice el modelo de objetos ReportDocument, por las siguientes razones: El modelo de objetos CrystalReportViewer genera el riesgo de crear conflictos entre los modelos de objetos.
No mezcle el modelo de objetos CrystalReportViewer con otros modelos.
El modelo de objetos CrystalReportViewer proporciona una interacción limitada con los informes; contiene un pequeño subconjunto de las funciones disponibles en el modelo de objetos ReportDocument.
El modelo de objetos CrystalReportViewer difumina la separación del nivel de presentación y de la lógica de
negocios subyacente del código.
El modelo de objetos ReportDocument
ReportDocument es un modelo de objetos más eficaz y completo que CrystalReportViewer. Se incluye con el SDK de SAP Crystal Reports .NET y proporciona mayores posibilidades de manipular los informes en el código.
¿Cuál es el modelo de objetos que se debe utilizar? Si no va a actualizar a SAP Crystal Reports Server ni a la plataforma SAP BusinessObjects Business Intelligence, el modelo de objeto ReportDocument es el modelo de objeto recomendado para el trabajo de desarrollo con el SDK de SAP Crystal Reports.
Nota
En SAP Crystal Reports 10 o superior y SAP Crystal Reports para Visual Studio 2005, el modelo de objetos ReportDocument se ha adaptado al modelo de objetos ReportClientDocument para facilitar la actualización a un servidor.
1.3.1.2 Evitar mezclar los modelos de objetos
No mezcle el modelo de objetos CrystalReportViewer con otros modelos.
El uso del control CrystalReportViewer en su función de modelo de objetos limitado funciona correctamente, siempre y cuando lo enlace directamente al informe con una cadena de ruta sencilla.
Pero si lo encapsula en uno de los demás modelos de objetos (como ReportDocument o ReportClientDocument) y, a continuación, enlaza el control a ese modelo de objetos, deje de utilizar inmediatamente el modelo de objetos
CrystalReportViewer. El modelo limitado que se proporciona con el control CrystalReportViewer se convierte enredundante respecto al modelo de objetos más eficaz al que está enlazado. Además, la configuración que se aplica al modelo de objetos CrystalReportViewer es visible para el otro modelo de objetos, lo que podría dar lugar a un comportamiento y excepciones inesperados.
Por ejemplo, quizá prefiera utilizar el modelo de objetos ReportDocument para exportar o imprimir un informe mensual desde el servidor. Si ha establecido un parámetro mensual en este informe con el modelo de objetos CrystalReportViewer, puede que experimente problemas. El modelo de objetos ReportDocument no puede ver la configuración de parámetros aplicada en el modelo de objetos CrystalReportViewer. Intentará exportar o imprimir el informe sin darse cuenta de la existencia de esa configuración de parámetro mensual y, a continuación, mostrará el mes equivocado o incluso provocará una excepción.
La mejor respuesta es limitar el uso del control CrystalReportViewer para informar de la configuración de presentación sólo cuando el control se haya enlazado a uno de los modelos de objetos subyacentes.
1.3.1.3 SAP Crystal Reports Designer incrustado
SAP Crystal Reports Designer incrustado crea o modifica informes. Está formado por una interfaz gráfica para elusuario para el diseño de informes WYSIWYG, y una serie de asistentes que simplifican la conectividad, la ordenación, el agrupamiento de los datos y los problemas de diseño de informes complejos adicionales. SAP Crystal Reports Developer incluye una versión mejorada del diseñador incrustado que permite crea potentes informes y aplicaciones de elaboración de informes. El diseñador incrustado que se incluye con SAP Crystal Reports, versión para programadores de Microsoft Visual Studio contiene muchas de las funciones de SAP Crystal Reports Designer.
Función de SAP Crystal Reports Designer incrustado en la arquitectura
SAP Crystal Reports Designer incrustado se incluye en la descripción de la arquitectura porque su función es fundamental para SAP Crystal Reports, versión para programadores de Microsoft Visual Studio: crea los archivos de informe que se mostrarán. Sin embargo, la función de SAP Crystal Reports Designer incrustado es una función en tiempo de diseño. La función que implica la presentación e interacción con los informes, que se produce en tiempo de ejecución, pertenece al SDK de SAP Crystal Reports. Por lo tanto, aunque el diseñador incrustado crea los informes que se utilizan en la arquitectura, no forma parte de la propia arquitectura.
1.3.1.4 Controles de visores de informes
SAP Crystal Reports, versión para programadores de Microsoft Visual Studio incluye controles de forma estándar para visualizar informes. Cada control encapsula compleja información de diseño de informe en un objeto GUI dentro del cuadro de herramientas.
Se incluyen dos controles:
El control CrystalReportViewer. Este control muestra el informe con un diseño basado en páginas, con la posibilidad de moverse entre ellas.
Control CrystalReportPartsViewer.
El control muestra información de resumen de informe en una pequeña ventana al estilo de un portal, con la posibilidad de profundizar en el informe a través de una serie de partes vinculadas.
Cada control se usa para mostrar un informe arrastrando y soltando el control desde el Cuadro de herramientas en el formulario Web o para Windows y, a continuación, asignando la propiedad ReportSource de dicho control a un informe.
¿Cómo utilizo los controles de visores de informes? [página 43]
1.3.1.5 Modelos de objetos
SAP Crystal Reports, versión para programadores de Microsoft Visual Studio proporciona un SDK que contiene dos modelos de objetos. Con licencia adicional, el SDK se expande para contener cuatro modelos de objetos.
Los controles del visor de informes proporcionan el punto de entrada al SDK. La razón es que el visor de informes muestra los informes mediante el enlace a un objeto de informe; todos los modelos de objetos del SDK exponen y manipulan objetos de informe.
Cada modelo de objetos proporciona niveles de mayor eficacia y complejidad: El modelo de objetos más sencillo esCrystalReportViewer .
El controlCrystalReportViewer de un formulario Web Forms o Windows Forms tiene, por definición, una clase subyacente del mismo nombre. Esta clase CrystalReportViewer expone propiedades y métodos para modificar la funcionalidad de presentación del control, así como para interactuar con las clases que administran inicios de sesión, parámetros y fórmulas de selección de base de datos. Este conjunto de clases es el modelo de objetos más sencillo. La clase CrystalReportViewer existe de dos formas distintas: una en un espacio de nombres de Windows y otra en un espacio de nombres Web. Por tanto, muchos elementos de este modelo de objetos se duplican en ambos espacios de nombres, con algunas variaciones para admitir las diferencias de las plataformas Windows y Web. Las clases de este modelo de objetos se incluyen en el espacio de nombres CrystalDecisions.Web para la
versión de formularios Web Forms de este control o en el espacio de nombres CrystalDecisions.Windows.Forms para la versión de formularios Windows Forms del control.
Un modelo de objetos más amplio esReportDocument . La clase ReportDocument es una puerta de enlace al conjunto de clases del espacio de nombres Engine , que incluyeDatabase , DataDefinition , ExportOptions , PrintOptions , ReportDefinition , ReportOptions ySummaryInfo . Se trata de un conjunto más completo de clases que proporcionan posibilidades más eficaces de personalización e interacción con el informe. Las clases de este modelo de objetos se incluyen en el espacio de nombres CrystalDecisions.CrystalReports.Engine .
Los siguientes modelos de objetos están disponibles mediante actualización:
Un modelo de objetos con mayor posibilidad de modificación de informes denominadoReportClientDocument . Esta clase funciona como puerta de enlace a un modelo de objetos mucho más amplio formado por muchas clases de varios espacios de nombres. Expone la estructura completa del informe mediante el SDK, de tal forma que se pueden crear o modificar todos los aspectos del informe mediante programación en tiempo de ejecución. Las clases de este modelo de objetos se incluyen en el grupo de espacios de nombres CrystalDecisions.ReportAppServer . El modelo de objetosReportClientDocument se suministra con un Report Application Server (RAS), para el que se requiere una licencia adicional. Hay disponible un servidor de aplicaciones de informes con SAP Crystal Reports Server y la plataforma SAP BusinessObjects Business Intelligence.
Un modelo de objetos más completo para interactuar con las funciones en el nivel de plataforma SAP Crystal Reports Server o la plataforma SAP BusinessObjects Business Intelligence, denominado
InfoObject. Se suministra con la licencia de SAP Crystal Reports Server o de la plataforma SAP BusinessObjects Business Intelligence. Esta clase funciona como puerta de enlace al modelo completo de objetos de plataforma SAP Crystal
Reports Server o de la plataforma SAP BusinessObjects Business Intelligence.Las clases de este modelo de objetos se incluyen en el grupo de espacios de nombres CrystalDecisions.Enterprise .
Nota
El modelo de objetos InfoObject se proporciona sólo con SAP Crystal Reports Server y la plataforma SAP BusinessObjects Business Intelligence, para la que se requiere una licencia adicional.
Elegir el modelo de objetos correcto para el proyecto [página 31] Comparar soluciones de elaboración de informes de SAP BusinessObjects Business Intelligence [página 65]
1.3.1.5.1 Modelo de objetos CrystalReportViewer
La clase CrystalReportViewer tiene dos funciones: En el formulario Web Forms o Windows Forms, CrystalReportViewer se expone como control .NET que se
puede agregar al formulario para mostrar el informe. Para obtener información específica sobre su función como control .NET, veaControles de visores de informes [página 34].
En el código subyacente del formulario Web Forms o Windows Forms, la clase CrystalReportViewer proporciona el modelo de objetos más sencillo del SDK. Exploraremos ese modelo de objeto más adelante en esta sección.
La forma más sencilla de colocar un informe en un formulario Web Forms o Windows Forms es agregar el control CrystalReportViewer al formulario y, a continuación, en la clase de código subyacente, asignar la ruta del informe como cadena a la propiedad ReportSource de la clase CrystalReportViewer.
Si asigna la ruta del informe directamente al control (en vez de colocar el informe dentro de un modelo de objetos más complejo, como ReportDocument o ReportClientDocument), restringe la interfaz a sólo el modelo de objetos
más sencillo: CrystalReportView
Comparación del modelo de objetos CrystalReportViewer
CrystalReportViewer tiene dos diagramas de modelo de objetos, ya que se vuelve a utilizar el mismo nombre de control y de clase (y, por tanto, su modelo de objetos subyacente) en aplicaciones para Windows y Web. Por consiguiente, el modelo de objetos CrystalReportViewer se repite (con variaciones mínimas) en dos espacios de nombres distintos.
La versión de Windows deCrystalReportViewer incluye las clases y los eventos principales compartidos por las versiones de Windows y Web del modelo de objetos.
La versión Web del modelo de objetos CrystalReportViewer incluye las mismas clases y eventos que la versión de Windows, pero, además, tiene los siguientes eventos relacionados con la forma en que se carga la página ASPX.
Controles de visores de informes [página 34] Enlazar informes al modelo de objetos CrystalReportViewer [página 166]
1.3.1.5.2 Modelo de objetos ReportDocument La clase ReportDocument proporciona un modelo de objetos más completo para el SDK que el modelo de objetos CrystalReportViewer .
La clase ReportDocument forma parte del espacio de nombres CrystalDecisions.CrystalReports.Engine . Funciona como puerta de enlace a un conjunto de clases del espacio de nombres Engine, que proporciona más herramientas para la manipulación de un informe mediante programación.
El modelo de objetos ReportDocument
En la sección anterior, aprendió a trabajar con el modelo de objetosCrystalReportViewer básico asignando la cadena de la ruta de un informe directamente al control CrystalReportViewer .
En el siguiente nivel del modelo de objetos, utilice el modelo de objetosReportDocument para encapsular el informe dentro de una instancia de ReportDocument , antes de que se asigne al control. De esta forma, se proporciona acceso al modelo de objetos más complejo y eficaz deReportDocument .
Nota
Puesto que ambos modelos de objetos están implicados en este proceso ( CrystalReportViewer para cargar y mostrar el informe,ReportDocument para encapsularlo y manipularlo), es fácil confundir las funciones de ambos modelos de objetos. Una vez que el modelo de objetosReportDocument se ha utilizado para encapsular el informe, se debe restringir cualquier manipulación del informe a ese modelo. Si trata de utilizar las propiedades y los métodos de CrystalReportViewer para manipular el informe, los dos modelos de objetos entran en conflicto y genera un comportamiento inesperado.
Una vez que ha introducido un modelo de objetos adicional, restrinja el uso del código de CrystalReportVi ewer sólo para establecer propiedades de pr esentación.
ReportDocument y ReportClientDocument (RAS)
En SAP Crystal Reports 9, ambos modelos de objetos eran totalmente independientes. En SAP Crystal Reports 10y versiones posteriores, se ha eliminado la separación básica entre los modelos de objetos. El modelo de objetos ReportDocument ahora funciona como proxy para (un subconjunto de) funcionalidad desde el modelo de objetos ReportClientDocument .
SAP Crystal Reports 2008 permite acceder a una versión limitada del modelo de objetos ReportClientDocument mediante la propiedad ReportDocument.ReportClientDocument .
Tutoriales del modelo de objetos ReportDocument [página 327] Enlazar informes al modelo de objetos ReportDocument [página 194] Modelo de objetos CrystalReportViewer [página 36] Elegir el modelo de objetos correcto para el proyecto [página 31]
1.3.1.5.3 Modelo de objetos ReportClientDocument (RAS)
El modelo de objetosReportClientDocument proporciona el modelo de objetos más eficaz y completo para manipular informes. Este modelo de objetos sólo está disponible como parte de un servidor de aplicaciones de informes (RAS), que puede ser un servidor de aplicaciones de informes no administrado (RAS) o un servidor de aplicaciones de informes administrado (BOE).
El modelo de objetosReportClientDocument está formado por muchas clases de diversos espacios de nombres. El espacio de nombres lleva el prefijoCrystalDecisions.ReportAppServer . Este modelo de objetos expone toda la estructura del informe en el SDK, para permitir crear, modificar y guardar cambios mediante programación en todos los aspectos del informe en tiempo de ejecución.
Una instancia de ReportClientDocument consta de un informe que se puede modificar con programación mediante sus propiedades de clase. Estas propiedades están vinculadas co n una serie de bibliotecas del SDK que
contienen controladores, modelos de definición de datos y modelos de definición de informes: Repor tDefinition corresponde a la apariencia del informe, como se muestra en SAP Crystal Reports
Designer. DataDefinition corresponde al explorador de campos de SAP Crystal Reports Designer. RowsetController corresponde a los valores de datos procesados de cada fila de detalles, cuando se
consulta el informe en tiempo de ejecución.
Las instancias de ReportClientDocument pueden ser instancias de uno de estos objetos:
Un archiv

Documents

Manual de Instalación de SAP Crystal Reports Papa Visual Studio Para Programadores