Índice

Objetivo

O objetivo deste guia é instruir os administradores de sistemas que desejam realizar a conversão do TOTVS ECM para a plataforma fluig.

Conversão para o fluig

Acompanhe a seguir as etapas e procedimentos necessários para a conversão do TOTVS ECM para o fluig. 

Cópia de Segurança

A fim de preservar os recursos e dados do TOTVS ECM caso ocorra algum erro durante o processo de conversão é importante realizar um cópia de segurança dos seguintes itens:

• Recursos utilizados no TOTVS ECM: como Fichários, Datasets customizados, Processos workflow, Eventos de fichários, Eventos de Processos, Eventos Globais, Serviços, Aplicativos, Parâmetros Gerais, Templates de e-mail, Mecanismos de Atribuição, e demais customizações utilizadas no TOTVS ECM. É importante exportar o máximo destes recursos, para melhor manipulação durante o processo de homologação após a conversão do TOTVS ECM para o fluig além de possibilitar a importação no fluig caso necessário posteriormente.

• Banco de dados: Importante possuir uma cópia de segurança do banco de dados para caso seja necessário a restauração do último estado válido da instalação do TOTVS ECM. Se desejar manter a instalação antiga é válido realizar a duplicação da base de dados de forma que o mesmo conteúdo assuma um novo nome. Por exemplo, a base de dados do TOTVS ECM, por padrão chama-se totvsecm, enquanto para o fluig são nomeadas como fluig.

• Volume: Caso deseje-se manter a instalação antiga do TOTVS ECM, após a conversão os volumes cadastrados no TOTVS ECM ainda serão utilizados. Com isto, os dados nos mesmos poderão sofrer mudanças na utilização do fluig, e este compartilhamento entre os dois sistemas pode causar conflitos e erros na utilização. Para evitar esta situação é necessária a cópia dos volumes para um novo local. A cópia de segurança dos volumes também é necessário para caso seja necessário a restauração do último estado válido da instalação do TOTVS ECM.

Antes da Conversão

Realize as cópias de segurança descritas no item anterior e caso uma nova base de dados for utilizada, restaure a cópia de segurança da base de dados sobre esta nova base.

Antes de realizar a conversão é necessário realizar alguns procedimentos:

1) Certifique-se de que o fluig será disponibilizado no mesmo endereço IP e porta HTTP/HTTPS que a versão atual do TOTVS ECM. Caso não for utilizar estes mesmos critérios de acesso inicie o serviço TOTVS ECM, para esta nova base de dados, se for o caso. Ao iniciar o serviço do TOTVS ECM, acesse o cadastro das empresas do TOTVS ECM e altere as configurações de acesso, sendo os campos Servidor Web e Porta Web, como ilustrado abaixo.

Parâmetros da Empresa no ECM.

2) Caso deseje alterar a localização dos volumes, é importante que a mudança seja feita antes da conversão. Para isso, acesse a aba Volumes e realize as alterações necessárias no caminho do diretório do volume.

Volume(s) de dados do TOTVS ECM.

3) O número de colaboradores cadastrados no TOTVS ECM não pode ser superior ao numero de usuários disponíveis na licença do fluig cadastrada no License Server.

4) Certifique-se que todos os colaboradores cadastrados no TOTVS ECM atendam os seguintes requisitos:

a) O colaborador não pode possuir login, e-mail ou matrícula duplicada;

b) A matrícula do colaborador deve possuir somente caracteres alfanuméricos, ponto (.), hífen ( - ) e traço inferior (_);

c) O login do colaborador deve possuir somente caracteres alfanuméricos, ponto (.), hífen ( - ) e traço inferior (_);

d) O nome do colaborador não pode ultrapassar o limite máximo de 255 caracteres;

e) O e-mail do colaborador deve ser um e-mail válido;

f) A senha do colaborador não pode ser em branco;

Caso algum dos colaboradores não atendam aos requisitos informados é necessário adequá-lo a estes requisitos;

5) Remova qualquer evento global ou outra customização que manipule a publicação de documentos ou outras funcionalidades do TOTVS ECM. Por exemplo: um evento global beforeDocumentPublisher que não permita publicar na pasta raiz;

6) Remova todos os agendamentos de tarefas cadastrados no TOTVS ECM;

7) Ao finalizar estes procedimentos, desconecte e pare o serviço do TOTVS ECM.

Após executados os procedimentos acima, pode ser realizada a instalação do fluig conforme instruções disponíveis no guia Instalação fluig (Instalador) - Windows ou  Instalação fluig (Instalador) - Linux.

Iniciando o fluig

Para o processo de migração, quando o fluig é inicializado sobre uma base de dados utilizada pelo TOTVS ECM, as estruturas das tabelas deste último permanecem da mesma forma. Entretanto, o fluig irá criar suas próprias tabelas, separadamente. 

Verifique os modos de inicialização abaixo e escolha aquele que deseja utilizar para iniciar o fluig:

HH:MM:SS,mmm INFO [com.fluig.startup.service.fluigStartupBean] (EJB default - x) ===============================================
HH:MM:SS,mmm INFO [com.fluig.startup.service.fluigStartupBean] (EJB default - x) == fluig is up and running right now. ==
HH:MM:SS,mmm INFO [com.fluig.startup.service.fluigStartupBean] (EJB default - x) ===============================================

<?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>

function createDataset(fields, constraints, sortFields) {
	var query = "SELECT login,email FROM fdn_usertenant LIMIT 100";
	var dataSource = "jdbc/FluigDSRO";       
	var newDataset = DatasetBuilder.newDataset();
	var ic = new javax.naming.InitialContext();
	var ds = ic.lookup(dataSource);
	
	try {
		var conn = ds.getConnection();
		var stmt = conn.createStatement();
		var rs = stmt.executeQuery(query);
		
		newDataset.addColumn("Login");
		newDataset.addColumn("Email");
		
		while (rs.next()) {
			newDataset.addRow([ rs.getString("login"), rs.getString("email") ]);
		}
		
	} catch(e) {
		newDataset.addColumn("erro");
		newDataset.addRow([e.message]);
	} finally {
		if(rs != null) rs.close();
		if(stmt != null) stmt.close();
		if(conn != null) conn.close();		
	}
	
	return newDataset;
}