Índice

Objetivo

El objetivo de este guía es instruir a los administradores de sistemas que desean realizar la conversión del TOTVS ECM para la plataforma Fluig.

Conversión para el Fluig

Siga a continuación las etapas y procedimientos necesarios para la conversión del TOTVS ECM para el Fluig.

Copia de Seguridad

Antes de la Conversión

Realice las copias de seguridad descritas en el ítem anterior y en el caso que se utilice una nueva base de datos, restaure la copia de seguridad de la base de datos sobre esta nueva base.

Antes de realizar la conversión es necesario realizar algunos procedimientos:

1. Asegúrese de que el Fluig responderá en la misma dirección IP y puerta HTTP/HTTPS que la versión actual del TOTVS ECM. En el caso que no se utilicen estos mismos criterios de acceso, inicie el servicio TOTVS ECM, para esta nueva base de datos, en su caso. Al iniciar el servicio del TOTVS ECM, acceda el registro de las empresas del TOTVS ECM y modifique las configuraciones de acceso, siendo los campos Servidor Web y Puerta Web, como ilustra en la figura 1.
   

   
   

   Figura 1 - Parámetros de la Empresa en el ECM.

   
   

2. En el caso que desee modificar la ubicación de los volúmenes, es importante que realice la acción antes de la conversión, para esto acceda la pestaña Volúmenes, y realice las modificaciones necesarias.
   

   

   Figura 2 - Volume(s) de dados do TOTVS ECM.

   
   

3. El número de colaboradores registrados en el TOTVS ECM no puede ser superior al número de usuarios disponibles en el License Service.
4. Asegúrese de que todos los colaboradores registrados en el TOTVS ECM atiendan los siguientes requisitos:
   
   1. El colaborador no puede poseer login, e-mail o matrícula duplicada;
   2. El login del colaborador debe poseer solamente caracteres alfanuméricos, punto (.), guión ( - ) y guión bajo (_);
   3. El nombre del colaborador no puede exceder el límite máximo de 255 caracteres;
   4. El e-mail del colaborador debe ser un e-mail válido;
   5. La contraseña del colaborador no puede ser en blanco.
   En el caso que alguno de los colaboradores no atiendan los requisitos informados es necesario adecuar el mismo a estos requisitos;
5. Elimine cualquier evento global u otra personalización que manipule la publicación de documentos u otras funcionalidades del TOTVS ECM. Por ejemplo: un evento global beforeDocumentPublisher que no deje publicar en la carpeta raíz;

6. Elimine todas las programaciones de tareas registradas en el TOTVS ECM.

Al finalizar estos procedimientos, desconecte y pare el servicio del TOTVS ECM.

A partir de eso, se puede realizar la instalación del fluig conforme a instrucciones disponibles en la guía Instalación Fluig (Instalador) - Windows o  Instalación Fluig (Instalador) - Linux.

Iniciando el Fluig

Para el proceso de migración, cuando el Fluig se inicializa sobre una base de datos utilizada por el TOTVS ECM las estructuras de las tablas de este último permanecen de la misma forma. Sin embargo, el Fluig creará sus tablas, separadamente.

Verifique los modos de inicialización a seguir y elija aquel que desea utilizar para iniciar el Fluig:

Conversión

En este momento, se puede iniciar el proceso de conversión.

Esté atento a los pasos a seguir para iniciar la conversión:

1. Después de inicializar el Fluig es necesario realizar login utilizando el usuario wcmadmin y contraseña adm;
2. Después de realizar el login, acceder el ítem de menú Panel de control y activar la pestaña ECM, en esta pestaña acceder la opción Conversor de Base;
3. Con eso, se realizará una validación de la base para verificar si la conversión se puede iniciar. La Figura 4 ilustra ese proceso;
   
   

   

   Figura 4 - Proceso de conversión de la base ECM para Fluig.

   
   

4. En el caso que no se encuentren inconformidades, se debe hacer clic en Convertir;
5. Al hacer clic en Convertir se exhibe un mensaje, conforme a la Figura 5, indicando el inicio de la conversión;
   
   

   

   Figura 5 - Proceso de conversión Iniciado.
   
   

6. Para seguir el proceso de conversión se debe acceder el archivo <<FLUIG_HOME_PATH>>\jboss\standalone\log\conversion.log;
7. ¡La frase "Conversión finalizada con éxito!!!" presentada al final del archivo de log, indica el término del proceso de conversión;
8. A partir de este momento es posible conectar en el Fluig con los usuarios y contraseñas que existían en el TOTVS ECM. Para administrar empresas se utiliza el usuario wcmadmin, y no más el usuario wdkAdmin.
   
   

Figura 6 - Pantalla de login Fluig.

Posconversión o migración

Cuando un proceso de conversión se realiza, algunos procedimiento son necesarios para que los servicios del Fluig puedan presentar sus funcionalidades correctamente. Se recomiendan los siguientes pasos:

1. Indexación del(de los) Volumen(es).
2. Actualización de los servicios de datos del TOTVS ECM. Esto es la modificación de estos servicios para que se recreen los stubs, en el caso de modificación de las URLs de los webservices utilizados.

3. Para la migración y donde el TOTVS ECM se integraba al TOTVS EMS/HCM, se debe verificar si en la carpeta <<FLUIG_HOME_PATH>>\jboss\modules\com, existen los directorios progress\main con las bibliotecas (JAR) del respectivo Progress.

   Atención

   Esto no es el JAR, generado por el ProxyGen (Proxy Generator), son las bibliotecas del antiguo Ambiente registrado en el TOTVS ECM. Este procedimiento es necesario, pues en esta version del producto no existe más dicho registro de ambientes e indicación de las bibliotecas. El JBoss AS 7, requiere que el acceso a estas clases JAVA comunes del Progress se inicialicen como un módulo del JBoss.

   Dentro de esta carpeta junto a las bibliotecas debe existir un archivo “module.xml”. En su contenido todas estas bibliotecas se deben relacionar. Recordando que el archivo se debe guardar con la codificación UTF-8 (sin BOM). El archivo sigue el modelo:

   <?xml version="1.0" encoding="UTF-8"?>
   <module xmlns="urn:jboss:module:1.1" name="com.progress">
      <properties>
           <property name="jboss.api" value="private"/>
      </properties>               
   
      <resources>
           <resource-root path="o4glrt.jar"/>
           <resource-root path="common.jar"/>
           <resource-root path="commonj.sdo.jar"/>
           <resource-root path="ecore.change.jar"/>
           <resource-root path="ecore.jar"/>
           <resource-root path="ecore.resources.jar"/>
           <resource-root path="ecore.sdo.jar"/>
           <resource-root path="ecore.xmi.jar"/>
           <resource-root path="openedge.jar"/>
           <resource-root path="progress.jar"/>
      </resources>
   </module>

   Observación

   Después de realizar esta configuración es obligatoria la reinicialización del Fluig para que estas bibliotecas se carguen en el classpath del JBoss AS 7. Hasta que esto se realice, las operaciones devolverán un error como: JavaException: java.lang.ClassNotFoundException: com.progress.open4gl.ProDataGraphHolder. U otra clase en el intento de crear un objeto dentro del packagecom.progress.*.

   Tratamiento alternativo

   Una forma de posibilitar la utilización de estas clases por el proxy generado es incluir el contenido de estas bibliotecas dentro del paquete de este proxy, es decir, los archivos del tipo y extensión JAR son archivos compactados como los del tipo ZIP, cada una de estas bibliotecas se puede abrir a través de su aplicación de compactación de archivos preferido (WinZIP, WinRAR, 7-ZIP, entre otros) y su contenido copiado para dentro del archivo JAR del proxy. Solamente las carpetas y su contenido “META-INF” se deben ignorar, no copiar.

4. Agregue nuevamente los eventos globales u otras personalizaciones que se eliminen antes de iniciar la conversión;
5. Registre nuevamente las programaciones de tareas eliminados antes de iniciar la conversión, en el caso que los mismos aun sean necesarios;
6. Si, al acceder el Fluig, ocurre el direccionamiento para la dirección <host>:<porta> que eran del TOTVS ECM, eso significa que no se modificó la dirección de acceso antes de la conversión (conforme se menciona en la sesión Antes de la Conversión) y por lo tanto será necesario modificar la dirección de acceso en el Fluig, entrando como wcmadmin y yendo hasta la guía Panel de Control, pestaña WCM, ítem Configuraciones del Sistema.