PDF de programación - Manual del desarrollador del SDK .Net de SAP Crystal Reports para Visual Studio

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
1.1

1.2

1.3

1.4

1.5

1.6

1.7

Manual del desarrollador del SDK de SAP Crystal Reports .Net . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
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
Configurar el entorno de desarrollo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Configuración del sistema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Configuración de proyectos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
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
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
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
Implementación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588
Componentes de implementación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588
Implementación para Visual Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
Crear informes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .617
Usar SAP Crystal 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 deSAP
Crystal 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 y ReportDocument 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. Vea Soluciones 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:
●
● Obtenga acceso a sus informes desde un directorio de archivos.

Incruste los informes directamente en el proyecto.

4

© 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
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

Objetos Flash incrustados

Resúmenes incrustados en tablas de referencias cruzadas

Vista previa editable

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 para
diseñ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.

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.

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