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
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
2/967
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
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
3/967
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
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
4/967
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.
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
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
5/967
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
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 5
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
6/967
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.
6 © 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
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
7/967
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.
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 7
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
8/967
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
9/967
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).
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 9
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
10/967
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.
Información relacionada
Soluciones de elaboración de informes de SAP BusinessObjects
Business Intelligence [página 64]
10 © 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
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
11/967
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
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 11
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
12/967
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í .
12 © 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
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
13/967
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.
Información relacionada
Versiones compatibles de Visual Studio [página 10]
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 13
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
14/967
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:
14 © 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
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
15/967
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 .
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 15
http://slidepdf.com/reader/full/manual-de-instalacion-de-sap-crystal-reports-papa-visual-studio-para-programadores
16/967
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.
16 © 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
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
17/967
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;
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 17
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
18/967
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
.
18 © 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
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
19/967
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
20/967
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
21/967
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">
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 21
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
22/967
</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>
22 © 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
http://slidepdf.com/reader/full/manual-de-instalacion-de-sap-crystal-reports-papa-visual-studio-para-programadores
23/967
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>
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 23
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
24/967
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.
24 © 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
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
25/967
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.
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 25
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
26/967
<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>
26 © 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
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
27/967
</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>
Información relacionada
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
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 27
http://slidepdf.com/reader/full/manual-de-instalacion-de-sap-crystal-reports-papa-visual-studio-para-programadores
28/967
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 .
28 © 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
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
29/967
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.
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 29
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
30/967
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 .
30 © 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
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
31/967
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.
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 31
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
32/967
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.
32 © 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
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
33/967
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.
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 33
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
34/967
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.
Información relacionada
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.
34 © 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
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
35/967
¿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
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 35
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
36/967
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.
Información relacionada
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.
36 © 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
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
37/967
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.
Información relacionada
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.
Manual del desarrollador del SDK .Net de SAP Crystal Reports para
Visual Studio Manual del desarrollador del SDK de SAP Crystal
Reports .Net
© 2015 SAP SE o una empresa filial de SAP. Reservados todos los
derechos. 37
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
38/967
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 .
Información relacionada
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