manual del desarrollador del sdk .net de sap crystal reports para

SAP Crystal Reports, versin para programadores de Microsoft Visual StudioVersin 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.1 Inicio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Qu es SAP Crystal Reports, versin para programadores de Microsoft Visual Studio?. . . . . . . . . . . 4Migrar la aplicacin SAP Crystal Reports .Net. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

1.2 Configurar el entorno de desarrollo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Configuracin del sistema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Configuracin de proyectos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

1.3 Aspectos fundamentales del SDK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Arquitectura. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Control CrystalReportViewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Cul es el enfoque de persistencia que se debe usar con SAP Crystal Reports?. . . . . . . . . . . . . . . 53Escalar la aplicacin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Usar SAP Crystal Reports en una matriz de servidores o de procesos Web. . . . . . . . . . . . . . . . . . . .74Trabajar con Crystal Reports como servicio web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Consideraciones sobre la seguridad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

1.4 Uso del SDK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Imprimir un informe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Exportar un informe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120Filtrar datos con parmetros o frmulas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Establecer el origen de datos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147Visualizar un informe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159Personalizar el control CrystalReportViewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218Uso de los informes de slo lectura de SAP Crystal Reports (RPTR). . . . . . . . . . . . . . . . . . . . . . . 235

1.5 Tutoriales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236Tutoriales del modelo de objeto CrystalReportViewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236Tutoriales del modelo de objetos ReportDocument. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327Tutoriales de cdigo reducido en Visual Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483Tutoriales de conectividad de datos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523Otros tutoriales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560

1.6 Implementacin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588Componentes de implementacin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588Implementacin para Visual Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599

1.7 Crear informes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .617Usar SAP Crystal Reports Designer incrustado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618Referencia de frmulas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751Referencia 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 StudioContenido

1.8 Glosario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 966

Manual del desarrollador del SDK .Net de SAP Crystal Reports para Visual StudioContenido

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 diseada para ayudarle a desarrollar su propia aplicacin Web o para Windows con el SDK de SAP Crystal Reports .NET. Incluye tutoriales y referencias de programacin que puede usar para implementar el SDK de SAP Crystal Reports .NET.

1.1.1 Qu es SAP Crystal Reports, versin para programadores de Microsoft Visual Studio?

SAP Crystal Reports, versin para programadores de Microsoft Visual Studio permite crear informes complejos y profesionales en un programa basado en GUI. Despus puede conectar el informe a casi todos los orgenes de base de datos, as como a datos proxy, como un conjunto de resultados (por ejemplo, un ADO.NET DataSet). Los asistentes del diseador de GUI le permiten establecer los criterios de formato, agrupamiento y grficos, etc.

Puede almacenar el informe en una aplicacin Web o para Windows, con uno de los controles de visores deSAP Crystal Reports. La presentacin de informes, tanto en clientes Windows como en HTML 4.0 es muy interactiva y proporciona funciones como la profundizacin en grficos, la exploracin de informes y la bsqueda de texto.

SAP Crystal Reports, versin para programadores de Microsoft Visual Studio incluye un SDK extenso. Puede utilizarlo para interactuar con el informe mediante programacin en tiempo de ejecucin, usando uno de los cuatro modelos de objetos posibles:

CrystalReportViewer, el modelo de objetos ms sencillo. ReportDocument, el modelo de objetos ms completo. ReportClientDocument, el modelo de objetos ms completo. Este modelo de objetos est disponible con un

servidor RAS. InfoObject, un modelo de objetos muy eficaz para la programacin y configuracin de informes en el marco

de SAP Crystal Reports Server o la plataforma SAP BusinessObjects Business Intelligence.

NotaLos modelos de objetos CrystalReportViewer y ReportDocument estn disponibles con todas las versiones de SAP Crystal Reports, versin para programadores de Microsoft Visual Studio. Los modelos de objetos ReportClientDocument e InfoObject requieren una licencia actualizada. Vea Soluciones de elaboracin de informes de SAP BusinessObjects Business Intelligence [pgina 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 StudioManual 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 actualizacin a SAP Crystal Reports Server puede tener acceso a sus informes a travs del

servidor RAS. Mediante la actualizacin a la plataforma SAP BusinessObjects Business Intelligence, puede tener acceso a

sus informes a travs 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 estn disponibles con SAP Crystal Reports, versin para programadores de Microsoft Visual Studio:

Funcin Descripcin

Miembros calculados en grficos de tabla de referencias cruzadas

Puede agregar filas o columnas a un grfico de tabla de referencias cruzadas insertando un miembro calculado. Estas filas o columnas pueden contener clculos 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 lneas para mejorar la legibilidad). Tiene total flexibilidad para disear sus propias frmulas de clculo 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 vnculo a un objeto Flash en cualquier seccin de un informe de SAP Crystal Reports.

Resmenes incrustados en tablas de referencias cruzadas Puede agregar un clculo adicional a un grfico de tabla de referencias cruzadas insertando un resumen incrustado. Los resmenes incrustados no agregan filas ni columnas a la tabla de referencias cruzadas. En lugar de ello, hacen que aparezcan clculos adicionales en cada celda de la tabla de referencias cruzadas. Por ejemplo, en un informe que muestra las ventas regionales, podra insertar un clculo para cada regin que mostrase el porcentaje de ventas totales del pas.

Vista previa editable Con SAP Crystal Reports Designer puede visualizar un informe en la ficha de diseo o la ficha de vista previa. En la ficha Vista previa dispone de las mismas opciones de formato que en la ficha Diseo. Sin embargo, en la ficha Vista previa trabaja con los datos reales. En lugar de un marco de



Funcin Descripcin

campo que representa varios valores de campo, en el informe se muestran los valores reales.

Cdigos de barras con formato SAP Crystal Reports Designer incluye las frmulas y fuentes necesarias para admitir cdigos de barras Code39. Puede usar la opcin Dar formato al campo para cambiar el aspecto de un cdigo de barras.

Existen varias razones para cambiar el aspecto de un cdigo de barras, como:

Para cambiar el tamao de modo que el cdigo de barras no sea demasiado grande o pequeo como para leerlo con un escner.

Para mostrar el cdigo de barras en un color diferente.

Ordenacin de campos interactiva Puede disear el informe de modo que los usuarios puedan modificar un campo o una direccin de ordenacin sin necesidad de actualizar la informacin de la base de datos. Puede hacerlo agregando un Control de ordenacin al informe.

Un Control de ordenacin es especialmente til por diversos motivos:

Permite que los usuarios ordenen los datos de un informe para analizarlos sin necesidad de abandonar el lienzo 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 conexin o derechos para acceder a la base de datos en el momento de la visualizacin.

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 arrastrndolos y colocndolos donde desee que se muestren. Tambin puede arrastrar archivos de informes desde Windows Explorer y colocarlos en la carpeta que desee en Workbench.



1.1.2 Migrar la aplicacin SAP Crystal Reports .Net

En esta seccin se ofrece informacin sobre la migracin de la aplicacin SAP Crystal Reports .Net a SAP Crystal Reports, versin para programadores de Microsoft Visual Studio.

NotaSAP Crystal Reports, versin 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, versin para programadores de Microsoft Visual Studio no se incluye en la aplicacin SAP Crystal Reports Designer.



Opciones de migracin en las diferentes versiones de SAP Crystal Reports

Este diagrama muestra las diferentes opciones de migracin entre versiones de SAP Crystal Reports.



Migrar a SAP Crystal Reports, versin para programadores de Microsoft Visual Studio

SAP Crystal Reports, versin para programadores de Microsoft Visual Studio actualiza automticamente los proyectos anteriores a la versin actual. Si un proyecto incluye referencias a componentes anteriores, se solicita al usuario que realice una actualizacin.

Al hacer clic en el botn S, los proyectos y sus archivos se actualizan a la versin actual de SAP Crystal Reports. Si se hace clic en el botn 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 tendrn esa funcionalidad determinada.

NotaSi estn 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 actualizacin o la aplicacin de soluciones.

Informacin relacionada

Soluciones de elaboracin de informes de SAP BusinessObjects Business Intelligence [pgina 64]

1.1.2.1 Problemas de migracin

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 funcionarn si el proyecto tiene como destino .NET 4.x Framework. Se produce el siguiente error: "Informacin adicional: se ha creado un conjunto de modo combinado frente a la versin 'v2.0.50727' del tiempo de ejecucin y no puede cargarse en el tiempo de ejecucin 4.x sin informacin de configuracin adicional."

Este problema puede solucionarse actualizando el archivo .config de los proyectos. Agregue las siguientes lneas de cdigo a la seccin del archivo:

1.1.2.2 Limitaciones de 64 bits

SAP Crystal Reports, versin 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 geogrfica. Componentes de fuente de cdigo de barras Azalea.

1.2 Configurar el entorno de desarrollo

En esta seccin se ofrecen instrucciones detalladas sobre cmo instalar y configurar el entorno de implementacin y cmo crear un sitio Web o proyecto Windows en SAP Crystal Reports, versin para programadores de Microsoft Visual Studio.

1.2.1 Configuracin del sistema

En esta seccin se proporciona una vista general de cmo 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, versin 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, versin para programadores de Microsoft Visual Studio, deber verificar que la versin 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 elaboracin de informes de SAP BusinessObjects Business Intelligence [pgina 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 este documento son especficos de versin. Para obtener el mximo partido de este documento, determine en primer lugar qu versin de SAP Crystal Reports tiene instalada.

1.2.1.1.2.1 Para determinar qu versin de SAP Crystal Reports est ejecutando:

Procedimiento

1. Vaya a GAC (cach de ensamblados global) en C:\WINNT\Assembly o C:\Windows\Assembly.2. Busque el archivo CrystalDecisions.CrystalReports.Engine.

NotaSi ha instalado ms de una versin 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 columna Versin que aparece en la ventana.

sta es la "versin de ensamblado".4. Busque el nmero ms alto de un ensamblado determinado.5. Compare la versin del ensamblado con el nmero de versin en el grfico de versiones de SAP Crystal

Reports.

1.2.1.1.2.2 Versiones de SAP Crystal Reports

Producto Versin de ensamblado

SAP Crystal Reports, versin para programadores de Microsoft Visual Studio (.NET 4.0 Framework)

13.0.2000.0

SAP Crystal Reports 2008 (.NET 2.0 Framework) 12.0.2000.0

SAP Crystal Reports 2008 (.NET 1.1 Framework) 12.0.1100.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



Producto Versin de ensamblado

SAP Crystal Reports 9 9.2.3300

SAP Crystal Reports para Visual Studio 2003 9.1.5000

SAP Crystal Reports 2008 y SAP Crystal Reports 2008 SP1 usan el mismo nmero de versin de ensamblado. Para comprobar si tiene instalado SAP Crystal Reports 2008 SP1, compruebe que la versin 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, versin 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, versin 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, versin 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 botn derecho en el nombre de proyecto en negrita y haga clic en Agregar Nuevo elemento .

3. En el cuadro de dilogo Agregar nuevo elemento, seleccione Crystal Reports.4. En el campo Nombre, especifique Test.rpt y, a continuacin, haga clic en Agregar.

NotaSi es la primera vez que usa SAP Crystal Reports Designer incrustado, se le pedir que acepte el Contrato de licencia para el usuario final. Despus de esto, se abrir el cuadro de dilogo Servicio de actualizaciones. Si ha abierto antes SAP Crystal Reports Designer incrustado, deber abrir manualmente el cuadro de dilogo Servicio de actualizaciones.

Se abrir SAP Crystal Reports Designer incrustado y mostrar el nuevo informe.5. Si no aparece el cuadro de dilogo Servicio 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 dilogo Servicio de actualizaciones, haga clic en S.



Se cargar el sitio Web del Servicio de actualizaciones de SAP Crystal Reports, que dispone de un vnculo 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. Abra Test.rpt.

Se iniciar SAP Crystal Reports Designer incrustado y mostrar el informe.10. En el men Crystal Reports, haga clic en Comprobar actualizaciones.

Se abrir el Servicio de actualizaciones y buscar actualizaciones. Puede aceptar o rechazar las actualizaciones disponibles.

1.2.1.1.4 Cdigo de clave de producto de SAP Crystal Reports

El cdigo de clave de producto es una cadena alfanumrica con una longitud de 19 dgitos o caracteres. En SAP Crystal Reports, versin para programadores de Microsoft Visual Studio, al crear proyectos de implementacin que usen Windows Installer, es posible que necesite un cdigo 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 aplicacin 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, implementacin y Web.

En esta seccin se explica la configuracin que tendr que comprobar antes de crear una aplicacin de SAP Crystal Reports .NET.


Versiones compatibles de Visual Studio [pgina 10]



1.2.1.2.1 Comprobar que SAP Crystal Reports est instalado

Contexto

Para verificar que el componente SAP Crystal Reports de Visual Studio est instalado, asegrese de que SAP Crystal Reports aparece en el cuadro de dilogo 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.

NotaLos 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 dilogo Agregar nuevo elemento, desplcese 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 funcionarn sin conflictos.

1.2.1.2.2.1 Ubicacin predeterminada del directorio de visores

Si ha instalado SAP Crystal Reports usando la configuracin y las rutas de archivos predeterminadas, el directorio virtual de visores estar configurado de la siguiente forma:



Tabla 1:

Versin Framework Ruta de archivos

SAP Crystal Reports, versin para programadores de Microsoft Visual 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, versin para programadores 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 en Herramientas administrativas y, a continuacin, haga doble clic en Internet Information Services.

2. En el cuadro de dilogo Internet Information Services, expanda el nodo Sitios Web y, a continuacin, el nodo Sitio Web predeterminado.

3. Busque todas las carpetas que contengan una carpeta crystalreportsviewers13.4. Haga clic con el botn derecho en cada carpeta crystalreportsviewers13 y seleccione Propiedades.5. En el cuadro de dilogo Propiedades, confirme que la ruta local est configurada correctamente para su

versin 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 .



http://help.sap.com/disclaimer?site=http://www.sdn.sap.com/irj/boc/downloads

1.2.2 Configuracin de proyectos

Esta seccin constituye un punto de aprendizaje clave tanto para programadores de nivel avanzado como intermedio. Aqu se muestran las mejores prcticas recomendadas para continuar con la creacin y la configuracin de un nuevo proyecto para Windows o un proyecto/sitio Web con SAP Crystal Reports, versin para programadores de Microsoft Visual Studio.

El proyecto nuevo que se crea sirve tambin como requisito previo para los tutoriales suministrados junto con esta ayuda en lnea.

1.2.2.1 Configuracin de sitios Web en Visual Studio

En esta seccin se describe la configuracin de sitios Web en Visual Studio. Este sitio web que se crea sirve tambin como requisito previo para los tutoriales de codificacin suministrados junto con esta ayuda en lnea.

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 en Nuevo sitio Web.3. En el cuadro de dilogo Nuevo sitio Web, haga clic en Sitio Web ASP.NET.4. En la lista desplegable Ubicacin, seleccione Sistema de archivos.5. En la lista desplegable Idioma, seleccione el idioma de codificacin que desea usar.6. En el campo de texto Ubicacin indique la ruta de directorio C:\WebSites\, seguida del nombre del

proyecto.

C:\WebSites\MiProyecto 7. Haga clic en Aceptar.

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 seccin puede configurar la clase de cdigo subyacente del formulario Web Form.



NotaLos trminos "formulario Web", "pgina ASPX" y "Default.aspx" son intercambiables.

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 en Cdigo.

Se abrir la clase de cdigo subyacente. La clase se denomina _Default. El archivo de la clase se llama Default.aspx.cs o Default.aspx.vb.

NotaSi su pgina Default.aspx predeterminada se cre con cdigo en lnea, no coloque dicho cdigo en un archivo independiente. En tal caso, elimine la pgina ASPX y vuelva a crearla. Al crear la pgina ASPX, active la casilla de verificacin "Colocar cdigo en archivo independiente".

3. Si utiliza Visual Basic para escribir la clase, escriba "Option Strict On" en la parte superior de la clase.

NotaComo prctica recomendada, se sugiere establecer Option Strict On al comienzo de cualquier clase de Visual Basic del sitio Web. Cuando se escribe cdigo, se impone el uso de las prcticas ms recomendables, con declaraciones de variables con tipos declarados y una proyeccin vlida. Ambos se comprueban durante la compilacin. Las comprobaciones de cumplimiento estricto realizadas durante la compilacin pueden reducir las excepciones en tiempo de ejecucin.

1.2.2.1.2.2 Para agregar instrucciones Imports/Using a los espacios de nombres de referencia

Procedimiento

1. Abra la pgina Default.aspx.2. En el men Ver, haga clic en Cdigo.

Aparece la clase de cdigo subyacente del formulario Web Form.3. Sobre la firma de clase, agregue una declaracin "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.EngineImports CrystalDecisions.Shared using CrystalDecisions.CrystalReports.Engine;using CrystalDecisions.Shared;



NotaLas clases de estos dos ensamblados se usan habitualmente en todos los tutoriales. Si hay ensamblados adicionales que pueda necesitar ocasionalmente en tutoriales especficos, se le indicar que los agregue durante dicho tutorial.

1.2.2.1.2.3 Para agregar un mtodo de ayuda privado para el cdigo de configuracin de SAP Crystal Reports

Procedimiento

En la clase, agregue un nuevo mtodo de ayuda de mbito privado sin valor de devolucin, denominado ConfigureCrystalReports(). Private Sub ConfigureCrystalReports()End Sub private void ConfigureCrystalReports(){}

El mtodo ConfigureCrystalReports() permite a los usuarios interactuar con el informe en tiempo de ejecucin. Adems, controla la interaccin mediante programacin con el informe.

Pasos siguientes

A continuacin, agregue un controlador de eventos Page_Init desde el que se llamar al mtodo ConfigureCrystalReports(). Si se llama al mtodoConfigureCrystalReports() desde este controlador de eventos, se garantiza que el cdigo de configuracin de informes de Crystal se ejecute durante el evento de inicializacin de pginas.

1.2.2.1.2.4 Para agregar un controlador de eventos Page_Init a la clase de cdigo subyacente

Contexto

Normalmente el controlador de eventos Page_Load se usa para especificar cdigo de configuracin de Web Forms en una aplicacin Web de ASP.NET para que el cdigo se llame durante el evento Page.Load. Sin embargo, el cdigo de configuracin del informe de Crystal se debe llamar antes durante el evento Page.Init.



Procedimiento

1. Agregue el evento Page_Init al cdigo.

Si est codificando en Visual Basic, seleccione Eventos de pgina en la lista desplegable de la parte superior izquierda y, a continuacin, el evento Init en lista desplegable de la parte superior derecha. El controlador de eventos Page_Init se agregar a la clase subyacente. Private Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.InitEnd Sub

Si est codificando en C#, escriba el control de eventos Page_Init con la siguiente sintaxis exacta.

private void Page_Init(object sender, EventArgs e){}

NotaEn un formulario Web de C# en Visual Studio 2005 o posterior, los controladores de eventos Page_Init, Page_Load o Page_PreRender de la clase de cdigo subyacente se conectan automticamente al evento Init, Load o PreRender. La firma del control de eventos deber coincidir exactamente para que sea llamada.

Esta caracterstica ocurre cuando la directiva Page, que se encuentra en la parte superior de la pgina ASPX en la vista HTML, tiene el parmetro AutoEventWireup establecido como true.

Las versiones anteriores de Visual Studio .NET siempre establecan la directiva AutoEventWireup Page en False, pero en los formularios Web de C# en Visual Studio 2005 y posterior la directiva AutoEventWireup Page se establece en True de forma predeterminada.

2. En el controlador de eventos Page_Init de Visual Basic o C#, indique una llamada al mtodo de auxiliar ConfigureCrystalReports(). ConfigureCrystalReports() ConfigureCrystalReports();

3. En el men Archivo, haga clic en Guardar todo.

1.2.2.1.3 Para agregar un control de CrystalReportViewer a un sitio Web

Procedimiento

1. Abra la pgina Default.aspx.2. Haga clic en el botn Diseo situado en la parte inferior de la vista del formulario.3. En el Cuadro de herramientas, abra el nodo Informes para buscar el control CrystalReportViewer.



NotaEn las versiones anteriores de SAP Crystal Reports, versin para programadores de Microsoft Visual Studio, el control CrystalReportViewer apareca en el nodo Crystal Reports.

4. Arrastre y coloque el control CrystalReportViewer en el formulario Web Forms.5. En el men Archivo, haga clic en Guardar todo.

Resultados

Cuando se agrega un control CrystalReportViewer a su aplicacin, se agregarn de forma automtica a su proyecto referencias a los ensamblados de SAP Crystal Reports.

1.2.2.1.4 Configuracin del archivo Web.Config

Un archivo Web.Config de una aplicacin Web ASP.NET almacena configuracin global, como informacin de conexin de base de datos, referencias de ensamblados y tratamiento de errores. Este archivo se escribe en XML y su elemento raz siempre debe ser . Se trata de una configuracin avanzada y es opcional.

Los elementos siguientes son exclusivos de SAP Crystal Reports y se pueden agregar al archivo Web.Config.

NotaLos nmeros de versin pueden cambiar segn el producto que tenga.

NotaEn .NET 2.0 y versiones superiores, la etiqueta section del archivo Web.Config debe utilizar la siguiente sintaxis:

CrystalImageCleaner

El proceso CrystalImageCleaner elimina automticamente las imgenes generadas que ha representado el control CrystalReportViewer. Esta configuracin permite establecer el intervalo de tiempo entre la exploracin del directorio de imgenes y la duracin mnima de los archivos antes de que se eliminen. Este elemento se agrega



automticamente al archivo Web.Config cuando se agrega el control CrystalReportViewer al sitio Web. Esto corresponde a la clase CrystalImageCleaner.

CrystalImageCleaner-Sleep inicializa el perodo de tiempo en milisegundos que el sistema de limpieza de imgenes permanece inactivo antes de buscar y limpiar los archivos de imagen del directorio de imgenes dinmicas.

CrystalImageCleaner-Age inicializa la duracin mnima en milisegundos de un archivo antes de que se elimine.

CrystalImageCleaner-AutoStart controla el proceso CrystalImageCleaner. El sistema de limpieza de imgenes limpia las imgenes temporales que se han creado al visualizar un informe.

NotaSlo se puede iniciar un sistema de limpieza en un nico proceso de trabajo ASP.NET.

CrystalImageHandler

El elemento CrystalImageHandler muestra todas las imgenes dinmicas 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 imgenes solamente. Si no tiene la configuracin CrystalImageHandler en el archivo Web.Config, no se mostrarn las imgenes del sitio web. Este elemento se agrega automticamente al archivo Web.Config cuando se agrega el control CrystalReportViewer al sitio Web.

documentView

El elemento documentView controla el aspecto del informe en el lienzo de informes. Hay dos configuraciones disponibles:

Si se establece el valor a printlayout 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.



EnableTextClipping

El elemento EnableTextClipping 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.

globalResourcePath

El elemento globalResourcePath 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 ubicacin central y se puede compartir entre varias aplicaciones Web. Este ajuste permite acceder a los recursos globales de un sitio Web especfico. En SAP CrystalReports.NET, los archivos de recursos predeterminados no se incluyen en la instalacin del producto, pero pueden descargarse desde el sitio Web de asistencia tcnica de SAP BusinessObjects: http://help.sap.com. Este elemento se tiene que agregar manualmente al archivo Web.Config del sitio Web.



http://help.sap.comhttp://help.sap.com

maxNumberListOfValues

maxNumberListOfValues controla el nmero de elementos de LOV que se enviarn al cliente. Esto controla el nmero de valores que se muestran en el panel de parmetros. Cuando se establece este valor, slo aparecern los primeros n valores en una lista de valores. Podr consultar los diferentes conjuntos de valores en el cuadro de dilogo Avanzado en funcin del tamao de su lista y del valor del elemento maxNumberListOfValues. Por ejemplo, si dispone de 180 valores, y establece el elemento maxNumberListOfValues en 50, podr ver los primeros 50 valores enumerados en el panel de parmetros. Podr consultar los 180 valores en el cuadro de dilogo Avanzado, donde se mostrarn 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.

printControl

El elemento printControl permite imprimir el informe directamente en la impresora local. El directorio de instalacin predeterminado es C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Common\Crystal Reports 2011\crystalreportviewers.

Esta configuracin 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.



processingIndicatorDelay

El elemento processingIndicatorDelay controla el tiempo que transcurre antes de que aparezca el indicador de 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.

processingIndicatorText

El elemento processingIndicatorText controla el texto que se muestra en el indicador de procesamiento de informes. El texto predeterminado es: Espere mientras el documento se procesa.

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 configuracin 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 versin ms reciente de Visual Studio. Este elemento se tiene que agregar manualmente al archivo Web.Config del sitio Web. La configuracin reportMappings requiere una ruta absoluta.



NotaEste elemento slo es vlido para Visual Studio 2005 y Visual Studio 2008.

resourceURI

El elemento resourceURI establece la ubicacin del directorio crystalreportviewers en su aplicacin Web. El directorio crystalreportviewers contiene todos los archivos que necesita el visor.

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 raz del directorio de archivos para el servidor. En este ejemplo, la raz se establece en c:\inetpub\wwroot. Este elemento se tiene que agregar manualmente al archivo Web.Config del sitio Web.



NotaEsto corresponde a la clase serverFileReportManager.

UseAsynchronousRequests

De forma predeterminada, se permiten las solicitudes asncronas dentro del visor de DHTML. Si desea habilitar el botn Atrs en el navegador del usuario para que funcione con el visor DHTML, deber deshabilitar las solicitudes asncronas estableciendo este parmetro a false.

NotaNo se recomienda establecer el elemento UseAsynchronousRequests en false. Si lo hace, se deshabilitar el cuadro de dilogo Avanzado en el panel de parmetros, as como algunas mejoras de rendimiento del visor y funciones de aspecto mejoradas.

crystal_use_asynchronous_requests false

UseBrowserLocale

El elemento UseBrowserLocale recupera la configuracin de idioma del explorador para el control CrystalReportViewer. Cuando se establece en true, este ajuste configura el control CrystalReportViewer para observar la configuracin regional del explorador. Cuando se establece en false, este ajuste restringe la configuracin regional que se muestra pgina a pgina. Este elemento se tiene que agregar manualmente al archivo Web.Config del sitio Web.



EjemploArchivo Web.Config de ejemplo


Imprimir Web: configurar la localizacin basada en el explorador Web configurar recursos personalizados globales o locales Cmo agregar o eliminar referencias en Visual Studio Versiones de SAP Crystal Reports

1.2.2.2 Configuracin de proyectos de Windows en Visual Studio

Esta seccin constituye un punto de aprendizaje clave tanto para programadores de nivel avanzado como intermedio. Aqu se muestran las mejores prcticas recomendadas para continuar con la creacin y la



http://help.sap.com/disclaimer?site=http://msdn2.microsoft.com/en-us/library/ms225384(VS.80).aspxhttp://help.sap.com/disclaimer?site=http://msdn2.microsoft.com/en-us/library/ms227611(VS.80).aspxhttp://help.sap.com/disclaimer?site=http://msdn2.microsoft.com/en-us/library/ms227574(VS.80).aspxhttp://help.sap.com/disclaimer?site=http://msdn2.microsoft.com/en-us/library/wkze6zky(VS.80).aspxhttp://help.sap.com/disclaimer?site=http://msdn2.microsoft.com/en-us/library/ms225607(VS.80).aspx

configuracin de un nuevo proyecto de Windows con SAP Crystal Reports, versin para programadores de Microsoft Visual Studio.

En esta seccin se muestra la configuracin de un proyecto de Windows mediante un modelo de codificacin. Como parte de esta configuracin, se tendr acceso a la clase Form1 y se escribir cdigo. Este proyecto de Windows basado en cdigo que se crea sirve tambin como requisito previo para los tutoriales de codificacin suministrados junto con esta ayuda en lnea.

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 continuacin, haga clic en Proyecto.3. En el cuadro de dilogo Nuevo proyecto, seleccione una carpeta de lenguaje para C# o Visual Basic en la lista

Tipos de proyecto.4. En la lista Plantillas, haga clic en Aplicacin para Windows Forms.5. En el campo Nombre, sustituya el nombre de proyecto predeterminado por el nombre de su proyecto.

Utilice la convencin de nomenclatura Pascal, donde se escribe la primera letra del nombre del proyecto en maysculas, ya que el nombre del proyecto tambin 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 configuracin de proyecto Visual Basic estndar (opcional)

Contexto

Si desea configurar el proyecto de forma que se pueda utilizar con los tutoriales incluidos en esta documentacin, es necesario realizar una pequea modificacin en la configuracin del mismo.

Procedimiento

1. En Explorador de soluciones, haga clic con el botn derecho en el nombre de proyecto en negrita bajo del nombre de solucin y, a continuacin, seleccione Propiedades.

2. En la vista Propiedades, haga clic en la ficha Compilar.3. En la lista OptionStrict, haga clic en Activada.



4. Cierre la vista Propiedades.5. En el men Archivo, haga clic en Guardar todo.

NotaComo prctica recomendada, se sugiere habilitar OptionStrict al comienzo de cualquier proyecto de Visual Basic. Cuando se escribe cdigo, se impone el uso de las prcticas ms recomendables, con declaraciones de variables con tipos declarados y una proyeccin vlida. Ambos se comprueban durante la compilacin. Las comprobaciones de cumplimiento estricto realizadas durante la compilacin pueden reducir las excepciones en tiempo de ejecucin.

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 extensin cs o vb, en funcin del lenguaje que se utilice.

Procedimiento

1. Si Form1 no aparece en la ventana principal, haga doble clic en Form1 en el Explorador de soluciones para abrirlo en la vista Diseo.

Form1 se abrir en Designer.2. En el men Ver, haga clic en Cdigo.

Aparece la vista Cdigo de la clase Form1. La presentacin de esta clase depende de si la aplicacin 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).

NotaUna clase "partial" independiente contiene mtodos y variables adicionales de la clase Form1. (Esto es cierto para C# y Visual Basic). Las clases parciales se explican posteriormente en Configuracin de proyectos de Windows.



1.2.2.2.3.2 Para agregar un mtodo de ayuda privado para el cdigo de configuracin de SAP Crystal Reports

Procedimiento

1. Agregue a esta clase Form1 un nuevo mtodo auxiliar de mbito privado sin valor devuelto, denominado ConfigureCrystalReports(). Private Sub ConfigureCrystalReports()End Sub private void ConfigureCrystalReports(){}

A continuacin, agregue un controlador de eventos Form_Load y una llamada a ConfigureCrystalReports() en el controlador de eventos Form_Load. De este modo, el mtodo ConfigureCrystalReports() se ejecutar automticamente al cargar el formulario.

2. En el men Ver, haga clic en Diseador.3. Haga doble clic en Form1.

Regresar a la vista Cdigo. Como hizo doble clic en Form1, se generar automticamente un controlador de eventos Form1_Load en la clase Form1.

4. En el control de eventos Form1_Load, escriba una llamada al mtodo ConfigureCrystalReports().

ConfigureCrystalReports()

ConfigureCrystalReports();

5. En el men Archivo, haga clic en Guardar todo.

1.2.2.2.4 Agregar un control CrystalReportViewer

1.2.2.2.4.1 Para agregar un control de CrystalReportViewer a una aplicacin de Windows

Procedimiento

1. Abra un formulario de Windows Form en la vista Diseo.2. En el Cuadro de herramientas, abra el nodo Informes para buscar el control CrystalReportViewer.

NotaEn las versiones anteriores de Visual Studio, el control CrystalReportViewer apareca en el nodo Crystal Reports.



3. Arrastre y suelte el control CrystalReportViewer en el formulario.4. En el men Archivo, haga clic en Guardar todo.

Resultados

Cuando se agrega un control CrystalReportViewer a su aplicacin, se agregarn de forma automtica 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 continuacin, en el men Ver, haga clic en Cdigo.5. Sobre la firma de clase, agregue una declaracin "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.EngineImports CrystalDecisions.Shared using CrystalDecisions.CrystalReports.Engine;using CrystalDecisions.Shared;

1.3 Aspectos fundamentales del SDK

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 mtodos prcticos para trabajar con el control CrystalReportViewer y saber cmo interacta este control con el resto de los modelos de objetos.



NotaEn esta documentacin, un modelo de objetos hace referencia a una clase bsica y las clases que la rodean, que forman un modelo de programacin. En SAP Crystal Reports estos modelos de objetos se basan en una clase bsica que encapsula un archivo de definicin de informes. Esa clase bsica y el modelo de objetos que la rodea permiten la interaccin mediante programacin con el informe.

Mtodo prctico para trabajar con el control CrystalReportViewer

Una aplicacin Web eficaz diferencia claramente su nivel de presentacin de la lgica de negocios subyacente.

El diseo del control ASP.NET promueve de forma natural este modelo. Encapsula la informacin de presentacin en el control y, a continuacin, lo enlaza a un objeto subyacente o a un modelo de objetos que lleva a cabo la lgica de negocios.

CrystalReportViewer es un control .NET que sigue esta arquitectura. Funciona como objeto de presentacin de Web Form o Windows Form (el nivel de presentacin), 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 mtodo prctico, el control CrystalReportViewer enlaza a uno de los modelos de objetos que lleva a cabo la lgica de negocios, normalmente para la manipulacin del informe.

En este caso, el control CrystalReportViewer limita su interaccin mediante programacin para modificar slo la configuracin de presentacin; por ejemplo, ocultar o mostrar la barra de herramientas del visor o un botn de esa barra de herramientas.

Modelo de objetos CrystalReportViewer

El control CrystalReportViewer contiene propiedades y mtodos que permiten la interaccin con la presentacin de los informes. Asimismo tiene unas pocas propiedades y mtodos para interactuar con los informes enlazados al control. Estas propiedades y mtodos 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 ningn 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 programacin.

Pero en la mayora 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 interaccin limitada con los informes; contiene un pequeo subconjunto de las funciones disponibles en el modelo de objetos ReportDocument.

El modelo de objetos CrystalReportViewer difumina la separacin del nivel de presentacin y de la lgica de negocios subyacente del cdigo.

El modelo de objetos ReportDocument

ReportDocument es un modelo de objetos ms 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 cdigo.

Cul 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.

NotaEn 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 actualizacin 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 funcin 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 dems modelos de objetos (como ReportDocument o ReportClientDocument) y, a continuacin, 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 en redundante respecto al modelo de objetos ms eficaz al que est enlazado. Adems, la configuracin que se aplica al modelo de objetos CrystalReportViewer es visible para el otro modelo de objetos, lo que podra 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 parmetro mensual en este informe con el modelo de objetos CrystalReportViewer, puede que experimente problemas. El modelo de objetos ReportDocument no puede ver la configuracin de parmetros aplicada en el modelo de objetos CrystalReportViewer. Intentar exportar o imprimir el informe sin darse cuenta de la existencia de esa configuracin de parmetro mensual y, a continuacin, mostrar el mes equivocado o incluso provocar una excepcin.

La mejor respuesta es limitar el uso del control CrystalReportViewer para informar de la configuracin de presentacin slo 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 grfica para el usuario para el diseo de informes WYSIWYG, y una serie de asistentes que simplifican la conectividad, la ordenacin, el agrupamiento de los datos y los problemas de diseo de informes complejos adicionales. SAP Crystal Reports Developer incluye una versin mejorada del diseador incrustado que permite crea potentes informes y aplicaciones de elaboracin de informes. El diseador incrustado que se incluye con SAP Crystal Reports, versin para programadores de Microsoft Visual Studio contiene muchas de las funciones de SAP Crystal Reports Designer.

Funcin de SAP Crystal Reports Designer incrustado en la arquitectura

SAP Crystal Reports Designer incrustado se incluye en la descripcin de la arquitectura porque su funcin es fundamental para SAP Crystal Reports, versin para programadores de Microsoft Visual Studio: crea los archivos de informe que se mostrarn. Sin embargo, la funcin de SAP Crystal Reports Designer incrustado es una funcin en tiempo de diseo. La funcin que implica la presentacin e interaccin con los informes, que se produce en tiempo de ejecucin, pertenece al SDK de SAP Crystal Reports. Por lo tanto, aunque el diseador incrustado crea los informes que se utilizan en la arquitectura, no forma parte de la propia arquitectura.


Usar SAP Crystal Reports Designer incrustado [pgina 618]

1.3.1.4 Controles de visores de informes

SAP Crystal Reports, versin para programadores de Microsoft Visual Studio incluye controles de forma estndar para visualizar informes. Cada control encapsula compleja informacin de diseo 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 diseo basado en pginas, con la posibilidad de moverse entre ellas.

Control CrystalReportPartsViewer.

El control muestra informacin de resumen de informe en una pequea ventana al estilo de un portal, con la posibilidad de profundizar en el informe a travs 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 continuacin, asignando la propiedad ReportSource de dicho control a un informe.




Cmo utilizo los controles de visores de informes? [pgina 43]

1.3.1.5 Modelos de objetosSAP Crystal Reports, versin 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 razn 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 ms sencillo es CrystalReportViewer.El control CrystalReportViewer de un formulario Web Forms o Windows Forms tiene, por definicin, una clase subyacente del mismo nombre. Esta clase CrystalReportViewer expone propiedades y mtodos para modificar la funcionalidad de presentacin del control, as como para interactuar con las clases que administran inicios de sesin, parmetros y frmulas de seleccin de base de datos. Este conjunto de clases es el modelo de objetos ms 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 versin de formularios Web Forms de este control o en el espacio de nombres CrystalDecisions.Windows.Forms para la versin de formularios Windows Forms del control.

Un modelo de objetos ms amplio es ReportDocument.La clase ReportDocument es una puerta de enlace al conjunto de clases del espacio de nombres Engine, que incluye Database, DataDefinition, ExportOptions, PrintOptions, ReportDefinition, ReportOptions y SummaryInfo. Se trata de un conjunto ms completo de clases que proporcionan posibilidades ms eficaces de personalizacin e interaccin 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 estn disponibles mediante actualizacin:

Un modelo de objetos con mayor posibilidad de modificacin de informes denominado ReportClientDocument.Esta clase funciona como puerta de enlace a un modelo de objetos mucho ms 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 programacin en tiempo de ejecucin.Las clases de este modelo de objetos se incluyen en el grupo de espacios de nombres CrystalDecisions.ReportAppServer.El modelo de objetos ReportClientDocument 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 ms 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.

NotaEl modelo de objetos InfoObject se proporciona slo 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 [pgina 31]Comparar soluciones de elaboracin de informes de SAP BusinessObjects Business Intelligence [pgina 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 informacin especfica sobre su funcin como control .NET, vea Controles de visores de informes [pgina 34].

En el cdigo subyacente del formulario Web Forms o Windows Forms, la clase CrystalReportViewer proporciona el modelo de objetos ms sencillo del SDK. Exploraremos ese modelo de objeto ms adelante en esta seccin.

La forma ms sencilla de colocar un informe en un formulario Web Forms o Windows Forms es agregar el control CrystalReportViewer al formulario y, a continuacin, en la clase de cdigo 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 ms complejo, como ReportDocument o ReportClientDocument), restringe la interfaz a slo el modelo de objetos ms sencillo: CrystalReportView

Comparacin 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 mnimas) en dos espacios de nombres distintos.

La versin de Windows de CrystalReportViewer incluye las clases y los eventos principales compartidos por las versiones de Windows y Web del modelo de objetos.



La versin Web del modelo de objetos CrystalReportViewer incluye las mismas clases y eventos que la versin de Windows, pero, adems, tiene los siguientes eventos relacionados con la forma en que se carga la pgina ASPX.


Controles de visores de informes [pgina 34]Enlazar informes al modelo de objetos CrystalReportViewer [pgina 166]

1.3.1.5.2 Modelo de objetos ReportDocument

La clase ReportDocument proporciona un modelo de objetos ms 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 ms herramientas para la manipulacin de un informe mediante programacin.

El modelo de objetos ReportDocument

En la seccin anterior, aprendi a trabajar con el modelo de objetos CrystalReportViewer bsico 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 objetos ReportDocument 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 ms complejo y eficaz de ReportDocument.

NotaPuesto que ambos modelos de objetos estn implicados en este proceso (CrystalReportViewer para cargar y mostrar el informe, ReportDocument para encapsularlo y manipularlo), es fcil confundir las funciones de ambos modelos de objetos. Una vez que el modelo de objetos ReportDocument se ha utilizado para encapsular el informe, se debe restringir cualquier manipulacin del informe a ese modelo. Si trata de utilizar las propiedades y los mtodos 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 cdigo de CrystalReportViewer slo para establecer propiedades de presentacin.



ReportDocument y ReportClientDocument (RAS)

En SAP Crystal Reports 9, ambos modelos de objetos eran totalmente independientes. En SAP Crystal Reports 10 y versiones posteriores, se ha eliminado la separacin bsica 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 versin limitada del modelo de objetos ReportClientDocument mediante la propiedad ReportDocument.ReportClientDocument.


Tutoriales del modelo de objetos ReportDocument [pgina 327]Enlazar informes al modelo de objetos ReportDocument [pgina 194]Modelo de objetos CrystalReportViewer [pgina 36]Elegir el modelo de objetos correcto para el proyecto [pgina 31]

1.3.1.5.3 Modelo de objetos ReportClientDocument (RAS)

El modelo de objetos ReportClientDocument proporciona el modelo de objetos ms eficaz y completo para manipular informes. Este modelo de objetos slo 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 objetos ReportClientDocument est formado por muchas clases de diversos espacios de nombres. El espacio de nombres lleva el prefijo CrystalDecisions.ReportAppServer. Este modelo de objetos expone toda la estructura del informe en el SDK, para permitir crear, modificar y guardar cambios mediante programacin en todos los aspectos del informe en tiempo de ejecucin.

Una instancia de ReportClientDocument consta de un informe que se puede modificar con programacin mediante sus propiedades de clase. Estas propiedades estn vinculadas con una serie de bibliotecas del SDK que contienen controladores, modelos de definicin de datos y modelos de definicin de informes:

ReportDefinition 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 ejecucin.

Las instancias de ReportClientDocument pueden ser instancias de uno de estos objetos:

Un archivo .rpt existente cargado desde un directorio y modificado con las clases de definicin de informe y de definicin de datos del SDK de ReportClientDocument.

Un informe completamente nuevo y vaco que se genera con las clases de definicin de informe y definicin de datos del SDK de ReportClientDocument.



Esta instancia de la clase ReportClientDocument puede cargarse tan slo el tiempo suficiente para enviar la instancia al visor para su visualizacin, antes de que pase a estar fuera del mbito. Sin embargo, tambin se puede modificar y, a continuacin, guardar como un informe (.rpt) en un directorio con una de las clases de controlador.

Para obtener informacin detallada sobre el modelo de objetos ReportClientDocument, consulte la documentacin del SDK de SAP BusinessObjects RAS .NET.

ReportClientDocument en SAP Crystal Reports 9

SAP Crystal Reports 9 (versin Advanced) se entregaba con RAS no administrado y los ensamblados .NET de RAS necesarios para programar en el modelo de objetos ReportClientDocument. De esta forma, los programadores podan crear proyectos .NET que aprovechaban el modelo de objetos ReportClientDocument.

Sin embargo, tambin significaba que los proyectos que se crearon anteriormente con el modelo de objetos ReportDocument proporcionado con SAP Crystal Reports se deba volver a codificar totalmente para el modelo de objetos ReportClientDocument proporcionado con RAS. La razn era que ambos modelos de objetos eran totalmente independientes.

ReportClientDocument en SAP Crystal Reports 10 y superior

En SAP Crystal Reports 10, se elimin la separacin bsica entre los modelos de objetos. Esto se ha realizado reescribiendo el modelo de objetos ReportDocument para que sirva como proxy para funcionalidad (o para un subconjunto de funcionalidad) desde el modelo de objetos ReportClientDocument. Las clases del modelo de objetos ReportDocument exponen las mismas firmas de propiedades y mtodos que antes, pero la funcionalidad subyacente se modifica para redirigir cada propiedad y mtodo a las propiedades y mtodos del modelo de objetos ReportClientDocument ms eficaz.

Esto no significa que una versin bsica de SAP Crystal Reports Developer obtenga acceso total a un servidor RAS no administrado ni al modelo de objetos ReportClientDocument. La versin bsica de SAP Crystal Reports sigue teniendo acceso slo al modelo de objetos ReportDocument (aunque el modelo de objetos ReportDocument funcione como proxy para un subconjunto del modelo de objetos ReportClientDocument). El motor de creacin de informes original de las versiones anteriores de SAP Crystal Reports se ha reemplazado por una versin limitada e incrustada del motor de creacin de informes de RAS.

Instale y obtenga acceso al modelo ReportClientDocument slo con una licencia actualizada para el servidor RAS no administrado. En ese punto, todo el cdigo existente escrito para el modelo de objetos ReportDocument se puede redirigir fcilmente al servidor de RAS independiente, estableciendo dos propiedades en cualquier instancia de informe dado y se puede obtener acceso directamente al modelo de objetos ReportClientDocument subyacente, al recuperarlo desde la propiedad ReportClientDocument de la clase ReportDocument.



1.3.1.5.4 Modelo de objetos InfoObject (BOE)

El modelo de objetos InfoObject incluye los productos de actualizacin SAP Crystal Reports Server y la de plataforma SAP BusinessObjects Business Intelligence.

NotaPara obtener ms informacin, vea Soluciones de elaboracin de informes de SAP BusinessObjects Business Intelligence [pgina 64].

El modelo de objetos InfoObject proporciona un modelo de objetos de nivel de plataforma para el SDK. InfoObject funciona como clase base, en la que se encapsulan muchos objetos Enterprise en clases derivadas. La clase derivada que representa informes es la clase CrystalDecisions.Enterprise.Desktop.Report.

El SDK de la plataforma SAP BusinessObjects Business Intelligence se ha diseado a partir de la clase de objetos InfoObject y sus clases de soporte.

La clase InfoObject

La clase InfoObject se utiliza en el SDK para representar una amplia variedad de entidades de informacin. Incluye tanto entidades fsicas (archivos de informe o archivos PDF) como entidades de red (usuarios, servidores o conexiones FTP).

La clase InfoObject es una clase base de distintas clases ampliadas que corresponden a estas entidades de informacin con ms detalle. Las clases extendidas que heredan de InfoObject incluyen las siguientes: Report, User, Server, Folder, Program, Ftp, Smtp, Word, Excel y Pdf.

Mediante la manipulacin de estas instancias de InfoObject y de las clases ampliadas, puede crear una aplicacin de escritorio cliente o administrativa.

Clases de soporte

Dos clases adicionales admiten la clase InfoObject.

Clase InfoStore Esta clase acta como controlador, o puerta de enlace, para el repositorio del Servidor de administracin central (CMS), que es una base de datos donde se guardan todas las instancias de InfoObject. La clase InfoStore se utiliza para crear instancias, recuperar y validar todas las instancias de la clase InfoObject guardadas en el repositorio del CMS.

Clase indizada InfoObjects

Esta clase incluye varias instancias de InfoObject. InfoStore la utiliza para mover instancias de InfoObject desde y hacia el repositorio de CMS.

Las instancias de InfoObject no se pueden administrar directamente mediante la clase InfoStore. Antes, deben incluirse en la clase indizada InfoObjects. Mediante esta clase indizada, las instancias individuales de InfoObject se pueden agregar, recuperar, actualizar o programar.



NotaPara obtener informacin detallada del SDK de SAP Crystal Reports Server o de la plataforma SAP BusinessObjects Business Intelligence, consulte la documentacin del SDK de SAP Crystal Reports Server o de la plataforma SAP BusinessObjects Business Intelligence.


Elegir el modelo de objetos correcto para el proyecto [pgina 31]

1.3.1.6 Comparacin de arquitecturas en las soluciones de elaboracin de informes SAP Business Intelligence

Existen cuatro soluciones de elaboracin de informes de SAP Business Intelligence:

SAP Crystal Reports, versin para programadores de Microsoft Visual Studio SAP Crystal Reports Developer Servidor de aplicaciones de informes (RAS) no administrado SAP Crystal Reports Server o plataforma SAP BusinessObjects Business Intelligence

La diferencia principal de la arquitectura entre cada solucin de elaboracin de informes es la forma en la que cada uno coloca e implementa el motor de informes.

Qu es el motor de informes?

El motor de informes se encuentra en el ncleo de cada solucin de elaboracin de informes. Procesa todas las solicitudes de usuario y extrae la informacin del informe.

El rendimiento mximo del procesamiento de solicitudes de usuario simultneas vara entre las soluciones. En algunas soluciones se establece mediante diseos de arquitectura o restricciones de licencia.

Los componentes principales restantes de cada solucin de elaboracin de informes son los siguientes:

El archivo de definicin de informes (.rpt). El origen de datos. El visor de informes. El SDK. Marco de plataforma (encontrado en SAP Crystal Reports Server o la plataforma SAP BusinessObjects

Business Intelligence).



Cmo interacta el motor de informes con el resto de los componentes principales?

El motor de informes utiliza el archivo de definicin de informes (.rpt) como plantilla. A continuacin, recupera los datos del origen de datos y utiliza la definicin de informes para presentar el informe solicitado actualmente, que se pasa al visor de informes. La informacin recibida del visor, o codificada con el SDK de la interfaz, activa un procesamiento posterior desde el motor de informes que realiza ms acciones en el informe.

En qu se diferencia la configuracin del motor de informes en las distintas soluciones de elaboracin de informes de SAP Business Intelligence?

El motor de informes se incrusta.En SAP Crystal Reports, versin para programadores de Microsoft Visual Studio, el motor de informes est incrustado en la aplicacin.Este motor de informes incrustado tiene un lmite de un mximo de tres solicitudes de usuario simultneas. No se trata de un lmite de licencia arbitrario, sino de una limitacin de la arquitectura del motor de informes incrustado.

El motor de informes se extrae en un proceso de servidor de informes independiente.En la solucin que utiliza el servidor de aplicaciones de informes (RAS), el motor de informes se extrae en un proceso de servidor independiente. Dicho proceso de servidor se puede ejecutar en el mismo equipo o colocar en un hardware fsico distinto para incrementar el rendimiento mediante la descarga de parte del procesamiento del servidor de aplicaciones. Un servidor RAS no administrado ya no est disponible como opcin de actualizacin. Se recomienda realizar una actualizacin a SAP Crystal Reports Server en su lugar. Para obtener ms informacin, vea Soluciones de elaboracin de informes de SAP BusinessObjects Business Intelligence [pgina 64].

El proceso de servidor de informes independiente se encapsula en una arquitectura de plataforma completa.En la solucin SAP Crystal Reports Server o plataforma SAP BusinessObjects Business Intelligence, se agrega una arquitectura de plataforma completa que encapsula el proceso de servidor de aplicaciones de informes independiente (RAS). El servidor de aplicaciones de informes (RAS) administrado se convierte en un solo servidor, entre muchos otros servidores de la arquitectura de plataforma. Esta arquitectura proporciona un conjunto muy amplio de funciones adicionales, como programacin, equilibrio de carga, conmutacin por error y escalabilidad tanto horizontal como vertical.

1.3.2 Control CrystalReportViewer

Para ver un informe de Crystal, debe agregar un control CrystalReportViewer a la aplicacin. El control CrystalReportViewer se usa en .NET Framework para enlazar y mostrar informes. El control CrystalReportViewer predeterminado incluye elementos de interfaz de usuario para facilitar la visualizacin, guardado y navegacin en un informe.

Los dos controles CrystalReportViewer usados con mayor frecuencia son el control CrystalReportViewer para las aplicaciones de Windows, al que se accede a travs de la clase CrystalDecisions.Windows.Forms.CrystalReportViewer y el control CrystalReportViewer para sitios



web, al que se accede a travs de la clase CrystalDecisions.Web.CrystalReportViewer. Para obtener ms informacin, consulte SAP Crystal Reports .NET API Reference.

NotaSlo es necesario un control CrystalReportViewer si desea visualizar informes de Crystal.

Personalizar el control CrystalReportViewer

Segn su aplicacin, puede interesarle modificar ciertos elementos del control predeterminado. SAP Crystal Reports permite personalizar de diferentes formas el aspecto del visor que se muestra en la aplicacin. Entre otras opciones:

Se puede eliminar del visor la barra de herramientas de CrystalReportViewer. Se pueden agregar o eliminar los botones de la barra de herramientas mediante programacin. El control CrystalReportViewer admite la personalizacin mediante CSS o temas.


Personalizar el control CrystalReportViewer [pgina 218]Visualizar un informe [pgina 159]

1.3.2.1 Cmo utilizo los controles de visores de informes?

Los controles de visores de informes son controles .NET que se pueden agregar a un formulario en una aplicacin para Windows o Web, con el fin de mostrar los informes en dicho formulario.

Al planear la creacin de una aplicacin con el SDK de SAP Crystal Reports, una de las consideraciones ms importantes es si se van a usar controles de visores de informes. Conocer los aspectos fundamentales del SDK que afectan a estos controles le ayudar a elegir la estructura ms adecuada para el proyecto de SAP Crystal Reports, versin para programadores de Microsoft Visual Studio.

Qu son los controles .NET?

Los controles de Microsoft .NET son un tipo especial de clases que se muestran en el Cuadro de herramientas de Visual Studio. Se agregan a Web Forms o Windows Forms como objetos GUI, y heredan de una clase base Control comn. Los controles .NET tpicos son: Button, DropDownList, CheckBox, TextBox o DataGrid.

Los controles de Microsoft .NET cumplen la siguiente prctica recomendada: separar la capa de presentacin de la capa de lgica empresarial. Encapsulan la informacin de presentacin dentro del propio control en Web Forms o W

manual del desarrollador del sdk .net de sap crystal reports para

Documents