Integria Asd IMS Guia Usuario ES

Manual
de uso y administracin
v4.0
Tabla de contenidos
Integria IMS 4.0 Manual de uso y administracin

PDF Version
1 Edicin, 19 Noviembre 2013
Artica Soluciones Tecnolgicas 2009-2013

Puede ver la versin online actulizada de esta documentacin en
http://wiki.integriaims.com

Pag 2
Tabla de contenidos
1. Tabla de contenidos

1. TABLA DE CONTENIDOS ......................................................................................................................................... 3
2. INTRODUCCIN .......................................................................................................................................................... 9
QU ES INTEGRIA IMS? ......................................................................................................................................................... 9
ACERCA DE INTEGRIA IMS ..................................................................................................................................................... 9
CARACTERSTICAS GENERALES .............................................................................................................................................. 9
GESTIN DE INCIDENCIAS (TICKETING) ............................................................................................................................ 10
GESTIN DE PROYECTOS ...................................................................................................................................................... 10
SISTEMA DE GESTIN DE CLIENTES (CRM) ..................................................................................................................... 11
WIKI ......................................................................................................................................................................................... 11
INVENTARIO (CMDB) .......................................................................................................................................................... 11
QU SE NECESITA PARA INSTALAR INTEGRIA IMS? ...................................................................................................... 11
3. INSTALACIN DE INTEGRIA .............................................................................................................................. 12
DEPENDENCIAS NECESARIAS ............................................................................................................................................... 12
INSTALACIN DESDE LAS FUENTES .................................................................................................................................... 12
INSTALACIN PREVIA DE SOFTWARE NECESARIO ............................................................................................................ 12
DESCARGA DE LAS FUENTES ................................................................................................................................................ 13
INSTALACIN .......................................................................................................................................................................... 13
INSTALACIN EN UN ENTORNO DE HOSTING WEB ......................................................................................................... 20
INSTALACIN MEDIANTE PAQUETES .................................................................................................................................. 21
INSTALACIN DE INTEGRIA IMS MEDIANTE EL PAQUETE .DEB .................................................................................. 21
INSTALACIN DE INTEGRIA IMS MEDIANTE EL PAQUETE .RPM .................................................................................. 22
INSTALACIN DE INTEGRIA IMS EN WINDOWS .............................................................................................................. 22
INSTALACIN DE WAMP ..................................................................................................................................................... 22
INSTALACIN DE INTEGRIA ................................................................................................................................................. 25
INSTALACIN DE LA VERSIN ENTERPRISE ...................................................................................................................... 33
INSTALACIN DE LA VERSIN ENTERPRISE EN WINDOWS ............................................................................................ 34
INSTALACIN DE SCRIPT DE MANTENIMIENTO ................................................................................................................ 36
EN SISTEMAS UNIX ................................................................................................................................................................ 36
EN SISTEMAS WINDOWS ...................................................................................................................................................... 37
ACTUALIZACIN DE INTEGRIA ............................................................................................................................................ 37
ACTUALIZACIN CON RPM .................................................................................................................................................. 37
ACTUALIZACIN CON DEB .................................................................................................................................................. 38
ACTUALIZACIN CON TARBALL .......................................................................................................................................... 38
DESPUES DE ACTUALIZAR .................................................................................................................................................... 38
4. USUARIOS EN INTEGRIA ..................................................................................................................................... 39
USUARIOS Y GRUPOS ............................................................................................................................................................. 39
USUARIOS ................................................................................................................................................................................ 39
MEN "MI USUARIO" ............................................................................................................................................................ 40
MEN "INFORMES DE USUARIO" ........................................................................................................................................ 43
INFORMES DE USUARIO ......................................................................................................................................................... 43
GESTIN DE USUARIOS (COMO ADMINISTRADOR) .......................................................................................................... 49
Pag 3
Tabla de contenidos
GESTIONAR ROLES ................................................................................................................................................................. 52

IMPORTAR USUARIOS DESDE CSV ...................................................................................................................................... 53
GRUPOS ................................................................................................................................................................................... 54
GESTIN DE GRUPOS ............................................................................................................................................................. 54
GESTIN DE COLA DE MAILS ................................................................................................................................................ 56
PERFILES Y USUARIOS ........................................................................................................................................................... 57
TIPOS DE USUARIOS ............................................................................................................................................................... 58
TABLA DE FLAGS PARA ACL ................................................................................................................................................ 58
5. GESTIN DE INCIDENCIAS ................................................................................................................................. 63
UN EJEMPLO DEL FLUJO DE TICKETING CON INTEGRIA ................................................................................................... 63
ESTADOS DE UNA INCIDENCIA ............................................................................................................................................. 67
USUARIOS EN UNA INCIDENCIA ........................................................................................................................................... 68
CREADOR DEL INCIDENTE .................................................................................................................................................... 68
RESPONSABLE DEL INCIDENTE ........................................................................................................................................... 68
USUARIO CON ACCESO DE ESCRITURA AL INCIDENTE ..................................................................................................... 69
USUARIO CON ACCESO DE LECTURA AL INCIDENTE ......................................................................................................... 69
USUARIO CON ACCESO DE GESTIN AL INCIDENTE .......................................................................................................... 69
USUARIO QUE CIERRA LA INCIDENCIA ................................................................................................................................ 69
USUARIO ADSCRITO A UNA INCIDENCIA ............................................................................................................................. 69
PRIMEROS PASOS CON UNA INCIDENCIA ............................................................................................................................ 70
TIPOS DE INCIDENCIA ........................................................................................................................................................... 70
CREACIN DE UNA INCIDENCIA ........................................................................................................................................... 71
PRIMER TRABAJO CON LA INCIDENCIA: CREACIN DE LA PRIMERA UT ...................................................................... 75
DASHBOARD (VISTA PRINCIPAL) ....................................................................................................................................... 75
VISTA DE BSQUEDA ............................................................................................................................................................. 76
ESTADSTICAS DE UN INCIDENTE / INFORME GENERAL ................................................................................................. 79
OPERACION SOBRE LA INCIDENCIA .................................................................................................................................... 81
BSQUEDAS DE INCIDENTES PERSONALIZADOS ............................................................................................................... 85
GESTIN DE SLA ................................................................................................................................................................... 85
CREACIN DE INCIDENCIAS A TRAVS DE UN FORMULARIO WEB ................................................................................. 88
GESTIN DE INCIDENCIAS POR EMAIL ................................................................................................................................ 91
CREAR UNA INCIDENCIA POR EMAIL .................................................................................................................................. 93
AADIR NUEVA WORKUNIT ................................................................................................................................................. 95
ACTUALIZACIN DE INCIDENCIAS Y PERSONALIZACIN DE WORKUNITS .................................................................... 96
ENMASCARAR DIRECCIONES DE CORREO WORKUNITS ................................................................................................... 97
6. SISTEMA DE GESTIN DE PROYECTOS ........................................................................................................ 99
PROYECTOS Y TAREAS ........................................................................................................................................................... 99
ASIGNACIN DE RECURSOS DE PERSONAL ..................................................................................................................... 100
CREACIN DE UNA TAREA NUEVA .................................................................................................................................... 102
TAREAS Y COSTES ............................................................................................................................................................... 103
BORRADO DE TAREAS Y PROYECTOS ............................................................................................................................... 103
GESTIN DE PROYECTOS CON EL PLANIFICADOR DE TAREAS .................................................................................... 104
INFORMES Y RESULTADOS ................................................................................................................................................. 106
MAPA DE TIEMPO PROYECTOS POR PERSONA ............................................................................................................... 106
OVERVIEW DE PROYECTO ................................................................................................................................................. 107
PLANIFICADOR DE TAREAS ............................................................................................................................................... 108
MAPA DE TIEMPO ............................................................................................................................................................... 109
DIAGRAMA GANTT INTERACTIVO .................................................................................................................................... 109
OVERVIEW DE TAREA ........................................................................................................................................................ 110
Pag 4
Tabla de contenidos
DETALLE DE IMPUTACIONES DE HORAS ......................................................................................................................... 111

CREACIN DE NUEVAS UNIDADES DE TRABAJO (WU) ................................................................................................. 112
FICHEROS ADJUNTOS A LAS TAREAS ................................................................................................................................ 114
MOVER TAREA ..................................................................................................................................................................... 115
INFORME DE TAREA ........................................................................................................................................................... 115
SEGUIMIENTO DE TAREAS ................................................................................................................................................. 116
INFORMES GENERALES DE SEGUIMIENTO ...................................................................................................................... 117
RDENES DE TRABAJO ....................................................................................................................................................... 119
NOFICACIONES POR EMAIL ............................................................................................................................................... 120
CREACIN DE NOTAS POR EMAIL ..................................................................................................................................... 120
ASIGNACIN DE TAREAS GLOBALES ................................................................................................................................ 120
7. GESTIN DE CLIENTES (CRM) ....................................................................................................................... 122
CUENTAS/COMPAAS ...................................................................................................................................................... 122
ROLES DE EMPRESAS .......................................................................................................................................................... 122
CONTACTOS ......................................................................................................................................................................... 122
CONTRATOS ......................................................................................................................................................................... 123
FACTURAS ............................................................................................................................................................................ 124
BLOQUEO DE FACTURAS .................................................................................................................................................... 126
VISTA PRINCIPAL (EMPRESAS) ........................................................................................................................................ 126
INFORMES Y LISTADOS ....................................................................................................................................................... 128
LEADS (OPORTUNIDADES) ............................................................................................................................................... 131
CREACIN DE UN LEAD A TRAVS DE UN FORMULARIO WEB ...................................................................................... 131
CAMPAAS ........................................................................................................................................................................... 135
EJEMPLO DE CREACIN DE UNA CAMPAA .................................................................................................................... 137
8. INVENTARIO .......................................................................................................................................................... 139
CREACIN DE UN TIPO DE OBJETO DE INVENTARIO ..................................................................................................... 139
CREACIN DE UN OBJETO DE INVENTARIO ..................................................................................................................... 142
BSQUEDAS DE INVENTARIO ............................................................................................................................................ 144
IMPORTAR DATOS DE INVENTARIO DESDE CSV ............................................................................................................ 147
SINCRONIZACIN DE INVENTARIO CON PANDORA FMS ............................................................................................. 147
INVENTARIO REMOTO BASADO EN AGENTES DE PANDORA FMS .............................................................................. 149
FUNCIONAMIENTO INTERNO DEL INVENTARIO REMOTO ............................................................................................ 150
INSTALACIN DE TENTACLE_SERVER ............................................................................................................................. 155
CONFIGURACIN DEL INVENTARIO REMOTO ................................................................................................................. 156
CONFIGURACIN DE LOS AGENTES DE PANDORA FMS ............................................................................................... 157
PERSONALIZACIN DEL INVENTARIO .............................................................................................................................. 157
9. BASE DE CONOCIMIENTO ................................................................................................................................ 158
INTRODUCCIN ................................................................................................................................................................... 158
GESTIN DE LA BASE DE CONOCIMIENTO ....................................................................................................................... 158
GESTIONAR CATEGORAS .................................................................................................................................................. 159
GESTIONAR PRODUCTOS ................................................................................................................................................... 160
CREAR UN NUEVO ARTCULO DE LA BC .......................................................................................................................... 161
CREAR UN NUEVO ARTCULO DESDE UN INCIDENTE .................................................................................................... 162
PERMISOS EN LA KB .......................................................................................................................................................... 162
10. SISTEMA DE DISTRIBUCIN DE FICHEROS .......................................................................................... 164
INTRODUCCIN ................................................................................................................................................................... 164
Pag 5
Tabla de contenidos
VISTA GENERAL .................................................................................................................................................................. 164

CREACIN DE UNA CATEGORA ........................................................................................................................................ 165
GESTIN DE ACCESO ........................................................................................................................................................... 166
CREACIN DE UNA FILE RELEASE .................................................................................................................................... 167
11. NEWSLETTER ..................................................................................................................................................... 169
EDICIONES ........................................................................................................................................................................... 169
DIRECCIONES ....................................................................................................................................................................... 170
COLA DE ENVO ................................................................................................................................................................... 171
VISUALIZACIN WEB DE LA NEWSLETTER ................................................................................................................... 172
FORMULARIO DE SUBSCRIPCIN DE LA NEWSLETTER ................................................................................................. 174
FORMULARIO DE DE-SUBSCRIPTION DE LA NEWSLETTER .......................................................................................... 176
12. WIKI ........................................................................................................................................................................ 177
SINTAXIS BSICA ................................................................................................................................................................. 177
CABECERAS .......................................................................................................................................................................... 177
LISTAS Y LISTAS NO ORDENADAS ..................................................................................................................................... 177
ENLACES, IMGENES, FICHEROS ...................................................................................................................................... 178
IMAGENES ............................................................................................................................................................................ 179
TABLAS DE CONTENIDO ..................................................................................................................................................... 179
CDIGO O PREFORMATO .................................................................................................................................................... 179
LINEA HORIZONTAL ........................................................................................................................................................... 180
EVITANDO EL FORMATO WIKI .......................................................................................................................................... 180
CODIGO HTML ................................................................................................................................................................... 180
LNEA EN BLANCO .............................................................................................................................................................. 180
MENU DEL WIKI .................................................................................................................................................................. 180
PERMISOS LECTURA Y ESCRITURA ................................................................................................................................... 181
13. CONFIGURACIN ............................................................................................................................................... 183
OPCIONES DE CONFIGURACIN ........................................................................................................................................ 184
CONFIGURACIN GENERAL ............................................................................................................................................... 184
CONFIGURACIN VISUAL ................................................................................................................................................... 186
CONFIGURACIN DE LA GESTIN DE PASSWORDS ........................................................................................................ 187
CONFIGURACIN DE INCIDENTES .................................................................................................................................... 187
CONFIGURACIN DEL CORREO ELECTRNICO ............................................................................................................... 189
PLANTILLAS DE CORREO ................................................................................................................................................... 192
VISIBILIDAD DEL MEN ..................................................................................................................................................... 194
INVENTARIO ........................................................................................................................................................................ 195
AUTENTICACIN ................................................................................................................................................................. 196
CRM ...................................................................................................................................................................................... 198
GESTIN DE DATOS VIEJOS ................................................................................................................................................ 200
GESTIN DE PROYECTOS ................................................................................................................................................... 200
HERRAMIENTAS DEL SISTEMA ......................................................................................................................................... 201
TRADUCCIN DE CADENAS ................................................................................................................................................ 201
GESTOR DE NOTICIAS GLOBALES DEL SISTEMA ............................................................................................................. 204
GESTOR DE SQL .................................................................................................................................................................. 204
GESTOR DE ARCHIVOS ........................................................................................................................................................ 204
ENLACES ............................................................................................................................................................................... 205
EVENTOS DEL SISTEMA ...................................................................................................................................................... 205
LOG DE AUDITORA ............................................................................................................................................................. 206
LOG DE ERRORES ................................................................................................................................................................ 206
Pag 6
Tabla de contenidos
SISTEMA DE ALERTAS Y NOTIFICACIONES ...................................................................................................................... 206

ACTUALIZADOR OFFLINE ................................................................................................................................................... 207
14. API EXTERNA DE INTEGRIA ......................................................................................................................... 209
SEGURIDAD .......................................................................................................................................................................... 209
AUTENTICACIN POR IP VLIDA ..................................................................................................................................... 209
AUTENTICACIN POR CONTRASEA ................................................................................................................................ 210
15. FUNCIONES DEL API ........................................................................................................................................ 211
RETORNO DE INFORMACIN SOBRE INTEGRIA IMS ..................................................................................................... 211
INCIDENTS ........................................................................................................................................................................... 211
GET_INCIDENTS ................................................................................................................................................................... 211
GET_INCIDENT_DETAILS .................................................................................................................................................... 212
CREATE_INCIDENT .............................................................................................................................................................. 212
UPDATE_INCIDENT ............................................................................................................................................................. 213
DELETE_INCIDENT .............................................................................................................................................................. 213
WORKUNITS ........................................................................................................................................................................ 214
GET_INCIDENT_WORKUNITS ............................................................................................................................................. 214
CREATE_WORKUNIT ........................................................................................................................................................... 214
FILES ..................................................................................................................................................................................... 215
GET_INCIDENT_FILES ......................................................................................................................................................... 215
DOWNLOAD_FILE ................................................................................................................................................................ 216
ATTACH_FILE ....................................................................................................................................................................... 216
DELETE_FILE ........................................................................................................................................................................ 217
USERS ................................................................................................................................................................................... 217
CREATE_USER ...................................................................................................................................................................... 217
VALIDATE_USER .................................................................................................................................................................. 218
LEADS ................................................................................................................................................................................... 218
CREATE_LEAD ...................................................................................................................................................................... 218
OTHERS ................................................................................................................................................................................ 218
GET_INCIDENT_TRACKING ................................................................................................................................................ 218
GET_INCIDENTS_RESOLUTIONS ........................................................................................................................................ 219
GET_INCIDENTS_STATUS ................................................................................................................................................... 219
GET_INCIDENTS_SOURCES ................................................................................................................................................. 220
GET_GROUPS ........................................................................................................................................................................ 221
GET_USERS ........................................................................................................................................................................... 221
GET_STATS ........................................................................................................................................................................... 222
GET_INVENTORIES .............................................................................................................................................................. 223
GET_LAST_CRON_EXECUTION ........................................................................................................................................... 223
GET_NUM_QUEUED_EMAILS .............................................................................................................................................. 224
16. EXTENSIN DEL API ........................................................................................................................................ 224
EJEMPLOS DE FUNCIONES PARA EL API ......................................................................................................................... 225
EJEMPLO DE FUNCIN QUE DEVUELVE UN NICO VALOR ............................................................................................ 225
EJEMPLO DE FUNCIN QUE DEVUELVE UNA LISTA DE VALORES ................................................................................. 225
17. SISTEMA DE EXTENSIONES ......................................................................................................................... 226
EXTENSIONES DE MEN .................................................................................................................................................... 226
CREANDO UNA EXTENSIN DE MEN .............................................................................................................................. 226
EXTENSIONES DE PREFERENCIAS .................................................................................................................................... 228
Pag 7
Tabla de contenidos
CREANDO UNA EXTENSIN DE PREFERENCIAS .............................................................................................................. 228

EXTENSIONES DE PESTAA ............................................................................................................................................... 228
CREANDO UNA EXTENSIN DE PESTAA ........................................................................................................................ 229
LISTAS DE PESTAAS DISPONIBLES ................................................................................................................................. 229
Pag 8
Introduccin
2. Introduccin
Qu es Integria IMS?
Integria IMS es una herramienta que nos permite hacer una gestin integral
para empresas, organizaciones y equipos de trabajo. IMS son las siglas de "ITIL
Management System", lo que implica que Integria sirve para gestionar una
organizacin desde el punto de vista ITIL [1].
A un nivel ms funcional, podemos definir Integria como una herramienta
para la gestin de proyectos, recursos humanos, imputacin de horas/time
tracking, seguimiento de incidencias (ticketing), combinado con un completo
sistema de inventario, y un sistema de CRM (gestion de clientes), un Wiki,
gestin de asignacin de tareas, una Base de conocimiento, un sistema de
distribucin de ficheros y algunas otras funcionalidades ms. Todo ello va
WEB, multiusuario / multiperfil.
Existe una parte Enterprise de Integria, que aade un sistema de ACL basado
en usuario, grupo y perfil para controlar el acceso a los diferentes elementos
de Integria. Es lo que diferencia principalmente la version OpenSource de la
versin Enteprise.
Acerca de Integria IMS

Integria IMS originalmente se dise como un sistema de
incidentes/seguimiento de bugs sencillo, pero orientado para ser multiusuario
y multigrupo, con soporte para diferentes perfiles y capacidad interna de
auditora. Integria fue un derivado parcial del proyecto Pandora FMS.
Aunque la primera versin vio la luz en 2007, realmente fue poco ms que un
proyecto interno con cdigo OpenSource liberado en Sourceforge. Despus
hubo varias versiones (1.1, 1.2, 2.0 y 2.1) entre 2008 y 2013 hasta que con la
versin 4.0 hemos cerrado una versin estable despus de varios aos
usndolo en nuestros clientes e internamente.
Integria IMS es desarrollado por una empresa de Madrid, [Artica ST]. `
La pgina web oficial es http://integriaims.com.
Caractersticas generales
Pag 9
Introduccin
Gestin de incidencias (ticketing).

Gestin de proyectos.
Gestin del tiempo (time tracking).
Gestin del conocimiento (knowledgue base).
Sistema de inventario (cmdb).
Agenda.
Wiki.
Gestin de leads, empresas, contratos, contactos y facturas (CRM).
Entorno centralizado de descargas de software.
Control de personal.
Integria es una herramienta que se puede usar en modo "onsite" (instalado en
un servidor Windows o Linux) o como servicio, en un hosting (modo SAAS). Es
una herramienta 100% web, con una interfaz de usuario traducida a varios
idiomas (Espaol, Ingls, Chino, Portugus, Ruso, Francs, Italiano entre otros
idiomas).
A continuacin se detallan las caractersticas generales de cada una de las
funcionalidades principales de Integria IMS.
Gestin de incidencias (Ticketing)

Integria IMS implementa un sistema de gestin de incidencias o ticketing. Se
puede utilizar en proyectos de desarrollo de software, como herramienta de
helpdesk o adaptado a sus necesidades para atender cualquier necesidad de
interacin con clientes o usuarios. Permite notificacin por correo en ambos
sentidos, incluida la creacin de tickets a travs de email. Dispone de una
interfaz completa web, una interfaz simplificada WEB y una interfaz para
dispositivos mviles. Se pueden crear tipos personalizados de incidencia con
campos personalizados para cada tipo. Con integria puede implementar una
metodologa gil (KANBAN) o un sistema ms clsico de gestin de tickets.
Se puede hacer un seguimiento pormenorizado de cada estado de la
incidencia, su tiempo total, y el grado de cumplimiento de SLA. El sistema
tambin dispone de una herramienta para medir el nivel de satisfaccin del
cliente.
Gestin de proyectos
Integria se puede emplear para hacer una metodologa clsica de proyectos
(basada en Gantt, hitos y tareas) o tambin en metodologas giles (SCRUM).
Dispone de varios tipo de informes y tiene mtricas basadas en tiempo y
costes.
Pag 10
Introduccin
Permite definir roles y costes a cada rol e integra simultneamente la

planificacin con la imputacin de costes y tiempos. Todas las actualizaciones
se notifican va email.
Sistema de gestin de clientes (CRM)

Constituye por si mismo un CRM completamente funcional. Incluye gestin de
newsletters. Se utiliza para gestionar cuentas de clientes, contactos, contratos,
leads, y tiene una gestin de facturas emitidas integrado en el sistema.
Wiki
El sistema Wiki es una forma muy conocida de compartir y publicar
informacin (nacio con la Wikipedia). Integria tiene un Wiki integrado, que
incluye un sistema de permisos y accesos,
Inventario (CMDB)
Integria integra un sistema de inventario flexible, donde los tipos de objetos,
los campos y la relaciones entre ellos son definidos por el administrador. Esto
permite desde gestionar un stock de dispositivos de forma sencilla, hasta
implementar una CMDB con datos que ya existan en su organizacin. El
sistema de inventario est vinculado (opcionalmente) al CRM y al sistema de
Ticketing.
Qu se necesita para instalar Integria IMS?

Integria es una aplicacin desarrollada en PHP5 y que utiliza como base de
datos MySQL. Apache/PHP se utiliza como motor de aplicaciones WEB. Se
puede instalar en cualquier servidor (Linux, Windows, Solaris), mientras que
soporte PHP5 y MySQL.
Si se baja la imagen Vmware, o el CD de instalacin tendr un sistema listo
para funcionar basado en CentOS Linux. Tambin puede montar Integria IMS
en entornos Windows, usando el metapaquete WAMP [2], que instala todo lo
necesario para que Integria funcione.
Pag 11
Instalacin de Integria
3. Instalacin de Integria
Dependencias necesarias
Integria IMS es una aplicacin PHP que necesita una base de datos MySQL para
funcionar. Actualmente slo soporta MySQL y necesita una versin de PHP 5.2
o superior (debido a su uso intensivo de AJAX, entre otras razones). Debido a
que es una aplicacin completamente WEB, puede instalarla en un servidor y
acceder a ella desde cualquier puesto de trabajo con un navegador moderno
(Firefox, o Internet Explorer a partir de la versin 6). La resolucin mnima de
trabajo es 1024x768.
Las grficas utilizan Flash y puede que necesite un complemento para
visualizarlas. Integria IMS puede funcionar sobre sistemas Windows, Unix o
Linux mientras tenga satisfechas sus dependencias. No obstante, nuestra
plataforma favorita es CentOS Linux.
Todas las dependencias necesarias que ha de tener nuestro sistema para el
correcto funcionamiento de Integria IMS son:
php php-cli php-gd php-intl curl php-ldap php-imap php-mysql php-mbstring php
Ser necesario reiniciar el servidor de apache una vez hecho los cambios:
service httpd restart
La instalacin la podremos hacer de forma manual a travs de las fuentes

(.tar.gz), mediante paquetes .DEB para sistemas basados en Debian o .RPM
para Suse, Red Hat Enterprise Linux, Fedora y CentOS, o bien descargndonos
el cdigo de la versin de desarrollo, utilizando el SVN (Subversin).
Integria IMS se puede instalar tambin sobre sistemas operativos Microsoft
Windows, mediante el paquete WAMP Server[1], que instala Apache. PHP 5 y
MySQL sobre el sistema operativo.
Instalacin desde las fuentes

Instalacin previa de software necesario
Pag 12
Debera disponer al menos de la herramienta tar para descomprimir el

paquete "tarball" de instalacin. No olvide instalar subversion, y por supuesto
cumplir todos los pre-requisitos de instalacin mencionados arriba.
Descarga de las fuentes

Necesitaremos descargar el tarball de la ltima versin de Integria IMS. Para
ello tenemos dos opciones: la primera es descargar el .tar.gz de la ltima
versin desde Sourceforge [2], y la segunda opcin que tenemos es
descargarnos la versin de desarrollo mediante el cliente de Subversion (svn),
usando la lnea de comandos:
svn co https://integria.svn.sourceforge.net/svnroot/integria integria
Conviene ejecutar este comando en el directorio de publicacin web

directamente (/srv/www/htdocs/ para Suse o /var/www/ para
Ubuntu/Debian) porque se descargar la versin descomprimida en dicha
carpeta, y podremos proseguir con la instalacin desde ah.
Instalacin
Una vez tengamos el tarball de instalacin, por ejemplo en /tmp, nos hacemos
root:
su -
Y nos movemos al directorio de publicacin web (/srv/www/htdocs/ para Suse

o /var/www/ para Ubuntu/Debian) para descomprimir el paquete:
cd /var/www/ tar xvzf /tmp/IntegriaIMS-xxx.tar.gz
Cambiamos los permisos para que el directorio sea propiedad del usuario del
servidor web:
Por ejemplo, en sistemas Debian:
chown -R www-data /var/www/integria
Pag 13
Ahora debemos acceder via web a la direccion IP de su servidor para

proseguir con la instalacion de Integria IMS. Esta parte de la instalacin sirve
para crear la base de datos de Integria y configurar las credenciales de acceso
(usuario, password y nombre de BD) a la BBDD establecidas por el usuario:
http://ip_servidor/integria/install.php http://ip_servidor/integria/trunk/install.php (si se
ha optado por descargar usando svn)

Seguiremos los pasos de instalacin que nos van indicando:
Pag 14
Pulsamos en Siguiente, aceptamos la licencia y volvemos a pulsar siguiente:
Pag 15
En esta pantalla se verifica si todas las dependencias necesarias estn

instaladas correctamente:
Pag 16

Aqu configuraremos las credenciales de acceso a MySQL, para que el
instalador sea capaz de crear la nueva base de datos de Integria:
Pag 17
Hemos completado la instalacin
Pag 18

Una vez completados todos los pasos, habremos finalizado correctamente la
instalacin de Integria IMS y ya podremos acceder al sistema. Recuerde que
las credenciales (usuario y password) por defecto son admin con
password integria.
http://ip_servidor/integria/index.php
Pag 19
Instalacin en un entorno de hosting WEB

En la instalacin por defecto de Integria se supone que tiene la cuenta de root
para crear la base de datos de Integria y hacer la instalacin automatizada. En
esta seccin se describe la manera de cmo hacer una instalacin manual, algo
que se tiene que hacer, por ejemplo, en un entorno de hosting web (donde no
se tienen credenciales de root en el MySQL).
NOTA: Algunos entornos de hosting no tienen compilado el mdulo IMAP de

PHP necesario para la funcionalidad de gestin de incidencias por email.
En primer lugar, necesita obtener el tarball y descomprimirlo en un directorio
temporal, por ejemplo:
tar xzf integria_xxxx.tar.gz
Esto crear un directorio llamado "trunk" en el directorio actual. Se mueve a

su directorio de publicacin web, en un nuevo directorio, por ejemplo
"Integria":
mv trunk /srv/www/htdocs/integria
Su entorno de hosting debe tener una instalacin completa de PHP 5.x (esto
incluye algunas extensiones como gettext, json, MySQL, LDAP, mbstring y zlib).
Graphviz tambin es necesaria para grficas de tipo "rbol"
Es necesario crear la base de datos con el mecanismo que su hosting
proporcione. Despus de eso va a tener una un host de base de datos el
usuario de la base de datos, contrasea de base de datos y el nombre de la
base de datos.
Importe estos dos archivos (en este orden) en su nueva base de datos:
integria_db.sql integria_dbdata.sql
Esto podra hacerse mediante el uso de la lnea de comandos de la CLI de

mysql:
mysql -u user -p -D databasename -h hostname
Pag 20
<It will ask your password>

integria_dbdata.sql;
mysql> use pandora; mysql> source integria_db.sql; mysql> source

Despus de eso, tendr que editar el archivo "include / config.inc.php",
agregando estas lneas, con los valores que tiene en su configuracin:
$config["dbname"] = "integria";
// MySQL DataBase name $config["dbuser"] = "integria";
$config["dbpass"] = "integria"; // DB Password $config["dbhost"] = "localhost"; // DB Host
$config["homedir"] = " /srv/www/htdocs/integria/";
// Config homedir $config["base_url"]
= "http://mydomain.net/integria";
// Public URL
Guarde el archivo o cambie el nombre a "include / config.php" y dele permisos

de slo lectura a la aplicacin web (normalmente apache o http).
Elimine install.php y proceder a entrar en Integri
http://youraddress/integria
Instalacin mediante paquetes

Primero debemos obtener los paquetes de instalacin de Integria, que los
podemos descargar desde sourceforge [3]. Deber descargar los paquetes para
su distribucin, ya sea .deb para Debian/Ubuntu o .rpm para Suse/Red Hat
Enterprise Linux/Fedora/CentOS.
Instalacin de Integria IMS mediante el paquete .DEB

La instalacin de Integria a partir del paquete .deb es sencilla, y simplemente
necesitar ejecutar, como root, el siguiente comando:
dpkg -i IntegriaIMS_xxx.deb
Si no se dispone de conexin a Internet y se han dejado dependencias sin

cumplir, ser necesario descargarse las dependencias, y a continuacin
instalar el paquete. Si por el contrario tenemos conexin a Internet, y nos ha
quedado alguna dependencia sin resolver, ejecutamos:
apt-get -f install
Pag 21
Este comando intentar descargar todos los paquetes necesarios que faltan
para que podamos instalar Integria en el sistema. Una vez que se hayan
instalado las dependencias necesarias, ya podremos instalar el paquete de
Integria.
Despus de la instalacin del paquete, nos mostrar un mensaje como este en
la lnea de comandos:
Please, now, point your browser
to http://your_ip_address/integria/install.php and follow all the steps described
on it
A partir de aqu, seguiremos los mismos pasos que vimos en la instalacin va
web a partir de las fuentes, donde configuraremos las credenciales de MySQL
para crear la base de datos de Integria IMS.
Instalacin de Integria IMS mediante el paquete .RPM

Una vez descargado el paquete, la instalacin de Integria la haremos
ejecutando como root:
rpm -i IntegriaIMS-xxx.noarch.rpm
Al igual que en la instalacin con los paquetes .deb, se debern resolver las
dependencias que no se cumplan al intentar instalar el paquete. Al finalizar la
instalacin del paquete por la lnea de comandos, seremos avisados de que
sta debe proseguir a travs de un explorador. Seguiremos los mismos pasos
que en la instalacin va web a partir de las fuentes para crear la base de datos
sobre la que se apoyar Integria IMS.
Instalacin de Integria IMS en Windows

Instalacin de WAMP
Para instalar Integria sobre un Sistema Operativo Windows, deberemos tener
instalado previamente el metapaquete WAMP Server [4], que instala todo lo
necesario para que Integria pueda ejecutarse correctamente. Esto es, un
servidor MySQL, Apache y PHP. Una vez descargado, lo ejecutamos y seguimos
los pasos necesarios para su instalacin.
Pag 22
Para que WAMP funcione adecuadamente tiene que tener instalado el

Paquete Redistribuible de Visual C++ 2010 SP1.

En algunos sistemas la version 2.2 puede dar problemas, si es as, pruebe

a instalar la version 2.1.

Pag 23

Lo primero ser establecer una contrasea de root para MySQL, que ms
adelante utilizaremos para la instalacin de la base de datos de Integria. Para
ello, accedemos a travs del icono de WAMP a phpMyAdmin, lo que nos abrir
un explorador desde donde podremos gestionar MySQL. Pinchamos en la
pestaa Privilegios y editamos el usuario root.

Pag 24
Dentro de la configuracin del usuario root, en la parte de Cambio de

contrasea, establecemos la password que utilizar este usuario para
conectarse a MySQL. Ser necesario reiniciar el servidor de MySQL y apache
para que los cambios tengan efecto.

Pag 25
A continuacin, descargamos el .tar.gz de Integria desde sourceforge [5].

Tambin podemos descargarnos el cdigo a travs del svn, utilizando un
cliente de Subversion para Windows, como por ejemplo TortoiseSVN, que
podemos descargar desde sourceforge [6].
Creamos un directorio llamado integria dentro del directorio www de servidor
WAMP:
C:\wamp\www\integria
En el caso de haber instalado el servidor WAMP en otra ubicacin que no sea

la de por defecto (C:\wamp), esta ruta cambiar.
Ahora, descomprimimos el tarball de Integria y copiamos todos los ficheros
que estn dentro del directorio trunk al nuevo directorio que hemos creado. Si
la descarga se ha hecho a travs de subversin, copiaremos el contenido de la
carpeta trunk del directorio de descarga de TortoiseSVN, al directorio de
publicacin del servidor WAMP, donde hemos creado anteriormente el
directorio integria.
Pag 26
A partir de este punto, al igual que en los dems sistemas, accederemos

mediante un explorador para proseguir con la instalacin de Integria y poder
crear as la base de datos de integria:
http://ip_servidor/integria/install.php
Donde "ip_servidor" puede ser "localhost" si estamos en nuestra propia

mquina.
Pincharemos en siguiente y aceptaremos la licencia:

Pag 27
En la siguiente pantalla se mostrarn las dependencias que estn

correctamente instaladas o si por el contrario quedan por resolver o no estn
bien instaladas. Dependiendo de esto, ser necesario, acceder a las extensiones
PHP de WAMP y activar las que queden por resolver. Por ejemplo, si dice que
no tiene instalado soporte para Gettext: acceda al men de WAMP (en la
bandeja de iconos), y en la opcin "PHP extensions" busque y active las
extensiones que le faltan, como se ve en la captura siguiente:

Pag 28
Pag 29
Pag 30
Una vez resuletas todas las dependencias, pinchamos en siguiente y en esta

pantalla introducimos la contrasea de root que configuramos anteriormente
en PHPMyAdmin. Pinchamos en el siguiente, y si todo ha ido bien, nos habr
creado la nueva base de datos donde se apoyar integria.

Pag 31
Hacemos click en siguiente, y una vez finalizada la instalacin, ya podremos

acceder a la pantalla de login de Integria mediante un explorador, escribiendo:
http://ip_servidor/integria/index.php
Podemos acceder a Integria mediante el usuario admin y la contrasea por

defecto integria.
Pag 32
Instalacin de la versin Enterprise

Una vez que tenemos el fichero comprimido con la parte enterprise de
Integria, por ejemplo IntegriaIMS_enterprise_xxx.tar.gz, debemos proceder de
forma similar a como se hizo para la instalacin a partir de las fuentes. Para
ello, descomprimimos el tarball:
su - cd /tmp tar xvzf IntegriaIMS_enterprise_xxx.tar.gz
Una vez descomprimido, nos crear una carpeta llamada enterprise que
moveremos dentro de la carpeta integria que se encuentra en el directorio de
publicacin.
Para Debian/Ubuntu:
mv /tmp/enterprise /var/www/integria/

Para Suse:
mv /tmp/enterprise /srv/www/htdocs/integria/
A continuacin tenemos que cambiar los permisos del directorio enterprise

para que el directorio sea propiedad del usuario del servidor web
Para Debian/Ubuntu:
chown -R www-data /var/www/integria/enterprise

Para Suse:
chown -R wwwrun /srv/www/htdocs/integria/enterprise

El ltimo paso es abrir un explorador e introducir:
http://ip_servidor/integria/

Pag 33
Aceptamos la licencia y con esto ya tendramos Integria IMS instalado con la

versin enterprise.
Instalacin de la versin Enterprise en Windows
Pag 34
La instalacin de la versin enterprise sobre Windows la hacemos a partir del

archivo comprimido. Para ello, descomprimimos el fichero y copiamos la
carpeta enterprise dentro del directorio www que se encuentra dentro de
nuestra instalacin del servidor WAMP. Si este est instalado por ejemplo en el
directorio C:\ copiaremos la carpeta en C:\wamp\www\integria.

Abrimos el explorador con la direccin:
Pag 35
http://ip_servidor/integria/
Y aceptamos la licencia enterprise como se mostr en el apartado anterior, con

lo que ya tendramos la versin enterprise instalada.
Instalacin de script de mantenimiento

Integria enva los correos y realiza ciertas operaciones "automticas" de forma
programada. Para ello es necesario automatizar un proceso para que se
ejecute cada 5 minutos. Si no hace esto, operaciones importantes de Integria
(como enviar correos) no funcionarn.
Si ha instalado el paquete desde .DEB o .RPM ya est instalado este script en su
sistema, se puede saltar este apartado. Si lo ha instalado desde tarball o
fuentes tendr que hacerlo manualmente.
En unix esto se hace aadiendo una tarea al cron, tal como sigue:
En sistemas Unix
Como root, crear un fichero nuevo llamado /etc/cron.d/integria
# Execute Integria CRON each 10 minutes. 5,10,15,20,25,30,35,40,45,50,55,59 * * * *
php5 /srv/www/htdocs/integria/include/integria_cron.php
root

Si ha instalado integria en otro directorio diferente, por ejemplo, en Ubuntu, la
ruta completa sera diferente, por ejemplo:
# Execute Integria CRON each 10 minutes. 5,10,15,20,25,30,35,40,45,50,55,59 * * * *
php5 /var/www/integria/include/integria_cron.php
root
Antes de continuar compruebe que funcione, ejecutando desde lnea de

comando, como root la orden completa, p.e:
php5 /srv/www/htdocs/integria/include/integria_cron.php
El script no debera devolver nada.
Pag 36
Puede que en su sistema el intrprete php no se llame 'php5' sino 'php',

compruebe este punto si tiene algn problema y sustituya php5 por php en
todas las rdenes indicadas anteriormente.
En sistemas Windows
Si usa XP o Windows 2000, deber buscar el comando SCHTASKS de Windows
2003 o superiores para poder programar una llamada a un comando cada 10
minutos. Lo puede descargar de Microsoft,
aqui http://www.microsoft.com/resources/documentation/windows/xp/all/
proddocs/en-us/schtasks.mspx?mfr=true
Habria que crear una entrada en el programador de tareas de la siguiente
SCHTASKS /create /SC minute /MO 5 /TN Integria /TR "C:\wamp\bin\php\php5.3.5\php-cgi.exe
c:\wamp\www\integria\include\integria_cron.php" /RU system
(Las rutas pueden cambiar en funcin de su version de WAMP)

Esto utiliza el programador de tareas para ejecutar el script integria_cron.php
cada 10 minutos.
Actualizacin de Integria
Consideramos actualizar (update), al proceso de "aplicar ltimos cambios" o
parches sobre una instalacin ya funcional. Esto consiste bsicamente en
"reemplazar" los ficheros de cdigo nuevos sober los viejos.
El proceso es sencillo, y se puede describir en tres pasos.
1. Descargar el paquete (en formato tarball) o en formato .RPM o .DEB 2.
Actualizar. 3. Comprobar que todo va bien.
El segundo paso (actualizar), va a variar en funcin de si es RPM, DEB o
Tarball.
Actualizacin con RPM

Escribimos el comando:
rpm -U nombre_paquete.rpm
Pag 37
Actualizacin con DEB

Escribimos el comando:
dpkg -i nombre_paquete.deb
Actualizacin con Tarball

Unix/Linux
Depender de donde est instalado nuestro Integria. Supongamos que est
en /var/www/html/integria. Suponemos que tenemos en /tmp el tarball que
hemos bajado de la web. Escribiremos los siguientes comandos como root:
cd /tmp tar xzf nombre_paquete.tar.gz cd trunk ./integria_update -p /var/www/html/integria
Esto copia el contenido de todos los ficheros de cdigo, sobrescribiendo los

actuales en /var/www/html/integria e intentando cambiar el
propietario/grupo al usuario del servidor WEB.
Windows
Abra el fichero tarball con una herramienta de manipulacin de ficheros
comprimidos tipo "winzip" o "winrar", localice el directorio donde instal
integria y sobreescriba esos ficheros con los contenidos en el fichero tar.gz
Despues de actualizar
Compruebe, en el footer (pie de pgina) de la aplicacin que haya cambiado la
version y/o build respecto a la versin que tena antes. Esto es un indicador
fiable de que ha actualizado la aplicacin con xito.

Pag 38
4.
Usuarios en Integria
Usuarios y grupos
Una de las caractersticas ms importantes de Integria IMS es la caracterstica de
poder trabajar con diferentes grupos de usuarios y que cada grupo solo vea lo
suyo. Estos grupos de usuarios pueden ser departamentos, clientes o empresas
diferentes. A esta caracterstica generalmente se la conoce como entorno
Multitenant.
Para implementar esto, se diferencia entre tres conceptos clave:
Grupo: Un grupo es una agrupacin de usuarios con visibilidad entre ellos, un grupo
puede ser traducido por "departamento", por "cliente" o por "empresa", segn sea el
contexto del uso de Integria.
Perfil: Define una serie de privilegios, por ejemplo: acceso a la agenda, o tener acceso
para crear incidencias, o ser gestor de proyecto.
Usuario: Un usuario dentro de Integria es un usuario para entrar en la aplicacin va

WEB. Ese usuario tiene asignado uno o varios grupos, a travs de la asignacin de
perfiles, de forma que un usuario puede ser gestor de proyectos en un grupo y operador
de incidencias en otro, o ser nicamente gestor de proyectos en un grupo. Un usuario no
tiene nada que ver con un contacto (los contactos se usan en el sistema CRM de
Integria).
Las dos caractersticas ms importantes de la versin Enterprise

respecto la OpenSource son la funcionalidad Multitenant y la gestin
de permisos

Dado que cada funcionalidad dentro de Integria (ticketing, proyectos, wiki, etc) es
muy diferente una de otra, la gestin y la implicacin de los perfiles en uno o en
otro caso vara enormemente. Es decir, como se aplica el perfil de acceso a un
incidente o a un proyecto es muy diferente. Esto se explica con detalle en la
seccion de configuracin, Permisos de usuario.
Usuarios
Para poder aadir a personas a los proyectos, a las incidencias, etc, stas deben
estar presentes como usuarios del sistema Integria IMS. Cada usuario puede tener
Pag 39
diferentes perfiles en diferentes grupos (gestor de los incidentes para una

empresa, participante en un proyecto, etc.), y gracias a esos perfiles tendr
ciertos privilegios sobre el sistema y sobre las caractersticas de Integria en las
que est asignado. Los usuarios pueden pertenecer a diferentes grupos y tener
diferentes roles en cada uno de ellos, como se menciona anteriormente, pueden
ser los responsables de las incidencias de la empresa A y participantes de un
proyecto de la empresa B.
En el men Usuarios se puede gestionar todo lo relacionado con los usuarios, ver
los usuarios, editarlos, ver el informe de horas del usuario, las tareas asignadas,
los roles y grupos existentes etc. Esta seccin dispone de diferentes sub-
secciones, algunas visibles solo para administradores o jefes de grupo, otras
visibles para todos los usuarios. Algunas secciones dejarn realizar ciertas
operaciones en funcin de las credenciales del usuario activo.
Men "Mi usuario"

Modificar usuario
En el primer submenu, existe una opcin para modificar las propiedades del
usuario. Aqu podemos cambiar nuestro propio usuario, alterando el nombre,
email, password, etc. No podremos cambiar nuestro "user_id" o nombre corto de
usuario, ya que es nico y no se puede cambiar.
El idioma del usuario "ignora" al lenguaje definido a nivel global, esto significa
que si el usuario define su propio idioma, usar ese en vez del lenguaje del
sistema.
Esta sera una vista de la pantalla de configuracin del propio usuario:

Pag 40
Algunos campos son informativos, como el user id y el n de incidencias abiertas

en total.
Informe de UT
Esta opcin solo aparece si tenemos acceso al sistema de proyectos.
Muestra un calendario mensual con la asignacin de horas de nuestro usuario.
Esto permite ver en difernetes colores las UT asignadas a incidencias y su
duracin y las UT asignadas a proyectos.
Ejemplo de informe de UT con horas de proyectos

Pag 41

Ejemplo de informe de UT con horas de incidencias
En el caso de haber horas mixtas sale con un color alternativo.

Pag 42
Men "Informes de usuario"

Informes de usuario
En el men lateral de Informe de usuario existen varias secciones disponibles:
Informe completo
Informe mensual
Informe anual
Informes a medida
Programar informes
Cada una de las secciones presentar informes en funcin del aspecto

seleccionado, y dentro de ellas existen enlaces para ver los informes en modo
grfico y en modo de calendario.
Informe completo

Pag 43
En la seccin Informe completo del men lateral Informe de usuario se

muestra la actividad de un usuario en todos los proyectos. La tabla contiene la
siguiente informacin:
Proyecto: Nombre del proyecto.

Horas del usuario: Horas que el usuario ha imputado en ese proyecto, en el conjunto de
sus tareas.
Total del proyecto: Total de horas imputadas en el proyecto por todos los usuarios.
%: Porcentaje que representa el trabajo del usuario.
Adems, es posible pulsar sobre el nombre del proyecto para ir directamente a su

pgina de descripcin.
En las cajas de seleccin de la parte superior del formulario se puede seleccionar
otro usuario y otra fecha diferente, que de forma predeterminada ser el usuario
conectado y el da actual.
Pag 44
Informe mensual
En la seccin Informe mensual del men lateral Informe de usuario se muestra

la actividad de cada uno de los usuarios. La tabla tiene los siguientes campos:
ID de usuario: Identificador del usuario.

Informe: horas de trabajo: Enlace a la vista detallada de las horas del usuario.
Vista de calendario: Enlace a la vista de calendario del usuario.
Vista gafica general: Grfica de tarta con las horas repartidas en trozos.
Horas totales para este mes: Total de horas imputadas en el mes actual.
Cargado este mes: Total de dinero imputable en el mes actual.
Dispone de una caja de seleccin donde se puede cambiar a otro mes.

Ejemplo de vista grfica mensual

Pag 45
Informe anual

Pag 46
En la seccin Informe anual del men lateral Informe de usuario se muestra un

calendario con la actividad de un usuario durante todo el ao. En el calendario se
resaltan los das de vacaciones, de trabajo y das con incidentes. El calendario
anual, permite si deja el cursor del ratn sobre un dia concreto con datos, mostrar
el n de workunits asignadas ese dia. Si hace clic, en el podr verlas en detalle, a
modo de drill-down.
Puede acceder al informe mensual para ese usuario haciendo click en el mes
correspondiente.
Dispone de una caja de seleccin donde se puede cambiar a otro usuario si
dispone de privilegios para ver esa informacin.
Informes a medida
Pag 47
En la seccin Informes a medida del men lateral Informe de usuario se

muestra una lista con los informes personalizados creados anteriormente. Desde
la lista, cada informe se puede visualizar en el navegador o descargar en formato
PDF o CSV. Los informes se crearn a travs de una sentencia SQL, por lo que ser
necesario conocer el el esquema de la base de datos.
Programar informes

En la seccin Programar informes del men lateral Informe de usuario se

muestra una lista con los informes programados creados anteriormente. Desde la
lista cada informe se puede descargar en formato PDF, pero lo ms importante es
que los informes que aparezcan, sern generados automticamente y enviados a
la direccin email indicada.
En el formulario de creacin habr que rellenar ciertos campos:
Nombre: Nombre del informe.

Email de destino: Email que recibir el informe.
Pag 48
Lenght on days: Rango de das de los datos.

Execute each X days: Das que deben pasar entre cada envo.
Tipo de informe: Como su nombre indica, es el tipo del informe. Determinados tipos de
informes tienen asociados subtipos que podrn aparecer al seleccionarlo.
Para que los informes se puedan aadir correctamente como

archivo adjunto, la direccin IP del servidor de Integria IMS debe

tener acceso a la API. Se puede agregar la IP del servidor en la
configuracin general.
Gestin de usuarios (Como administrador)

Desde la seccin de "Gestin de usuarios" podr realizar todas las tareas de
gestin relacionadas con los usuarios, gestionar (aadir, editar y borrar) usuarios
y sus detalles, gestionar los roles y perfiles existentes, as como los grupos
definidos.

Pag 49
A la hora de crear un usuario o modificarlo, existen diversos campos en el

formulario:

En este formulario puede introducir cualquier informacin del usuario:
ID usuario: Identificador o nombre de usuario. Este dato no se puede cambiar una vez
creado, ni siquiera por el administrador. Puede ser un email o una combinacin de letras
y nmeros.
Activado: Este usuario tiene deshabilitado el acceso, y tampoco puede ser usado como
destinatario en una incidencia, proyecto, etc. Los proyectos/tickets donde ya est
mantienen su estado.
Enable login: Es un usuario vlido pero que no puede entrar en el sistema, pero si
pueden ser asignados manualmente por otro usuario como parte de un incidente, un
proyecto, etc. Si est desactivado no podr acceder a la interfaz de Integria, pero si
recibir, por ejemplo, las notificaciones via email del sistema de incidencias y/o
proyectos.
Nombre real: Nombre real del usuario.
N empleado: Generalmente un cdigo interno de la empresa que identifica al usuario.
Contrasea: Contrasea del usuario. Requiere comprobacin doble.
Pag 50
Correo-e: Correo electrnico del usuario. Este e-mail se usar para todas las
notificaciones automticas va email. Compruebe que es correcto, es muy importante. No
debe contener espacios ni caracteres invlidos. Solo puede introducir un email.
Imagen: Imagen de usuario. Esta imagen se usar como "avatar" en diferentes pantallas.
Telfono: Telfono del usuario. Informativo.
Ubicacin: Campo opcional para indicar donde se puede localizar al usuario.
Empresa: Campo opcional. Utilizar las empresas definidas en el CRM para asignarsela
al usuario. Es til para visualizar la empresa al que pertenece el usuario en la vista de
incidencias.
Perfil global: Tipo de perfil del usuario; estndar, external o administrador. El usuario
estndar se cie a los roles de permisos establecidos para el. El perfil "external" hace
referencia a que es un usuario que no podr trabajar "en grupo" en el sistema de
incidencias, de forma que solo podr ver las incidencias que ha creado l. Un usuario
"normal" sin embargo, puede ver las incidencias abiertas en su grupo, aunque no las
haya abierto l. De igual forma, puede hacer anotaciones (UT) sobre las incidencias de
gente de su grupo.
Idioma: Idioma de la interfaz de Integria IMS para el usuario. Este idioma personaliza la
experiencia de usuario, haciendo que cada usuario pueda ver la interfaz en su propio
idioma, independientemente de lo establecido en el sistema a nivel general.
N total de incidencias: Campo informativo acerca de cuantas incidencias ha abierto
ese usuario.
Modo simple: Si se activa, la vista de incidencias es muy simplificada respecto a la
normal.
Comentarios: Campo informativo.
Una vez que haya finalizado de introducir los datos, pulse el botn Crear.
Aparecern nuevas opciones debajo del campo Comentarios, donde podr aadir:

Grupo(s) disponible(s): Los grupos a los que puede aadirse el usuario.

Perfiles: Los perfiles disponibles para los grupos.
Para editar cualquier usuario, siempre que se tengan permisos, puede pulsar
sobre su nombre o identificador de usuario. Aparecer un formulario de edicin
del usuario que le permite modificar todos los campos del usuario.
Pag 51
Gestionar roles
Los roles son las funciones que los usuarios pueden desempear, y sus costes por
hora asociados. Son necesarios para calcular los costes reales de un proyecto en
base a la imputacin de horas de los participantes del proyecto. Integria IMS trae
varios roles predeterminados:
Project manager
Systems engineer
Junior consultant
Junior programmer
Senior programmer
Analyst
Senior consultant
Support engineer
Cada uno de ellos tiene asignado un coste, que se aplicar cuando un usuario con
ese rol introduzca horas en un proyecto, incidente, etc. Est pensado
principalmente para la externalizacin de servicios, donde es muy interesante
saber los costes asociados a los mismos.
El unico rol importante es el rol de "Project manager" que no se puede borrar, ya
que es el que da "permisos" de gestion a un proyecto, si ese usuario tiene el rol de
project manager.
Desde la seccin Gestionar roles podr aadir, editar y borrar roles.

Pag 52
Importar usuarios desde CSV

Un fichero CSV es un documento que permite representar datos en forma de
tabla. Las columnas se separan por comas y las filas por saltos de lnea. Nuestro
fichero CSV tendr el siguiente formato:
id_usuario,password,real_name,email,telephone,description,avatar,disabled,id_company,simple_mo
de,num_employee,enable_login (without commas)
Pag 53
Ejemplo fichero :
alberto,1234*xcf,Alberto Garrido,alberto@gmail.com,91345678,Gestor de
cuentas,avatar8.png,0,12,0,123,1 juan,348x*13,Juan Rodriguez,juan@gmail.com,914543210,Gerente
de canal,avatar9.png,0,12,0,124,1
El resto de campos no se pueden incorporar de forma automtica. Mediante la

interfaz podr elegir algunas opciones con las que el usuario se importar.
Grupos
Los grupos sirven para asociar conjuntos de actividades o empresas a los que un
usuario puede pertenecer; estn estrechamente ligados a los perfiles, as un
usuario del departamento de soporte puede estar en la empresa A con un rol
asignado de Senior consultant y al mismo tiempo estar en la empresa B como
Support engineer, pudiendo adems estar asignado en otro grupo o empresa
como Project manager.
Gestin de grupos
Esta opcin solo es visible para usuarios con perfil de administracin.
A la hora de asignar incidentes, se puede asignar un usuario predeterminado que
recibir los correos de las incidencias. ste podr luego escalar los incidentes a
cualquiera dentro de su grupo, si bien se ha de configurar dicho usuario con los
permisos necesarios para ello.
Desde la seccin Gestionar grupos podr aadir, editar y borrar grupos.

Pag 54
La seccin Gestionar grupos del men lateral Gestin de usuarios proporciona

una tabla con informacin acerca de los grupos en el sistema. Una vez que hace
click en un grupo, puede editar sus propiedades, en una ventana como la
siguiente:

Pag 55
Para crear un grupo pulse el botn Crear grupo bajo la tabla que lista los grupos.
Aparecer un formulario en el que deber rellenar la informacin del nuevo
grupo. En este formulario debe aadir la siguiente informacin:
Nombre: Nombre del grupo nuevo. Este nombre no se traduce.

Forzar el correo-e: Si se debe forzar el envo (activacin de la casilla) de correo-e al
grupo en las incidencias.
Padre: Caja de seleccin, por si tiene un padre.
Icono: Icono o imagen para el grupo.
Banner: Si se quiere aadir una imagen de banner al grupo. Este banner aparecer en
vez del logo del sitio, que aparece en la cabecera, arriba a la izquierda. Es una forma de
personalizar la interfaz para cada grupo.
Usuario predeterminado: El usuario predeterminado del grupo, el usuario
seleccionado de forma predeterminada al abrir un incidente con este grupo.
Idioma: Idioma predeterminado para el grupo.
Incident "soft limit": Indica el n de incidencias mximas por usuario, para ese grupo,
que un usuario puede tener abiertas simultneamente.
Incident "hard limit": Indica el n de incidencias mximas por usuario, para ese grupo,
que un usuario pueda haber abierto en total (estn abiertas o cerradas). Cuando este
lmite se rebasa el usuario recibe una notificacin en pantalla al intentar crear una
incidencia y no puede crear ms.
Forzar el "soft limit": Si el "soft limit" se rebasa y esa casilla no est activada,
simplemente avisar de que se ha superado el lmite de incidencias simultneas
abiertas, pero el usuario podr seguir con la creacin de la incidencia. Si est marcada, el
sistema no permite abrir ms incidencias.
Objeto de inventario por defecto: El objeto de inventario seleccionado se asignar por
defecto al crear incidencias asociadas a este grupo.
Incident SLA: Ser la SLA que se aplique a incidencias de este grupo. Las SLA son un
conjunto de "reglas" para verificar que una incidencia se est gestionando con calidad.
Se puede ver ms informacin sobre ellas en la seccion de ticketing/incidencias.
Para editar cualquier grupo, siempre que se tengan permisos, se puede pulsar
sobre su nombre o identificador de grupo. Aparecer un formulario de edicin del
grupo que le permite modificar todos los campos del grupo.
Gestin de cola de mails

Integria IMS permite gestionar colas de correo, definidas por cada grupo de
usuarios, que permiten gestionar el flujo de trabajo de las incidencias mediante
emails. Esta es una funcionalidad Enterprise no disponible con la versin
Open Source de Integria IMS.
Los parmetros para configurar las colas de correo son los siguientes:
Autocrear usuarios: Activa/desactiva la creacin de usuarios nuevos en el sistema

cuando se recibe un email.
Pag 56
Dar acceso a usuarios: Activa/desactiva el acceso de los nuevos usuarios para que
puedan entrar en la aplicacin usando su usuario/contrasea.
Enviar email de bienvenida: Activa/desactiva el envo del email de bienvenida al crear
un usuario nuevo.
Activar modo simple: Activa/desactiva el modo simple de gestin de incidencias para
los nuevos usuarios.
Tipo usuario: Asocia el tipo de usuarios a los nuevos usuarios creados.
Compaa por defecto: Compaa que se asociar por defecto a los nuevos usuarios
creados.
Perfil de usuarios por defecto: Perfil por defecto para los nuevos usuarios.
Tipo de incidente por defecto: Tipo de incidente por defecto para los incidentes
creados a travs de esta cola de emails.
Cola de emails: Configuracin de las colas de correo electrnico asociadas a este grupo.
Este campo permite configurar varias expresiones regulares o direcciones de correo que
luego sern usadas para asociar los emails correspondientes a nuevos incidentes al
grupo. El campo admite varias direcciones de correo o expresiones regulares, una en
cada lnea. Por ejemplo:
support@integria.com .*@otherdomain.com
Con esta configuracin la cola de correo acepta todos los emails enviados a la
direccin support@integria.com y todos aquellos que con el formato
xxxx@otherdomain.com como por ejemplo: user1@otherdomain.com,
superadmin@otherdomain.com, etc.
Email de bienvenida: Email de bienvenida que se enviar a los nuevos usuarios cuando
se cree una nueva cuenta para ellos. Este campo de texto acepta las siguientes macros:
_password_: cambiar esta macro por el password por defecto asignado en la creacin
del usuario.
Si quiere saber ms sobre el funcionamiento de las Colas de emails puede

consultar la seccin: Gestin de incidencias por email
Perfiles y usuarios
La versin Enteprise de Integria IMS, permite asociar a un usuario, informacin
de que perfil tiene para cada grupo. Esto se realiza en la administracin de
usuarios (en la versin enterprise). Esto permite especificar qu permisos de
acceso se le dan a cada usuario en cada seccin o conjunto de datos.

Pag 57
Tipos de usuarios
Resumiendo lo visto anteriormente, se puede decir que en Integria hay tres tipos
de usuarios:
Administrador: pueden acceder a todas las secciones y ver la informacin de todos los
grupos.
Usuario estandar: pueden acceder y ver la informacin de cada grupo segn el perfil
asignado.
Usuario externo: slo pueden acceder a las secciones: Incidentes, BC, Descargas y
Personas. En la seccin de Incidentes slo puede ver las incidencias que ha creado. Este
usuario es muy til para ofrecer un servicio de soporte de forma sencilla.
Tabla de flags para ACL

Los perfiles, estn compuestos por "flags" de acceso. En este apartado se define
qu habilita cada flag de ACLs en cada seccin.
Proyectos
Bit de acceso
PR
Permite ver la informacin de los proyectos en los que se est

asignado.
PW
Permite crear proyectos nuevos.
PM
Permite crear y modificar los grupos de los proyectos.
TR
Permite ver la informacin de las tareas en las que se est asignado.
TW
Permite aadir workunits, ficheros y costes a las tareas en las que

se est asignado, as como visualizar sus datos.
TM
Permite modificar o borrar tareas en las que se est asignado, as
Pag 58
como agregar usuarios o crear subtareas.

Rol de manager
del proyecto
Puede realizar cualquier operacin en los proyectos en los que

tiene ese rol asignado, as como en las tareas de los proyectos.
Adems de los usuarios con este rol podrn eliminar proyectos.
Propietario del
proyecto
Tiene los mismos permisos que el manager del proyecto.
Usuario
Administrador
Puede realizar todas las acciones anteriores en cualquier proyecto o

tarea sin resctricciones (segn la disponibilidad de las mismas en el
interfaz).

En el sistema de ACLs de proyects las subtareas heredan los
permisos de las tareas padre. Es decir, si un usuario puede modificar
la tarea padre tambin podr modificar la tarea hija

Incidencias
Bit de acceso
Usuario Estndar
Usuario Externo
Permite acceder a la seccin Incidencias y podr interactuar (ver la

informacin, aadir workunits, subir archivos,etc) con los incidentes
segn las siguientes condiciones:
IR
Los que pertenezcan al grupo/s

del usuario
En los que el usuario sea el dueo
En los que el usuario sea el

creador
En los que el usuario sea el editor
En los que el usuario escribi

alguna workunit

En los que el usuario sea el
creador
En los que el usuario sea el editor
En los que el usuario escribi
alguna workunit
IW
Permite crear nuevas incidencias y editar (cambiar el grupo, cambiar

el estado, asignar a otro usuario, etc) las existentes. La edicin slo
estar disponible para el usuario que sea dueo (owner) de la
incidencia.
IM
Permite: Borrar incidencias, Gestionar tipos de incdencias y Gestionar

SLAs
Usuario
Puede realizar todas las acciones anteriores sin resctricciones (segn
Pag 59
Administrador
la disponibilidad de las mismas en el interfaz).

Modos de visualizacin
Modo normal: El modo normal da acceso a todas las opciones disponibles.

Modo simple: El modo simple es un modo en el que la gestin de incidencias est
limitada a visualizar el listado, aadir workunits y ficheros
Los usuarios con el flag IW pero sin flag IM por defecto no pueden
seleccionar el creador de la incidencia, para habilitar esta opcin

deber ir a la configuracin general y marcar la casilla Enable IW to
change creator.
Inventario
Bit de acceso
Permite acceder a la seccin de objetos de Inventario y ver su
informacin segn las siguientes condiciones:
VR
VW

En los que sean de tipo Pblico
Si tiene empresa asociada, por los usuarios asignados a esa
empresa
Si est asociado el usuario
Permite crear nuevos objetos de inventario y editar los existentes
Permite:
VM
Usuario
Administrador
Borrar objetos de inventario

Gestionar tipos de inventario
Gestionar SLAs
Puede realizar todas las acciones anteriores sin resctricciones
(segn la disponibilidad de las mismas en el interfaz).
Pag 60
Wiki
Los permisos de lectura y escritura del Wiki se definen en cada una de las pginas
del mismo. Por defecto todas las pginas son accesibles y editables por todos los
usuarios. Puede ver cmo modificar estos permisos en la seccin Permisos
lectura/escritura Wiki
CRM
El CRM tiene una forma particular de funcionar, donde no se tienen en cuenta los
grupos, solo la empresa a la que pertenece el usuario y los perfiles que tiene en
cualquiera de los grupos. El mtodo principal de restriccin de acceso, ser la
relacin padre/hijo entre empresas. De forma que si uno tiene acceso a una
empresa, tiene acceso a todas las empresas hijo. Excepto el usuario externo que
solo ve lo suyo. En el caso de la versin Open, el usuario externo sigue viendo
nicamente lo suyo y si no es externo, ve absolutamente todo. En la Enterprise,
solo vera las de su empresa y las hijas (y nietas, etc) de su empresa.
Compaas
Los flags bsicos para la gestin de empresas son los siguientes:

Bit de acceso
CR
Permite ver la informacin de las compaas a las que tiene

acceso.
CW
Permite editar las compaas a las que tiene acceso.
CM
Permite eliminar compaas a las que tiene acceso.
Un usuario tiene acceso a una compaa si est asociado a sta,

Usuario con acceso a
es el dueo, o bien, si sta compaa es hija de otra a la que
una compaa
tiene acceso el usuario.
Usuario externo
Tiene acceso nicamente a la compaa que tiene asociada.
Usuario
Administrador
Puede realizar todas las acciones en cualquier compaa.
Pag 61
En el sistema de ACLs de compaas se heredan los permisos de las

compaas padre. Es decir, si un usuario puede modificar la
compaa padre tambin podr modificar la compaa hija

Roles
Bit de acceso
CM
Permite crearlos.
Usuario con acceso
Slo tendr acceso si tiene asignado el perfil CM.
Usuario Administrador Puede acceder a los roles de cualquier compaa.
Facturas
Bit de acceso
CM
Usuario con acceso a facturas de una
compaa
Usuario Administrador
Permite ver y modificar las facturas de las

compaas.
Si es el dueo de la empresa o tiene asignado el
perfil CM.
Puede acceder a las facturas de cualquier
compaa.
Contactos, Ficheros, Leads, Actividades, Contratos

Bit de acceso
CR
Permite ver la informacin de los elementos a los que tiene acceso.
CW
Permite eliminar los elementos a los que tiene acceso.
CM
Permite editar los elementos a los que tiene acceso.
Usuario con
acceso
Usuario
Administrador
Un usuario tiene acceso a los contactos, ficheros, actividades, etc de

una compaa si est asociado a sta, es el dueo, o bien, si sta
compaa es hija de otra a la que tiene acceso el usuario.
Puede realizar todas las acciones en cualquier compaa.
Pag 62
5.
Gestin de incidencias
Integria IMS propone una visin de la gestin de incidencias adaptable a

diferentes necesidades: Se puede entender una incidencia como un problema
tcnico, una operacin de cambio de configuracin, el resultado de una
intervencin planificada, un bug de software o una hoja de trabajo sobre un
problema ms complejo. Una serie de elementos comunes unen a todas esas
actividades, para Integria IMS esos elementos comunes son las referencias a otras
incidencias, las referencias a uno o varios objetos del inventario y la
vinculacin nica de un usuario con una incidencia. Todos estos conceptos estn
recogidos en las guas de buenas prcticas propuestas por ITIL [1].
Integria adems se adapta muy bien a la metodologa Kanban [2] que permite
gestionar el desarrollo como un proceso evolutivo basado en colas de procesos.
Para implementar Kanban es necesario integrar la gestion de incidencias con las
WorkOrders y la gestin de proyectos.
Un ejemplo del flujo de ticketing con Integria

Nuestro equipo de soporte, est formado por tres personas (Toms, Javi, Luis) y
un "jefe" de equipo (Ramn).
Tenemos varios tipos de clientes. Los que trabajan en equipo y los que van "por
libre".
Pag 63
Los que operan tambien en "equipo", es decir, un cliente que tiene a varias
personas trabajando simultneamente, y que pueden 'ver' las incidencias de sus
compaeros, o bien para aportar algo, o bien para hacerse cargo de ellas.
Los que van por libre, solo ven lo suyo, y no ven ni quieren que los dems vean, lo
suyo.
El primer tipo de cliente, tendr un grupo propio, y usuarios asignados a ese
grupo. Mientras que el segundo tipo de cliente, pertenecer a un grupo "general"
y tendra el bit de "modo externo" activado, de forma que aunque pertenece a un
grupo solo podr ver "lo suyo".
Cuando un cliente de los que trabajan en grupo, abre una incidencia.
Automticamente, ya que ese grupo est definido as, se asigna a una cuenta
genrica de integria llamada "Support". Generando un email que va a
"support@nowhere.com".

Esa cuenta de email, automaticamente enva una copia a cada uno de los
miembros del equipo de soporte. Esa semana, est de "guardia" Javi, quien ve el
correo y pincha en el enlace para ir a Integria. Vera algo como lo siguiente:

Pag 64
En integria ve una incidencia nueva, en color rojo. Se puede ver el usuario creador
asi como otros datos
Ante una incidencia nueva, como la que est en rojo, podemos aadir la primera
respuesta. Cuando a una incidencia nueva se le aade una Unidad de Trabajo (o
nota), esta automticamente se le asigna al usuario que escribe la unidad de
trabajo, se le cambio a estado "Asignado".
Haciendo clic en la incidencia que esta en rojo entramos en la pantalla principal
de gestin de la incidencia. Podemos cambiar su estado, o navegar por las solapas
de la incidencia para ver su histrico, notas asociadas a la incidencia (workunits),
ficheros, etc. Nos interesa dar la primera respuesta al problema, ya que desde que
se abre, se calcula cuanto tiempo pasa sin respuesta. Si pasa el margen de tiempo
establecido por la SLA asociada al grupo de esa incidencia, saltar una alarma.
Cuando se aade una Unidad de trabajo (una nota) o un fichero o se cambia su
estado, se le envia una notificacin por email a todos los usuarios "suscritos" a
esa incidencia. En este caso, Javi va a poner una nota que dice "Veo lo que me
cuentas y voy a intentar reproducirlo para determinar el origen del problema".

Pag 65
Al crear la WU, mi incidencia ha cambiado de estado. Al autor de la incidencia le

llegar la nota que Javi ha metido en el sistema.

Pasan los das y el problema no se soluciona. Julio, el cliente que cre la

incidencia, vuelve a preguntar por el tema. Pero ese dia Javi no est en la oficina.
Un compaero suyo, Luis, al cargo de las incidencias, ve que la incidencia est
actualizada por el cliente, y le contesta, aadiendo una Unidad de Trabajo l
mismo.
A partir de ese momento, queda suscrito a la incidencia, recibiendo todas las
notificaciones sobre cambios en la incidencia. Podemos ver en el menu de la
izquierda, los usuarios que participan en la incidencia: el creador, el usuario
"dueo" de la incidencia (javi), y los que han participado en ella.

Un usuario sin permisos de "Gestin" en el sistema de incidencias, pero con

permisos de escritura, puede aadir unidades de trabajo, pero no puede
"cambiar" al dueo de la incidencia, ni cerrarla, si no es suya. Si es un "gestor" de
incidencias, puede cambiar el dueo de la incidencia. Si el usuario es dueo de la
incidencia, puede "reasignarsela" a otra persona. Este proceso se conoce como
escalar una incidencia.
Finalmente, Javi pudo cerrar la incidencia, puso en el campo "Epilogo" el resumen
de la solucion al problema, y cambia la incidencia a estado "Resolved". De esta
Pag 66
forma, las incidencias "resueltas" o "cerradas" ya no se ven en la vista por defecto

de incidencias, aunque por supuesto, se pueden buscar si se desean
Estados de una incidencia

Una incidencia tiene numerosos campos. Quizs el ms importante es el campo
estado. Este campo se refiere a si una incidencia / problema / cambio se da por
cerrado, pendiente de un tercero, nuevo o recin creado, si est asignado, si se ha
reabierto, si se ha verificado o si no se ha confirmado. Este ciclo est abierto al
usuario y se puede pasar de uno a otro sin restriccin. Existen determinadas
circunstancias que actan automticamente cuando pasamos de un estado a otro:
Diferentes estados de una incidencia

Al pasar de cualquier estado, al estado cerrado, automticamente se activar
una casilla de texto que antes no estaba accesible llamada eplogo que sirve
para explicar cul fu el resultado de la intervencin o cambio o cual fu -en
suma- la causa del problema y su solucin. Como se ver ms adelante, una
incidencia solucionada es la base para generar un artculo en la base de
conocimiento que sirva para en posteriores ocasiones, solucionar un problema de
forma rpida y documentada.
Pag 67
Usuarios en una incidencia

Existen cinco roles diferentes en un incidente:
1.
2.
3.
4.
5.
6.
7.
Creador del incidente.

Responsable del incidente.
Usuario con acceso de escritura (IW)
Usuario con acceso de lectura (IR)
Usuario con acceso de gestin (IM)
Usuario que cierra la incidencia.
Usuario adscrito a una incidencia.
Creador del incidente

Es el autor original del incidente. Es quien establece el responsable de ese
incidente (a no ser que esto se haga automticamente, como veremos ms
adelante), el grupo al que pertenece el incidente (idem) y otros parmetros como
su criticidad, nivel de resolucin, descripcin, elementos de inventario a los que
est vinculado, etc.
El autor original una vez que crea una incidencia, ya no puede "gobernarla", es
decir, no podr cerrarla hasta que usuario responsable de la incidencia no lo
decida. Tampoco podr reabrirla.
Como cualquier usuario con acceso a la incidencia, el usuario creador puede
aadir ficheros y unidades de trabajo (UT o WU en ingls).
Responsable del incidente

Es el usuario asignado al incidente, tambin llamado "dueo" de la incidencia
(owner). En la definicin de grupos se asigna un usuario predeterminado, que
ser el usuario asignado por defecto, en funcin del grupo seleccionado por el
usuario creador de la incidencia.
El creador del incidente puede cambiar este usuario y seleccionar otro
perteneciente al grupo al que asigna el incidente. El usuario responsable del
incidente es el nico que puede actualizar sus detalles y cambiar su estado.
Un usuario con permisos de gestin de incidencias (IM) sobre el grupo del
incidente, puede realizar las mismas operaciones que un responsable de
incidente, a todos los efectos, puede gestionar (modificar datos del incidente,
cambiar el responsable, cambiar el estado) de cualquier incidente perteneciente a
un grupo donde tenga un perfil con la opcin IM. Cuando un "gestor" cambia el
responsable de la incidencia decimos que hay un "escalado manual" de la
incidencia.
Pag 68
Usuario con acceso de escritura al incidente

La incidencia siempre pertenece a un grupo. Todos los usuarios con el flag de
acceso "IW" pueden escribir UT (Unidades de Trabajo o Workunit en ingles)
sobre una incidencia. Estas UT son como "notas" que se van quedando adjuntas a
la incidencia. Este tipo de usuario no puede modificar ningn otro detalle de la
incidencia, tal como estado o criticidad, ni alterar la descripcin principal de la
incidencia.
Usuario con acceso de lectura al incidente

Cualquier usuario que pertenezca al grupo de trabajo de una incidencia y tenga el
flag de acceso "IR" podr leer los detalles de la incidencia, aunque no podr
modificar nada, ni agregar una UT o fichero.
Usuario con acceso de gestin al incidente

Un usuario con el bit de acceso IM sobre el grupo al que pertenece un incidente
puede operar con el como si fuera el propietario del mismo. Esto implica que
puede escalar el incidente apropindoselo o traspasar la responsabilidad del
mismo a otro usuario. Por supuesto puede agregar UT o ficheros e incluso cerrar
el incidente.
Usuario que cierra la incidencia

Es el responsable del cierre de la incidencia, que puede no ser el mismo que
ejecuta la accin. Por ejemplo, el usuario 'tecnico' cierra una incidencia por orden
del usuario 'admin'. En este caso, el usuario que cierra la incidencia sera el
usuario 'admin'.
Usuario adscrito a una incidencia

Es cualquier persona "externa" al sistema. Se pone su email en el campo avanzado
"Direcciones de email adicionales", si hay varios, se separan por comas. Si dicho
email es parte del sistema (en el sistema de contactos) se visualizarn algunos de
sus datos, como nombre y empresa, sino simplemente su email.
En la solapa "Contactos" podemos ver la lista completa de las personas que
participan en una incidencia.

Pag 69
Primeros pasos con una incidencia

Tipos de incidencia
A una incidencia se le puede asignar un tipo. Cada tipo de incidencia puede tener
asociados campos personalizados segn convenga. Estos campos puede ser de
tres tipos: texto, combo o rea de texto. Si se elige el combo, habr que especificar
los valores que tendr ste control. A continuacin, vemos un ejemplo de creacin
de tipo:

Ahora creamos un campo personalizado asociado al tipo anterior:

Pag 70
Los campos marcados con el check "Mostrar en la vista general" son campos que
se pueden usar en busquedas y que se muestran en la visualizacin de lista. En los
campos de tipo textarea no se puede usar esta casilla.
Vista general:

Creacin de una incidencia

Crear una incidencia no es tan simple. Para llegar a este paso hemos debido ser
capaces de configurar y entender los siguientes aspectos:
Qu es un usuario en Integria.
Pag 71
o
o
o
o
Tipo de usuario (Externo, Normal)

Qu es un grupo en Integria
Qu relacin tiene el grupo con la visibilidad de ese usuario al resto de cosas de Integria.
Qu relacin hay entre el grupo, el perfil de acceso del usuario y el tipo de usuario que es
(externo, normal)
El inventario:
Contrato
SLA
Una vez, que suponemos que todos estos conceptos estn claros, crear una
incidencia ser algo muy sencillo :-). Hay que tener en cuenta -como repaso- que
las siguientes propiedades alteran el comportamiento de Integria a la hora de
crear una incidencia:
Tipo de usuario externo: Los usuarios externos solo podrn ver sus propios informes,
as que el concepto de grupo, perfil y dems no tiene tanta relevancia para este tipo de
usuarios. Los usuarios externos no pueden cambiar algunas propiedades de la incidencia
que se configuran por defecto, tales como usuario asignado, u objeto por defecto, ya que
van asociados al grupo.
Usuario normal: De igual manera que el anterior, no pueden cambiar algunas

propiedades de la incidencia que se configuran por defecto, tales como usuario asignado,
u objeto por defecto, ya que van asociados al grupo. Sin embargo un usuario con perfiles
de "gestin" (IM) podr cambiar aqui el estado de la incidencia, o incluso campos como
el "creador original" (para que no sea el mismo), u otros aspectos.
Por defecto una incidencia nueva, recin creada, est en estado "Nuevo".
Existen algunos campos, asignados automticamente como "SLA Desactivada" o
"Notificacin automtica por email", que en principio van ligados a los valores
que tiene ese grupo por defecto (el grupo al que se le haya asignado la
incidencia). Esos valores, si se tienen permisos de gestor(IM), se pueden alterar.
De lo contrario irn por defecto.
Limitacin de incidencias
Al crear una incidencia, existen dos valores definidos en un grupo, tal y como se
vi en el captulo de usuarios y grupos [Integria:Documentation_es:Usuarios] que
permiten definir cuantas incidencias de un grupo puede haber (abiertas o
cerradas) para cada usuario (en total) y cuantas incidencias puede haber abiertas
(en estado no cerrado) para un usuario dado de este grupo. Un recordatorio de
donde se configura ese comportamiento:

Pag 72
Si se sobrepasan esos valores, una ventana de advertencia se mostrar en Integria

y no podremos crear el incidente, tal y como se puede ver en esta captura:

El lmite de incidencias se calcula contando el nmero de

incidencias del ltimo ao a partir de la fecha actual.

Vista de un usuario normal al crear una incidencia:

Pag 73
Vista de un gestor al crear (o modificar) una incidencia:

Pag 74
Primer trabajo con la incidencia: Creacin de la primera UT

Bien, la incidencia ha sido creada por un usuario (llammosle A) y asignada a otro
usuario (llammosle B). Ahora qu?.
Al crear la incidencia, el sistema habr enviado un email al usuario A y otro al
usuario B, informando sobre la creacin de la incidencia. Al usuario A, este
mensaje le sirve como confirmacin de que la incidencia ha sido registrada por el
sistema.
El usuario B, puede contestar ese mismo correo, que lleva un cdigo especial y
enviar su primera UT, algo as como "He recibido la incidencia". Tambin puede
conectarse al sistema, con la URL suministrada para poder agregar manualmente
una UT a la incidencia.
En el momento que la incidencia en estado "Nuevo" recibe una WU,
automticamente se cambia su estado a "Asignada", es una forma de decir "se ha
empezado a trabajar" con la incidencia.
Dashboard (Vista principal)

Pag 75
El dashboard es una vista que permite ver de un simple vistazo las incidencias
agrupadas de diferentes maneras y tener acceso directo a las bsquedas
personalizadas que hemos creado.

Vista de bsqueda
Las bsquedas de incidencias es la herramienta bsica y la pantalla por defecto
cuando se hace click en Incidencias, en el men principal.
Se puede usar la vista de bsqueda bsica para encontrar las incidencias que
queremos, o acceder directamente al nmero de incidente en el men de la
izquierda. Las bsquedas por defecto muestran todas las incidencias no
cerradas y no solucionadas. Las bsquedas son un listado y una informacin
estadstica bsica sobre los resultados de esta bsqueda. Se pueden ver, en
pantalla completa, listas para imprimir utilizando el botn de generar vista de
informe HTML, en la solapa de "Estadsticas".

Pag 76
La bsqueda avanzada es similar a la bsqueda bsica, pero aade diversos

controles de filtrado ms. Cualquier bsqueda se puede guardar como bsqueda
personalizada, de forma que con el combo de seleccin de bsquedas
personalizadas se puede acceder a cualquier bsqueda previa guardada. Las
bsquedas personalizadas son diferentes para cada usuario.

Pag 77
Pulsando sobre una incidencia se puede acceder a todos los detalles de la misma.
Esto activar las pestaas superiores de la seccin de incidencias y podremos
visualizar su detalle, ver el inventario de objetos asociados a la incidencia, revisar
los cambios, aadir unidades de trabajo, etc. El entorno est basado en AJAX de
forma que no hay que refrescar la pgina. Podemos igualmente volver a la
pgina de bsquedas y acceder a otro incidente.
Todas las columnas de la vista de bsquedas de incidentes son auto-ordenables al
pinchar en el ttulo: pueden ordenarse por fecha, ttulo, horas de trabajo
asignadas, grupo, estado, etc.
Veamos la informacin que muestra cada fila de la lista de incidencias:

ID: La primera columna hace referencia al cdigo numrico de la incidencia, se puede

utilizar para acceder directamente a la incidencia en cuestin.
SLA: En la captura de arriba no hay ninguna incidencia con la SLA "Alertada", en la

captura que se presenta aqu debajo, se ve el smbolo de exclamacin para hacer
referencia a que la incidencia no cumple la SLA.

Incidente: Es el ttulo de la incidencia. Debajo aparece el tipo de incidencia, y entre

corchetes los campos personalizados del tipo de incidencia marcados para ser
mostrados en la vista principal.
Grupo: Grupo al que pertenece la incidencia. Debajo aparece la empresa (si existe esa
informacion) del usuario que cre la incidencia.
Pag 78
Estado / Resolucin : El estado (cerrada, asignada, pendiente de cerrar, nuevo,

solucionado y sin confirmar) y la resolucin (Solucionado, Incompleto, "a m me
funciona", expirado, etc.).
Prioridad: Color en funcin de la criticidad del ticket. Opcionalmente puede aparecer

como en esta captura un icono como un bocadillo, debajo del color. Esto indica que la
incidencia tiene una UT por parte del creador original de la incidencia, lo que significa
que "deberamos contestar" o que "la pelota est en nuestro tejado".
Actualizado / Creado : Indica cundo se actualiz la ltima incidencia y cundo se cre.

Si aparece un nombre de usuario es quien cre la ultima Workunit (nota) en el incidente.
Creador: Muestra el creador de la incidencia.
Propietario: Muestra el nombre del usuario asignado a la incidencia, el dueo (owner)

y nico usuario que puede cerrarla (exceptuando a usuarios con ms privilegios -
administradores o managers-).
Estadsticas de un incidente / Informe general

Al seleccionar (en la primera solapa de la vista de incidencias) una bsqueda, est
configurando automticamente un informe general con los parmetros de dicha
bsqueda. Si hace clic en la solapa de estadsticas, podr ver varios elementos
estadsticos predefinidos, usando la bsqueda que ha definido en la primera
solapa.
La suma del listado y las estadsticas de las incidencias se consideran un informe
tcnico o detallado de las incidencias. Se puede generar un informe en pantalla
listo para imprimir pulsando sobre el botn Informe HTML en la esquina
inferior derecha de la vista de bsqueda de incidentes. Este informe est listo
para imprimir desde su navegador. Tambin puede descargarlo en PDF.
Pag 79
Pag 80
Operacion sobre la incidencia

Una vez que ha seleccionado una incidencia (o bien despus de crearla).
Podremos operar bien con las solapas superiores o las inferiores. Las solapas
superiores dan acceso a la edicin de la incidencia, o ver/aadir adjuntos o notas.
Tambien podemos volver a la bsqueda

Pag 81
En la parte inferior, podemos navegar por las solapas que presentan las notas de
la incidencia, los ficheros, las estadisticas de esta incidencia, el tracking detallado
y los contactos de la incidencia activa.

Pag 82
Aqui podemos ver ordenados de mas nuevo a ms antiguo, las notas generadas
por los diferentes usuarios. Podemos directamente desde aqui, agregar una nota.

Pag 83
Al igual que en la parte de notas (workunits) podemos ver los ficheros adjuntos,
descargarlos y subir nosotros los que queramos.

Esta es la vista de detalle de una incidencia, que muestra los tiempos totales, los
tiempos que ha pasado en cada estado y los tiempos dedicados por cada persona
implicada en la incidencia, entre otros detalles.

Pag 84
Finalmente, aqui se puede ver los detalles de las personas implicadas en esta
incidencia.
Bsquedas de incidentes personalizados

Un incidente es un concepto genrico, como la palabra "ticket", pero esto se
puede aplicar a un fallo de software (un bug), a un problema de comunicaciones,
o a un problema de un cliente con un pedido. En un caso tendr una serie de
campos "personalizados", y en otros otra. Por ello, la posibilidad de definir tipos
de incidente permite esta flexibilidad. En el mismo sistema podemos trabajar con
diferentes tipos de incidencias.
Todos los campos personalizados se pueden buscar, y guardar en una bsqueda
personalizada, al seleccionar el tipo de incidente en la bsqueda.

Sobre una incidencia ya creada podemos cambiar su tipo, opcionalmente, ya que
existe una casilla en el setup para definir este comportamiento. Si lo hacemos,
perderemos el valor que contenan los campos personalizados del tipo anterior.
Gestin de SLA
Pag 85
La SLA es la forma de "comprobar" que la gestin de incidencias funciona bajo

unos criterios. Las SLA se gestionan automticamente por Integria, que las
comprueba de forma peridica mediante la tarea programada que se activa
cuando se instala Integria.
El SLA se procesa conforme unos parmetros:
Nombre: Es el texto que aparecer en los combos de seleccin para identificar el

SLA.
Enforced: Hace que la SLA dispare los emails cuando se imcumpla (enforced) o
que solo avise con un indicador luminoso.
SLA Base: Indica que la SLA est relacionada con otra (solo a nivel informativo).
Max. Tiempo de respuesta: Indica en horas, el mnimo tiempo de respuesta que
tiene que haber entre una notificacin (incidencia nueva o UT) del creador de la
incidencia. Pasado ese tiempo, se disparar la SLA. Por ejemplo, si es 4 horas, y
una incidencia nueva tiene 4.1 horas de vida, se disparar la SLA. Si por ejemplo
es una incidencia vieja (1 semana) y la ltima UT es del creador de la incidencia,
y tiene ma de 4 horas, tambin se disparar la incidencia.
Max. Tiempo de resolucin: Indica en horas, el mximo tiempo de vida de una
incidencia. Si una incidencia tiene ms de ese tiempo y no est cerrada o resulta,
saltar la SLA.
Max. Tiempo de inactividad: En horas, es el tiempo mximo que una incidencia
puede estar sin actualizar.
N Mx de incidencias abiertas simultneamente: Indica el n total de
incidencias que pueden estar abiertas simultneamente. Si hay ms, saltar la
SLA.
Max. tiempo inactividad: Define el tiempo mximo de inactividad de la
incidencia. Cuando este tiempo se supere se enviar un email al responsable
para recordarle que la incidencia est abierta.
Hora de comienzo para activar la SLA: Hora a partir de la cual la SLA se
empieza a calcular (p.e: 9 de la maana).
Hora de fin para una SLA: Hora a partir de la cual la SLA ya no se calcula (p.e: 18
hr).
Deshabilitar SLA en fines de semana: si esta opcin est activada el SLA slo se
calcula los das entre semana, los fines de semana quedaran excluidos.
Deshabilitar SLA en vacaciones: si esta opcin est activada el SLA no se
calcular los das definidos como das de vacaciones.
Descripcin: Texto informativo para describir la SLA.
Que significa "saltar la SLA" ?

Significa que el sistema enviar una notificacin por email al propietario de la
incidencia, advirtiendo que la incidencia no cumple los baremos establecidos en
la SLA a la que pertenece la incidencia. Una incidencia puede estar sujeta a
diferentes SLA simultneamente, si est asociado a diferentes objetos de
inventario. Una SLA que ya ha saltado no se desactiva sola por el hecho de estar
Pag 86
en fin de semana, es decir, aquellas incidencias que no cumplen SLA, hasta que no
cumpla todas las condiciones, no volver a estado "normal".
Podemos ver la evolucin histrica del cumplimiento de SLA de una incidencia, o
los valores de cumplimiento en total en los informes generales. Una SLA baja,
generalmente significa que la incidencia no se ha gestionado bien. Es un indicador
muy usado para ofrecer un resumen de la calidad de la gestin de la incidencia.
Cuando una SLA salta, un indicador luminoso aparece en la vista de incidencias.
Veamos un ejemplo de definicin de SLA:

Las SLAs estn vinculadas al estado de las incidencias. De forma que

no se aplicar el SLA para las incidencias que estn en estados
Cerrado y Pendiente de terceras personas

Evaluacin de una incidencia por su SLA

Utilizando el sistema de SLA, y en el informe de "seguimiento" de una incidencia,
podemos ver, en una escala de tiempo, cuando la incidencia no ha cumplido una
incidencia (en rojo) y cuando ha cumplido (en verde). Adems de un indicador
del % de cumplimiento de la incidencia en toda la vida de sta.
Pag 87
Creacin de incidencias a travs de un formulario web

A travs del API REST de Integria IMS es posible crear nuevas incidencias,
usaremos esta funcionalidad para desarrollar un formulario personalizado que
nos permita dar de alta nuevas incidencias en el sistema.
El siguiente cdigo PHP crea un formulario y recoge los datos enviados por el
formulario. Con ellos compone una llamada al API de Integria IMS que crea una
nueva incidencia.
<?php //Config parameters $integria_url = "http://192.168.70.163/integria"; $user =
"api_user"; $group = 12; $priority = 3; $inventory = 11; //Get post parameters $title =
$_POST["title"]; $description = $_POST["description"]; //Create url to call the API $myurl =
$integria_url."/include/api.php?user=".$user."&op=create_incident&params=".urlencode($title)."
,".urlencode($group).","; $myurl .=
urlencode($priority).",".urlencode($description).",".urlencode($inventory); // Configure curl
$ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $myurl); curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE); // Send curl request and close $ret =
curl_exec($ch); curl_close ($ch); ?> <h2>Integria IMS Incidents form</h2> <form
method="post"> Title: <input type="text" name="title" size="35" > <br> <br> Description: <br>
<textarea name="description" cols="50" rows="8"></textarea> <br> <br> <input type="submit"
name="submit" value="Submit"> </form>
El formulario resultante tiene el siguiente aspecto.
Pag 88

A continuacin comentaremos la parte de cdigo. Las dos primeras variables
definen la url donde est alojada Integria IMS y el usuario que tiene permisos
para usar las funciones del API.
//Config parameters $integria_url = "http://192.168.70.163/integria"; $user = "api_user";
La siguientes variables configuran opciones generales de las incidencias, en este

caso el grupo, la prioridad y el objecto de inventario asociado. Usaremos las IDs
para identificar los diferentes elementos.
$group = 12; $priority = 3; $inventory = 11;
A continuacin se crea una cadena de texto con al url que usaremos para crear los
leads mediante el API de Integria IMS. Adems de la direccin del servidor y el
usuario, se configuran los parmetros op con el valor create_incident que indica la
funcin del API a usar y params con los parmetros de la funcin.
$myurl =
$integria_url."/include/api.php?user=".$user."&op=create_incident&params=".urlencode($title)."
,".urlencode($group).","; $myurl .=
urlencode($priority).",".urlencode($description).",".urlencode($inventory);
Pag 89
Un ejemplo de resultado de la url resultante podra ser el siguiente:

http://192.168.70.163/integria/include/api.php?user=api_user&op=create_incident&params=Error+i
n+Linux+server+disk+usage,12,3,The+monitoring+information+about+disk+usage+is+wrong.+Please+ch
eck+it+to+ensure+the+data+is+collected+properly.,11
Por ltimo el cdigo realiza una llamada al API de Integria IMS por medio de la
utilidad CURL de PHP.
// Configure curl $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $myurl); curl_setopt($ch,
CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE); // Send curl request and
close $ret = curl_exec($ch); curl_close ($ch);
Si enviamos un formulario con lo siguientes datos:

Se crear una incidencia dentro del sistema con los datos del formulario,
resultado algo como lo siguiente:
Pag 90
Gestin de incidencias por email

Integria permite la creacin y actualizacin de incidencias mediante el envo de
mails. Esta caracterstica Enteprise y permite agilizar la gestin de incidentes
usando el cliente de correo electrnico.

Dependiendo del cliente de correo electrnico usado el formato de

los emails podra ser diferente. La gestin de emails de Integria ha

sido validada con los siguientes gestores de correo: Evolution,
GMail, Outlook y Mail
La creacin de incidencias y workunits por email usa los mismos

principios de ACLs que el interfaz grfico. Puedes ver estos
principios en la seccin Perfiles y usuarios.

Pag 91
La gestin de incidencias por email est basada en una gestin de colas de

correos, configuradas para cada uno de los grupos existentes en Integria IMS.
Puede ver cmo configurar las colas de correo para cada grupo en la seccin
Gestin de colas de mails. Adems deber configurar los parmetros de correo
como se indica en la seccin Configuracin de correo-e.
Internamente la gestin de incidentes por email funciona de la siguiente manera:
Supongamos que tenemos habilitada la siguiente direccin de correo para recibir
los email: support@integria.com y configurado el parmetro 'Cola de emails de un
grupo con la siguiente informacin:
support@integriaims.com
Adems enviaremos un email con los siguientes datos:
From: user@company.com
To: support@integria.com, myboss@company.com
CC: admin1@company.com, admin2@company.com
Subject: Another problem with the servers
Body: We are having a big problem with our servers!
Attachment: screen1.png, screen2.png
1. Una vez el email est en el inbox de la direccin support@integriaims.com se

comprobar si corresponde con alguna cola de correo configurada.
1. Si no encuentra ninguna cola de correo el email se desecha
2. Si encuentra una cola de correo entonces se usaran los parmetros por defecto
configurados en esa cola de correo para gestionar la incidencia.
2. Ahora la aplicacin procesar el email, en este punto pueden suceder dos cosas:
1. El email no se corresponde con ninguna incidencia actual. En este caso se crear
una nueva incidencia.
2. El email se corresponde con una incidencia creada en el sistema. En este caso se
crear una nueva workunit y se actualizarn los datos de la incidencia.
3. Para crear una incidencia se configurarn los siguientes parmetros:
o
o
o
o
o

Creador: ser el usuario asociado con la direccin from. Si el usuario no exite se
crear siguiendo los parmetros de configuracin de la creacin de usuarios para
la cola de correo detectada.
Editor: se usar el mismo usuario asociado con la direccin from del correo.
Grupo: grupo correspondiente con la cola de correo.
Dueo: como dueo se usar el usuario por defecto del grupo asociado a esta cola
de correo.
Ttulo: subject del correo electrnico.
Descripcin: body del correo electrnico.
Pag 92
Notificaciones por email: en este campo de la incidencia se aaden todas las

direcciones de correo de los campos TO y CC que no se correspondan con la
direccin encontrada para la cola de correo. En este ejemplo se aadirn las
siguientes direcciones: admin1@company.com, admin2@company.com,
myboss@company.com
o Archivos de incidencia: se aadirn los adjuntos del correo electrnico.
o
1. Si la incidencia existe en el sistema se aadir el contenido del cuerpo del correo

electrnico como una workunit y adems se realizarn las modificaciones
necesarias en el estado de la incidencia.
La siguiente imagen explica el flujo de gestin de colas de emails de una forma

resumida:
Crear una incidencia por email
Pag 93
Para crear una nueva incidencia a travs del email slo tiene que envar un correo
al mailbox configurado y que adems coincida con una cola de correo configurada
en el sistema. Los parmetros del email deben ser:
From: <direccin de correo usuario Integria> (si el usuario no existe se crear)

To: <mailbox configurado para POP en Integria>, <direcciones de colas de correo>,
...
CC: <otras direcciones en copia>
Subject: <ttulo de la incidencia>
Body: <descripcin de la incidencia>
Adjuntos: <archivos adjuntos al email>
Un ejemplo de email para crear una incidencia sera:
From: my.email@company.com
To: integria.mailbox@company.com, my@domain.com
CC: admin1@company.com, admin2@comapny.com
Subject: My test incidents
Body: Incident description
Adjuntos: captura1.png, captura2.png
Este email crear un incidente como el de la siguiente imagen:

Pag 94

Adems si aade archivos adjuntos al email, estos sern aadidos de forma
automtica. La funcionalidad de aadir adjuntos no permite aadir dos archivos
con el mismo nombre al mismo incidente, esta precaucin es necesaria para
evitar sobrecargar el sistema con archivos sin importancia como las firmas
adjuntas como imgenes en los correos electrnicos.
Aadir nueva workunit

Si tiene activado el sistema de envo de emails para seguir las novedades en las
incidencias de Integria, recibir emails con las novedades de sus incidencias.
En algunos de ellos ver que en el ttulo tiene asignado un ticket ID, respondiendo
a estos emails podr aadir nuevas workunits al incidente correspondiente.

Pag 95

Para aadir una nueva workunit slo tiene que contestar el email aadiendo en el
cuerto el contenido de la workunit. Como resultado aparecer una nueva
workunit en el incidente. Si por ejemplo responde al email con el siguiente cuerpo
"Thanks. Please close the incident all its ok. Javi" aparecer el siguiente workunit.

Al igual que la creacin de incidencias por email, la creacin de workunits aade
los archivos adjutnos en los emails a la incidencia correspondiente.
Actualizacin de incidencias y personalizacin de workunits

Integria permite modificar las incidencias por email. Para ello es necesario aadir
la siguiente estructura en el cuerpo del email.
[INCIDENT] GROUP: IT ASSIGNED_TO: dario PRIORITY: 3 STATUS: Assigned RESOLUTION: Invalid
[INCIDENT]
Los campos y sus posibles valores son los siguientes:

Pag 96
GROUP: nombre del grupo al que se quiere cambiar el incidente.

ASSIGNED_TO: nombre corto del usuario al que pertenece el incidente. Es el nombre
con el que el usuario entra en Integria.
PRIORITY: prioridad a la que se cambiar el incidente. La prioridad es un nmero entre
0 (ms baja) y 5 (ms alta).
STATUS: nombre del estado al que se cambiar el incidente. El nombre de los estados se
define en el tab de Incidentes de la Configuracin general.
RESOLUTION: nombre de la resolucin al que se cambiar el incidente. El nombre de los
estados se define en el tab de Incidentes de la Configuracin general.
Tambin es posible modificar algunos parmetros en la creacin de la workunit

usando la siguiente estructura en el cuerpo del email:
[WORKUNIT] TIME_USED: 0.05 [WORKUNIT]
Los campos y sus posibles valores son los siguientes:
TIME_USED: tiempo dedicado a la workunit. Es un nmero decimal separado por

puntos. Por defecto el valor de este parmetro es 0.25 horas.

Las estructuras anteriormente descritas para modificar la incidencia
o personalizar la workunit no quedarn reflejadas dentro de la
informacin de la incidencia en la aplicacin

Es muy importante verificar la correcta sintaxis de las estructuras

anteriores, ya que un error en las cabeceras o en los parmetros
resultarn en una deteccin incorrecta de las directivas y por ello no

se aplicarn los cambios. En este caso se tratarn como otro texto
cualquier y aparecern en la informacin de las workunits dentro de
la aplicacin
Enmascarar direcciones de correo workunits

Es posible que al crear una workunit mediante el correo electrnico aparezca en
el cuerpo del mensaje alguna direccin de email fruto de usar la funcion
responder a todos o por cualquier otra razn.
Pag 97
Si en su organizacin considera que esta informacin es sensible y no debera

aparecer en los workunits, Integria le permite enmascarar las direcciones de
correo, de forma que usted sabr que ah haba una direccin de correo
electrnico, pero no podr adivinar cul.
Puede configurar esta opcin en el tab de Incidencias de la Configuracin General
de la aplicacin marcando el flag Masking email addresses.
Cuando este flag est activado Integria cambiar todas las direcciones de correo
electrnico por la siguiente direccin comodn xxxx@xxxx.xxxx

Pag 98
6.
Sistema de gestin de proyectos
Integria IMS tiene una gestin de proyectos dinmica que incluye

planificacin, seguimiento y reporte por parte de los usuarios. De esta forma
es posible no slo planificar (tiempos y costes) sino ver la evolucin en el
tiempo gracias a la imputacin de horas de las propias personas que trabajan
en los proyectos. Esa imputacin se hace de forma pormenorizada, en forma
de "Workunits" o unidades de trabajo (que pueden ser horas o das, segn el
nivel de detalle que se precise) y asignadas especficamente a cada tarea del
proyecto.
Los diagramas gantt, el clculo de costes, las notificaciones automticas de
aviso de cierre de tareas e hitos, etc son acciones automticas del sistema que
se alimentan de todos los datos que se introducen a lo largo del tiempo por los
usuarios.
Proyectos y tareas
Un proyecto en Integria IMS es un contenedor de tareas con fecha de inicio y
fecha de fin. Los proyectos a su vez estn agrupados en grupos de proyectos,
por ejemplo: Proyectos de desarrollo, Proyectos facturables, Proyectos de
gestin interna, etc.
Internamente, un proyecto est compuesto por tareas. Estas tareas a su vez
pueden contener otras tareas (de forma que se pueden definir relaciones de
start-to-end entre ellas y construir una jerarqua que finalmente se ver
reflejada en un diagrama gantt).
Pag 99
Las tareas pueden (opcionalmente) contener tanto Incidencias asociadas como

Work-Orders (rdenes de trabajo) que representan una descomposicin
atmica de la tarea en diferentes paquetes de trabajo unipersonales
(asignados a una sola persona). Esto nos permite ver de un vistazo en que se
descompone una tarea, tanto en trabajo planificado (Work orders) como en
trabajo no planificado (incidencias).

Asignacin de recursos de personal
Pag 100
Como en cualquier opcin de Integria, en la versin enterprise existe un

complejo sistema de ACL que permite a Integria diferenciar quin puede ver
determinadas cosas y qu nivel de acceso tiene a ellas. En la gestin de
proyectos el sistema de acceso es completamente granular y permite la
definicin de un jefe de proyecto "general" que es el que puede crear tareas y
asignar roles dentro del proyecto. De esta forma puede definir un "pool" de
personas (y sus roles) dentro de cada proyecto. Estas personas pueden ser de
varios grupos y es el responsable de proyecto quien decide qu roles tienen en
el proyecto. En cada tarea se puede asociar uno o varios sub-jefes de proyecto
adicional que tambien pueden a su vez crear taras, incluir personas etc. Estos
usuarios deben tener el rol de jefe de proyecto.
Individualmente, por tarea, estos roles pueden ser ajustados, de forma que no
todos los participantes de un proyecto pueden estar en las mismas tareas. Los
participantes de una tarea pueden tener permisos para modificar algunos
parmetros de esa tarea (el grado de progreso, la descripcin de la tarea) o ser
simples usuarios con esa tarea asignada, de forma que solo pueden
visualizarla y reportar trabajo y costes a la misma.

Pag 101
Con el "pool" de personas asignadas a un proyecto, luego en cada tarea se

eligen, de los disponibles definidos a nivel de proyecto, los asignados para
cada tarea. Por defecto se asignan todos los usuarios disponibles.
Creacin de una tarea nueva

A la hora de definir una tarea, sta se define dentro de unos mrgenes

temporales de inicio y fin, as como una criticidad o prioridad para ella. Se le
asignan recursos (personas) y se le asignan unos costes objetivo y unos
recursos de tiempo (en horas). sta es la estimacin o la planificacin de la
tarea. A partir de aqu, y basndonos en la imputacin de horas a dicha tarea
que hagan los usuarios que estn asignados a ella, podremos saber las
desviaciones en el tiempo, desviaciones en costes y desviaciones en la
planificacin sobre los recursos horas/persona. Integria automticamente va
generando esos ndices que se pueden consultar en tiempo real.
Pag 102
El primer paso es la creacin de una tarea, no podemos asignar recursos,

aadir ficheros, imputar unidades de trabajo, etc hasta que no se ha creado la
tarea. Una vez creada, el siguiente paso lgico es asignar recursos (personas) a
esa tarea. Por defecto, asume que sus recursos son los asignados al proyecto.
Podemos quitar a las personas que no queramos en esa tarea.
Tareas y costes
Los costes de cada tarea se calculan en base a los costes de cada perfil
(horas/persona) y a los costes adicionales imputados (en forma de facturas de
gastos, gastos adicionales o cualquier otra frmula) que se impute
directamente a la tarea (y por tanto al proyecto). Esa gestin de coste por
perfil (llamado rol en Integria para diferenciarlo de los perfiles de usuario de
la aplicacin) se definen en la seccin de Usuarios -> Roles.

Las tareas asignadas a un proyecto se visualizan en forma de tabla, y sta
muestra la tarea, su prioridad, si una tarea depende de otra, una grfica con la
estimacin de horas y las horas imputadas realmente, el tiempo real
empleado, el coste en horas por tarea, el nmero y la lista de personas
asignada a esa tarea, el inicio y el final de la tarea.
Borrado de tareas y proyectos
Pag 103
Los proyectos pasan a estado de desactivado, guardando toda la informacin

que contienen. Un proyecto desactivado se puede borrar, y todas las unidades
de trabajo que contiene se convierten en "hurfanas" y no estn asignadas a
ningn proyecto ni tarea, aunque siguen existiendo.
Para desactivar un proyecto basta con darle al botn con forma de cruz roja a
la derecha de la vista general de proyectos. Automticamente ese proyecto
pasar a la vista de proyectos desactivados. Dichos proyectos no notifican
automticamente ni el cierre de tarea, de proyecto o de hito (milestone).
Dichos proyectos pueden ser activados desde la vista de proyectos
desactivados. Para acceder a dicha vista, basta con acceder al men de
proyectos -> Proyectos desactivados.
Un proyecto desactivado se puede borrar, pero esta operacin debe ser hecha
con mucho cuidado ya que NO borra las unidades de trabajo asignadas a dicho
proyecto, pero s la informacin de todas las tareas asociadas a este proyecto.
Las unidades "hurfanas" constan, pero ya no se pueden relacionar con una
tarea o proyecto concreto.

Gestin de proyectos con el Planificador de Tareas

El planificador de tareas es una vista que permite una gestin gil de las
tareas. Es posible crear y borrar tareas, modificar el propietario y el estado de
las tareas con muy pocos clicks.
Adems ofrece una estadsticas con: el nmero de tareas por estado, las horas
trabajadas por empleado, y las tareas asignadas a cada empleado.
Pag 104

Para actualizar la informacin de las tareas realice todos los cambios que
quiera en la tabla y para salvarlos pulse en el botn Update. Si la tarea tiene
ms de un empleado asignado y quiere realizar algn cambio en este campo
deber ir al men de edicin detallado pulsando en el icono con forma de
herramienta situado en la columna de la derecha. Para borrar una tarea puede
usar el botn con forma de cruz situado en la columna de la derecha.
La codificacin de los estados de la tarea se corresponde al siguiente
porcentaje completado:
Pending (blanco): Entre 0% y 39%

In progress (amarillo): Entre 40% y 89%
Complete (azul): Entre 90% y 99%
Verified (verde): 100%
Para aadir una nueva tarea tiene que pulsar en el botn Add Task que
despliega el formulario de creacin de tarea, ahora solo tiene que rellenar los
campos y pulsar en el botn Create.

Pag 105
Informes y resultados
Mapa de tiempo proyectos por persona
Esta opcin nos permite ver de una forma visual, para una persona dada, en un
intervalo de tiempo dado, que a proyectos ha dedicado tiempo, y mostrarlo a
escala.

Pag 106
Overview de proyecto
Es la vista principal de un proyecto. Desde aqu podemos editar algunos
detalles generales de proyecto y ver un informe global sobre el estado del
proyecto. Este informe, como muchos otros, se puede ver en PDF haciendo
click en el icono de PDF a la derecha del titulo.

Pag 107
Planificador de tareas
Presenta grficas de reparto de carga de tareas por usuario y permite editar de
forma rpida todas las tareas de un proyecto, as como aadirlas o borrarlas.
Pag 108
Mapa de tiempo
Similar al proyecto de tiempo por hombre/proyecto, este grfico representa la
imputacin de tiempos de cada usuario por tarea en este proyecto, de forma
proporcional y en escala. Es interactivo y me permite, situando el ratn,
obtener ms informacin.
Diagrama Gantt interactivo

Muestra la informacin del proyecto, fusionando la imputacin real (en rojo),
con el progreso de la tarea (en verde) y la planificacin original (azul).
Muestra depedendencias e hitos.

Pag 109
Overview de Tarea
Muestra la informacin especfica de una tarea: su progreso en el tiempo,
horas imputadas, horas imputadas con coste, coste real (basado en la
imputacion de las personas que trabajan en el, y su coste por hora). Permite
definir una fecha de inicio y fin o una cantidad total de horas (para reflejar el
numero de personas que trabajan en ella). Tambien se puede definir que el
progreso de la tarea vaya reflejado en funcion del % de horas imputadas
respecto al total de horas planificadas.

Pag 110
Detalle de imputaciones de horas

El detalle de las imputaciones de horas totales (y por tarea) de cada miembro
muestra la accin de cada usuario, en la fecha que se hizo, la descripcin, la
tarea o subtarea y una serie de atributos que se muestran como iconos. +
El jefe de proyecto puede "certificar" una WU, de forma que el usuario no la
pueda modificar o borrar. La persona que report esa unidad de trabajo puede
ver esa unidad de trabajo, modificarla (si no est certificada) y borrarla.

Pag 111
Creacin de nuevas unidades de trabajo (WU)

La creacin de una WU permite rellenar una serie de campos que son
evidentes (descripcin, nmero de horas empleadas en la unidad de trabajo,
perfil asignado, etc). Adems de esos campos evidentes existen unos controles
que permiten "dividir" la unidad de trabajo en bloques de X horas (por defecto
8 horas) y repartir ese tiempo en diferentes Unidades de Trabajo (WU) a lo
largo del tiempo (para adelante o para detrs, segn se elija) con el mismo
contenido que la original, exceptuando por la fecha. Es la forma idnea de
"rellenar" las horas para completar un calendario de vacaciones, por ejemplo.
Las unidades de trabajo de un proyecto se pueden crear desde el men
contextual de la tarea donde se quiera aadir la unidad de trabajo (Proyectos -
> Elegir proyecto -> Elegir tarea -> Agregar unidad de trabajo), o se pueden
hacer de forma general desde la vista de usuario (Usuarios -> Agregar horas de
trabajo sueltas). La nica forma de agregar horas de trabajo en los tres
supuestos especiales que contempla Integria IMS es desde la vista de usuario
(Agregar horas de trabajo sueltas):
Vacaciones
Pag 112
Baja por enfermedad

No justificado.
Esos conceptos corresponden a tareas especiales dentro de un proyecto

especial que se computa de manera diferente.
Las unidades de trabajo se pueden crear de una en una o en bloques de forma
que sea ms comodo y se puedan previsualizar todas antes de subirlas al
sistema.

Pag 113
Ficheros adjuntos a las tareas

El gestor de tareas de Integria IMS permite adjuntar archivos a las tareas.
Estos archivos se almacenan en el servidor y se guardan en el directorio de
adjuntos. Se pueden subir tantos archivos como se quiera (no hay gestor de
cuota o almacenamiento mximo). Todos los archivos subidos sern accesibles
por los usuarios con permisos de lectura de la tarea.

Pag 114
Mover tarea
Es posible mover la tarea de un proyecto a otro. Para ello, navegue por el rbol
de proyectos, localice el proyecto, y la tarea que quiere mover. Una vez ah,
elija la opcin de mover tarea y seleccione el proyecto de destino. Si lo que
desea es cambiar el padre de la tarea, edite las propiedades de la misma y
cambie el padre. Las Unidades de Trabajo (WU) de la tarea van vinculadas a la
tarea, as que si sta se mueve de proyecto o de tarea padre, no importa ya que
las WU van asociadas siempre a la tarea, no al proyecto.

Informe de tarea
Integria IMS tiene una opcin para enviar un informe automtico sobre la
tarea y su estado actual a todos los miembros de la tarea. Seleccione Proyecto -
> Tarea -> Informe de tarea para acceder a esta herramienta.
El informe de tarea generar automticamente un texto que puede modificar o
personalizar. Al darle al botn de enviar, generar un email automticamente
y lo enviar a cada uno de los participantes de la tarea.
Pag 115
Seguimiento de tareas
Integria IMS realiza un seguimiento (tracking) de prcticamente todas
aquellas secciones o elementos de informacin que son susceptibles a
cambios. En el caso de la tarea registra todas las operaciones de apertura,
cierre, cambio y adicin de informacin; ya sea en forma de Workunit o en
forma de fichero adjunto.
Pag 116
Informes generales de seguimiento

Aunque los informes generales de seguimiento tambin visualizan la
informacin de las incidencias (ticketing), son extremadamente tiles para
hacer el seguimiento personal de actividad en proyectos. El informe completo
permite hacer una trazabilidad detallada de la actividad de una persona, entre
un intervalo de fechas. De esta forma, podemos saber qu tareas ha acometido,
cunto tiempo les ha dedicado, y podemos "ver el detalle" de cada una de ellas,
listando las unidades de trabajo (workunit) reportadas a cada tarea/subtarea,
a mximo nivel de detalle. Este informe adems permite verse en modo
"pantalla completa" que nos permite imprimirlo directamente desde el
navegador (o generar un PDF con el navegador, p.e).
Al elegir un usuario, podemos elegir un rango de fechas. sto nos muestra la
lista de proyectos/tareas sobre los que ha imputado horas de trabajo. Se
muestra las horas imputadas por esa persona en ese intervalo y se compara a
las horas imputadas en TOTAL por todo el mundo en esa tarea.

Pag 117
Tambin se muestra la misma informacin en formato de grfico un poco ms

abajo.

Pag 118
Si hacemos click en cualquiera de las tareas mostradas, se ve el informe

detallado, en ese perodo de tiempo, para ese usuario y para esa tarea. Esta
informacin detallada se puede editar si somos administradores. Si las
unidades de trabajo ya han sido validadas, nadie puede modificarlas a
excepcin del administrador o su jefe de equipo.

rdenes de trabajo
Las rdenes de trabajo permiten gestionar las diferentes tareas que surgen en
el da a da y que no tienen por qu estar vinculadas a un proyecto. Adems es
una forma rpida y sencilla de asignar tareas que no necesitan estar
Pag 119
programadas, ya que permite asignar un usuario encargado de realizar la

orden de trabajo.
Noficaciones por email

Las rdenes de trabajo de Integria ofrecen la posibilidad de enviar a las partes
implicadas notificaciones por email cuando se produzca cualquier cambio
(creacin, moficiacin, nueva nota, etc.) en la orden de trabajo. Esta
funcionalidad es opcional y se configura activando el flag Noficaciones por
email disponible en cada uno de las rdenes de trabajo.
Puede ver cmo configurar esta funcionalidad en la seccin Configuracin de
correo-e.
Podr distinguir de forma sencilla los emails provenientes de rdenes de
trabajos ya que tienen, en el contenido del asunto, algo como esto:
[WO#9/e06b9/admin] [Integria IMS - the ITIL Management System] NEW WO #9 Prueba envo nota por
email.
Creacin de notas por email

Es posible aadir una nueva nota a una orden de trabajo usando el email.
Esta funcionalidad Enterprise permite aadir una nueva nota simplemente
respondiendo al email asociado a la orden de trabajo.

Asignacin de tareas globales

Pag 120
La seccin Asignacin de tareas globales permite ver las tareas que tiene
asignadas un usuario concreto, su rol en la tarea, las unidades de trabajo que
ha imputado en ella y las unidades de trabajo totales de la tarea.
Adems, desde aqu podemos asignar de forma rpida ("en bloque") tareas
especficas a ese usuario.
Esta seccin es especialmente til para administradores, en ella pueden ver si
un usuario tiene asignadas tareas que no debera, bien de forma global o
viendo que el usuario no ha imputado ninguna hora en la tarea. O bien
confirmar si el rol del usuario en la tarea es el correcto. Aqu podemos "sacar"
de una tarea a un usuario con pulsar un solo click.
Pag 121
7.
Gestin de Clientes (CRM)
La gestin de clientes que se puede realizar con Integria IMS es una gestin
orientada a mantener una base de datos relacionada de cuentas (trmino que
comprende empresas, organizaciones, compaas), contactos (personas),
contratos, facturas y "actividad reciente" sobre una cuenta, todo ello
relacionado.
Muy relacionado con esto est el inventario, donde se vinculan los objetos de
inventario a travs de un contrato, y este va vinculado a una empresa. De esta
forma, es posible saber, cuando hay una incidencia, que empresa est
relacionada con ese problema y qu contactos, facturas, o actividad comercial
reciente hay sobre esa cuenta.
El modelo de gestin de clientes por tanto est basado en cuatro elementos:
compaas (o cuentas), contacto, contrato y factura.
Cuentas/Compaas
Son el elemento "central" de la gestin de cliente, almacenan datos sobre la
empresa u organizacin. Esto es, el nombre, telfono, el rol que tiene como
empresa, y algunos otros datos. De especial relevancia es el grupo al que
pertenece, porque solo los usuarios de integria que pertenezcan a ese grupo
podrn ver los datos de esa compaa.
Roles de empresas
Sirve para clasificar las compaas en categoras, como por ejemplo: partners,
clientes, fabricantes, reseller, posible cliente, etc.
Contactos
Los contactos son las personas asociadas a esa empresa. Aqui es donde
podemos definir, ademas del nombre de esa persona, su telfono, direccin de
correo, y por supuesto la empresa a la que pertenece.
A veces no queremos meter las empresas de todos los contactos que tenemos
porque son contactos "ocasionales", p.e: contactos de una feria, o importados
de un listado. Estos contactos se pueden "agrupar" bajo una cuenta de
empresa "ficticia", p.e: Campaa de XXXX. de forma, que si intereresa
realmente crear una cuenta de empresa para ese contacto, se puede crear y
cambiar el contacto para que "cuelgue" de la nueva empresa.
Pag 122
En la versin Enterprise existe control de acceso a los contactos de una

empresa. Tienen acceso a ellos, el usuario asociado a la empresa y los usuarios
que pertenecen a la empresa padre.

Contratos
Vinculados a una empresa, llevan datos relevantes, como cuanta econmica y
fecha de inicio y fin. Especialmente til para poder buscar por contratos a
punto de vencer o conocer otros detalles.

Pag 123
En la versin Enterprise existe control de acceso a los contratos de una

empresa. Tienen acceso a ellos, el usuario asociado a la empresa y los usuarios
que pertenecen a la empresa padre.
Facturas
De forma similar a los contratos, nos sirven para saber cuando hay facturas
emitidas sin cobrar, y para saber cuando, y cuanto se ha facturado a una
empresa determinada. El sistema se utiliza para gestionar las facturas
EMITIDAS por nosotros, es decir, en ningun caso es un ERP que sirva para
calcular ciclos de tesorera, gestin de impagos u otras caractersticas propias
de un ERP. La gestin de facturas, que incluye la generacin de facturas en
PDF; est orientada desde el punto de vista de la gestion de Clientes, no de
proveedores.
En la versin Enterprise existe control de acceso a las facturas de una
empresa. Tienen acceso a ellas, el propietario de la empresa y los usuarios que
tengan perfil de gestor (CM). En la version open, todo el mundo tiene acceso a
las facturas.

Pag 124
Las facturas contienen varios campos, de los cuales los ms importante son:
Identificacin de la factura: Nmero de factura. No puede estar

duplicado con otra factura del sistema. Este sistema es unicamente para
facturas emitidas por nuestra empresa, por lo que no deberia ser posible
tener dos facturas con el mismo ID.
Referencia: Generalmente para indicar un numero de pedido, orden de
compra o similar. Es opcional.
Estado de la factura: Pendiente de pago, pagada o anulada.
Fecha de creacion y fecha de pago efectiva.
Concepto: Hay cinco lineas, con cinco cantidades. Se mete por cada
concepto la cantidad. Siempre sin impuestos, en bruto.
Impuesto: Indicar el %, p.e: 21 para 21%.
Moneda: EUR por defecto.
Descripcion: Texto que saldr en la factura, generalmente aclarando
datos del pedido, aadiendo informacina adicional (como por ejemplo
n de cuenta para el pago, etc).
Adjunto: Si es una factura generada por otro sistema y queremos
guardar una imagen del archivo original de la factura aqui se puede
adjuntar un fichero.

Pag 125
Bloqueo de facturas
Una factura se puede bloquear -mediante el icono del candado- de forma que
una vez bloqueada, no se puede modificar. Solo la puede modificar o borrar la
persona que bloque la factura.
Vista principal (Empresas)

Desde esta vista, podemos ver casi todos los datos relevantes, y hacer
pequeas bsquedas o filtros para ver la informacin deseada. En la siguiente
vista podemos acceder directamente a los datos de la empresa, o a sus
contactos, contratos o facturas, haciendo click en los iconos de la tabla:
Pag 126

Esta es la vista de detalle de la empresa, donde podemos actualizar los datos.

Aqu podemos ver la actividad reciente sobre esta compaia (lo ms reciente
est arriba). Podemos agregar ms actividad de forma sencilla.
Pag 127

Tambin podemos acceder a un listado de las facturas actuales. Haciendo click
en cualquiera de ellas puede ver el detalle o descargar el archivo adjunto de la
factura.

En la versin Enterprise existe control de acceso a las empresas. Tienen acceso
a ellas, los usuarios asociados a la empresa y los usuarios que pertenecen a la
empresa 'padre'. Es decir, cuando un usuario tiene acceso a una empresa,
tambin lo tiene a todas las empresas 'hijas'.
Informes y listados
Una de las partes ms importantes de una base de datos de clientes o un
sistema de gestion de relacion con el cliente (CRM) es la posibilidad de sacar
listados de datos, de forma flexible y definida por el usuario. Con Integria tiene
la posibilidad de generar listados para poder descargarlos en PDF, HTML, CSV
y tambin de programarlos automticamente con el programador de informes.
Pag 128
Para ello necesita saber lenguaje SQL o apoyarse en un motor de informes

externos tipo "Crystal Reports". La estructura de la Base de datos de integria
se encuentra en el fichero integria_db.sql en el directorio principal de
Integria.
El creador de informes est en la seccin de "Personal". Este sera un ejemplo
de creacin y ejecucin del informe que visualiza todos los contactos de una
determinada "cuenta" que agrupa contactos genricos para una newsletter.

Pag 129
Existe un programador de informes, que le permite enviar estos informes en

formato PDF via email. Para ello primero debe crearlos. Existen algunos
informes predefinidos, como el informe de incidencias, que envia un informe
similar al generado en tiempo real desde la interfaz. En el futuro este
programador podr lanzar informes de Leads y de evolucin de un proyecto
determinado.

Pag 130
Leads (Oportunidades)
A travs de la gestin de leads de Integria podemos hacer un seguimiento de
posibles clientes. generalmente estos leads entran de forma "externa"
(mediante API), aunque tambien se pueden crear manualmente desde el
editor. Al igual que otros objetos de Integria, un Lead tiene un "propietario"
que es la persona que lo gestiona.
El sistema permite ir anotando la actividad de ese lead, e ir modificando su
estado, de forma que progrese desde un lead sin "clasificar" a una venta
cerrada (o perdida). Los leads se pueden reenviar (mail forward) o gestionar
directamente por correo desde la herramienta. Si se hace desde el propio
integria, se podr gestionar el envio y la recepcin de las respuestas por email,
que quedarn reflejados en el seguimiento del lead, al llevar en CC la direccin
de Integria, para que este pueda "capturar" el correo de respuesta del lead.
Creacin de un lead a travs de un formulario web

Usando el API REST de Integria IMS es posible crear nuevos leads a partir de
un formulario de contacto de una web. De esta forma podr introducir la
informacin de sus leads de forma automtica en la herramienta. A
continuacin se explica un breve ejemplo sobre cmo crear un script para
realizar esta tarea.
El siguiente cdigo PHP crea un formulario y recoge los datos enviados por el
formulario. Con ellos compone una llamada al API de Integria IMS que crea un
nuevo lead.
<?php //Config parameters $integria_url = "http://192.168.70.163/integria"; $user =
"api_user"; //Get post parameters $name = $_POST["name"]; $email = $_POST["email"]; $company
= $_POST["company"]; $role = $_POST["role"]; $country = $_POST["country"]; $comments =
$_POST["comments"]; //Create url to call the API $myurl =
$integria_url."/include/api.php?user=".$user."&op=create_lead&params=".urlencode($name).",".ur
lencode($company).","; $myurl .=
urlencode($email).",".urlencode($country).",0,0,,,".urlencode($role).",,,".urlencode($comments
).",1,0"; // Configure curl $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $myurl);
curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE); // Send
curl request and close $ret = curl_exec($ch); curl_close ($ch);
?> <h2>Integria IMS Lead
form</h2> <form method="post"> Full name: <input type="text" name="name" size="35" > <br> <br>
E-mail: <input type="text" name="email" size="25" > <br> <br> Company: <input type="text"
name="company" size="30" > <br> <br> Position: <input type="text" name="role" size="30" > <br>
<br> Country: <input type="text" name="country" size="20" > <br> <br> Comments and questions:
<br> <textarea name="comment" cols="50" rows="8"></textarea> <br> <br> <input type="submit"
name="submit" value="Submit"> </form>
El formulario resultante tiene el siguiente aspecto.
Pag 131

A continuacin comentaremos la parte de cdigo. Las dos primeras variables
definen la url donde est alojada Integria IMS y el usuario que tiene permisos
para usar las funciones del API
//Config parameters $integria_url = "http://192.168.70.163/integria"; $user = "api_user";
Las siguientes asignaciones recogen los valores enviados por el formulario y

los asignan a variables para su posterior uso.
//Get post parameters $name = $_POST["name"]; $email = $_POST["email"]; $company =
$_POST["company"]; $role = $_POST["role"]; $country = $_POST["country"]; $comments =
$_POST["comments"];
A continuacin se crea una cadena de texto con al url que usaremos para crear
los leads mediante el API de Integria IMS. Adems de la direccin del servidor
y el usuario, se configuran los parmetros op con el valor create_lead que
indica la funcin del API a usar y params con los parmetros de la funcin.
Pag 132
//Create url to call the API $myurl =

$integria_url."/include/api.php?user=".$user."&op=create_lead&params=".urlencode($name).",".ur
lencode($company).","; $myurl .=
urlencode($email).",".urlencode($country).",0,0,,,".urlencode($role).",,,".urlencode($comments
).",1,0";
Un ejemplo de resultado de la url resultante podra ser el siguiente:

http://192.168.70.163/integria/include/api.php?user=api_user&op=create_lead&params=Dario,Artic
a+ST,Rodriguez,Spain,0,0,,,Developer,,,,1,0
Por ltimo el cdigo realiza una llamada al API de Integria IMS por medio de la
utilidad CURL de PHP.
// Configure curl $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $myurl); curl_setopt($ch,
CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE); // Send curl request and
close $ret = curl_exec($ch); curl_close ($ch);
Al enviar un formulario como por ejemplo el siguiente:
Pag 133

Se crear un nuevo lead como se puede ver en la siguiente captura:

Gestin de actividad de leads a travs de emails
Integria IMS permite gestionar la actividad comercial de los leads mediante
emails. Esta funcionalidad Enterprise, le permitir actualizar la conversacin
entre las partes y subir ficheros al lead de forma automtica.
Para ello se usa un buzn de correo electrnico como referencia del que
Integria leer los emails para extraer la informacin y los adjuntos. En la
seccin Configuracin de correo-e puede consultar todos los detalles sobre la
configuracin del buzn de correo.
Esta funcionalidad se usa por medio de la opcin Email de
respuesta disponible en los leads. Con esta opcin Integra enviar un email
aadiendo un token del tipo[Lead#35] al principio del subject del email,
Pag 134
adems al realizar el envo de emails se aadira la direccin del buzn de

referencia en el campo Cc.
De esta forma, cuando un cliente o un comercial respondan al email, una copia
llegar al buzn de referencia e Integria identificar el correo y lo procesar.
Para actualizar el lead, se aadir la informacin del cuerpo del email en al
actividad del lead y los archivos adjuntos se subirn al servidor asocindose al
lead correspondiente.

Es muy importante que tanto sus clientes como los comerciales utilicen la
funcionalidad de Responder a todos de su cliente de correo para garantizar
que una copia del email llega al buzn de referencia que est en el campo Cc

Campaas
Las campaas permiten agrupar informacin acerca de una campaa de
promocin de un producto o servicio. Usando las funcionalidades de
Newsletter y Leads podr comprobar la eficacia de la campaa.

Una campaa est definida por los siguientes parmetros:
Ttulo: ttulo de la campaa.

Fecha de inicio y Fecha de finalizacin: fechas para definir la duracin
de la campaa.
Pag 135
Gastos: costes totales asociados a la campaa. Este campo se usar para

realizar varios clculos sobre la efectividad de la campaa.
Descripcin: descripcin de la campaa.
Con los datos de las diferentes fuentes Integria IMS crear el informe de
campaa que podr ver pulsando en el botn de Estadsticas de la parte
superior, de la vista de campaa.

Este informe tiene datos sobre el estado de las ventas asociadas a la campaa,
as como el retorno de inversin de la propia campaa. Tambin podr ver
estadsticas sobre la efectividad de la newsletter y el ratio de conversin de
leads.
Para poder desarrollar una campaa es necesario dos cosas: poder crear los
leads desde una fuente que incluya el identificador de la campaa (por
medio de un formulario a medida de insercion de leads) y por medio de una
newsletter asociada a esa campaa, de forma que automticamente se vaya
incrementando el numero de "newsletter" recibidas. Para esto es precio que
Integria sea accesible desde internet, ya que el formulario personalizado de
creacion de leads ataca contra la API de Integria, y la newsletter enviada a
Pag 136
cada cliente incorpora un pixel transparente que sirve para saber si esa
persona ha abierto el email.
Ejemplo de creacin de una campaa

El primer paso es crear una campaa con la duracin y los costes
correspondientes, como se puede ver en la seccin anterior.
Una vez definida la campaa podr asociar los Leads pertinentes y las
ediciones de Newsletter que desee a la campaa. Para asociarlos tendr que ir
a cada unos de los Leads y ediciones de Newsletter y seleccionar la campaa
escogida en el campo Campaa.

Pag 137

Podr asociar la campaa a tantos leads y ediciones de newsletter como desee.
Desde el momento en el que se aadan los diferentes leads y ediciones, se
podr visualizar el resultado de la campaa por medio del informe que se ir
actualizando de forma automtica segn varien los datos de leads y de
ediciones de newsletter asociados.
Pag 138
8.
Inventario
Inventario
El men Inventario proporciona todos los elementos necesarios para aadir

todo el conjunto de objetos de los que dispone la empresa, su ubicacin, su
fabricante, sus contratos de soporte, las personas y telfonos de contacto, etc.
Los objetos de inventario son una pieza clave del sistema de ticketing
(incidencias) ya que permiten asociar una incidencia a un activo relativo al
negocio.
El Inventario permite crear tipos objetos de inventario con campos
personalizados. De este modo, el sistema se adapta a todas las necesidades y
permite realizar bsquedas con gran nivel de detalle.
Creacin de un tipo de objeto de inventario

Los tipos de objeto de inventario sirven para personalizar los diferentes
elementos que se van a utilizar en inventario. Puede gestionar los tipos de
objetos pulsando en la opcin Tipos de objetos.
Explicaremos el funcionamiento de los tipos de objetos con un ejemplo, vamos
a crear un tipo de objeto de inventario llamado Software que tendr los
campos asociadosVersion y Description.

Pag 139
Inventario
Un tipo de objeto de inventario tiene asociado un nombre, un icono, el valor

mnimo que debe tener en stock y una descripcin. Adems podremos definir
si este tipo aparecer o no como raz en la vista de rbol del inventario. Por
cada tipo, se pueden aadir campos personalizados.

Estos campos pueden tener valor nico que sirva como identificador y se
pueden marcar para ser heredados por otros objetos. Otra caracterstica es
que se pueden marcar para ser mostrados en la bsqueda. De esta forma, la
visualizacin de inventario en la bsqueda tambin es flexible.
Los campos personalizados pueden ser de tipo numrico, texto, combo o bien
externo.

Los campos de tipo externo hacen referencia a una tabla externa en la base de
datos. Cuando se crean, se debe detallar el nombre de la tabla y el campo
identificador de la misma.
Pag 140
Inventario
A la hora de seleccionar el valor de estos campos aparecer una ventana modal

mostrando toda la informacin de la tabla externa.

Pag 141
Inventario
Para aadir una tabla externa y usarla posteriormente en los objetos de

inventario slo tiene que aadir la tabla que desee con los datos
correspondientes dentro de la base de datos de Integria. El mantenimiento de
esta tabla se realiza de forma manual, por lo que tendr que operar con ella por
medio de sentencias SQL
Creacin de un objeto de inventario

Para crear un nuevo objeto de inventario slo tiene que pulsar en la
opcin Crear objeto de inventario del men de la izquierda. Entonces ver el
siguiente formulario con todas las opciones disponibles para configurar el
objeto de inventario.

Los campos ms importantes en este formulario son: Propietario, Compaas

asociadas, Usuarios asociados y Pblico. Estos campos definen quin ve el
Pag 142
Inventario
objeto. De esta forma el objeto estar accesible por el propietario, los usuarios
asociados directamente al objeto o los usuarios pertenecientes a una
compaa asociada, adems si se marca el flan Pblico todo el mundo podr
ver el objeto.
Un objeto de inventario puede tener una "jerarqua" de objetos (un objeto
puede ser hijo de otro). Esto se define al escoger un "padre". Adems de este
parentesco padre/hijo, se pueden establecer relaciones entre objetos.
El inventario de Integria IMS posee un sencillo sistema de control de stocks.
Para gestionar el stock, todos os objetos de inventario tienen un campo
"estado" que permite llevar un sistema de stock. Los estados posibles son:
Nuevo, En uso, No usado o Dado de baja. Tambin puede registrar la fecha de
recepcin y baja.
Veamos un objeto de inventario de ejemplo;
La solapa de relaciones, muestra los dems objetos relacionados con ste. Se
pueden asociar nuevos objetos, tan slo hay que escogerlo del combo y
vincularlo como se muestra a continuacin. De esta forma, se pueden
relacionar otros objetos adems del objeto padre.

La solapa de contactos, nos muestra las personas asociadas a ese objeto de

inventario. Podemos hacer click en cualquiera de ellos para acceder a su
informacin directamente.

Pag 143
Inventario

La solapa de incidencias asociadas al objeto de inventario indica qu
incidencias ha sufrido este objeto, y en qu estado se encuentran. Podemos
hacer click en cualquiera de ellas para acceder a su informacin directamente.

La solapa tracking muestra los cambios que se producen en el objeto de
inventario como el cambio de propietario, si se asocia un tipo de objeto, un
objeto padre...
Bsquedas de inventario
El resultado de la bsqueda de inventario puede visualizarse en dos modos:
rbol o listado.
Pag 144
Inventario
En la vista de rbol se muestran los objetos de inventario agrupados por tipo.

Tambin se visualiza el stock, mostrndose: Unidades totales:Nuevas:Sin
usar:Stock mnimo. Si el nmero de unidades totales es inferior al stock
mnimo, se marcar en rojo.
En la vista en modo listado se muestra informacin sobre el inventario, as

como sus campos personalizados que hayan sido marcados para mostrar.

Pag 145
Inventario

Los campos por los que se pueden realizar bsquedas son:
Campo de texto libre, que hace referencia al nombre o descripcin del

inventario. Esto es as si no se seleccionan campos personalizados. En
este caso, la bsqueda se acota al valor de stos campos.
Tipo de objeto
Campos personalizados del tipo de objeto
Propietario
Fabricante

Pag 146
Inventario

Adems puede exportar los resultados de las bsquedas en PDF y CSV para
obtener listados que aadir a cualquier tipo de informe.
Importar datos de inventario desde CSV

Existe la opcin de importar datos de inventario desde un fichero CSV. Para
ello, se carga el fichero con una lnea por inventario y los valores separados
por comas. El orden debe ser el siguiente:
Tipo de objeto, Propietario, Nombre, Pblico, Descripcin, Contrato,
Fabricante, Padre
Sincronizacin de inventario con Pandora FMS

Integria permite crear objetos de inventario sincronizando la informacin de
los agentes existentes en una instancia de Pandora FMS que se encuentre en su
sistema.
Para comenzar es necesario configurar los parmetros que conectan Integria
IMS con Pandora FMS. La configuracin se encuentra en el men Setup ->
Pandora FMS Inventory.
Pag 147
Inventario

En el formulario deber configurar los parmetros obligatorios:
Pandora FMS URL: url donde est accesible la consola de Pandora FMS
Pandora FMS API password: contrasea del API de Pandora FMS. Este
parmetro se configura en la consola de Pandora FMS.
Pandora FMS User: usuario con el que acceder a la informacin de
Pandora FMS.
Pandora FMS User password: contrasea del usuario de Pandora FMS.
Default Contract: contrato por defecto asociado al objeto.
La sincronizacin del inventario se realiza mediante el script de

mantenimiento una vez al da. Puede ver cmo instalar este script en la
seccin Instalacin del script de mantenimiento.
En nuestra instancia de Pandora FMS tenemos los siguientes agentes
instalados y queremos sincronizarlos en el inventario de Integria.

Pag 148
Inventario

Una vez configurado Integria sincronizar los agentes y el inventario, desde
ese momento dispondremos de los agentes en el tipo de objeto de inventario
'Pandora agents'.

Esta sincronizacin crear los objetos de inventario con la informacin de los
agentes monitorizados en el servidor de Pandora FMS.
Estos campos son fijos y no es posible ampliarlos. Si necesita personalizar la
extraccin de informacin de un dispositivo o PC puede usar el Inventario
automtico con los agentes de Pandora FMS
Inventario remoto basado en agentes de Pandora FMS

Esta funcionalidad Enterprise permite extraer informacin de inventario
personalizada de cualquier dispositivo y sistema operativo.
El inventario remoto se basa en el uso de los agentes software de Pandora FMS
que son instalados en las mquinas de las que se desea extraer la informacin.
Los agentes recolectan informacin de inventario mediante scripts y la envan
al servidor donde se est ejecutando Integria IMS. Una vez recibida la
Pag 149
Inventario
informacin Integria la procesar y crear los objetos de inventario

pertinentes en base a los datos recibidos.

A diferencia de la Sincronizacin de inventario con Pandora FMS, para usar

el Inventario remoto basado en agentes de Pandora FMSno es necesario instalar

la aplicacin Pandora FMS, slo es necesario instalar los agentes en las
mquinas que se desee
Funcionamiento interno del inventario remoto

Los agentes de Pandora FMS envan un fichero XML con la informacin de
inventario al servidor que soporta Integria IMS. Integria procesa estos
archivos mediante el script de mantenimiento, el procesado de archivos se
realiza cada 5 minutos.

Con la informacin de inventario enviada en el XML se crearn varios objetos
Pag 150
Inventario
de inventario. De tal forma que si un agente enva informacin sobre 12

aplicaciones instaladas en el sistema, se crearn 13 objetos de inventario (uno
para el agente y 12 para las diferentes aplicaciones instaladas).
Cuando se recibe informacin sobre un dispositivo o elemento de inventario,
pueden suceder dos cosas:
1. Que el elemento exista: entonces se actualizar la informacin de
inventario.
2. Que el elemento no exista: en este caso, se crear un nuevo objeto de
inventario slo si el tipo de objeto asociado est definido en Integria.
Es importante definir los tipos de objeto que usarn antes de comenzar a
realizar el inventario, a continuacin se explica cmo funciona la adquisicin de
datos en detalle y podr ver cmo se asocian los tipos a los diferentes elementos.

Los agentes de Pandora estn asociados al tipo llamado Pandora agents, por lo
que para que el inventario funcione es necesario que est definido. Los dems
objectos de inventario se asocian a sus tipos como se explica a continuacin.

El siguiente XML con la informacin de inventario podra ser enviado por un
agente de Pandora FMS.
<?xml version='1.0' encoding='UTF-8'?> <agent_data description='' group='' os_name='linux'
os_version='"CentOS release 6.4 (Final)"' interval='300' version='4.1(Build 130822)'
timestamp='2013/10/22 09:27:38' agent_name='localhost.localdomain' timezone_offset='0'
address='192.168.70.163'> <inventory>
<inventory_module>
<name><![CDATA[Users]]></name>
<datalist>
<data><![CDATA[root]]></data>
</datalist>
</inventory_module>
<inventory_module>
<name><![CDATA[Process]]></name>
<datalist>
<data><![CDATA[COMMAND]]></data>
<data><![CDATA[/sbin/init]]></data>
<data><![CDATA[[kthreadd]]]></data>
<data><![CDATA[[migration/0]]]></data>
<data><![CDATA[[ksoftirqd/0]]]></data>
<data><![CDATA[[scsi_eh_6]]]></data>
<data><![CDATA[sh -c ps -eo command | tr -d "" ]]></data>
<data><![CDATA[ps -eo
command]]></data>
<data><![CDATA[tr -d ]]></data>
</datalist>
</inventory_module>
<inventory_module>
<name><![CDATA[Software]]></name>
<datalist>
<data><![CDATA[acl;2.2.49;Access control list utilities]]></data>
<data><![CDATA[acpid;1.0.10;ACPI Event Daemon]]></data>
<data><![CDATA[alsalib;1.0.22;The Advanced Linux Sound Architecture (ALSA) library]]></data>
<data><![CDATA[alsa-plugins-pulseaudio;1.0.21;Alsa to PulseAudio backend]]></data>
<data><![CDATA[zenity;2.28.0;Display dialog boxes from shell scripts]]></data>
<data><![CDATA[zip;3.0;A file compression and packaging utility compatible with
PKZIP]]></data>
<data><![CDATA[zlib;1.2.3;The zlib compression and decompression
library]]></data>
</datalist>
</inventory_module>
<inventory_module>
<name><![CDATA[File system]]></name>
<datalist>
<data><![CDATA[tmpfs;0;244M;/dev/shm]]></data>
Pag 151
<data><![CDATA[/dev/sda1;34M;426M;/boot]]></data>
</inventory> </agent_data>
</datalist>
Inventario
</inventory_module>
Integria crear un tem para el agente que report el XML y a continuacin

procesar los diferentes mdulos de inventario por separado, por ejemplo:
<inventory_module>
<name><![CDATA[Software]]></name>
<datalist>
<data><![CDATA[alsalib;1.0.22;The Advanced Linux Sound Architecture (ALSA) library]]></data>
<data><![CDATA[alsa-plugins-pulseaudio;1.0.21;Alsa to PulseAudio backend]]></data>
<data><![CDATA[zenity;2.28.0;Display dialog boxes from shell scripts]]></data>
<data><![CDATA[zip;3.0;A file compression and packaging utility compatible with
PKZIP]]></data>
<data><![CDATA[zlib;1.2.3;The zlib compression and decompression
library]]></data>
</datalist>
</inventory_module>
Se escoger el nombre del mdulo de inventario definido en el XML, en este

caso Software, para identificar el tipo de objeto asociado a estos elementos.
Despus, se crearn tems de inventario con dicho tipo para cada uno de los
elementos reportados en el XML:
<datalist>
<data><![CDATA[alsa-lib;1.0.22;The
Advanced Linux Sound Architecture (ALSA) library]]></data>
<data><![CDATA[alsa-pluginspulseaudio;1.0.21;Alsa to PulseAudio backend]]></data>
<data><![CDATA[zenity;2.28.0;Display
dialog boxes from shell scripts]]></data>
<data><![CDATA[zip;3.0;A file compression and
packaging utility compatible with PKZIP]]></data>
<data><![CDATA[zlib;1.2.3;The zlib
compression and decompression library]]></data> </datalist>
Los elementos de inventario separan la informacin por el carcter ;. La

informacin quedara desglosada como se puede ver a continuacin:
acl
2.2.49
Access control list utilities
El primer componente define el nombre del nuevo tem de inventario, el resto

componentes se asocian a los campos del tipo de objeto en el mismo orden en
el que aparecen en la definicin del objeto de inventario. En este caso el
segundo elemento se asocia a Version y el tercero a Description.
Pag 152
Inventario

Adems todos los tems correspondientes a los elementos tendrn como padre
al agente que los report a travs del XML. El resultado final del objeto de
inventario creado para ese elemento del XML quedara como en la siguiente
imagen:

En el inventario, junto con los objetos creados a partir de los diferentes
mdulos de inventario del XML, aparecer un objeto para el agente en este
caso llamadolocalhost.localdomain.

Pag 153
Inventario

Por defecto, Integria 4.0 trae definidos los principales modulos de inventario
para agentes Windows: Software, Parches, HD, Video, CPU, Servicios y RAM. A
continuacin se puede ver un ejemplo de como se visualizara.

Pag 154
Inventario
Instalacin de tentacle_server
La funcionalidad de inventario remoto de Integria requiere de la instalacin de
la aplicacin tentacle_server. A continuacin se explica cmo instalarlo en los
diferentes sistemas.
Unix/Linux
Para instalar el servidor tentacle_server en sistemas Unix/Linux deber
acceder a la carpeta extras en el directorio de Integria y ejecutar el siguiente
comando con privilegios de root:
./inventory_installer
Posteriormente podr arrancar y parar el servicio con los siguientes

comandos:
Pag 155
Inventario
/etc/init.d/tentacle_serverd start /etc/init.d/tentacle_serverd stop
Windows
En sistemas Windows deber ejecutar a mano el servidor tentacle_server en
una shell ejecutando el siguiente comando:
C:\wamp\www\integria\extras\tentacle_server.exe -a 0.0.0.0 -p 41121 -s
"C:\wamp\www\integria\attachment\inventory"
Esta shell deber estar siempre abierta con el comando en ejecucin.
Configuracin del inventario remoto

La configuracin del inventario automtico se encuentra en el men Setup en
la pestaa Pandora FMS Inventory. Detro de esta seccin ver un apartado
llamado Remote Inventory.
Los campos configurables son:
Default owner: dueo por defecto del nuevo objeto de inventario.

Associated comapany: compaas por defecto para el nuevo objeto de
inventario.
Associated user: usuarios por defecto para el nuevo objeto de
inventario.
El campo Default owner es obligatorio, si no se configura no se crearn los
objetos de inventario. Los dems campos sirven para propsitos de
configuracin de ACLs de acceso y visualizacin de los objetos

Adems de la configuracin de los campos mencionados es necesario habilitar

el script de mantenimiento. Puede ver cmo instalar este script en la
seccin Instalacin del script de mantenimiento.
Si no habilita el scipt de mantenimiento no se procesarn los archivos enviados

por los agentes de Pandora FMS

Pag 156
Inventario
El envo de archivos de hace mediante una conexin TCP al puerto 41121. Por
ello para el correcto funcionamiento de esta funcionalidad puede que tenga
que revisar las reglas de routing o firewalls de su red

Configuracin de los agentes de Pandora FMS

Para extraer la informacin de los dispositivos deber instalar los agentes de
Pandora FMS. Puede ver la compatibilidad del agente de Pandora FMS con sus
sistemas en la seccin Requisitos agente software del manual de Pandora FMS.
Hay versiones del agentes software de Pandora FMS disponibles para
mltiples plataformas y cada una tiene su proceso de instalacin, toda la
informacin sobre los procesos de instalacin est disponible en la
seccin Instalacin agentes Pandora FMS del manual de Pandora FMS.
Los parmetros adicionales a configurar en el agente son los siguientes:
server_ip: IP del servidor que ejecuta Integria IMS.

module_plugin: directiva para ejecutar scripts para extraer la
informacin de inventario.
Toda la informacin sobre la configuracin del agente software est en la

seccin Agentes software de Pandora FMS dentro del manual de Pandora FMS.
Por defecto los agentes de Pandora FMS disponen de un mdulo plugin para
extraer informacin de inventario, puede ejecutarlo con la siguiente directiva:
module_plugin inventory 1 cpu ram video nic hd cdrom software init_services filesystem users
process ip route
Personalizacin del inventario

Si desea personalizar la informacin recogida puede modificar este script o
crear uno propio. En la seccin Creacin de mdulos de inventario locales del
manual de Pandora FMS podr ver la estructura XML de los mdulos de
inventario y ejemplos de cmo crear mdulos de inventario para plataformas
Linux y Windows.
Pag 157
Base de conocimiento
9.
Introduccin
Integria IMS posee un sistema de gestin de Base de conocimiento (BC por sus
siglas en espaol) o Kb (por su acrnimo en ingls de Knowledge base), que
permite mantener una base formada por diferentes artculos, los cuales se
organizan dependiendo del tipo de producto, categora o lengua en el que se
redactan.
Constituye un elemento centralizado de consulta y edicin de artculos, el cual
puede ser alimentado por los usuarios, tanto de forma manual, como a travs
del sistema de incidencias.
Gestin de la base de conocimiento

Dentro de la seccin de Base de Conocimiento (KB en ingls) podremos
visualizar los diferentes artculos que contiene, crear nuevos artculos y
gestionar las diferentes categoras y productos a los que pueden pertenecer
cada uno de ellos, as como el acceso a estos artculos por parte de diferentes
grupos de usuarios.
En la pantalla principal (por defecto el men lateral de Examinar) podemos
encontrar la vista con los diferentes artculos que constituyen la BC. Esta vista
permite filtrar todos los artculos dependiendo de la categora o producto de
cada elemento, as como de la lengua en el que haya sido redactado. Tambin
es posible acotar las bsquedas mediante un campo de texto de bsqueda
libre.

Pag 158

Como se puede observar en la anterior captura, para cada artculo
perteneciente a la base de conocimiento, se detalla la categora y el producto al
que pertenece, as como la lengua y un timestamp con el tiempo desde la
ltima modificacin. Desde esta misma vista, tenemos la posibilidad de
eliminar un artculo haciendo click en el aspa roja.
Gestionar Categoras
Para crear o visualizar las diferentes categoras que tenemos disponibles en
nuestra base de conocimiento, debemos pinchar en el men lateral, en la parte
de Gestionar categoras.
Desde esta seccin, podemos ver la lista de categoras que tenemos creadas.
Cada una de ellas tendr un icono asignado, un nombre y, opcionalmente, un
padre, que ser la categora de la que cuelga. Dentro de esta misma vista,
tenemos la columna de Elementos, que muestra el nmero de artculos que
tienen asignada esa categora. Podemos eliminar una categora pinchando
sobre el aspa roja de la categora que deseamos eliminar de la BC.

Pag 159
Gestionar Productos
Los diferentes elementos de una BC tambin pueden hacer referencia a un
determinado producto, por lo que, al igual que en las categoras, tenemos la
posibilidad de gestionar y visualizar diferentes productos, para
posteriormente asignarlos a los artculos de nuestra BC.
Para acceder a esta seccin, debemos pinchar en Gestionar productos, en el
men lateral dentro de la seccin BC. Una vez dentro, se pueden visualizar
todos los productos que hay creados. Al igual que en con las categoras, la vista
de los productos muestra el nombre y el icono del producto, el padre del que
cuelga dicho producto (opcional), una descripcin y el nmero de
elementos/artculos que lo tienen asignado. Pulsando el aspa roja podemos
eliminar los diferentes productos existentes.

Pag 160
Crear un nuevo artculo de la BC

Una vez que ya hemos creado las categoras y los productos, ya podemos
empezar a crear los artculos que formarn nuestra base de conocimiento de
Integria IMS.
Para crear un nuevo elemento de la BC, debemos pinchar en el men lateral, en
la seccin Crear elemento de la BC. Esto abrir una nueva pantalla donde
tendremos que rellenar el Ttulo del nuevo artculo, el Lenguaje en el que
ser escrito, el Producto y la Categora a la que pertenecer y que hemos
creado con anterioridad, y un campo Datos donde escribiremos el texto de
nuestro nuevo elemento.

A continuacin pulsamos sobre el botn Crear para guardar el nuevo artculo,
lo que nos llevar a la vista general de elementos, donde ya se encontrar el
nuevo artculo recin creado.

Para poder visualizar un elemento en concreto, se ha de pinchar sobre el
nombre del artculo, y una vez dentro, podemos ver el Autor del artculo, la
Pag 161
fecha de la ltima modificacin, el producto y la categora que tiene asignado,

as como el lenguaje en el que se ha escrito.
A su vez, la BC permite adjuntar archivos a los elementos o artculos que la
forman. Para ello, es necesario primero crear el artculo, y una vez creado,
editarlo para poder aadir los diferentes archivos adjuntos. Para poder aadir
uno o varios ficheros a un artculo, debemos pinchar sobre el nombre del
artculo, y una vez dentro de ste, hacer click sobre el icono de edicin, tal
como se muestra en la siguiente captura:

Dentro de la edicin del artculo, podremos ir aadiendo los diferentes
archivos mediante el campo Adjuntar. Los diferentes archivos adjuntados al
elemento aparecern en una lista dentro de la edicin, pudiendo eliminarlos
pulsando sobre el aspa del archivo que se desea borrar.
Crear un nuevo artculo desde un Incidente

Es posible crear una entrada nueva en la BC a partir de la resolucin de un
incidente. De esta forma, la gestin de incidencias y la base de conocimiento se
relacionan entre s para permitir una mayor flexibilidad a la hora de crear
artculos nuevos basados en las resoluciones de incidentes.
Cuando una incidencia pasa al estado resuelto, se muestra un icono de estrella
amarilla. Si pinchamos sobre ste, Integria nos redirige automticamente a la
seccin BCcon la vista de creacin de un nuevo artculo. Los distintos campos
se rellenan automticamente cogiendo los datos de la incidencia.
Permisos en la KB
Pag 162
Es una caracterstica Enterprise, que nos permite definir que grupos ven qu
productos. Esta relacin, al igual que ocurre por ejemplo, con la seccin de
distribucin de ficheros, hay que hacerla manualmente. Accedemos a la
gestin de permisos a travs de la ltima opcin del menu de la base de
conocimiento (KB en ingls):

En ella, escogeremos un tipo de producto y un grupo para dar acceso a los
usuarios de ese grupo a los artculos de ese producto (en cualquier categora).

Pag 163
10.
Sistema de distribucin de ficheros
Introduccin
Integria IMS dispone de un entorno centralizado de descargas, que permite la
distribucin de archivos y releases de software a los clientes y usuarios de
Integria. Todos los elementos de la File Releases deben pertenecer a una
categora, y las categoras a su vez estn relacionadas con un grupo, lo que
permite un control de acceso de los diferentes usuarios a los elementos.
Dispone de un sistema "annimo" que permite poder compartir un fichero a
un usuario cualquiera, sin que tenga que tener una cuenta en integria,
simplemente, compartiendo la URL de acceso a ese fichero.
Vista general
Accedemos al sistema de distribucin de ficheros desde el men superior de
Integria, pinchando en el men File Releases

Desde esta seccin, podemos crear las diferentes categoras a las que
pertenecern los archivos y gestionar el acceso de los usuarios y clientes,
relacionando una categora con uno o varios grupos.
En el men lateral Examinar se presenta una lista de los ficheros que
comforman nuestra File Releases, como puede verse en esta captura.

Pag 164

En esta vista, se indica el tamao del fichero de cada uno de los elementos, la
categora a la que pertenece, el nmero de descargas sobre este archivo y el
tiempo desde su subida.
Tambin podemos filtrar las file releases gracias a la bsqueda que se incluye
en la parte superior de la vista Examinar. El filtrado podemos hacerlo tanto
por categoras a las que pertenecen como por nombre de file release.
Creacin de una categora

Todos los elementos que componen una file releases tienen que pertenecer a
una categora. lo que significa que antes tendremos que tenerlas creadas. Para
ello, pinchamos en File Releases -> Gestionar categoras y accedemos a la vista
de las diferentes categoras que tenemos configuradas. Desde esta misma
seccin podemos crear nuevas categoras pinchando sobre el botn Crear.
Pag 165

En la nueva pantalla, pondremos un Nombre a la nueva categora y le
asignaremos un icono. Pulsamos en Crear para guardar los cambios.

De esta forma, vamos aadiendo todas las categoras a las que pertenecern
cada una de los file release de nuestro sistema.
Gestin de acceso
El objetivo de esta seccin es relacionar las categoras que hemos creado
dentro de File Releases, con los diferentes grupos configurados en el sistema
de Integria.
De esta forma conseguimos un sistema de control de acceso a los file releases,
ya que un elemento que pertenece a una categora, tiene asignado un conjunto
de grupos (uno o ms) que definen los usuarios que pueden o no tener acceso
dicho elemento.
Para asignar uno o varios grupos a una categora, pinchamos sobre el
botn File Releases -> Gestionar acceso y pinchamos en el botn Crear. En la
nueva pantalla, elegimos una categora y un grupo para crear la relacin.
Pag 166
Si queremos asignar ms de un grupo a una categora, creamos una nueva

entrada, escogiendo esa misma categora, y asignndole un grupo diferente.
Con esto, crearemos una nueva file release que tendr una categora asignada,
y al tener esta categora a su vez asignado uno o varios grupos, nicamente los
usuarios que pertenezcan a ese grupo o grupos podrn tener acceso a la file
release.
Creacin de una file release

Para crear una nueva file release, pinchamos en File Releases -> Create file
release, lo que nos mostrar una pantalla de edicin donde daremos de alta el
nuevo archivo en el sistema. Los campos a rellenar sern el Nombre de la file
release. la Categora a la que pertenecer (anteriormente habremos asignado
uno o varios grupos a dicha categora), una Descripcin y un desplegable
donde escogeremos el fichero que deseamos aadir.
Por defecto, los archivos deben estar en la carpeta /attachment/downloads de
nuestro directorio raz de Integria. Estos ficheros podemos subirlos mediante
una conexin FTP o usando el gestor de archivos que Integria posee[1]
Dentro de la propia seccin de File Releases tenemos un control para subir
ficheros desde aqu. Es importante tener en cuenta las limitaciones de tamao
de los archivos que se suben al sistema, ya que esto no ser aplicable para
archivos de tamao mayor a las que estn definidas dentro del fichero PHP.ini,
en la variable max. upload size.

Pag 167

El ID Externo se usa, en combinacin con la opcion "Publico" para poder crear
un enlace publico, que cualquiera pueda pinchar, sin tener siquiera acceso a la
herramienta. Es una forma de poder compartir (opcionalmente) ficheros con
todo el mundo, gestionados desde Integria.
Para borrar o editar una file release de la lista, pinchamos en Examinar, y en la
vista de elementos, pinchamos sobre el icono de herramienta si lo que se
desea es editar o sobre el aspa roja si queremos borrarla de la lista (el fichero
no se borra del sistema de archivos).

Pag 168
11.
Newsletter
Newsletter
Existe un sistema de distribucin de boletines, o de emisin de envo masivo de

correos. Esta opcin necesita primero ser habilitada en el setup, en la pantalla
principal, en la opcin "habilitar newsletter".
Una vez activado, podemos ver esta opcin disponible en la seccin de clientes,
para cualquier usuario con bits de acceso VM (Gestin de inventario).
Ediciones
Las newsletter permiten, poder enviar correos masivos a un conjunto de
direcciones de email. Estas direcciones de email se definen para cada newsletter.
Cada newsletter puede tener una o varias "ediciones", de forma que cada edicin
contiene un ttulo de mensaje (subject), as como un contenido en texto claro
(Ascii) y uno en texto formateado (HTML). Al editar / crear una nueva edicin se
permite adems especificar la fecha (sino se detectar automticamente). La
"edicin" "hereda" las direcciones asignadas a la newsletter de forma que
diferentes ediciones de una newsletter utilizarn siempre el mismo conjunto de
direcciones de correo.

Editor de ediciones de newsletter
Pag 169
Newsletter

NOTA: Si va a utilizar elementos grficos en la newsletter, suba primero los
recursos (imgenes, javascript, etc) a un servidor (p.e: el propio servidor de
integria, usando el filemanager) y luego enlcelos desde el editor HTML.
Direcciones
Aadir direcciones a una newsletter es sencillo. Basta meter una direccin (y un
nombre opcional, separado por una coma), o meter varias, separadas por saltos
de linea, tal como se ve en el ejemplo:

Editor de ediciones de newsletter
Pag 170
Newsletter

Las direcciones invlidas (se comprueba slo su sintaxis) se ignorarn. Si mete
alguna direccin que ya exista, no se volver a meter. Si intenta meter una
direccin que estaba desactivada, esta seguir desactivada.
Cola de envo
Una vez que ya ha definido una newsletter, ha creado al menos una edicin para
esa newsletter y ha introducido direcciones para el envo llega el momento de
enviar esa newsletter por correo.
Existe un parmetro en el setup muy importante que regula el comportamiento
de la cola de envos, de cuantos emails enva cada vez que se ejecuta la tarea
programada de Integria, que debera tener instalada en el cron de su sistema:

Nmero mximo de envios por ejecucin de crontask
Revsela, y tenga en cuenta cada cuanto se ejecuta su tarea (por defecto cada 5
minutos), de forma que si su servidor de correos tiene un lmite de envio de 200
mails por hora, tendr que calcular aproximadamente cuantos e-mails tiene que
enviar como mximo en cada ejecucin, en este caso:
200 mails por hora / 20 = 10
Pag 171
Newsletter
Es decir, para evitar no superar el lmite, tendr que configurar 10 en el n

maximo de envios por ejecucin, ya que al ejecutarse cada 5 minutos, se ejecutar
20 veces en una hora, enviando 10 mails cada 5 minutos, 200 mails en una hora.
Una vez que tenga claro esto, vaya a la cola de envo. Escoja una edicin y cree la
cola. Automticamente se crear una cola con todos los mensajes para cada
direccin de la cola, pero la cola estar en estado de espera, no se lanzar todava.
Pulse el botn de crear y visualizar algo parecido a esto :

Cola lista para ejecucin

Solo tiene que pulsar ahora el botn de empezar (la flecha verde) para que
cuando el proceso en segundo plano (crontask) se ejecute empiece a enviar
correos.
Existen 4 nmeros en la columna de "direcciones". El primero es el total de envios
encolados, el 2 es el numero de emails pendientes de enviar, el 3 el nmero de
mails enviados, y el 4 el numero de emails que no se pudieron enviar.
Una vez lanzada, deber esperar a que se envie todo el correo. Puede desconectar
de Integria, el proceso seguir en segundo plano, y en funcin de cmo haya
configurado la cola de envo, puede tardar horas o incluso dias. Conctese de vez
en cuando a ver como va.
Si cuando haya terminado, tiene muchas direcciones con error, puede probar a
"Reintentar" el envio (las flechas circulares verdes) y el sistema volver a intentar
enviar los correos que no pudo.
Visualizacin WEB de la newsletter
Pag 172
Newsletter
Puede enlazar en sus emails, una direccin web para visualizar el contenido de la
newsletter en HTML. Para ello necesita la ruta URL pblica de su integria, p.e:
http://artica.es/integria
Aadindole lo siguiente:
/include/newsletter.php?operation=read&id=X
Esto permite visualizar la newsletter con identificador "2". El identificador es la

segunda columna (Issue #) en la vista de ediciones de newsletter.
De forma que el siguiente enlace visualizara la edicin de la newsletter con el
identificador n "2"
http://artica.es/integria/include/newsletter.php?operation=read&id=2
As vera un usuario externo la newsletter en su navegador:

Pag 173
Newsletter

Esto permitir adems incrementar en uno el contador de visitas de esa
newsletter. Este conteo se puede ver en la lista de ediciones de newsletters.
Formulario de subscripcin de la newsletter

Similar a lo anterior, se utiliza una URL especialmente formada, junto con el
identificador numrico de la newsletter. Esto se puede localizar en el listado de
newsletter, tal como se ve en la imagen:

Pag 174
Newsletter

La url para el formulario de subscripcion es :
< Integria base url >/include/newsletter.php?operation=subscribe&id=X
Donde X es el identificador de la newsletter. Este formulario tiene un aspecto

similar al siguiente:

Nota: Existe un mecanismo de seguridad para prevenir inserciones masivas.
Todas las inserciones de emails se validan primero, evitando emails erroneos e
emails duplicados.
Al suscribir correctamente a un usuario, se le envia un email, informandole que
ha sido suscrito, y la URL para desuscribirse de dicha newsletter.
Pag 175
Newsletter
Formulario de de-subscription de la newsletter

Muy similar al anterior. La url para el formulario de subscripcion es :
< Integria base url >/include/newsletter.php?operation=unsubscribe&id=X
Donde X es el identificador de la newsletter. Este formulario tiene un aspecto

similar al siguiente:

Pag 176
12.
Wiki
Wiki
El wiki integrado dentro de Integria est realizado usando el cdigo de un

proyecto OpenSource llamado LionWiki [1]. Este Wiki, es reducido en
funcionalidades a otros wikis como MediaWiki (el usado en la Wikipedia),
pero totalmente funcional, y es perfecto para su uso con Integria.
El wiki tiene el mismo sistema de privilegios de acceso que el resto de la
aplicacin, es decir, puede restringir que usuarios pueden acceder y que
usuarios no. Eso si, dentro del wiki, todos los usuarios vern lo mismo, en esta
versin, no se puede restringir que categoras de pginas pueden ver segn
que grupos de Integria.
Como otros wikis, soporta:
Sintaxis Wiki para jerarquas de ttulos, hiperenlaces, listas, imgenes.

Gestin de cambios.
Subir ficheros y enlazarlos desde el wiki.
Generar tablas de contenidos y vistas jerrquicas de informacion (titulo,
subtitulo, etc)
Preformateado, negrita, cursiva.
La sintaxis de este Wiki es ligeramente diferente a la de MediaWiki (el ms

conocido).
Sintaxis bsica
Este es un resumen breve de su sintaxis.
Cabeceras
Example:
!Heading H2 !!Heading H3 !!!Heading H4
Cuantos ms signos de exclamacin que utilice, menor ser el ttulo ser (hasta
5 puntos de exclamacin). Los signos de exclamacin tiene que ser
exactamente al comienzo de la lnea.
Listas y listas no ordenadas
Pag 177
Wiki
Ejemplo de lista sin ordenar/numerar:

* Fruit ** Apple *** Granny smith ** Orange * Vegetables ** Garlic ** Onion
Se ver como
Fruit
Apple
Granny smith
Orange
Vegetables
Garlic
Onion
Ejemplo de lista numerada

# First item
## First subitem
### First subsubitem ## Second subitem
Se ver como:
1. First item
1. First subitem
1. First subsubitem
2. Second subitem
' Estilos de letra '
Negrita Negrita (tres comillas simples)
Cursiva Cursiva (dos comillas simples)
'Tachado' Tachado, con comilla y ralla baja.
'__Subrayado__' Con comilla y dos rallas bajas.
Enlaces, imgenes, ficheros

Basta con escribir el enlace as:
[Main page] Main page
Pag 178
Wiki
o
[Main project page|Main page] Main project page
o
[Features header on Main page|Main page#Features] Features header on Main page
Los emails y las pginas web se reconocen automticamente

http://lionwiki.0o.cz http://lionwiki.0o.cz
lionwiki@example.com lionwiki@example.com
Puede utilizar tambin los enlaces relativos, pero tiene que comenzar con. /
(De lo contrario se interpretar como pgina de Wiki). As que si usted desea
vincular alguna pgina HTML en el mismo directorio, se utiliza:

[Interesting page|./SomeWebPage.html] Interesting page
Imagenes
Para usar la imagen como enlace:
[http://lionwiki.0o.cz/lion.jpg|link=http://lionwiki.0o.cz/]
Puede poner la imagen a la izquierda, derecha o centrada, como en este

ejemplo.
[http://lionwiki.0o.cz/lion.jpg|link=http://lionwiki.0o.cz/|center|title=Big Lion|alt=Alt
text]
Tablas de contenido
Se pueden general Tabla de contenidos automticamente con {TOC}.
Cdigo o preformato
Es muy til cuando queremos evitar que el wiki nos "formatee" algo o lo
malinterprete, util para poner cdigo, o informacin en bruto. Se utiliza { { y }
}. Todo el texto entre medias ir formateado como este:
Pag 179
import sys
if len(sys.argv) == 2:
Wiki
print "Hello",sys.argv[1]}}
Linea horizontal
Usando ---- en una lnea sin nada ms.
Evitando el formato wiki

Usando el caracter ^ antes de cualquier palabra especial.
Codigo HTML
Puede meter cdigo HTML directamente en el wiki, mientras use los tags
{html} y {/html}
Lnea en blanco
Utilice {br} para meter lneas en blanco.
Menu del wiki

Puede modificar el men del wiki, insertando sus propios enlaces en formato
HTML, para ello tiene que editar una pgina especial llamada side_menu. Vaya
a la seccin "Admin pages" del men del Wiki, para editar todas las pginas,
incluida la pgina especial "Side_menu". En ella debe poner cdigo HTML
directamente enlazando a lo que quiera, puede ser una pgina del WIKI o algo
externo.
P.e: suponga que tiene una pgina del Wiki con el nombre "office". El enlace
sera algo como
http://localhost/integria/index.php?sec=wiki&sec2=operation/wiki/wiki&page=Office
Debe crear un cdigo en la pagina side_menu con el siguiente formato:

<li><a
href='http://localhost/integria/index.php?sec=wiki&sec2=operation/wiki/wiki&page=Telephone_ES'
>Telefonos</a>
Pag 180
Wiki
Permisos lectura y escritura

Esta funcionalidad permite gestionar el acceso al contenido y es Enterprise. En
un principio, todas las pginas son accesibles y editables por todos los
usuarios. Pero los usuarios administradores pueden crear listas de acceso para
lectura y escritura de cada pgina en las entradas del men lateral: 'Lectura
ACL' y 'Escritura ACL'.

Pag 181
Wiki
Si un contenido no tiene usuarios en su lista de lectura o escritura, ser

accesible por todos.

Cuando aadimos un usuario a las listas de acceso, slo tendrn permiso de

lectura o escritura dichos usuarios. Como se puede ver en el siguiente ejemplo,
el usuario 'dario' ser el nico que tenga permisos de escritura en la pgina
principal.

Pag 182
13.
Configuracin
Configuracin

Herramientas del sistema

Opciones de configuracin

El men Configuracin de Integria IMS proporciona la pantalla de
Pag 183
Configuracin
configuracin general de la aplicacin. La seccin principal de lo que es

propiamente la configuracin presenta una solapas. El men de la izquierda
incluye otras utilidades, que llamamos herramientas del sistema. Detallaremos
ambos, unos como opciones de configuracin (las solapas dentro de la seccin
de setup) y otras como herramientas del sistema (las opciones del men).

Estas secciones estn restringidas, y solo el usuario marcado como admin

podr acceder a estas opciones)

Opciones de configuracin
Configuracin general

En la seccin Configuracin general se pueden configurar diversos aspectos
generales de Integria IMS. aqu describimos los ms importantes y que
requieren una explicacin ms detallada.
Pag 184
Configuracin
Idioma: Puede seleccionar entre los idiomas disponibles. Este es el

idioma global del sistema, cada usuario puede tener definido un
lenguaje propio, que sobreescribe el valor de configuracin definido
aqu.
Nombre del sitio: Nombre del sitio web, visible en el ttulo de todas las
ventanas. Ese nombre ir tambien en el subject de todos los mensajes.
Puede dejarlo en blanco.
Error log: Si se activa, existir un fichero llamado integria.log con los
errores generados por la aplicacin, til para buscar origen de
problemas y reportarlos al equipo de desarrollo.
Timezone: Por ejemplo Europe/Berlin, especifica la zona horaria donde
operar la aplicacin. Dispone de una lista de Timezone soportadas
aqu:http://php.net/manual/en/timezones.php
Lista de IP's con acceso a la API: IP, separadas por comas, con acceso a
la API. Un * significa "cualquiera".
API password: Password necesaria para hacer peticiones via API.
Tamao mximo de upload: Define el tamao mximo de un fichero
para subir a la aplicacin. Si tiene un tamao ms bajo en el sistema
(configuracion de PHP) este lmite puede no respetarse. Si tiene
problemas a la hora de subir ficheros grandes, tambin puede deberse a
otros parmetros de PHP ms avanzados.
Activar newsletter: Puede desactivar completamente la feature de la
newsletter desde aqu.
Licencia: Para instalar la versin enterprise necesitar, adems del
cdigo, un nmero de licencia.
Primer da de la semana: Para calendarios y otros usos de la
aplicacin.
Habilitar acceso HTTPS: Configurar Integria IMS para usar https.
Puerto de acceso: Configurar el puerto de acceso del servidor.
Acceso pblico al servidor: URL de acceso pblico al servidor. Puede
ser una IP o una direccin url. Si se usa en un entorno local este
parmetro ser la misma IP de acceso al servidor.
El parmetro Acceso pblico al servidor se usa en la generacin de
newsletters para poder recolectar el nmero de visualizaciones de las
mismas
Pag 185
Configuracin
Configuracin visual

En esta seccin se configuran algunas de las opciones que definen la
"apariencia" general del sistema. Puede modificar las siguientes opciones:
Tamao del bloque de paginacin. Por defecto 25 elementos, si quiere

que en los listados aparezcan ms o menos elementos, puede modificar
ese valor aqu. No elija un valor muy alto, ya que eso repercutir
negativamente en el rendimiento del sistema.
Fuente para grficas. Las grficas se suelen ver mejor con una fuente
llamada "Smallfont", pruebe con otras si no es de su gusto. El tamao de
la fuente tambin puede ser seleccionado en otro elemento que est
debajo.
Fuente para informes PDF. Puede cambiar este valor para cambiar la
fuente usada en los PDF. Existe una fuente llamada "unicode" especial,
que le permitir utilizar todo tipo de grafas para sus informes (Japons,
Coreano, Chino, rabe...).
Logo del sitio. Es el logo que se muestra en la pantalla de login, deberia
tener fondo blanco.
Logo de la cabecera. Es el logo que se muestra en la pantalla de login,
deberia tener fondo transparente y unas dimensiones aproximadas de
140x47.
Grficas flash. Permite activar/desactivar globalmente el uso de
grficas Flash.
Pag 186
Configuracin
Configuracin de la gestin de passwords

La gestin de poltica de password excluye a los usuarios administrador. Esta
es una caracterstica Enterprise.
Activar poltica de password. Si esto no esta activado, el resto de

parmetros no se usarn.
Tamao minimo de password. En caracteres.
Nmeros en la contrasea. Tiene que haber al menos un nmero en la
password.
Smbolos en la contrasea. Debe haber algun simbolo (!*/$...) en la
contrasea.
Expiracin en das. Pasado ese tiempo el sistema obligar a cambiar la
contrasea.
Obligar al cambio de password en el primer login.
Tiempo de bloqueo del usuario. En minutos, despus de reiterados
fallos de login, el usuario no podr logearse (aunque meta bien la
contrasea) pasado ese tiempo.
Mx. numero de intentos de login. Superado ese umbral el usuario se
bloquar por un tiempo definido en el token de configuracin anterior.
Configuracin de incidentes

Pag 187
Configuracin
N de horas predeterminadas para una UT de Incidencia: Define el

valor por defecto que tiene una WU (en horas) al crear una unidad de
trabajo (workunit), por defecto es 0.25 (15 minutos).
Enviar automticamente un email a cada modificacin del
incidente: Esto es bastante "ruidoso" y enva una notificacin por
correo para cualquier cambio de la incidencia, no solo cuando se asignan
workunits o ficheros, sino tambin por ejemplo, ante la modificacin de
la prioridad de la incidencia.
Max. de incidencias por busqueda: Limitir el nmero de resultados
en una busqueda a esa cantidad, para evitar degradacin de
rendimiento del sistema.
Mostrar el propietario de la incidencia: Muestra en la lista
(bsqueda) de incidentes el propietario o usuario asignado a la
incidencia.
Mostrar el creador de la incidencia: De igual forma que el anterior,
muestra el usuario creador de la incidencia.
Pag 188
Configuracin
Autoincident close: N de horas pasadas las cuales una incidencia no

cerrada pasar al estado "Cerrada" de forma automtica.
Usuarios con acceso IW pueden cambiar el creador: Aquellos
usuarios con ese bit de acceso podrn cambiar el creador de la
incidencia.
Permitir cambiar el tipo de incidencia: Es opcional, porque al
cambiar el tipo de una incidencia que ya existe, se pierde la informacin
de los campos personalizados del tipo de incidencia.
Permitir definir la hora/fecha de la incidencia al crearla.
Tambin se puede cambiar el nombre de los estados posibles de una

incidencia (no se pueden quitar o aadir estados). Puede dejar alguno en
blanco. El primer estado ser siempre el estado NUEVO (incidencia recin
creada). El ltimo estado ser siempre el estado CERRADO. El penltimo ser
siempre el estado PENDIENTE DE... de forma que es un estado donde la SLA
"no cuenta". Puede ajustar los nombres o eliminar los estados que considere,
pero el workflow va asociado a esos estados.
Las "resoluciones" posibles tambien son "redefinibles", de forma que puede
ajustarlos a su organizacin. No dejan de ser un campo descriptivo.
Los dias no laborables se usan para definir fiestas locales/nacionales, etc. No
se tienen en cuenta en las SLAs (excepto aquellas que tambien incluyen
festivos), y se visualizan diferente en los calendarios.
El sistema de anomizacin de incidencias permite que cuando se

enven los mails, las direcciones de los usuarios se ocultan para evitar
que usuarios externos vean las direcciones de email de todos los
destinatarios
Configuracin del correo electrnico

En la seccin Configuracin del email se pueden configurar los parmetros
referentes a los correos electrnicos que Integria IMS enva automticamente
en varios casos: Creacin de una UT en un proyecto o una incidencia,
modificacin de algn dato de la incidencia o notificaciones automticas
cuando una SLA no se cumple.
El protocolo SMTP se usa para el envo de correos , por ejemplo cuando se
produce un cambio en una incidencia o se incumple un SLA. El protocolo
POP/IMAP se usa para gestionar incidencias enviando e-mails con una
estructura especfica al mailbox. Esta ltima opcin slo es necesaria si se
Pag 189
Configuracin
quiere gestionar las respuestas a los emails o la creacion de tickets desde un

email.

Si quiere usar una cuenta de GMail con el servicio de mailing de Integria debe
configurar las variables SMTP como sigue:
SMTP Host: ssl://smtp.gmail.com

SMTP Port: 465
SMTP User: yourmail@gmail.com
SMPT Passowrd: your_password
En esta seccin tambin puede cambiar parmetros globales de los emails

como la cabecera, el pie, la direccin de envo, el perodo de notificacin, etc.
Pag 190
Configuracin
Periodo de notificacin: Es el tiempo mnimo que debe pasar entre dos

notificaciones de SLA. Est definido en horas y de forma
predeterminada es un da. Es un parmetro global.
Direccin de correos de origen del sistema: Direccin desde la que se
enviarn los correos electrnicos desde Integria. Es la direccin que
ver el usuario cuando le llegue un correo.
Configuracin de SMTP
Se definen las credenciales y datos para conectar a su servidor SMTP. Si de
deja en blanco intentar usar un sistema de correo local en la misma maquina
donde corre Integria (generalmente sendmail o equivalente).
Configuracin de IMAP/POP
Similar al la configuracin de SMTP. Si va a usar SSL utilice
ssl://nombredehost.domain.com y configure adecuadamente el puerto.
Configuracin de la cola de envo de correos
Integria no envia automticamente los correos, si no que los "encola" para ser
enviados por el proceso que se ejecuta cada cinco minutos (integria cron).
Para ajustar este comportamiento existen una serie de parmetros especiales,
asi como un gestor de cola de envos pendientes. Nota: Los emails de las
newsletter no utilizan esta cola, sino una cola independiente que se gestiona
desde la cola de envios de la newsletter.
Intentos de reenvio SMTP: Excedido este numero, marcar el mail en

la cola como incorrecto.
Max. numero de correos pendientes: Excedido este numero, mostrar
una advertencia en la zona de avisos del sistema para indicar que puede
haber un problema en el envo de correos. Esto tambin se puede
monitorizar de forma externa a travs de la API.
Max. de mails enviados en cada ejecucin: Los correos se envan cada
vez que se ejecuta el proceso de background, pero aqu se puede
especificar que no enve mas que un nmero mximo cada vez. Util si
nuestro servidor no nos deja enviar ms de X correos por hora, por
ejemplo.
Cabecera del correo electrnico: Cabecera del correo electrnico que
se enviar en cualquier correo automtico de Integria IMS. No admite
macros.
Pag 191
Configuracin
Pie del correo electrnico: Pie del correo electrnico que se enviar en
cualquier correo automtico de Integria IMS. Se puede dejar en blanco,
al igual que la cabecera. Se enva como texto plano (plain ascii).
Gestin de la cola de envo de correos

Este sistema permite ver los mails pendientes de envo y su estado. Adems
podemos borrar la cola actual y/o reenviar aquellos mails marcados como
invlidos.
Plantillas de correo

Pag 192
Configuracin

Esta seccin sirve para poder editar las plantillas de correo que utilizar
Integria para componer emails as como las plantillas del "subject" del
mensaje. Las plantillas de correo son genricas y se utilizan para todos los
grupos.
Para editar una plantilla elija una y pulse el botn de editar. Puede ver que hay
unas marcas especiales, del tipo de _sitename_ que llamamos macros. Las
macros son marcas de texto que se sustituirn en el momento de componer el
mensaje por un valor concreto. En este momento estn definidas las siguientes
macros:
_sitename_: Nombre del sitio, tal y como se haya definido en el setup.

_incident_title_: Ttulo del incidente.
_username_: Nombre del usuario que recibe el correo (login name)
_fullname_: Nombre completo del usuario que recive el correo.
_incident_id: ID de incidente.
_url_: URL del incidente.
Pag 193
Configuracin
_creation_timestamp_: Fecha/Hora de la creacin del incidente.

_update_timestamp_: La ltima vez que se actualiz el incidente.
_owner_: Usuario que controla el incidente.
_group_: Grupo asignado a dicho incidente.
_author_: Creador del incidente.
_priority_: Prioridad del ncidente.
_status_: Estado del incidente.
_resolution_: Resolucin del incidente.
_time_used_: Tiempo total empleado en este incidente.
_incident_main_text_: Texto descriptivo principal del incidente.
_wu_user_: Usuario que reporta una unidad de trabajo.
_wu_text_: Texto de la unidad de trabajo.
_havecost_: Para reportes de la unidad de trabajo del proyecto
exclusivamente.
_taskname_: Para reportes del proyecto exclusivamente.
_projectname_: Para reportes del proyecto exclusivamente.
Visibilidad del men

Esta opcin sirve para "ocultar" ciertas partes de Integria de cara a grupos de
usuario. Esta es una caracterstica Enterprise. Se puede configurar, para cada
seccin y grupo de usuarios, los siguientes niveles de visibilidad:
Oculto: No se mostrar para quien tenga permisos en el grupo indicado.

Limitado: Se mostrar para quien tenga permisos en el grupo indicado
pero ciertas partes de la seccin podrn estar ocultas.
Completo: Los usuarios con permisos en el grupo indicado tendrn
acceso completo a la seccin.
Pag 194
Configuracin

Informacin adicional:
Si una seccin no tiene ninguna configuracin de visibilidad, por defecto

el acceso ser Completo para todos los usuarios.
Cada seccin est asociada a un perfil, siendo este el que se chequea
junto con el grupo del usuario para saber si tiene visibilidad o no, las
asociaciones son las siguientes:
Proyectos => 'PR'
Incidentes => 'IR'
Inventarios => 'VR'
BC => 'KR'
File releases => 'KR'
Agenda => 'AR'
Personas => Cualquier perfil
Work Orders => 'WOR'
Configuracin => Cualquier perfil
Si el usuario es administrador siempre tendr acceso completo
independientemente de la configuracin de visibilidad de men.
Si un usuario tiene perfiles en varios grupos que tienen distintos niveles
de visibilidad en una seccin, la visibilidad para ese usuario en esa
seccin ser la menos restrictiva.
Si se crea un nivel de visibilidad para una seccin seleccionando todos
los grupos (grupo 'Todos'), se eliminarn toda configuracin para esa
seccin permaneciendo solamente la introducida.
Inventario
Esta seccin controla la integracin automtica del inventario de pandora con
el de integria, y la gestin del inventario remoto (procesamiento de datos
enviados por agentes de pandora a Integria, sin necesidad de instalar Pandora
FMS).

Pag 195
Configuracin

Importacin de datos desde Pandora FMS
Pandora FMS URL: P.e: http://pandora.mydomain.com/pandora

Pandora FMS API: Password de la API.
Pandora FMS User & Password: Credenciales de acceso a Pandora
(con permisos para obtener informacin de inventario).
Pandora FMS Default contract: Contrato por defecto sobre el que se
colgarn los objetos importados.
Procesado de datos de inventario desde agentes de Pandora FMS
Tipo de objeto: Tipo de objeto base donde se colgar la informacin

proveniente de los agentes.
Propietario por defecto: Propietario por defecto para esos objetos.
Compaa asociada, y usuario asociado: Compaas con acceso a esos
objetos, y usuarios con acceso a esos objetos.
Autenticacin
Pag 196
Configuracin
Tipo de autenticacin: LDAP o local. Si se usa LDAP los usuarios de

tipo admin locales sern los nicos que funcionaran "localmente" sin
autenticar contra un LDAP, el resto se usarn para autenticar contra un
LDAP. Si algo falla, podr hacerlo con los usuarios administradores
localmente.
Timeout de sesion: En segundos. Pasado ese tiempo de inactividad, la

sesin se cerrar sola.
Los usuarios que se van a autenticar sern los contenidos en LDAP y

administradores locales. A continuacin se describen los campos que se
pueden configurar (una vez activada la opcion de LDAP).
Autocreate remote users: Habilita/Deshabilita la creacin automtica

de usuarios remotos. Esta opcin hace posible que se creen los usuarios
automticamente una vez hagan login usando LDAP.
Autocreate profile: Este campo hace posible asignar un tipo de perfil a
los usuarios que se crean automticamente.
Pag 197
Configuracin
Autocreate profile group: Este campo hace posible asignar un grupo a

los usuarios que se crean automticamente.
Autocreate blacklist: Una lista de usuarios, separados por comas, que
no se crearn de forma automtica.
LDAP server: Aqu se define la ruta en la que se encuentra el servidor
LDAP.
LDAP port: El puerto del servidor LDAP.
LDAP version: Combo para escoger la versin del servidor LDAP que se
utilizar.
Start TLS: Usar el protocolo Transport Layer Security (TLS) en las
comunicaciones entre el cliente y el servidor.
Base DN: Distinguised Name (DN) usado por el servidor LDAP. Por
ejemplo: ou=People,dc=example,dc=com
Login attribute: Atributo de login que usa LDAP durante el proceso de
autenticacin. Por ejemplo UID (User Identification Code).
CRM
Esta seccin controla toda la configuracin especfica del CRM.

Pag 198
Configuracin
Logo para la cabecera de las facturas. Indicar imagen que se desea

para poner en la cabecera de las facturas emitidas.
Nombre del impuesto. En Espaa por ejemplo se llama IVA; en Reino
Unido, VAT.
Cabecera de la factura. Datos que se desea mostrar en la cabecera de la
factura.
Pie de pgina de la factura. Texto que se aade en letra pequea en el
pi de pgina de la factura.
Parmetros de los leads
Filtrado de compaias por ID. Puede indicar el ID del tipo de

compaa (p.e: partners) para que al escoger la compaa asociada a un
lead (la comaia que gestiona ese lead), solo se muestren compaas de
ese tipo. Solo admite un ID.
Pag 199
Configuracin
N de dias antes de avisar sobre leads inactivos. A partir de ese

numero de dias sin actualizar un lead, se mostrar en un fondo de color
rojo.
Cabecera de la factura. Datos que se desea mostrar en la cabecera de la
factura.
Nombre de los estdos de un lead.. Puede redefinir los textos. Algunos
tipos son especiales (los marcados con *) y otros como el primero, si no
se redefinen se usan por defecto. El resto al dejarlos en blanco no se
muestran.
Gestin de datos viejos

Permite especificar al sistema cmo gestionar informacin vieja.

Das para borrado de eventos. A partir de ese numero de das de

antiguedad, son borrados. No borra las incidencias que no estn
cerradas.
Das para borrado de incidencias: Borra tambin ficheros adjuntos,
pero no las unidades de trabajo (WU).
Das para borrado de WU's: Borrado de WU's. Independiente de si son
de incidencias o proyectos.
Das para borrado de WO's: Borrado de WO's -independientemente de
su estado-. Tambin borra sus ficheros adjuntos.
Das para borrado de datos de auditoria. Similar al caso de los
eventos.
Das para borrado de datos de sesin. Es una tabla especial que
guarda las sesiones abiertas.
Gestin de proyectos
Pag 200
Configuracin
Usuarios que no usan el sistema de autocompletado de WU.

Especificar un userID separado por comas si hay varios.
Nmero de horas por dia. Usado para calcular mtricas.
Autocompletado de WU (dias). Por ejemplo, si se usa 30 dias, signfica
que el sistema automticamente rellenar una WU por dia asignado a la
tarea especial "No justificado" para cada usuario que ese da no haya
imputado actividad.
Tiempo por defecto para una WU de proyecto. De forma que al crear
una WU, usar esa cantidad de tiempo por defecto (en horas).
Moneda por defecto: Euros, Yenes, Dlares, etc.
Herramientas del sistema

Todas las herramientas aqu mencionadas, slo pueden ser accedidas, de igual
manera que las opciones de configuracin, por el administrador general del
sistema. Algunas herramientas, mal usadas, pueden dejar inoperativo el
sistema (gestor SQL, gestor de ficheros).

Traduccin de cadenas
La herramienta de traduccin de cadenas se encuentra dentro del
menu Setup y le permite cambiar cualquier texto que aparece en el interfaz de
Integria por uno personalizado. Esta herramienta funciona con todos los
idiomas disponibles en Integria.
Pag 201
Configuracin

En el interfaz hay un combo en el que podr seleccionar el idioma que desea
modificar y un campo libre para buscar el texto. La bsqueda se realiza sobre
el idioma de referencia que es el Ingls, todas las traducciones se basan en este
idioma.
Si queremos cambiar la traduccin de un texto por ejemplo en Espaol
primero deberemos encontrar el equivalente en Ingls, por ejemplo queremos
cambiar la cadenaContrasea que aparece en la pantalla de login.

Para ello buscamos el texto en la misma pantalla, pero en Ingls.
Pag 202
Configuracin

En la imagen siguiente realizamos una bsqueda para cambiar la traduccin
de la palabra Password en Espaol. Para ello seleccionamos el idioma y
realizamos la bsqueda de Password. Una vez realizada la bsqueda
aparecern tres columnas, la primera muestra el texto de referencia en Ingls,
la segunda el texto traducido al Espaol y la tercera el texto personalizado

Para personalizar el texto solo tiene que introducir el texto nuevo en la tercera
columna y pulsar en el botn Update
Pag 203
Configuracin
Una vez realizada la traduccin en la pantalla de login para el idioma Espaol

se mostrar la nueva cadena.
Gestor de noticias globales del sistema

sto le permite aadir pequeas noticias del sistema, que sern visibles a
todos los usuarios cuando entren. til para avisar de cambios en la plataforma
o avisos sobre intervenciones, desconexin del servicio u otros.
Gestor de SQL
Es una interfaz directa contra la BBDD del sistema, en SQL. No est
recomendada a usuarios que no sean expertos, pues un mal uso de ella puede
hacer que se destruya el sistema. Consulte con la estructura (esquema) de la
BD de Integria para poder hacer consultas SQL directamente contra la base de
datos.
Gestor de archivos
El gestor de archivos sirve para poder subir y borrar ficheros al sistema
interno de integria. sto es til para subir de forma cmoda nuevos logos o
avatares de usuario. Es tambin la forma ms cmoda de subir nuevos ficheros
al Sistema de distribucin de ficheros integrado en Integria IMS. Dichos ficheros
se ubican en el directorio /attachment/downloads.
Pag 204
Configuracin
Para subir imgenes de avatares, puede hacerlo en el directorio

/images/avatars.
Puede cambiar los iconos por defecto en el directorio /images
Si navega por el directorio /images en general, ver algunos subdirectorios
tiles si desea subir sus propias imagenes para categoras de producto, grupos,
etc. En dicha carpeta se ubican los logos que puede elegir para personalizar la
interfaz de Integria, tal como se elige en la seccin de configuracin visual.
Enlaces
En la seccin Enlaces podr gestionar los enlaces existentes a otros sitios web,
generalmente externos. Podr editar, aadir y borrar los enlaces existentes.
Para editar un enlace existente pulse sobre el nombre del enlace y se
presentar un formulario donde podr modificar el nombre del enlace y el
enlace al sitio web. Una vez que haya modificado los datos, pulse el
botn Actualizar y se modificar su enlace.
Para borrar un enlace existente simplemente pulse sobre la X debajo de la
columna Borrar en la tabla de enlaces. Se le presentar un cuadro de dilogo
pidindole confirmacin. Pulse Aceptar para borrar el enlace.
Para aadir un enlace pulse el botn Aadir. Se presentar un formulario
donde deber rellenar el nombre del enlace y el enlace al sitio web. Una vez
que haya introducido los datos pulse el botn Actualizar y se aadir su nuevo
enlace.
Eventos del sistema

La seccin Eventos del sistema de Integria IMS guarda un histrico de los
eventos sucedidos en el sistema, tales como enviar informes programados,
ejecutar chequeos en el cron, etc. No guarda informacin de actividad de
usuario, que se almacena en el log de auditora.
La tabla proporciona los siguientes campos:
Tipo: Tipo del evento.

Usuario: Usuario que gener el evento. Si no hay usuario es informacin
del sistema.
Informacin extendida: Informacin extendida acerca del evento, en
caso de estar disponible.
Pag 205
Configuracin
Fecha/Hora: Hora y fecha en la que sucedi el evento.
Log de auditora
En este registro quedarn reflejadas todas las acciones de cada usuario en
cada seccin. Si alguien modifica un dato de un cliente, usted sabr cuando y
qu cambio. Si alguien borra una factura, sabr cuando y que factura, y as
sucesivamente. Permite buscar por una subcadena concreta.

Log de errores
Visualiza el log de errores (si ste est activado), til para identificar posibles
errores de cdigo del sistema. En caso de consulta o incidencia, deber aportar
las ultimas entradas (por fecha) de este registro.
Sistema de alertas y notificaciones

Este sistema informa, mediante un icono circular amarillo en la cabecera, de
los problemas que puedan surgir en Integria. Avisa cuando:
Hay un nmero elevado de emails pendiente de envo. Este parmetro

se define en la Configuracin general y, por defecto, son 15 emails en
cola. Cuando se supera este lmite, el sistema muestra una alerta.
El cronjob no est instalado.
El cronjob se ha ejecutado hace ms de 10 minutos.
Pag 206
Configuracin
Actualizador offline
El actualizador offline permite subir paquetes de actualizaciones a
instalaciones que no tienen acceso a internet.

Esta herramienta admite ficheros .oum que son ficheros en formato zip que
contienen los ficheros que sern actualizados en la consola de Integria IMS.
Este archivo tiene una estructura idntica a la jerarqua de ficheros de la
consola, respetando la anidacin de carpetas, pero slo contiene los archivos
que es necesario actualizar.

El nombre de los archivos .oum no puede contener espacios o caracteres
extraos. En el caso de que algn caracter cause un conflicto, la herramienta
mostrar un error indicando que el paquete no existe.

Pag 207
Configuracin

Por ejemplo, si queremos actualizar el
archivo operation/incidents/incident.php tendramos la siguiente
estructura.
update_123.oum
|
|
|--- operation
|--- incident.php
|--- incidents
La herramienta descomprimir el fichero y copiara todos los archivos a sus

respectivas ubicaciones.
Tambin es posible actualizar el esquema de la base de datos, para ello hay
que aadir unos ficheros SQL en la carpeta extras/mr. Estos ficheros tienen
que ser nombrados con nmeros consecutivos y se pueden aadir tantos como
se quieran por cada fichero .oum. Por ejemplo:
update_123.oum
|
|
|
|--- 1.sql
|--- extras
|
|--- 2.sql
|--- mr
|--- 3.sql
La herramienta realizar los cambios en la base de datos aplicando los

archivos de forma consecutiva. La actualizacin de la base de datos se ejecuta
cuando un usuario entra en la herramienta. Los scripts SQL se ejecutan
individualmente por cada loggeo de usuario, de tal forma que si se tienen que
aplicar tres archivos ser necesario que se realicen tres entradas al sistema.
Pag 208
14.
API externa de Integria
La API externa de Integria se utiliza haciendo llamadas remotas via HTTP o

HTTPS sobre el fichero /include/api.php. Con este mtodo es posible la
integracin de aplicaciones de terceros con Integria. El uso del API se hace
mediante una llamada con unos parmetros definidos que devuelve un valor o
una lista de valores.
El prototipo de llamada al API es el siguiente:
http://<instalacin Integria>/include/api.php<parametros>
El API slo acepta los siguientes parmetros (otros parmetros sern

ignorados):
user (obligatorio): nombre del usuario de Integria que accede a los

datos, se usa para verificar ACLs.
op (obligatorio): operacin ha realizar. Las operaciones estn detalladas
ms abajo.
pass (obligatorio si est habilitado): password del API configurado en la
consola de Babel Enteprise.
params: lista de parametros que se pasaran a la funcin separados por
un token.
token: token que separa los diferentes parmetros (por defecto es ',').
return_type: formato del resultado de la llamada, puede ser 'xml' o 'csv'
(por defecto es 'csv').
info: parmetro especial con el que puede obtenerse la versin antes de
autenticarse.
Seguridad
La autenticacin para el API de Integria se puede realizar de dos maneras: por
contrasea o por una lista de IPs vlidas.
Autenticacin por IP vlida

La seguridad se basa en una lista de IPs que tendrn acceso a la herramienta.
Esta lista se puede crear en el men de configuracin de Integria.
Pag 209
Si se introduce en la caja de texto el carcter * se omite la comprobacin de

ACL, permitiendo el acceso desde todas las IPs y relegando la seguridad al
protocolo y al entorno.
Es importante tener en cuenta que este mtodo de autenticacin siempre est
activo por lo que si no desea usarse ser necesario poner el caracter * como
nica IP de la lista.
Autenticacin por contrasea

Dentro del men de configuracin de Integria es posible establecer una
contrasea para el API. Esta contrasea deber enviarse en la llamada al API
en claro, por ello es recomendable usar HTTPS si se quiere usar este mtodo
de autenticacin.
Si slo se desea usar la autenticacin por contrasea sin importar la IP de
origen de la peticin es importante poner el caracter * como nica IP de la
lista.

Pag 210
15.
Funciones del API
Funciones del API
Retorno de informacin sobre Integria IMS

Esta es una funcin especial que puede ser usada sin autentificarse, ya que la
informacin que devuelve se puede obtener de la pantalla de login y no se
considera que vulnere la seguridad.
Devuelve la versin del Integria IMS y es til para verificar que en esta ruta se
encuentra una instalacin de Integria IMS o para obtener la versin antes de la
autenticacin.
Llamada
http://127.0.0.1/integria/include/api.php?info=version
Resultado
Integria IMS OpenEdition v4.0dev - Build 130514 MR5
Incidents
get_incidents
Resultado: Devuelve una lista con las incidencias a las que tiene acceso
el usuario que hace la llamada
Parametros: Filtro de cadena (cadena vaca para todos), Filtro de estado
(1 para todos y -10 para los no cerrados), Filtro de grupo (1 para todos)
Llamada con resultado en CSV

http://127.0.0.1/integria/include/api.php?user=user&op=get_incidents&params=day,-10,1
Resultado CSV
user-laptop,3 server1,45
Llamada con resultado en XML

http://127.0.0.1/integria/include/api.php?user=user&op=get_incidents&params=day,10,1&return_type=xml
Pag 211
Funciones del API
Resultado XML
<xml>
<item>
<name>user-laptop</name>
<data>3</data>
</item>
</xml>
<item>
<name>server1</name>
<data>45</data>
</item>
get_incident_details
Resultado: Devuelve los detalles de una incidencia

Parametros: id de la incidencia

http://127.0.0.1/integria/include/api.php?user=user&op=get_incident_details&params=2
Resultado CSV
1,"2010-02-17 01:35:35","0000-00-00 00:00:00",Myfddfe,,demo,1,1,3,3,"2010-02-17
01:50:05",user,1,0,0,,,0,0,0,0

http://127.0.0.1/integria/include/api.php?user=user&op=get_incident_details&params=2&return_ty
pe=xml
Resultado XML
<xml>
<id_incidencia>1</id_incidencia>
<inicio>2010-02-17 01:35:35</inicio>
<cierre>0000-00-00 00:00:00</cierre>
<titulo>Myfddfe</titulo>
<descripcion></descripcion>
<id_usuario>demo</id_usuario>
<origen>1</origen>
<estado>1</estado>
<prioridad>3</prioridad>
<id_grupo>3</id_grupo>
<actualizacion>2010-02-17 01:50:05</actualizacion>
<id_creator>admin</id_creator>
<notify_email>1</notify_email>
<id_task>0</id_task>
<resolution>0</resolution>
<epilog></epilog>
<id_parent></id_parent>
<sla_disabled>0</sla_disabled>
<affected_sla_id>0</affected_sla_id>
<id_incident_type>0</id_incident_type>
<score>0</score> </xml>
create_incident
Resultado: Se crea una incidencia.

Parmetros: Ttulo, Id del grupo, Prioridad, Descripcin, Id de
inventario.

http://127.0.0.1/integria/include/api.php?user=user&op=create_incident&params=Titulo%20de%20la
%20incidencia,2,1,Descripcion%20de%20la%incidencia,1
Pag 212
Funciones del API
Resultado CSV
0

http://127.0.0.1/integria/include/api.php?user=user&op=create_incident&params=Titulo%20de%20la
%20incidencia,2,1,Descripcion%20de%20la%incidencia,1&return_type=xml
Resultado XML
<xml>
<data>0</data> </xml>
update_incident
Resultado: Actualiza los datos de un incidente

Parametros: Id del incidente, ttulo, descripcin, eplogo, id del grupo,
prioridad, origen, resolucin, estado

http://127.0.0.1/integria/include/api.php?user=user&op=update_incident&params=4,nuevo%20titulo
,nueva%20descripcion,nuevo%20epilogo,4,2,1,1,3
Resultado CSV
0

http://127.0.0.1/integria/include/api.php?user=user&op=update_incident&params=4,nuevo%20titulo
,nueva%20descripcion,nuevo%20epilogo,4,2,1,1,3&return_type=xml
Resultado XML
<xml>
delete_incident
Resultado: Se elimina una incidencia.

Parmetros: Id de la incidencia

http://127.0.0.1/integria/include/api.php?user=user&op=delete_incident&params=3
Pag 213
Funciones del API
Resultado CSV
0

http://127.0.0.1/integria/include/api.php?user=user&op=delete_incident&params=3&return_type=xm
l
Resultado XML
<xml>
Workunits
get_incident_workunits
Resultado: Devuelve una lista con los workunits asociados a una

incidencia
Parametros: id de la incidencia

http://127.0.0.1/integria/include/api.php?user=user&op=get_incident_workunits&params=3
Resultado CSV
3,"2010-02-17 01:48:48",0.25,admin,"Workunit description",0,0,,1 2,"2010-02-17
01:47:41",0.25,admin,"Another workunit description",0,0,,1

http://127.0.0.1/integria/include/api.php?user=user&op=get_incident_workunits&params=3&return_
type=xml
Resultado XML
<xml>
<workunit>
<id>3</id>
<timestamp>2010-02-17
01:48:48</timestamp>
<duration>0.25</duration>
<id_user>admin</id_user>
<description>Workunit description</description>
<have_cost>0</have_cost>
<id_profile>0</id_profile>
<locked></locked>
<public>1</public>
</workunit>
<workunit>
<id>2</id>
<timestamp>2010-02-17 01:47:41</timestamp>
<duration>0.25</duration>
<id_user>admin</id_user>
<description>Another workunit description</description>
<have_cost>0</have_cost>
<id_profile>0</id_profile>
<locked></locked>
<public>1</public>
</workunit> </xml>
create_workunit
Pag 214
Funciones del API
Resultado: Crea un workunit en una incidencia

Parametros: Id de la incidencia, descripcin, duracin en horas, si ha
tenido coste, si es publico o no, perfil asociado

http://127.0.0.1/integria/include/api.php?user=user&op=create_workunit&params=1,Descriopcion,0
.5,0,1,1
Resultado CSV
0

http://127.0.0.1/integria/include/api.php?user=user&op=create_workunit&params=1,Descriopcion,0
.5,0,1,1&return_type=xml
Resultado XML
<xml>
Files
get_incident_files
Resultado: Devuelve una lista con los ficheros asociados a una

incidencia
Parametros: Id de la incidencia

http://127.0.0.1/integria/include/api.php?user=user&op=get_incident_files&params=1
Resultado CSV
1,1,0,0,admin,file1.php,"php example",764026 2,1,0,0,admin,file2.png,"png example",34026

http://127.0.0.1/integria/include/api.php?user=user&op=get_incident_files&params=1&return_type
=xml
Resultado XML
<xml>
<file>
<id_attachment>1</id_attachment>
Pag 215
Funciones del API
<id_kb>0</id_kb>
<id_usuario>admin</id_usuario>
<filename>file1.php</filename>
<description>php example</description>
<size>764026</size>
</file>
<file>
<id_attachment>2</id_attachment>
<id_kb>0</id_kb>
<id_usuario>admin</id_usuario>
<filename>file2.png</filename>
<description>png example</description>
<size>34026</size> </file> </xml>
download_file
Resultado: Devuelve una lista con las incidencias a las que tiene acceso
el usuario que hace la llamada
Parametros: Filtro de cadena (cadena vaca para todos), Filtro de estado
(1 para todos y -10 para los no cerrados), Filtro de grupo (1 para todos)

http://127.0.0.1/integria/include/api.php?user=user&op=get_incidents&params=day,-10,1
Resultado CSV
[contenido del fichero en base64]

Resultado XML
<xml>
<data>[contenido del fichero en base64]</data> </xml>
attach_file
Resultado: Aade un fichero a la lista de ficheros de una incidencia

Parametros: Id de la incidencia, nombre del fichero, tamao del fichero
en Bytes, Descripcin del fichero, contenido del fichero en base 64

http://127.0.0.1/integria/include/api.php?user=user&op=attach_file&params=1,example.txt,234,Fi
chero%20de%20ejemplo,aW50ZWdyaWEgcm9ja3M=
Resultado CSV
0
Pag 216
Funciones del API

http://127.0.0.1/integria/include/api.php?user=user&op=attach_file&params=1,example.txt,234,Fi
chero%20de%20ejemplo,aW50ZWdyaWEgcm9ja3M=&return_type=xml
Resultado XML
<xml>
delete_file
Resultado: Elimina un fichero de la lista de ficheros de una incidencia

Parametros: Id del fichero

http://127.0.0.1/integria/include/api.php?user=user&op=delete_file&params=32
Resultado CSV
0

http://127.0.0.1/integria/include/api.php?user=user&op=delete_file&params=32&return_type=xml
Resultado XML
<xml>
Users
create_user
Llamada usada para crear un usuario y asignarlo a un rol/grupo. (Para asignar
ms perfiles hay que usar una llamada diferente).
Devuelve: Devuelve 1 si se crea correctamente, 0 si no.
Parmetros: user, pass, params [(username, group_id, profile_id, email,

password, description, simplemode, realname, externaluser)]
Ejemplo:
Pag 217
Funciones del API
http://localhost/integria/include/api.php?op=create_user&user=admin&params=jorge,5,4,jorge@lux
.com,none,This is a normal user,0,Jorge Gonzalez,1
validate_user
Resulado: Devuelve 1 si la autenticacin es correcta, 0 si no

Parmetros: user, pass
Ejemplo
http://localhost/integria/include/api.php?op=validate_user&user=admin&pass=integria
Leads
create_lead
Llamada usada para crear un lead.
Devuelve: Devuelve 1 si se crea correctamente, 0 si no.
Parmetros: fullname, company, email, country, estimated_sale,

progress, phone, mobile, position, owner, language, comments, category,
managed_by, campaign
Ejemplo:
http://192.168.70.163/integria/include/api.php?user=api_user&op=create_lead%C2%B6ms=Dario,Arti
ca+ST,Rodriguez,Spain,0,0,55566677,6665577,Developer,admin,es,This comment is very
important,1,0,7
Others
get_incident_tracking
Resultado: Devuelve una lista con el tracking de una incidencia

Parametros: Id de la incidencia

http://127.0.0.1/integria/include/api.php?user=user&op=get_incident_tracking&params=2
Pag 218
Funciones del API
Resultado CSV
9,2,0,"2010-02-17 01:56:33",demo,0,Created 10,2,2,"2010-02-17 02:06:58",demo,0,"Workunit
added"

http://127.0.0.1/integria/include/api.php?user=user&op=get_incident_tracking&params=2&return_t
ype=xml
Resultado XML
<xml>
<tracking>
<id_it>9</id_it>
<id_incident>2</id_incident>
<state>0</state>
<timestamp>201002-17 01:56:33</timestamp>
<id_user>demo</id_user>
<id_aditional>0</id_aditional>
<description>Created</description>
</tracking>
<tracking>
<id_it>10</id_it>
<id_incident>2</id_incident>
<state>2</state>
<timestamp>201002-17 02:06:58</timestamp>
<id_user>demo</id_user>
<id_aditional>0</id_aditional>
<description>Workunit added</description>
</tracking> </xml>
get_incidents_resolutions
Resultado: Devuelve una lista con los identificadores y nombres de las

resoluciones de las incidencias de Integria
Parametros: -

http://127.0.0.1/integria/include/api.php?user=user&op=get_incidents_resolutions
Resultado CSV
1,Fixed 2,Invalid 3,"Wont fix"

http://127.0.0.1/integria/include/api.php?user=user&op=get_incidents_resolutions&return_type=x
ml
Resultado XML
<xml>
<resolution>
<id>1</id>
</resolution>
<resolution>
<id>2</id>
<name>Invalid</name>
</resolution>
<resolution>
<name>Wont fix</name>
</resolution> </xml>
<name>Fixed</name>
<id>3</id>
get_incidents_status
Pag 219
Funciones del API
Resultado: Devuelve una lista con los identificadores y nombres de los

estados de las incidencias de Integria
Parametros: -

http://127.0.0.1/integria/include/api.php?user=user&op=get_incidents_status
Resultado CSV
1,New 2,Unconfirmed 3,Assigned

http://127.0.0.1/integria/include/api.php?user=user&op=get_incidents_status&return_type=xml
Resultado XML
<xml>
<status>
</status>
<status>
</status>
<status>
</status> </xml>
<id>1</id>
<id>2</id>
<id>3</id>
<name>New</name>
<name>Unconfirmed</name>
<name>Assigned</name>
get_incidents_sources

orgenes de Integria
Parametros: -

http://127.0.0.1/integria/include/api.php?user=user&op=get_incidents_sources
Resultado CSV
1,"User report" 2,Customer 3,"Internal department"

http://127.0.0.1/integria/include/api.php?user=user&op=get_incidents_sources&return_type=xml
Resultado XML
<xml>
<source>
<id>1</id>
</source>
<source>
<id>2</id>
</source>
<source>
<id>3</id>
department"</name>
</source> </xml>
<name>"User report"</name>
<name>Customer</name>
<name>"Internal
Pag 220
Funciones del API
get_groups

grupos de Integria
Parametros: -

http://127.0.0.1/integria/include/api.php?user=user&op=get_groups
Resultado CSV
2,"Customer #A" 3,"Customer #B" 4,Engineering

http://127.0.0.1/integria/include/api.php?user=user&op=get_groups&return_type=xml
Resultado XML
<xml>
<group>
</group>
<group>
</group>
<group>
</group> </xml>
<id>1</id>
<id>2</id>
<id>3</id>
<name>"Customer #A"</name>
<name>"Customer #B"</name>
<name>Engineering</name>
get_users
Resultado: Devuelve una lista con los usuarios sobre los que tiene
visibilidad el usuario que hace la llamada
Parametros: -

http://127.0.0.1/integria/include/api.php?user=user&op=get_users
Resultado CSV
usuario1 usuario2 usuario3

Pag 221
Funciones del API
Resultado XML
<xml>
</xml>
<id_user>usuario1</id_user> <id_user>usuario2</id_user> <id_user>usuario3</id_user>
get_stats
Resultado: Devuelve un valor correspondiente con la consulta realizada.

Parametros: Espera los siguientes parmetros: metric, string, status,
id_user, id_group, id_company, id_product and id_inventory.
metric: Mtrica de valores estadsticos, puede ser los siguientes:
total_incidents: Nmero total de incidencias (limitado por
el nmero mximo de incidentes de Integria).
opened: Nmero total de incidencias abiertos.
closed: Nmero total de incidencias cerrados.
avg_life: Vida media de los incidencias en segundos.
sla_compliance: Porcentaje de cumplimiento de la SLA.
avg_scoring: Puntuacin media de los incidencias de 0 a 10.
avg_worktime: Tiempo medio de trabajo en la incidencia
en segundos.
string: String para filtrar la bsqueda de incidencias
status: String con valores separados por comas, puede tomar
valores entre 1 y 7. (Por defecto 1,2,3,4,5,6,7)
id_user: Filtrado por usuario. (Por defecto "").
id_group: Filtrado por grupo. (Por defecto 1).
id_company: Filtrado por compaia. (Por defecto 0).
id_product: Filtrado por producto. (Por defecto 0).
id_inventory: Filtrado por inventario. (Por defecto 0).

Obtener % SLA
http://127.0.0.1/integria/include/api.php?user=user&op=get_stats&params=sla_compliance
Obtener total de incidencias abiertas con estado NUEVO (codigo 1), en

cualquier grupo:
http://127.0.0.1/integria/include/api.php?user=user&op=get_stats&params=opened,,1
Pag 222
Funciones del API
Obtener el total de incidentes abiertos (cualquier estado, en cualquier grupo)

http://127.0.0.1/integria/include/api.php?user=user&op=get_stats&params=opened
Resultado CSV
1,"Sample inventory object" 2,"Another inventory" 3,Thirdventory

http://127.0.0.1/integria/include/api.php?user=user&op=get_stats&params=sla_compliance&return_
type=xml
Resultado XML
<xml>
get_inventories

inventarios de Integria
Parametros: -

http://127.0.0.1/integria/include/api.php?user=user&op=get_inventories
Resultado CSV
1,"Sample inventory object" 2,"Another inventory" 3,Thirdventory

http://127.0.0.1/integria/include/api.php?user=user&op=get_inventories&return_type=xml
Resultado XML
<xml>
<inventory>
object</name>
</inventory>
<name>Another inventory</name>
<id>3</id>
<id>1</id>
<name>Sample inventory
<inventory>
<id>2</id>
</inventory>
<inventory>
<name>Thirdventory</name>
</inventory> </xml>
get_last_cron_execution
Resultado: Devuelve el tiempo que ha pasado en minutos desde la

ltima ejecucin del Crontask.
Pag 223
Extensin del API
Llamada
http://127.0.0.1/integria/include/api.php?user=user&op=get_last_cron_execution
Resultado
3
http://127.0.0.1/integria/include/api.php?user=user&op=get_last_cron_execution&return_type=xml
Resultado XML
<xml>
<cronjob>
<last_exec>3</last_exec>
</cronjob> </xml>
get_num_queued_emails
Resultado: Devuelve el nmero de emails que estn en cola pendientes

de ser enviados.
Llamada
http://127.0.0.1/integria/include/api.php?user=user&op=get_num_queued_emails
Resultado
20
http://127.0.0.1/integria/include/api.php?user=user&op=get_num_queued_emails&return_type=xml
Resultado XML
<xml>
<pending_email>
16.
Extensin del API
<num>20</num>
</pending_email> </xml>
Para desarrollar nuevas llamadas para el API tiene que tener en cuenta que:
La llamada tiene que estar inscrita como una funcin en el

fichero <instalacin Integria>/include/functions_api.php, adems
Pag 224
Extensin del API
de estr contemplada en entre las funciones vlidas en el

archivo <instalacin Integria>/include/api.php .
La funcin debe devolver un nico valor o un array de pares por
ejemplo nombre-valor.
El formateo del resultado de la llamada a XML o CSV se realiza en el
archivo api.php de forma automtica.
Ejemplos de funciones para el API

Ejemplo de funcin que devuelve un nico valor
Definicin en el archivo functions_api.php:
function host_risk ($host_name) {
$host_id = get_hosts_id($host_name);
there is not a host with this name return false
if (!$host_id) {
false;
}
$risk = return_last_risk_agent($host_id);
return $risk; }
//If
return
Llamada en el archivo api.php:

switch ($op) {
...
case "host_risk":
if (isset($params['0'])) {
Ejemplo de funcin que devuelve una lista de valores

Definicin en el archivo functions_api.php:
function all_host_risk() {
//Get all host
$hosts = get_hosts();
//Check if there is host or not
if (empty($hosts)) {
return false;
$aux['name'] = $host_name;
$aux['data'] = $risk;
array_push($result, $aux);
}
return $result; }
Llamada en el archivo api.php:

switch ($op) {
...
break;
case "all_host_risk":
...
}
$result = all_host_risk ();
Pag 225
17.
Sistema de extensiones
Integria IMS cuenta con un sistema de extensiones que permite ampliar sus
funcionalidades dependiendo de las necesidades de cada usuario. Estas
extensiones permiten ampliar o crear secciones nuevas de manera ms
sencilla.
Actualmente, las extensiones pueden ser de tres tipos:
De men
De preferencias
De pestaa
Al ser una caracterstica aun en desarrollo, los tipos se pueden ampliar en un

futuro.
Extensiones de men
Las extensiones de este tipo aparecen en el men lateral de Integria IMS, justo
antes de la caja del calendario. Es posible aadir extensiones de men en
cualquier seccin.

Creando una extensin de men

Con al menos conocimientos de PHP es posible crear una extensin. Para ello
es necesario crear un script .php en la carpeta extensiones, la cual se encuentra
Pag 226
en la raz del directorio de Integria. Este fichero se encargar del registro y la

carga de las funcionalidades.
Para que una extensin pueda ser registada, se deben aadir ciertas funciones
al fichero de carga.
extensions_add_side_menu_option ([Nombre], [seccin]);
Con esta funcin, aparecer en la caja de extensiones de la seccin indicada

con el nombre indicado. Los parmetos a introducir son de tipo string.
Para conocer el nombre de la seccin para la cual se quiere introducir la
ampliacin hay que fijare en el parmetro sec de las url de Integria.
http://[host]/integria/index.php?sec=customers&sec2=operation/companies/company_detail
Aqu se puede ver, por ejemplo, que el nombre de la seccin de clientes

es customers.

Una vez aparece, hay que indicar que pasa cuando se le hace click.
extensions_add_main_function ([Nombre de funcin]);
Con esta funcin se indica, con una variable de tipo string, que funcin debe
ejecutarse para mostrar la informacin de la extensin.

Con una funcin que muestre el la informacin resultante en html, una para
indicar en que seccin debe aparecer y otra para indicar que hacer cuando se
haga click en ella escritas en un fichero .php situado en la carpeta extensions,
es posible crear una extensin. Si se requieren libreras o recursos adicionales,
basta con aadirlos en una carpeta llamada igual que el fichero y situada en el
mismo directorio.
Ejemplo:
<?php function extension1_main() {
echo "Hola Mundo"; } extensions_add_side_menu_option
('Extensin 1', 'customers'); extensions_add_main_function ('extension1_main'); ?>
Pag 227
Extensiones de preferencias
Este es un tipo especial de extensin muy similar al de men, pero con la
particularidad de que est pensada para aparecer en las preferencias de
Integria IMS. Esto la hace propensa a actuar como seccin de configuracin de
las extensiones.
Creando una extensin de preferencias

Al igual que las extensiones de men, debe ser registrada:
extensions_add_godmode_side_menu_option ([Nombre]);
Y se debe indicar que funcin cargar su informacin:

extensions_add_godmode_function ([Nombre de funcin]);
Ejemplo:
echo "<div style='color:".$config['color'].";'>Hola
Mundo</div>"; } function extension1_setup() {
$color = (string) $_POST['e1_color']; if
($color) {
update_config_token('color', $color); }
echo "<form>";
echo "
<input name='e1_color' type='text' value='$color'>";
echo "
<input
type='submit' name='upd_button' value='Actualizar'>";
echo "</form>"; }
extensions_add_side_menu_option ('Extensin 1', 'customers'); extensions_add_main_function
('extension1_main'); extensions_add_godmode_side_menu_option ('Configuracin de extensin 1');
extensions_add_godmode_function ('extension1_setup'); ?>
Extensiones de pestaa
Las extensiones de este tipo aparecern en la lista de pestaas indicada.

Pag 228
Creando una extensin de pestaa

Es muy parecida a la extensin de men, pero tiene la particularidad de poder
recibir parmetros desde la subseccin. Lo ms complicado es reunir los datos
necesarios para enlazarla a una lista de pestaas.
Para registrarla, habr que usar esta funcin:
extensions_add_tab_option ([Id de la pestaa], [Nombre], [Subseccin de la lista de pestaas],
[Ruta de icono], [Id de la lista de pestaas]);
La ruta del icono es opcional y comienza desde el directorio extensions,

tambin lo es la id de la lista de pestaas, la cual es necesaria en el caso de que
en la subseccin haya ms de una lista de pestaas.
Para conocer el nombre de la subseccin para la cual se quiere introducir la
ampliacin hay que fijare en el parmetro sec2 de las url de Integria.
http://[host]/integria/index.php?sec=incidents&sec2=operation/incidents/incident_dashboard_det
ail&id=[id de incidencia]
Aqu se puede ver, por ejemplo, que el nombre de la subseccin de la vista en

detalle de una incidencia es operation/incidents/incident_dashboard_detail.
Para indicar que funcin ejecutar para mostrar la informacin de la extensin:
extensions_add_tab_function ([Nombre de la funcin]);
Ejemplo:
echo "<div style='color:".$config['color'].";'>Hola
Mundo</div>"; } function extension1_setup() {
$color = (string) $_POST['e1_color']; if
($color) {
update_config_token('color', $color); }
echo "<form>";
echo "
<input name='e1_color' type='text' value='$color'>";
echo "
<input
type='submit' name='upd_button' value='Actualizar'>";
echo "</form>"; }
extensions_add_side_menu_option ('Extensin 1', 'customers'); extensions_add_main_function
('extension1_main'); extensions_add_godmode_side_menu_option ('Configuracin de extensin 1');
extensions_add_godmode_function ('extension1_setup'); extensions_add_tab_option ('extension1',
'Extensin 1', "operation/incidents/incident_dashboard_detail",
"extension1/images/integria_mini_logo.png", "incident-details-view");
extensions_add_tab_function ('extension1_main'); ?>
Listas de pestaas disponibles
Pag 229
Por ahora, la nica lista de pestaas que puede contener extensiones es la lista
de pestaas principal de la vista de detalle de una incidencia, pero los lugares
irn amplindose en un futuro.
Vista en detalle de incidencia
Parmetros recibidos: id (ID de la incidencia).
Subseccin: operation/incidents/incident_dashboard_detail.
Id de la lista de pestaas: indicent-details-view.
Pag 230

Integria Asd IMS Guia Usuario ES

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Integria Asd IMS Guia Usuario ES

Uploaded by

Copyright:

Available Formats

Manual

Integria IMS 4.0 Manual de uso y administracin

GESTIONAR ROLES ................................................................................................................................................................. 52

DETALLE DE IMPUTACIONES DE HORAS ......................................................................................................................... 111

VISTA GENERAL .................................................................................................................................................................. 164

SISTEMA DE ALERTAS Y NOTIFICACIONES ...................................................................................................................... 206

CREANDO UNA EXTENSIN DE PREFERENCIAS .............................................................................................................. 228

Acerca de Integria IMS

Gestin de incidencias (ticketing).

Gestin de incidencias (Ticketing)

Permite definir roles y costes a cada rol e integra simultneamente la

Sistema de gestin de clientes (CRM)

Qu se necesita para instalar Integria IMS?

La instalacin la podremos hacer de forma manual a travs de las fuentes

Instalacin desde las fuentes

Debera disponer al menos de la herramienta tar para descomprimir el

Descarga de las fuentes

Conviene ejecutar este comando en el directorio de publicacin web

Y nos movemos al directorio de publicacin web (/srv/www/htdocs/ para Suse

Ahora debemos acceder via web a la direccion IP de su servidor para

Pulsamos en Siguiente, aceptamos la licencia y volvemos a pulsar siguiente:

En esta pantalla se verifica si todas las dependencias necesarias estn

Hemos completado la instalacin

Instalacin en un entorno de hosting WEB

NOTA: Algunos entornos de hosting no tienen compilado el mdulo IMAP de

Esto crear un directorio llamado "trunk" en el directorio actual. Se mueve a

Esto podra hacerse mediante el uso de la lnea de comandos de la CLI de

<It will ask your password>

mysql> use pandora; mysql> source integria_db.sql; mysql> source

Guarde el archivo o cambie el nombre a "include / config.php" y dele permisos

Instalacin mediante paquetes

Instalacin de Integria IMS mediante el paquete .DEB

Si no se dispone de conexin a Internet y se han dejado dependencias sin

Instalacin de Integria IMS mediante el paquete .RPM

Instalacin de Integria IMS en Windows

Para que WAMP funcione adecuadamente tiene que tener instalado el

Dentro de la configuracin del usuario root, en la parte de Cambio de

A continuacin, descargamos el .tar.gz de Integria desde sourceforge [5].

En el caso de haber instalado el servidor WAMP en otra ubicacin que no sea

A partir de este punto, al igual que en los dems sistemas, accederemos

Donde "ip_servidor" puede ser "localhost" si estamos en nuestra propia

En la siguiente pantalla se mostrarn las dependencias que estn

Una vez resuletas todas las dependencias, pinchamos en siguiente y en esta

Hacemos click en siguiente, y una vez finalizada la instalacin, ya podremos

Podemos acceder a Integria mediante el usuario admin y la contrasea por

Instalacin de la versin Enterprise

A continuacin tenemos que cambiar los permisos del directorio enterprise

Aceptamos la licencia y con esto ya tendramos Integria IMS instalado con la

Instalacin de la versin Enterprise en Windows

La instalacin de la versin enterprise sobre Windows la hacemos a partir del

Y aceptamos la licencia enterprise como se mostr en el apartado anterior, con

Instalacin de script de mantenimiento

Antes de continuar compruebe que funcione, ejecutando desde lnea de

El script no debera devolver nada.

Puede que en su sistema el intrprete php no se llame 'php5' sino 'php',

(Las rutas pueden cambiar en funcin de su version de WAMP)

Actualizacin con RPM

Actualizacin con DEB

Actualizacin con Tarball

Esto copia el contenido de todos los ficheros de cdigo, sobrescribiendo los

Usuario: Un usuario dentro de Integria es un usuario para entrar en la aplicacin va

Las dos caractersticas ms importantes de la versin Enterprise

diferentes perfiles en diferentes grupos (gestor de los incidentes para una