Manual Usuario Instalacion Crystal Reports[1]

DOCUMENTO DE AYUDA

INSTALACION DEL DEPLOY

DE CRYSTAL REPORTS PARA

EXACTUS

VERSIÓN 1.00

2007 EXACTUS de Costa Rica ECR, SRL Deploy de Crystal Reports para Exactus

Para uso interno de EXACTUS de Costa Rica ECR, SRL. Prohibida su reproducción total o parcial. 2 de 33

Ninguna parte de este documento puede ser reproducida o transmitida de ninguna forma, ni por

cualquier medio, ya sea electrónico o mecánico, con ningún propósito, sin la previa autorización de

EXACTUS de Costa Rica ECR

2007 EXACTUS de Costa Rica ECR, SRL todos los derechos reservados. EXACTUS y EXACTUS

ImpulsoTM son marcas registradas de EXACTUS de Costa Rica ECR, SRL. Todas las otras marcas

son propiedad de sus respectivos fabricantes.



ÍNDICE GENERAL

ACERCA DE ESTA GUÍA .................................................................................................................................................... 4

NOTA INTRODUCTORIA .............................................................................................................................................................. 4 CONSIDERACIONES INICIALES .................................................................................................................................................... 4

COMO FUNCIONAN LOS REPORTES CRYSTAL REPORTS DESDE EL ERP? ...................................................... 5

COMO VISUALIZAR LOS DATOS DE UN REPORTE CON XML DESDE LA HERRAMIENTA

DE EDICIÓN DE REPORTES? ............................................................................................................................................ 6

INSTALACIÓN DEL DEPLOY CRYSTAL REPORTS: ................................................................................................... 7

COMO UTILIZAR EL PARÁMETRO LOGOCIA?: ...................................................................................................... 11

COMO INCLUIR LOS UDFS EN LOS REPORTES CRYSTAL?: ................................................................................ 13

ERRORES COMUNES ENCONTRADOS ........................................................................................................................ 17



INTRODUCCIÓN GENERAL

Acerca de esta Guía

NOTA INTRODUCTORIA Esta guía tiene como objetivo dar al usuario una guía básica de como instalar el

deploy de Crystal Reports para EXACTUS. Además se presenta una lista de

los posibles errores en el proceso y la solución correspondiente.

CONSIDERACIONES INICIALES Como puntos importantes y necesarios a tomar en cuenta en el proceso de

instalación, se menciona:

1. Exactus 500 y 510 solo son compatibles con los deploys de crystal 9 y 10.

Exactus 600 solo es compatible con el deploy de crystal 11.

2. Solo es posible utilizar un deploy a la vez, no es compatible tener instalado el

deploy de crystal 9 y 10 al mismo tiempo.

3. Si es posible tener en la misma maquina instalado el deploy de crystal 9 para

exactus 500 y el deploy de crystal 11 para exactus 600 a la vez. No es posible

tener crystal 10 y 11 pues no son compatibles.

4. También se pueden presentar incompatibilidades si se encuentra instalado en

la maquina Crystal Reports como herramienta de desarrollo en una versión

que no sea compatible con la del deploy para Exactus.

5. Para utilizar los reportes de Crystal 11 del ERP 600 con ORACLE es

necesario instalar el cliente ORACLE 9.2 o superior para utilizar los

subreportes o los reportes directos.



CAPÍTULO 1

Como funcionan los reportes Crystal Reports

desde el ERP?

Lo primero que hay que aclarar es la manera en que los reportes Crystal

Reports funcionan cuando son impresos desde el ERP y porque la necesidad

de instalar un deploy de Crystal que configure lo necesario.

Cada reporte standard de Exactus obtiene su información de tablas

provenientes de la fuente de datos EXCRY500XML410 para Exactus 5.00 y

EXCRY600XML420 para el ERP 600 como se muestra en la imagen:

Como vemos en el ejemplo la tabla factura proviene del ODBC

EXCRY500XML410, sucesivamente de esta tabla se obtienen los valores

que serán desplegados en el reporte. Este ODBC apunta a una carpeta

designada como DATA donde se almacenan los archivos XML que

contienen la información del reporte.

Cada vez que se genera un reporte desde el ERP el modulo correspondiente

genera un archivo XML con los datos que serán impresos y lo ubica en la

carpeta DATA con un código identificador, luego levanta una instancia de

Crystal Reports con los datos de conexión y con el código identificador del

reporte, después lo actualiza y lo despliega.



Es importante mencionar la utilidad de los archivos DTD en este proceso; si

bien los datos del reporte se leen del archivo XML de la carpeta DATA, el

formato y los tipos de cada campo se listan en el archivo XML que se

encuentra en la carpeta DTD, uno para cada reporte. El nombre de estos

reportes tiene el prefijo DD_, por ejemplo para el reporte factura.rpt existe en

la carpeta DATA un archivo XML llamado dd_factura.xml.

Si bien los reportes standard del ERP utilizan este formato de impresión por

XML también es posible utilizar reportes elaborados con tablas directamente

ligadas a la base de datos, ya sea SQL Server u ORACLE, porque el

componente de impresión cuando recibe los datos de conexión reubica el

reporte a la base de datos y la compañía correspondientes.

También es válido combinar los datos de tablas del origen XML y tablas

directamente ligadas a la base de datos.

Como visualizar los datos de un reporte con

XML desde la herramienta de edición de

reportes?

Poder visualizar los datos de un reporte en la herramienta de edición nos

facilita los cambios de formato y nos ayuda a determinar cuando existe un

problema para corregirlo. Para visualizar los datos de un reporte que

funciona con XML es necesario hacer lo siguiente:

1. Lo primero es estar seguro de que el deploy de Crystal Reports para

Exactus correspondiente esta bien instalado.

2. El siguiente paso es imprimir el reporte desde el ERP:

3. En el momento en que se genera el reporte se crea un archivo XML

nuevo en la carpeta DATA (la ruta de la carpeta data esta especificada en



el ODBC) con un identificador único, para determinar cual es el reporte

correspondiente ordene el contenido de esta carpeta por fecha de

modificación, será el último reporte generado:

Si abrimos este reporte en su contenido referencia al RPT que

imprimimos en el módulo, como en el ejemplo:

<BALGEN ProgID="D:\EXACTUS\REPORTES\BALGEN.RPT"

xmlns="x-schema:D:\EXACTUS\DTD\DD_BALGEN.XML">

Ya que ubicamos el XML que corresponde al reporte que imprimimos

hay que renombrar este archivo y ponerle el nombre del reporte, por

ejemplo si es el reporte BALGEN.RPT hay renombrar el XML como

BALGEN.XML. Es muy importante que exista el DTD correspondiente.

4. El siguiente paso es entrar en la herramienta de edición de reportes y

refrescar la información, de esta manera se desplegaran los datos del

archivo XML.

Instalación del deploy Crystal Reports:

El instalador del deploy de Crystal Reports en sus diferentes versiones copia

los componentes requeridos, registra dichos componentes, genera el ODBC

para los reportes y genera la carpeta DATA.

A continuación se presentan las pantallas del Wizard de instalación:

1. Primero seleccione el directorio donde se encuentra instalado Exactus en

la maquina, en esta ruta se generará la carpeta data y se copiará el

EXCRYREPORT.dll correspondiente a la versión.



2. Después aparece la pantalla final. Al oprimir el botón Install se inicia el

proceso de instalación.

Al finalizar la instalación quedaran copiados todos los componentes

requeridos, generada la carpeta DATA en la ruta seleccionada y generado el

ODBC de la siguiente forma:



El nombre del ODBC que se utiliza para EXACTUS 500 y 510 es

EXCRY500XML410 tanto para el deploy de Crystal 9 como para el deploy

de Crystal 10. La diferencia esta en que para Crystal 9 se utiliza la versión

4.10 del driver y para crystal 10 se usa la versión 4.20.

El ODBC para el ERP 600 con el deploy de Crystal 11 es

EXCRY600XML420 y usa la versión 4.20 del driver.

Al configurar este ODBC debe tener una variable en la sección “Location

Names” que se llame EXACTUS de la siguiente forma:



Al oprimir “Editar” de variable EXACTUS aparece la ruta a la que esta

apunta:



Si se oprime el botón “Test Connect” el resultado debería ser exitoso:

Como utilizar el parámetro LogoCia?:

Los reportes estándar del ERP cuenta con la opción de desplegar la imagen que se haya

definido para la compañía en el modulo de AS, para esto se utiliza el parámetro

{?LogoCompania} como se muestra en la imagen:

Los reportes cuentan con un objeto tipo imagen en la parte superior izquierda, si le damos

click derecho a este objeto nos aparecen varias opciones, debemos seleccionar “Format

Graphic…” como se muestra en la imagen:



Luego en la pantalla que se presenta seleccionamos el tab “Picture” y seguidamente

oprimimos el botón que esta junto al título “Graphic Location:” y que dice X+2:



Al hacer esto aparece un editor de fórmulas donde es necesario incluir el parámetro

LogoCompania, este parámetro esta dentro de los Report Fields y es posible arrastrarlo

hasta la sección en blanco de edición de la formula como se muestra en la imagen:

Al final esta formula se guarda y ya el reporte es capaz de desplegar el logo que se haya

definido en AS.

Como incluir los UDFs en los reportes

Crystal?:

Los UDF´s son campos adicionales diseñados para añadir información a una tabla de

EXACTUS dinámicamente. Ya que tenemos definido un UDF para una tabla queremos que

esta información se refleje en nuestros reportes, en el caso de EXACTUS 600, en Crystal

Reports 11.

A continuación se listan los pasos necesarios para incluir a un reporte Crystal Reports la

información de los UDFs:

1. Cuando se genera un UDF para una tabla se incluyen una serie de triggers y una vista

correspondiente, el formato de esta vista es [Exv_] y el nombre de la tabla que afecta. Ya

que tenemos definido un UDF para una tabla de EXACTUS es necesario abrir el diseño

del reporte en Crystal Reports 11 e incluir esta vista a nuestro reporte. Es importante

resaltar que esta vista tiene como llave principal el rowpointer(identificador único) del

registro al que corresponde, de manera que según el reporte puede ser necesario agregar

otra tabla que haga la relación, como en el ejemplo de la imagen donde se agrego

también la tabla “Pedido”.



2. Ahora es importante definir la relación existente entre los registros de nuestro reporte y

el contenido de la vista.



La vista contiene un rowpointer que corresponde a cada registro de la tabla a la que se

agregó el UDF, además una columna por cada UDF que tenga la tabla, de esta manera como

muestra el ejemplo se puede hacer la relación de cada registro en la tabla pedido con un

campo de la vista y con un valor para cada UDF. También hay una relación entre la llave

principal de la tabla pedido y la llave principal del reporte.

Si lo visualizamos como una sentencia SQL seria la siguiente:

select P.Pedido, V.CC from Infomax.Pedido P, Infomax.Exv_Pedido V

where P.rowpointer = V.rowpointer;

Ya en el diseño del reporte aparecerá la vista y podremos incluir estos valores a nuestro

reporte:



Así en el reporte aparecerá esta información, en el campo CC_UDF:



CAPÍTULO 2

Errores comunes encontrados

1. Error al principio de la instalación que no permite continuar:

Solución:

Este mensaje indica que el deploy que se desea instalar ya se encuentra instalado en

la maquina y no permite continuar, ante esta situación es necesario desinstalar el

deploy antes de continuar. Para desinstalar busque la aplicación en Control Panel \

Add or Remove Programs como en la imagen:

Para Crystal 9 aparece como Deploy de Crystal Reports versión 9, para Crystal 10

aparece como Deploy de Crystal Reports versión X y para Crystal 11 aparece como

Deploy de Crystal Reports versión XI.

Si el deploy correspondiente no aparece listado es necesario eliminar su identificador

del registro de la maquina de la ubicación siguiente:



Para el Deploy de Crystal 9:

HKEY_CURRENT_USER\Software\Microsoft\Installer\Products\

07192AA3DA83FDB4A839FC12C94D6120



78F0313E141130D44B33DFA736F0A488



6EC8E78DC632BAB4D915CBDB1F5B83D9

Como se ve en la imagen:

Si no se encuentran en esta dirección es posible que los mismos identificadores se

encuentren dentro de la ruta HKEY_CLASSES_ROOT\Installer\Products.

Con solo eliminar esta entrada del registry ya es posible instalar normalmente el

deploy.

2. En algunos sistemas operativos, cuando Exactus va a generar un reporte se muestra la pantalla

donde en apariencia lo esta generando. Sin embargo, se cierra automáticamente, no lo genera y no

da un mensaje de error.



También es probable, si en la maquina se encuentra instalado Visual Studio .net 2005, que

aparezca la siguiente pantalla:

Solución:

En realidad lo que sucede es que el sistema operativo (en este caso Windows Server 2003 en

ambiente Terminal Services), supone que sucedió un error y cierra la aplicación.

Para esto se debe entrar a: “My Computer” System Properties Advanced

Performance Settings



En el tab de “Data Execution Prevention” se activa la opción de “Turn On DEP”.

Ahí se agregan cada uno de los módulos de Exactus.



Como se puede observar una vez que se aplican los cambios, los reportes se pueden generar

sin problemas.



NOTA: En teoría y según la documentación, si se escoge la primer opción (Turn on DEP for

essencial Windows programs) también debería funcionar, pues hace las verificaciones para

todos los programas que corren sobre Windows.

3. Otro posible error es el siguiente:

Al ejecutar algunos procesos en Exactus y/o generar reportes se pueden presentar los

siguiente mensajes de Error.

Esto se debe a que con SqlServer 2005 es necesario configurar el atributo Compatibility

Level con el valor ‘SqlServer 2000 (80)’, caso contrario se obtienen problemas ejecutando

ciertos estatutos SQL que utilizan OuterJoins.



SELECT ctaban.moneda, ctaban.cuenta_banco, ctaban.nombre, ctaban.saldo, ef.descripcion,

mon.nombre

INTO :dlgRptMov.sMoneda, :dlgRptMov.sCuenta, :dlgRptMov.sNombreCuenta,

:dlgRptMov.nSaldoFinal, :dlgRptMov.sBanco, :dlgRptMov.sMonedaDescrip

FROM PRUEBA.cuenta_bancaria ctaban, PRUEBA.entidad_financiera ef, PRUEBA.moneda mon

WHERE ctaban.entidad_financiera = ef.entidad_financiera

AND ctaban.moneda = mon.moneda AND ctaban.cuenta_banco IN (SELECT

DISTINCT(cuenta_banco)

FROM PRUEBA.mov_bancos mb, PRUEBA.subtipo_doc_cb sub

WHERE mb.tipo_documento = sub.tipo

AND mb.Subtipo = sub.subtipo

AND mb.fecha >= :dlgRptMov.dfFechaInicial

AND mb.fecha <= :dlgRptMov.dfFechaFinal AND ( ( sub.TIPO = 'CHQ'

AND sub.SUBTIPO IN ( 0 )) OR ( sub.TIPO = 'N/D' AND sub.SUBTIPO IN ( 0 )) OR ( sub.TIPO =

'O/D' AND sub.SUBTIPO IN ( 0 )) OR ( sub.TIPO = 'T/D' AND sub.SUBTIPO IN ( 0 )) ) OR ( (

sub.TIPO = 'DEP' AND sub.SUBTIPO IN ( 0 )) OR ( sub.TIPO = 'N/C' AND sub.SUBTIPO IN ( 0

)) OR ( sub.TIPO = 'O/C' AND sub.SUBTIPO IN ( 0 )) OR ( sub.TIPO = 'T/C' AND sub.SUBTIPO

IN ( 0 )) ) )

ORDER BY ctaban.moneda, cuenta_banco

Microsoft SQL Server:4147[Microsoft][ODBC SQL Server Driver][SQL Server]The query uses non-

ANSI outer join operators ("*=" or "=*"). To run this query without modification, please set the comp

Solución: Este error se presenta en los servidores SQL 2005 cuando no esta habilitado el nivel de

compatibilidad de la base de datos con el formato SQL Server 2000, esto porque ciertos

símbolos de programación han cambiado en la versión 2005.

La solución es la siguiente y aplica par Exactus 500 y Exactus 600:

Autor de la solución: Mauricio Vega Alvarez

Para que Exactus Impulso versiones 5.0 y 6.0 funcione adecuadamente con SqlServer 2005

es necesario configurar el atributo Compatibility Level con el valor ‘SqlServer 2000 (80)’,

caso contrario se obtienen problemas ejecutando ciertos estatutos SQL que utilizan

OuterJoins.

SqlServer 2005, dejó de soportar la sintaxis anterior para realizar Outer Joins en estatutos

Sql, y en su lugar ahora sólo soporta la nueva sintaxis del estándar SQL92.



Exactus Impulso utiliza la sintaxis previa, por tanto para que pueda funcionar

adecuadamente con SqlServer2005 es necesario configurar la compatibilidad hacia

SqlServer2000 que es un atributo a nivel de base de datos.

A continuación se muestra la ubicación de dicho atributo, para modificarlo desde el

Management Studio:

Seleccione la base de datos de Exactus Impulso, y escoja la opción de Properties

Seleccione la página Options, y en el atributo Compatibility Level, seleccione de la lista el valor SQL

Server 2000 (80)

Presione el botón OK, para aceptar los cambios.




Solución: Este error se presenta cuando el componente EXCRYREPORT.DLL no se encuentra

registrado correctamente, para registrar este dll ejecute la siguiente sentencia en el RUN de

su sistema operativo:

Este componente esta en la carpeta de instalación de Exactus.

NOTA: El nombre de este componente depende de la versión de cristal (ExCryReport.dll

para 9, ExCryReport10.dll para 10 y ExCryReportXI.dll para 11).




Este error se presenta con subreportes en bases de datos ORACLE, cuando falla la conexión

del subreporte con el servidor.

Esto sucede porque Exactus se conecta con solo el nombre del servicio Oracle, cuando los

subreportes en algunos casos requieren el nombre del servicio y el dominio en el que se

encuentra, por ejemplo: ORA500M.exactus.com.

Solución:

Una posible solución es cambiar la conexión del subreporte, si es por medio de ODBC

cambiarla por una conexión directa con el driver de ORACLE, esto en la herramienta Crystal

Reports de desarrollo.

Otra posible solución es generar un archivo llamado sqlnet.ora en la misma ruta donde se

encuentre el TNSNAMES.ORA (por ejemplo: C:\oracle\ora92\network\ADMIN\) con el

siguiente contenido:

# SQLNET.ORA Network Configuration File: C:\oracle\ora92\network\admin\sqlnet.ora # Generated by Oracle configuration tools. NAMES.DEFAULT_DOMAIN = exactus.com SQLNET.AUTHENTICATION_SERVICES= (NTS) NAMES.DIRECTORY_PATH= (TNSNAMES)

Este archivo debe ser editado para cambiar el dominio exactus.com por el dominio

correspondiente. De esta manera la conexión ORACLE del reporte identifica el dominio

actual.

6. Instalación del deploy para servidores terminal:

Cuando se instala en un servidor y los usuarios se van a conectar por medio de terminal es

posible que se presente el siguiente error:



Solución: Este error se debe a una falta de privilegios del perfil del usuario raso que se conecta al

servidor por medio de terminal. Para solucionar el problema es necesario instalar el deploy

de crystal reports en el perfil de este usuario raso de manera que le permita accesar a las

entradas del registro que requiere, esto solo seria necesario hacerlo con un usuario raso y al

funcionar quedara listo para los demás usuarios rasos.

Adicionalmente estas entradas ya están identificadas y listadas en un archivo .REG de

manera que otra posible solución del problema seria ejecutar este archivo según corresponda

la versión del deploy. Es importante denotar que este archivo contiene unas variables que se

llaman [CommonFilesFolder] y [SystemFolder] que deben ser reemplazadas por sus

correspondientes rutas en la maquina actual. Por ejemplo la hilera siguiente:

@="[CommonFilesFolder]Crystal Decisions\\1.0\\Bin\\SACommonControls.dll"

Cambia por lo siguiente: @="C:\\Program Files\\Common Files\\Crystal Decisions\\1.0\\Bin\\SACommonControls.dll"

Y la siguiente:

@="[SystemFolder]CRiadx09.dll"

Por la siguiente:

@=" C:\\WINDOWS\\system32\\CRiadx09.dll"

Como se ve en el ejemplo se sustituyen las variables por las rutas correspondientes de la

maquina utilizando doble \\. Lo recomendado es abrir los archivos con el notepad y realizar

un reemplazar.

Los archivos son los siguientes:

ftp://ftp.exactus.com/exactus/Instaladores/Otros/Crystal-9/Todos los usuarios Crystal 9.reg

ftp://ftp.exactus.com/exactus/Instaladores/Otros/Crystal-9/





7. Error en el reporte de comprobantes de pago en CN600:

En el caso de que se presenten los siguientes errores:

Solución: Este error se debe a que estos reportes son directos y en el caso de ORACLE pueden requerir

más información de conexión que lo que le pasa Exactus; esto en el caso de que requiera el

dominio del servidor. Para solucionar el problema refiérase al punto 4 de esta misma sección

de errores comunes.

Otra posible razón de estos errores es que se encuentren instaladas varias versiones del

cliente de ORACLE en la maquina en cuyo caso lo recomendable es desinstalar las versiones

anteriores y dejar solo la última versión funcionando.

8. El siguiente error puede presentarse al imprimir cualquier reporte:





Solución: Este error se debe a que una función que esta siendo utilizada en las formulas no existe en el

componente CRUFLCRB.dll que esta registrado en la maquina, posiblemente porque se esta

utilizando una versión no actualizada. La solución es buscar este archivo en toda la maquina,

desregistrar los anteriores y registrar el último liberado.

La sentencia para registrar es la siguiente (por ejemplo):

REGSVR32 “C:\Exactus\CRUFLCRB.DLL”

La sentencia para desregistrar es la siguiente (por ejemplo):

REGSVR32 -u “C:\Exactus\CRUFLCRB.DLL”

Ejemplo de las funciones del CRUFLCRB.dll en un reporte:

9. Otro error posible es el siguiente:



Solución: Cuando se presenta este error es posiblemente porque el ODBC de Crystal esta mal

configurado, lo recomendable es revisar el ODBC y probar que tenga bien direccionada la

carpeta DATA .


Solución:



Este error se debe a que no se encuentra bien instadlo el componente EXCRYREPORT.dll

de la versión correspondiente, es necesario buscarlo en la maquina y registrarlo con la

sentencia REGSVR32 “C:\EXACTUS\EXCRYREPORT.dll” (por ejemplo).


Solución: Este error se debe a que el reporte no reconoce uno de los campos que se están mandando. Si

es un reporte standard que funciona con XML es recomendable revisar que exista el DTD

correspondiente y que al editar el reporte no de problemas. Si es un reporte directo también

se recomienda editarlo para determinar el problema.


Solución: Cuando se presenta este problema es posiblemente porque el deploy de Crystal se encuentra

mal instalado, en este caso hay que revisar el ODBC y verificar que tenga la dirección de la

carpeta data correcta. Si al tratar de ver la carpeta DATA no se despliega nada es porque esta

mal instalado y es necesario reinstalar, este problema también se presenta cuando en la

misma maquina están instalados los deploy de Crystal 10 y Crystal 11 que no son

compatibles.




Solución: Cuando se presenta este problema es porque en el reporte se añadió un subreporte con una

conexión directa que no está funcionando. Lo recomendable es utilizar para esta conexión el

mismo ODBC que se utiliza para la base de datos EXACTUS en el caso de SQL Server, y

para ORACLE utilizar la conexión directa al driver de Oracle y verificar si es necesario

utilizar el nombre del dominio en la conexión como se describe en el punto 5 de esta sección

de errores comunes.


Solución: El problema puede presentarse porque está definida la variable de entorno relacionada con

los archivos temporales del usuario terminal a una ruta inexistente, al momento de redefinir

el valor de esta variable a una ruta correcta se arregla.



14. Error en los reportes directos con conexiones de ORACLE:

Solución: Si se da el caso de un servicio de oracle que se llama igual al dominio y en el

TNSNAMES esta como EXACTUS.EXACTUS.com (por ejemplo) es necesario que se

coloque de primero en el TNSNAMES pues de no ser asi da problemas a la hora de imprimir

los reportes con conexiones directas a Oracle. Este error tambien se presetna si el cliente de

ORACLE de la maquina es menor que 9i.2.0.

Documents

Manual Usuario Instalacion Crystal Reports[1]