PDF de programación - Manual de instalación de jasperreports para sugar crm

MANUAL DE INSTALACIÓN DE JASPERREPORTS

PARA SUGAR CRM

JasperReports
Descarga del módulo de JasperReports.....................................................................................................2
Instalación de JasperR eports en Apache Tomcat 5.5...............................................................................2
Acceso a la interfaz web de JasperReports­sugarcrm...............................................................................3
Ejemplo: Informes.....................................................................................................................................4

Descarga del módulo de JasperReports

JasperReports se distribuye en dos paquetes diferentes. Por un lado jasperreports­sugarcrm­src.zip que 
contiene todo el código fuente y una copia del servidor Apache Tomcat que se configurará una vez 
que la aplicación se instaladado. Por otro lado jasperreports­sugarcrm.zip, que contiene una copia 
preconfigurada de Tomcat, sin el código fuente. Ambas opciones nos llevarán al mismo lugar y puede 
escogerse cualquiera de ellas, pero en este manual tomaremos la segunda, con el añadido de que 
realizaremos la instalación en un Tomcat previamente instalado en la máquina (sin utilizar el Tomcat 
preconfigurado que viene con el módulo). Ambos paquetes puedes descargarse de la siguiente 
dirección: http://www.sugarforge.org/frs/?group_id=193. 

Instalación de JasperReports en Apache Tomcat 5.5

PASO 1: parar Tomcat.

PASO 2: añadir las siguientes líneas a /conf/server.xml modificando los datos referentes a la 
configuración de la máquina:

  ...

<GlobalNamingResources>

<!-- Test entry for demonstration purposes -->
<Environment name="simpleValue" type="java.lang.Integer" value="30"/>

<!-- Editable user database that can also be used by
UserDatabaseRealm to authenticate users -->
<Resource name="UserDatabase" auth="Container"
type="org.apache.catalina.UserDatabase"
description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
pathname="conf/tomcat-users.xml" />
<Resource name="jdbc/jasperreports-sugarcrm" auth="Container"
type="javax.sql.DataSource"
maxActive="100" maxIdle="30" maxWait="10000"
username="sugarcrm" password="sugarcrm"
driverClassName="com.mysql.jdbc.Driver"
url="jdbc:mysql://localhost:3306/sugarcrm?autoReconnect=true"/>

</GlobalNamingResources>

  ...



PASO 3: añadir un contexto para jasperreports­sugarcrm en la definición de host adecuada 
(probablemente localhost): 

     ...

<Host name="localhost" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">

<!-- JasperReports for SugarCRM Context -->
<Context path="/jasperreports-sugarcrm" docBase="jasperreports-sugarcrm" debug="99"
reloadable="true" crossContext="true" useNaming="true">

<Logger className="org.apache.catalina.logger.FileLogger"
prefix="localhost_jasperreports_sugarcrm_log." suffix=".txt"
timestamp="true"/>

<Realm className="net.sf.jasperreports.sugarcrm.realm.SugarDataSourceRealm"
dataSourceName="jdbc/jasperreports-sugarcrm"
digest="md5" userNameCol="user_name" userRoleTable="roles"
userTable="users" debug="99" />



<ResourceLink global="jdbc/jasperreports-sugarcrm"
name="jdbc/jasperreports-sugarcrm"
type="javax.sql.DataSource"/>
</Context>

...

PASO 4: Copiar el directorio jasperreports­sugarcrm y todo su contenido (del archivo .zip 
descargado) al directorio raiz del Tomcat del servidor (en este ejemplo /usr/share/tomcat5.5/webapps/)

PASO 5: Del directorio catalina/common/lib/de la distribución de jasperreports­sugarcrm habrá que 
copiar los siguientes jars al directorio WEB­INF/lib/ de la carpeta jasperreport­sugarcrm en nuestro 
servidor:

● commons­dbcp.jar
● commons­pool­1.1.jar

PASO 6: Añadir sugarrealm­for­tomcat5_5.jar a la carpeta server/lib en nuestro servidor

PASO 7: Arrancar Tomcat.

Acceso a la interfaz web de JasperReports­sugarcrm

Para acceder a la interfaz web de JasperReports hay que introducir la siguiente dirección en la barra 
del navegador: http://ip­del­servidor:8080/jasperreports­sugarcrm con lo que debería acceder a la 
siguiente páquina de acceso:

Tanto el nombre de usuario como la contraseña deben pertenecer ya a SugarCRM, pues es el acceso a 
la información de dicha aplicación lo que hay que autenticar. Una vez loggeado satisfactoriamente, se 
accede a la página principal de JasperReports, en la cual se muestran algunos criterios para realizar 
informes en función a la información almacenada en SugarCRM:

Ejemplo: Informes

Veamos, como ejemplo, el caso de Closed Deals (Tratos cerrados):

Una vez introducida la fecha hasta la cual se quiere la información, y los datos opcionales, se obtendrá 
el informe correspondiente:

Además del informe correspondiente, también puede apeciarse que dicho informe puede exportarse 
mediante un simple click tanto a PDF como a documento de Word o de Excel (en el recuadro rojo). 
Basta hacer clic sobre el icono correspondiente para que el informe sea exportado de forma sencilla a 
dicho formato.

Pese a que esta versión inicial consta solo de 5 tipos de informe diferentes, pronto habrá más 
disponibles, y si no, siempre queda la opción de desarrollar nuestros propios informes en base a 
criterios de búsqueda y comparación personalizados. Para ello podemos valernos de la herramienta 
JasperAssistant, que facilita en gran medida dicha tarea.