De Orfeo

El presente manual, es la recopilación de comentarios en la página de la comunidad, de personas de la comunidad que colaboraron, más todos los problemas e inquietudes solucionados durante la instalación parametrización y puesta en producción en la Empresa de Energia de Cundinamarca. Espero sea de su ayuda, cualquier colaboración extra es bienvenida.

Instructivo para la instalacion de Orfeo en CentOS con Oracle

1.Revisar instalación de orfeo en el manual de instalación. Tener cuidado con las variables que se deben cambiar en php.ini como el directorio para los archivos temporales.

register_globals = On
display_errors = Off
session.save_path = “/var/lib/php/session”
session.gc_maxlifetime = 0
session.cache_expire = 180
session.use_trans_sid = 1

2.Descargar carpeta

svn co http://orfeo.superservicios.gov.co:8033/repos/orfeo/branches/orfeo_3.6.0  /var/www/html/orfeo_3,6,0

3.Cambiar el archivo config.php con los valores de :

$servidor = "pion.eec.com.co";
$dirora= "/oracle1/product/817";
$db = $servicio;
$driver = "oci8";
//Variable que indica el ambiente de trabajo, sus valores pueden ser desarrollo,prueba,orfeo
$ambiente = "desarrollo";
//Servidor que procesa los documentos
$servProcDocs = "";
$entidad = "EEC";
$entidad_largo="EMPRESA DE ENERGIA DE CUNDINAMARCA S. A. -ESP.";
$ADODB_PATH="/var/www/html/orfeo_3.6.0/adodb493a";
//autenticacion por ldap
$ldapServer='ldap://fermion.eec.com.co';
$cadenaBusqLDAP = 'ou=People,dc=eec,dc=com,dc=co';
campoBusqLDAP = 'mail';
//Variables de oracle que deben ser enviadas, SOLO es necesario si se instala instant client
putenv("ORACLE_HOME=/usr/lib/oracle/10.2.0.3/client");
putenv("TNS_ADMIN=/usr/lib/oracle/10.2.0.3/client");
putenv("LD_LIBRARY_PATH=/usr/lib/oracle/10.2.0.3/client/lib");
putenv("ORACLE_SID=desa.eec.com.co");
putenv("TWO_TASK=desa");

4.Guardar el logo de la empresa en /png como logoEntidad.gif.

5.Crear la bodega en un espacio asignado por la empresa con usuario de apache del grupo de apache, por defecto nobody:nogroup. Dentro de la bodega se crean las siguientes carpetas.

bodega/prod
bodega/prod/masiva
bodega/prod/pdfs
bodega/prod/pdfs/guias
bodega/prod/pdfs/planillas
bodega/prod/pdfs/planillas/dev
bodega/prod/pdfs/planillas/envios
bodega/prod/tmp/workDir/cacheODT}
bodega/prod/año
bodega/prod/año/dependencia
bodega/prod/año/dependencia/docs

6.Cambiar los permisos de la bodega chmod 755 o 775.

7.Crear el enlace simbolico bodega -> espacio asignado, dentro de la carpeta de orfeo_3.6.0.

8.Si el servidor de la base de datos es diferente al servidor de Orfeo, se debe permitir el tráfico hacia él, es decir al puerto 1521 de Oracle en el servidor de DB. (Revisar ACL o firewall).

9.Crear plantillas para envios dependiendo de los tipos de radicados.

10.Si es necesario, modificar /menu/menuprimero.php ya que sale un acceso a Reporte CRA.Eliminar las lineas.

11.Cambiar solicitar/Reservar.php fldradicado por 'fldradicado' en las consultas SQL.

12.Crear al menos un proceso en el modulo de Flujos para poder generar los expedientes.

13.Instalar el explorador Mozilla Firefox, la herramienta OpenOffice y la fuente Cod3of9, en todos los computadores.

14.Para realizar la autenticación con LDAP, se deben agregar tres lineas en el config.php

alter table usuario add USUA_AUTH_LDAP numeric(1);

$ldapServer = 'ldap://ldap.superservicios.gov.co'; 
$cadenaBusqLDAP = 'ou=People, o=usuarios,o=superservicios.gov.co';
$campoBusqLDAP = 'mail';

En el archivo autenticaLDAP.php se debe cambiar la cadena de busqueda.

Instrucciones para descargar el Editor de Flujos

(tomado de la pagina de la comunidad)

Consta de

1.Módulo de administración de permiso para utilizar el Editor

Gráfico: Applet para creación de etapas y conexiones entre las etapas

Editor de flujos, con sus etapas y conexiones. 

Cambios en Base de datos

1.Agregar en la base de datos una columna a la tabla USUARIO llamada USUA_PERM_ADMINFLUJOS, debe ser numérica que solo admita 1 o 0.

2.Agregar en la base de datos una columna a la tabla SGD_PEXP_PROCEXPEDIENTES llamada SGD_PEXP_TIENEFLUJO, debe ser numérica que solo admita 1 o 0.

Archivos a descargar

1.Descargar los siguientes archivos de la Administración de usuarios, lo cuales agregan la posibilidad de administrar un permiso especial para habilitar o deshabilitar el módulo del editor de flujos por usuario. Gracias a este permiso un usuario administrador, puede editar cualquier usuario y agregarle o quitarle la posibilidad de utilizar el módulo, si se marca el checkbox denominado: "Puede utilizar el editor de Flujos" el módulo queda habilitado para dicho usuario. En base de datos queda un 1 si está habilitado, de lo contrario 0.

Los archivos que se deben descargar para la administración del permiso son:

a. Administracion/usuario/grabar.php b. Administracion/usuario/validar.php c. Administracion/usuario/traePermisos.php d. Administracion/usuario/acepPermisosModif.php

Descargar por SVN toda la carpeta Administracion/flujos, además:

a. Administracion/formAdministracion.php
b. imagenes/add.gif
c. imagenes/FlechasEntrada2b.gif
d. imagenes/FlechasSalida.gif
e. include/query/flujos/queryEtapas.php
f. include/query/flujos/queryAristas.php
g. include/tx/Proceso.php
h. menu/menuPrimero.php
i. include/query/Flujos/queryProceso.php
j. session_orfeo.php 

Cambios que se verán reflejados en ORFEO

1. Entrar como un usuario administrador y editar el Usuario al que se le quieran dar permisos para utilizar el Editor de Flujos. En la parte inferior, en la sección Permisos Especiales, hay una caja de texto llamada: "Puede utilizar el editor de Flujos", marcarla y el usuario quedará habilitado para utilizar el Editor.

Al ingresar como el usuario con el permiso, si el usuario no es administrador, aparece como primera opción en el menú principal de la izquierda un enlace denominado: "Editor Flujos".

Pasos para la utilización de la funcionalidad

Prerequisitos:

El usuario que vaya a utilizar el Editor de Flujos, debe tener instalada la máquina virtual de Java, con el respectivo plug-in en Firefox (si requieren información al respecto para su instalación en Linux, favor contactarme).

Los siguientes son los pasos generales de la utilización del editor.

1. Ingresar como el usuario que tenga permisos para utilizar el editor.

2. Hacer click en "Editor Flujos" en el menú principal de la izquierda.

3. Crear el Flujo con la estructura de las etapas y las conexiones (Aristas) entre dichas etapas, para ello, hacer click en "2. Crear Flujo"

4. Adicionar Etapas:

a. click derecho en el área de Dibujo y seleccionar "Adicionar Etapa"

b. En la ventanita que sale Editar el nombre de la Etapa, y si es necesario ingresar el término de la etapa en días, de lo contario el término puede ir vacío.

c. Click en Aceptar

d. Seguir el proceso sucesivamente hasta que se tengan todas las etapas deseadas 

e. Adicionar Conexiones:

f. Ubicar el cursor en el centro de la cajita de la etapa inicial, éste cambia a una mano, hacer clikc y arrastrar hasta la etapa final de la conexión.

g. Repetir el proceso hasta completar todas las conexiones. 

h. Crear proceso y guardar información del flujo

i. El último paso es crear el proceso y guardar la información del flujo, para ello:

j. Hacer click en el botoncito que tiene como icono el pinguinito de Orfeo que está al final de la barra de herramientas.

k. Ingresar la información solicitada:

    Usuario: es el login que utiliza el usuario para conectarse a Orfeo (USUA_LOGIN) debe ir en mayúsculas
    Nombre del Proceso: es el nombre que le van a poner al proceso
    Contraseña: Password del Usuario

Instructivo para la instalacion del Digitalizador

1.Pegar la carpeta scanbarras en C:/.

2.Instalar el Imagin Professional para Windows.

3.Instalar el Oracle Client 9i en c:/orant92 con nombre Orant92 y crear el DSN de usuario en Panel de Control/Herramientas administrativas/Origenes de ODBC con Nombre Orfeo y TNS= Instancia de oracle, para cada equipo que vaya a instalar el digitalizador. Si esto no funciona, pegar el archivo tnsnames.ora creado para este fin en C:/Orant92/network/admin.

4.Guardar el logo de la empresa como logoentidad.png en la carpeta raiz. Las dimensiones del logo no deben pasar de 169 x 63 px.

5.Cambiar SSPD por la sigla de la empresa en Form2.

6.Predeterminar la impresora de stickers en Panel de Control/Impresoras y Faxes, ya que orfeoSacan no permite seleccionarla.

7.Instalar el escaner, debe ser preferiblemente Kodak.

8.Cambiar el archivo de configuración conf.orf. Este archivo será leido por el digitalizador al iniciar la aplicación. Este archivo debe estar centralizado, ello porque todos los digitalizadores instalados leen los parametros que en él se encuentran. El archivo es plano y posee la siguiente estructura:

 a. Los campos estan delimitados por comas y cada variable está entre comillas dobles.
 b. El 1er campo es la contraseña encriptada del usuario con permiso de DBA en la BD de produccion de ORFEO.
 c. El 2o campo es el nivel de encriptación/desencriptación (key) del campo anterior referido. 
    Para la encriptación/desencriptación del campo anterior se utiliza la utilidad crypt.exe que se encuentra en la misma carpeta.
 d. El 3er campo es el usuario con permiso de DBA en la BD de producción de ORFEO.
 e. El 4o campo es la contraseña encriptada del usuario con permiso de lectura/escritura en la bodega de datos. 
    Cabe decir que este usuario subirá las imágenes digitalizadas a través de FTP a la carpeta anterior mencionada.
 f. El 5o campo es el nivel de encriptación/desencriptación del campo anterior referido. 
    Para la encriptación/desencriptación del campo anterior se utiliza la utilidad crypt.exe que se encuentra en la misma carpeta.
 g. El 6o campo es el usuario del Directorio Activo cuya contraseña está especificada en el punto 5. 
    Este usuario debe ser el  dueño de la bodega de datos y pertenecer al grupo apache.
 h. El 7o campo es la ruta virtual en donde se encuentra la base de las carpetas que componen la bodega de datos a través del FTP.
 i. El 8o campo es el nombre/IP de la maquina que contiene la bodega de datos.
 j. El 9o campo es la ruta en donde se encuentra la versión de producción de ORFEO.
 k. El 10o campo es el nombre completo de la entidad en donde se encuentra instalada ORFEO.
 l. El 11o campo es el acrónimo de la base de datos utilizada en la entidad. 
    Los valores válidos a 31-01-07 son   MSSQL/ORACLE/POSTGRES.

9.Pegar los archivos *.ocx para los controles de los gráficos en la carpeta raíz del scanbarras, estos archivos varían según el equipo: Imgedit.ocx, imgscan.ocx, imgadmin.ocx, imgthumb.ocx, msdatgrd.ocx, comdlg32.ocx.

10.Se debe configurar el tamaño del sticker por medio del software de la impresora.

11.Cambiar el archivo conf.ini de la siguiente forma:

 a.El primer parámetro es la carpeta en el cliente digitalizador (local) donde se van a guardar las imágenes escaneadas.
 b.El segundo parámetro es una cadena con el número y nombre de la dependencia de correspondencia.
 c.El tercer parámetro es la ruta (red / local) en la cual existe el archivo config.orf (contiene parámetros de
   Inicialización tales como usuario BD, ruta bodega servidor FTP de imágenes, enlace web de ORFEO producción, entre otros)

12.Crear dentro de la carpeta local donde se guardan las imágenes, carpetas con el código de las dependencias para el proceso de digitalización.

13.El antivirus macaffee bloquea la doble extension del ejecutable .jai.exe, esto se arregla cambiando el archivo a extension .exe