Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: FFDN-7801

...

Nota
titleImportante

Para que o processo de conversão seja realizado com sucesso, é necessário que o TOTVS ECM esteja na versão mais atual dos pacotes de atualização, disponível no Portal de Clientes. Caso o ambiente esteja desatualizado é recomendado realizar a atualização e posteriormente prosseguir com as etapas para conversão.

...

Volume(s) de dados do TOTVS ECM.

4) Confira a quantidade de colaborações ativos no TOTVS ECM. 

Nota
titleImportante!

O número de colaboradores ativos no TOTVS ECM não pode ser superior

...

ao número de usuários disponíveis na licença do Fluig cadastrada no License Server. Se o número de usuários no ECM for maior do que as licenças adquiridas para a plataforma Fluig, será necessário desativar os usuários no ECM primeiro, via tela. Se necessário, pode ser utilizado o recurso de Transferir pendências, para os usuários que são responsáveis por algum processo/documento.

Para entender melhor como funciona o licenciamento da plataforma, consulte essa documentação.

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

...

Aviso
titleImportante

A conversão somente pode ser realizada até a atualização 1.5.13 (última EP) do Fluig, para posteriormente aplicar a atualização mais recente da plataforma.

É possível fazer o download do instalador através do nosso portal Suporte fluig, dentro da Central de Downloads, clicando aqui.

Caso o banco de dados do TOTVS ECM seja Microsoft SQL Server com agrupamento de caracteres (collation) diferente do padrão do Fluig "Latin1_General_CI_AS", será necessário seguir os procedimentos descritos em Migração e Conversão de Collation (SQL Server).

...


Sobre a reinicialização do serviço


No caso de uma nova inicialização do serviço ou falhas na reinicialização, pode ser necessário encerrar os processos do OpenOffice.org.

  1. Clique com o botão direito sobre a barra de tarefas do Windows e selecione a opção Iniciar o Gerenciador de tarefas (ou use o atalho do teclado CTRL + SHIFT + ESC).
  2. Localize na coluna "Nome da Imagem" os processos soffice.bin. Confirme que tratam-se dos processos referentes ao Fluig através da coluna "Nome do Caminho da Imagem", que exibe o diretório de origem do processo.
  3. Caso afirmativo, selecione os processos e clique sobre o botão Finalizar Processo no canto inferior da janela para encerrá-los.

Processo soffice.bin*32 em execução no Gerenciador de Tarefas


Conversão


Nota
titleImportante
  • Este é um processo irreversível, pois o Fluig irá realizar a leitura das tabelas do TOTVS ECM e transportar seus dados para as respectivas tabelas do Fluig. Algumas tabelas do TOTVS ECM serão excluídas neste processo de conversão.
  • Durante o processo podem ocorrer falhas que comprometam a base de dados. Caso isto aconteça, utilize a cópia de segurança criada anteriormente para restaurar a base de dados.
  • Os documentos do tipo Portal e PortalPage não serão convertidos. Sua conversão deverá ser realizada manualmente, ou seja, será necessário criar as páginas manualmente no Fluig, através do item Minhas páginas presente na guia Painel de Controle, aba WCM.

Acompanhe os passos a seguir para iniciar a conversão:

1) Após inicializar o Fluig, é necessário realizar login utilizando o usuário wcmadmin e senha adm;

2) Depois de feito o login, acessar o item de menu Painel de controle e acionar a aba ECM. Nesta aba, acessar a opção Conversor de Base;

3) Com isto, será realizada uma validação da base para verificar se a conversão pode ser iniciada;

Processo de conversão da base TOTVS ECM para Fluig.

4) Caso não sejam encontradas inconformidades, deve-se clicar em Converter;

5) Ao clicar em Converter é exibida uma mensagem indicando o inicio da conversão;

Processo de conversão Iniciado.

6) Para acompanhar o processo de conversão, deve ser acessado o arquivo [Instalação_fluig]\jboss\standalone\log\conversion.log;

7) A frase "Conversão finalizada com sucesso!!!" apresentada no final do arquivo de log indica o término do processo de conversão;

8) Neste momento é necessário reiniciar o serviço Fluig, para que os updates de banco de dados sejam efetuados. Isto acontece pois o processo de conversão adiciona novas estruturas de banco de dados, bem como alterando e eliminando algumas pré-existentes.

9) A partir deste momento é possível acessar o Fluig com os usuários e senhas que existiam no TOTVS ECM. Para gerenciar empresas é utilizado o usuário wcmadmin, e não mais o usuário wdkAdmin.

Tela de login do Fluig.


Pós-conversão ou migração


Quando um processo de conversão é realizado, alguns procedimentos são necessários para que os serviços do Fluig possam executar suas atividades corretamente. São recomendados os seguintes passos:

  • Indexação do(s) Volume(s).
  • Atualização dos serviços de dados do TOTVS ECM. Isto é, a modificação destes serviços para que sejam recriados os stubs, no caso de alteração das URLs dos Web Services utilizados.
  • Para migrações em que o TOTVS ECM era integrado ao TOTVS EMS/HCM, deve ser verificado se na pasta [Instalação_fluig]\jboss\modules\com, encontram-se os diretórios progress\main com as bibliotecas (JAR) do respectivo Progress.

Nota
titleAtenção

As bibliotecas citadas acima não correspondem ao JAR gerado pelo ProxyGen (Proxy Generator), mas sim às bibliotecas do antigo ambiente cadastrado no TOTVS ECM. Este procedimento é necessário, pois nesta versão do produto não existe mais tal cadastro de ambientes e indicação das bibliotecas. O servidor de aplicação requer que estas classes Java comuns do Progress sejam inicializadas como um módulo do servidor de aplicação.

Dentro desta pasta, junto às bibliotecas, deve existir um arquivo chamado "module.xml". Todas estas bibliotecas devem ser relacionadas em seu conteúdo. Lembrando que o arquivo deve ser salvo com a codificação UTF-8 (sem BOM).

Bloco de código
languagexml
titleModelo do arquivo module.xml
<?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>
Nota
titleAlerta

Depois de realizada esta configuração é obrigatória a reinicialização do Fluig para que estas bibliotecas sejam carregadas no classpath do servidor de aplicação. Até que isto seja realizado, as operações irão retornar um erro como "JavaException: java.lang.ClassNotFoundException: com.progress.open4gl.ProDataGraphHolder" ou outra classe, na tentativa de criar um objeto dentro do packagecom.progress.*.

Informações
titleTratamento alternativo

Uma forma de permitir a utilização destas classes pelo proxy gerado é incluir o conteúdo destas bibliotecas dentro do pacote deste proxy, isto é, os arquivos do tipo e extensão JAR são arquivos compactados como os do tipo ZIP. Cada uma destas bibliotecas pode ser aberta por seu aplicativo de compactação de arquivos preferido (WinZIP, WinRAR, 7-ZIP, dentre outros) e seu conteúdo copiado para dentro do arquivo JAR do proxy. Somente as pastas e seu conteúdo “META-INF” devem ser ignoradas, não copiadas.


  • Adicione novamente os eventos globais ou outras customizações que foram removidas antes de iniciar a conversão;
  • Cadastre novamente os agendamentos de tarefas removidos antes de iniciar a conversão, caso os mesmos ainda sejam necessários;
  • Gere as imagens dos diagramas de processo, acessando o Painel de Controle da cada empresa, aba Processos → Gerador de imagem de processo;
  • Se ao acessar o Fluig, ocorrer o direcionamento para o [endereço]:[porta] que eram do TOTVS ECM, isso significa que não foi alterado o endereço de acesso antes da conversão (conforme mencionado na sessão Pré-requisitos) e portanto será necessário alterá-lo no Fluig. Para isso, acesse com o usuário wcmadmin e navegue para o Painel de Controle, aba WCM, item Configurações do Sistema.
  • Em alguns desenvolvimentos no ECM utilizava-se jdbc/webdeskDS para conexão com o banco de dados. Para o correto funcionamento no Fluig, é necessário utilizar jdbc/FluigDSRO, ou seja, desenvolvimentos que estão no formato antigo devem ser atualizados. Abaixo é exibido um exemplo de utilização em dataset desenvolvido sobre a plataforma.
Bloco de código
languagejavascript
themeEclipse
firstline1
linenumberstrue
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;
}
Aviso
titleImportante

Após concluir a conversão, é fundamental atualizar "É necessário atualizar o sistema para última liberação da versão 1.6.5 para que não ocorra inconsistências de dados e arquivos e depois atualizar para a plataforma para a release mais recente. Seus processos e formulários também precisam revistos e de preferência, adaptados para os padrões do fluig Style Guide.

Dica
titleFique atento!

Confira as atualizações já liberadas e as datas futuras de liberações do Fluig acessando a página de Atualização Fluig. Veja as novidades de cada atualização acessando a página de Release Notes.