Integración Crystal Reports vs. Microsiga Protheus® 10

En Microsiga Protheus® 10 se pueden utilizar informes creados por el generador de informes Seagate Crystal Reports (versión 6.5 o posterior). Este recurso es válido para los entornos Windows 98/Me, NT, 2000 y XP, según la versión del Crystal compatible con dichos sistemas operativos. Para que esto sea posible, deben seguirse los siguientes procedimientos:

Crystal Reports:

• La versión que Totvs comercializa es Crystal Reports 8.0 Professional, que no viene con manual impreso por tratarse de una versión OEM.
• La versión instalada del Crystal Reports deberá ser 6.5 o superior, con acceso a la Base de Datos por ODBC (algunas versiones no permiten este acceso). Todo informe elaborado en el Crystal debe acceder a las tablas por ODBC o por Stored Procedure. Totvs no ha homologado otros tipos de acceso.
• Totvs homologó las versiones 7.0, 8.0, 8.5 y 9.0 para que funcionen en conjunto con Microsiga Protheus® 10. Otras versiones pueden no efectuar correctamente la integración.
• El Crystal Reports Full o sólo la versión Client (de preferencia) debe instalarse en cada estación de trabajo. En este último caso, el Crystal Reports Full debe estar instalado en el servidor. Para instrucciones más detalladas, lea el manual del Crystal Reports.

   Si su versión del Crystal es 8.0, entonces no tendrá instalador para las estaciones como las versiones anteriores. Para habilitar las estaciones que llamen a los informes Crystal a través del sistema Microsiga Protheus® 10 debe generarse un paquete de instalación en el diseñador del Crystal.

   Esta opción no viene instalada en el Diseñador de la versión 8.0. Para instalar esta opción, vaya al sitio www.seagatesoftware.com y acceda al enlace \"Compiled Reports and Report Distribution Expert For Crystal Reports 8\".

Existen varios enlaces para diferentes lenguajes. Seleccione el que sea compatible con su versión. Descárguelo y ejecútelo. A continuación, acceda a la opción \"Compile Report\" en el diseñador del Crystal Reports versión 8.0 en el menú Report.

Con esta opción se puede generar un instalador para cualquier informe. Este instalador se genera en el directorio que el usuario indique. Ejecute el instalador (setup.exe) en cada estación. De este modo, se instalarán las DLL necesarias en cada estación.

Observe que para generar este instalador primero debe crearse un informe y basándose en éste, generar el instalador. Esta operación debe efectuarse una sola vez. No es necesario generar un instalador para cada informe.

• Para la versión 9.0 vea las instrucciones en el FTP de TOTVS, en la carpeta Crystal\Crystal9.
• En cada estación, a partir del CD de instalación de Microsiga Protheus® 10, en el directorio \DRIVERS CRYSTAL, ejecute el setup.exe. Este procedimiento instalará algunos drivers necesarios para la integración entre el Microsiga Protheus® 10 y el Crystal Reports.
• En cada estación, cree un DataSource ODBC que apunte a la base de datos de Microsiga Protheus® 10. Este DataSource debe tener el mismo nombre en todas las estaciones. Todo informe construido para ser accedido a través de Microsiga Protheus® 10 debe utilizar este DataSource ODBC. Se puede crear un DataSource ODBC a través del Panel de Control - 32 bits ODBC. El tipo de driver del DataSource depende del tipo de base de datos (DBF, SQL SERVER, ORACLE, SYBASE, INFORMIX, BTRIEVE, etc).  Este DataSource ODBC es necesario para la conexión entre los informes que se generarán y la base de datos deMicrosiga Protheus® 10. Si usted está utilizando  acceso a una base DBF, utilice el driver Microsoft Visual FoxPro driver (si existe) o el Microsoft Fox Pro Driver, en vez del Microsoft Dbase Driver.
• TOTVS no distribuye los drivers ODBC para las diferentes bases de datos. Solamente las empresas que los comercializan lo hacen. Entonces, si no tiene el driver ODBC para su base, entre en contacto con la empresa proveedora correspondiente.
• Si adquirió la versión del Crystal Reports a través de TOTVS, para ejecutar el Crystal Reports Designer (Proyectista de Informes) es necesario que se esté ejecutando algún entorno de Microsiga Protheus® 10 en la estación que desea  acceder al Crystal Reports Designer. En caso contrario, no se ejecutará el diseñador del Crystal.

Microsiga Protheus® 10:

• El nombre del informe creado en el Crystal debe tener, como máximo 6 caracteres, si desea utilizar las preguntas del SX1.
• Coloque todos los informes generados por el Crystal (*.rpt) en un directorio. Este directorio debe informarse en el parámetro MV_CRYSTAL. Dicho directorio debe ser subdirectorio del raíz de Microsiga Protheus® 10.

Ejemplo: \CRYSTAL\, que es subdirectorio de raíz \Protheus10. Es obligatorio informar este parámetro.

• Para insertar un informe del Crystal Reports en el menú de cualquier entorno de Microsiga Protheus® 10, basta insertar en el menú un ítem cuyo nombre del programa que activará es el del informe precedido por una @ (arroba).
• Si desea utilizar parámetros en el informe del Crystal de la misma manera que en Microsiga Protheus® 10 a través del SX1, proceda según los siguientes pasos:
• Cree en su informe Crystal los parámetros deseados y asócielos a una condición de filtro o a una fórmula (vea el Help del Crystal).
• En el SX1 cree los mismos parámetros (preguntas), siguiendo siempre su orden de creación en el informe del Crystal. Por ejemplo: el primer parámetro creado en el informe del Crystal debe tener el X1_ORDEM como 01 y así en adelante.
• El X1_GRUPO debe ser el nombre del Informe. Si el nombre del informe es \"CRYS_1.RPT\", el contenido del X1_GRUPO debe ser \"CRYS_1\". Esto limita el tamaño del nombre del informe a 6 posiciones.
• Después de registrar las preguntas en el SX1, al acceder al informe de dentro de cualquier entorno de Microsiga Protheus® 10, se pueden configurar las preguntas del mismo modo que cualquier otro informe estándar de Microsiga Protheus® 10.

 

• Al acceder a un informe del Crystal a partir de Microsiga Protheus® 10, el sistema muestra una pantalla estándar de configuración de un informe. Hay sólo dos modificaciones con relación a un informe de Microsiga Protheus® 10: en vez de imprimir en disco, el Crystal imprime en video y también hay un checkbox llamado \"Actualiza\". Si está marcado (default), el sistema actualiza los datos del informe en pantalla, de lo contrario, Microsiga Protheus® 10 muestra los datos grabados en el informe impreso (el Crystal puede grabar los datos en el archivo .rpt):

Observe que existen opciones que no están habilitadas, porque se configuran en el mismo informe del Crystal. La impresora de destino es siempre la marcada como default en el Windows.

• Al ejecutar un informe, el sistema considera los archivos de la empresa en uso.

Por ejemplo: considere un informe construido a partir de los archivos de la empresa 01. Al acceder a Microsiga Protheus® 10 y seleccionar empresa 02, este informe mostrará los datos de la empresa en uso (empresa 02). Por lo tanto, no se necesita construir el mismo informe para diferentes empresas.

• La primera vez que se ejecuta cualquier informe de una estación se muestra una pantalla de configuración para Microsiga Protheus® 10:

 

• Informe los parámetros solicitados. Esta pantalla se muestra una sola vez.

Nota:

El directorio SYSTEMLOAD debe estar visible en todas las estaciones que acceden a los informes del Crystal Reports.

Observe que si el Servidor de Microsiga Protheus® 10 y el directorio SYSTEMLOAD están en un servidor Linux, se debe haber instalado el utilitario SAMBA en el servidor LINUX para que el compartimiento de los directorios esté activo.

 

 

Tratamiento de Sucursales:

Como los campos de sucursales en el sistema influyen directamente en toda relación entre tablas, no se deben relacionar los campos sucursales de las tablas en el Crystal, pues de este modo se pueden traer resultados nulos a su informe, ya que en algunas tablas el campo sucursal está vacío y en otras, el campo sucursal se rellena con el código de la sucursal, dependiendo de su configuración encontrada en el archivo SX2.

 

Cómo preparar un filtro por sucursal en un informe:

Supongamos que el sistema opera en el entorno Compras, en la empresa 01 y sucursal 01. Para que Microsiga Protheus® 10 respete las sucursales de cada tabla dentro del informe basta crear en el informe una fórmula con el nombre de TRATAFILIAL, cuyo contenido deberá ser ‘S’. A continuación, al ejecutar el informe, Microsiga Protheus® 10 efectúa un filtro automáticamente por las sucursales de las tablas utilizadas.

• Esta operación no es válida para informes generados a través de Diccionarios. En estos casos, se debe crear un filtro para las sucursales para cada informe.

 

 

Tratamiento de Registros Borrados en Bases Relacionales:

Como los registros borrados de las tablas de Microsiga Protheus® 10 creadas en entorno TOP Connect se marcan con un \"*\" (asterisco) en determinado campo, los informes creados basados en ODBC para bases que trabajen bajo el TOP siempre deben tener un filtro para que ignoren estos registros borrados. Para que Microsiga Protheus® 10 ignore automáticamente todos los registros borrados de todas las tablas involucradas, basta crear una fórmula con el contenido ‘S’ en el informe llamada \"TRATASQLDEL\" .

• Esto no es válido para informes generados a través de diccionarios. En este caso, para cada informe se deberá crear un filtro para considerar los registros borrados de las tablas.

 

 

Cómo accederá a un Informe a través de un Rdmake:

Para acceder a un informe del Crystal a través del menú de Microsiga Protheus® 10, basta insertarlo en el menú del entorno deseado, observando que debe colocarse una \"@\" (arroba) adelante del nombre del informe. No obstante, hay casos en que se debe crear un archivo temporario (generalmente un DBF) para generar el informe.

Esto es común cuando no se puede obtener el resultado esperado a través de relaciones entre las tablas involucradas. La solución es crear una función en Microsiga Protheus® 10 que cree un archivo DBF con el resultado deseado para que entonces se cree un informe Crystal sobre el mismo.

Entonces se puede acceder al informe Crystal inmediatamente después de generar el archivo DBF, dentro del Rdmake, por la función CALLCRYS. La sintaxis de la función es:

CALLCRYS (rpt , params, options), donde

 

rpt = Nombre del informe, sin el camino.

params = Parámetros del informe, separados por coma o punto y coma. Si se marca este parámetro, se ignorarán los parámetros marcados en el SX1.

options = Opciones para que no se muestre la pantalla de configuración de impresión, con el formato x;y;z;w, donde:

x = Impresión en Video (1) o Impresora (2)

y = Actualiza Datos (0) o No (1)

z = Número de Copias

w =Título del Report

 

Ejemplo:

User Function ImpRep01()

Local cParams,cOptions

//Trecho de creación del archivo Temporario

:

:

:

//Activación de la función CallCrys          

cParams := “000001;1/10/00;31/10/00;SP”

cOptions := \"2;0;2;Pedido de Compras\"

CallCrys(‘REP01’, cParams,cOptions)

Return .T.

 

 

• Si el segundo parámetro fuera muy grande, deberá grabarse en un archivo temporario con extensión .TXT y pasar este archivo como parámetro. Según el ejemplo anterior:

User Function ImpRep01()

Local cParams,cOptions,cFile

//Trecho de creación del archivo Temporario DBF

:

:

:

//Activación de la función CallCrys            

cParams := “000001;1/10/00;31/10/00;SP;Empresa Brasileira de Comércio Varejista e Atacado”

cFile := CriaTrab(nil,.f.)+”.Txt”

//Graba el contenido de cParams en el archivo creado recientemente

:

:

:

:

cOptions := \"2;0;2;Pedido de Compras\"

CallCrys(‘REP01’,cFile,cOptions)

Return .T.

 

Generador de Diccionarios del Crystal:

 

• Además de la integración con los informes del Crystal, ponemos a disposición un utilitario cuyo objetivo es facilitarle la construcción de diccionarios del Crystal a los usuarios de Microsiga Protheus® 10. Podemos accederlo a través del menú Misceláneas en el Diccionario Crystal.  Encontrará informaciones más detalladas en su respectivo Help on line.

 

• Observe que el uso del Diccionario del Crystal es totalmente opcional. Es posible hacer informes en el Crystal sin construir un diccionario.

 

Archivos Relacionados:

Algunos archivos para integración con el Crystal se instalan en el mismo servidor que Microsiga Protheus® 10, en el directorio \BIN, tanto en la estación como en el servidor. (Si esto no ocurre, se deberá reinstalarlos a través del instalador de Microsiga Protheus® 10):

• SGCRYS32.EXE, localizado en el directorio de los SX, es responsable por la ejecución del Informe.
• SIGACRYS.EXE, localizado en el directorio de los SX, es el Generador de Diccionarios.
• CIVTEXT.EXE, localizado en el directorio de los SX, es un utilitario para el Generador.
• DLLs del CivText: CIVAPI32.DLL y CIAPI32.DLL , localizados en el directorio de los SX.
• Helps (HLPCRY.HLP, HLPCRY1.HLP y HLPCRY2.HLP), localizados en el directorio de los SX.
• En la estación son necesarios dos DLLs (instalados a través de la carpeta \DRIVERS del CD, conforme se mencionó anteriormente): CRWDNR.DLL y CRWDNR16.DLL, instalados en el directorio System del Windows (System32 en el NT/2000/XP).