Instalar artefatos da migração

O arquivo instalacao_migrador.zip contém os artefatos mencionados nas etapas a seguir.

Descompacte o arquivo em uma pasta temporária e siga as instruções abaixo.

Criar o owner EMS506UNICOO através do script "1.0.1-create_owner_EMS506UNICOO.sql"

Owner que conterá as tabelas temporárias da migração de dados do módulo Financeiro do Unicoo para o EMS5 (cliente, fornecedor, títulos, etc).

Nesse momento deve ser decidido pelo cliente se a instalação ocorrerá na mesma instância do Unicoo ou na mesma instância do TOTVS12, e providenciados os DBLinks correspondentes. Exemplo de criação de DBLINK no arquivo "1.0.4-exemplo_criacao_DBLINK.sql".

O script cria o owner e concede os grants necessários.

Copiar os artefatos da pasta "1.0.4-Schema Holder" para a mesma pasta dos bancos de dados Progress na instalação do TOTVS12 (normalmente c:\totvs\datasul\dts-0\erp\database-8080\):

1. Shunimed.b1
2. Shunimed.d1
3. Shunimed.db
4. datasul.st

Executar os scripts para Reparar e Truncar os bancos de dados (pasta ...\database-8080\scripts):

1. ReparaBancos.bat
2. TruncaBancos.bat

(Obs: esses arquivos não fazem parte desse pacote. Já existem na instalação padrão do TOTVS12).

Criar atalho de Editor Progress para o Migrador.

Modelo na pasta "1.5-Editor (modelo)"

Exemplo da linha a ser adicionada no .pf (tomar como base a linha já existente para o EMSFND):

-db \\<servidor>\ERP\database-8180\shunimed   -RO -ld shunimed -db unimed     -ld unimed    -U ems506unicoo/ems506unicoo@HOMOLOGA -c 10000

Obs: trocar "HOMOLOGA" pela referência à instância do Oracle que está sendo utilizada.

Mesmo raciocínio do item anterior. À partir dessa ação torna-se possível acessar as tabelas do owner EMS506UNICOO à partir de uma sessão Progress.

Exemplo no anexo "BCO_EMPRES.png" da pasta 1.4-Anexos.
O teste do Schema Holder somente poderá ser realizado após a criação da camada Oracle (a seguir).

Criar a PCK que contém as tabelas e procedures do EMS506UNICOO através do script "EMS506UNICOO_INSTALACAO.sql" que se encontra na pasta "1.0.4-EMS506UNICOO".

Atenção antes de iniciar essa etapa:

1. Conectar ao owner EMS506UNICOO antes de prosseguir;

2. Garantir que o DBLINK esteja criado no Oracle com o mesmo nome que está setado dentro do arquivo 1.0.4-EMS506UNICOO.SQL (talvez você precise editar o script antes de importá-lo).

No exemplo:

"create or replace synonym ABRANGENCIA
  for PRODUCAO.ABRANGENCIA@DBLINK;"

Substituir em todo o arquivo a expressão "@DBLINK" por "@" + nome do DBLINK criado pelo cliente. Caso esteja sendo utilizada uma instância única de Oracle, então não será usado DBLINK. nesse caso, retirar "@DBLINK", ficando assim: "...PRODUCAO.ABRANGENCIA;"

Utilizar uma "Command Window" do PL/SQL.

Obs: essa etapa criará as tabelas e a versão inicial da PCK.

Os arquivos seguem a nomenclatura EMS506UNICOO_ATUALIZACAO_VXX, onde XX representa o número da versão.

Não é necessário atualizar um a um. Deve ser considerado apenas o mais atual.

Obs: a atualização contém apenas os programas, sem criação de tabelas.

Como atualizar: executar o código do arquivo na aba "Editor" de uma "Command Window" do PL/SQL.

Importar as tabelas e procedures das PCKs PCK_UNICOOGPS e PCK_MIGRACAO_TXT_GP através do script "2.0.2.2-PCK_UNICOOGPS.sql"

Atenção antes de iniciar essa etapa:

1. Conectar ao owner UNICOOGPS antes de prosseguir;

2. Garantir que o DBLINK esteja criado no Oracle com o mesmo nome que está setado dentro do arquivo UNICOOGPS.SQL.

No exemplo:
"create or replace synonym ABRANGENCIA
  for PRODUCAO.ABRANGENCIA@DBLINK;"
Substituir em todo o arquivo a expressão "@DBLINK" por "@" + nome do DBLINK criado pelo cliente. Caso esteja sendo utilizada uma instância única de Oracle, então não será usado DBLINK. nesse caso, retirar "@DBLINK", ficando assim: "...PRODUCAO.ABRANGENCIA;"

Obs: essa etapa criará as tabelas e a versão inicial da PCK.

Os arquivos seguem a nomenclatura UNICOOGPS_ATUALIZACAO_VXX, onde XX representa o número da versão.

Não é necessário atualizar um a um. Deve ser considerado apenas o mais atual.

Utilizar uma "Command Window" do PL/SQL.

Obs: a atualização contém apenas os programas, sem criação de tabelas.

Como atualizar: executar o código do arquivo na aba "Editor" de uma "Command Window" do PL/SQL.

Os arquivos seguem a nomenclatura MIGRACAO_TXT_GP_VXX, onde XX representa o número da versão.

Não é necessário atualizar um a um. Deve ser considerado apenas o mais atual.

Utilizar uma "Command Window" do PL/SQL.

Obs: a atualização contém apenas os programas, sem criação de tabelas.

Se já existir layout 9151 na tabela REM_ARQUIVO (do Unicoo), alterar esse código nos scripts "2.0.3-Geracao.sql" e "2.0.4-rem_campo.sql" antes de processá-los.

Da mesma forma, alterar o código caso já exista REM_DESTINATARIO com código 3000; REM_GRUPO_INFORMACAO com código 'MG';

A tarefa anterior cria um layout com a instrução 'select * from v_migracao_prestador'.

Visto que essa VIEW não existe no Unicoo, e sim no owner UNICOOGPS, deve ser criado DBLINK e SYNONYM correspondentes no Unicoo, para que a view do UNICOOGPS fique acessível.

Exemplo:

-- Create database link:
create public database link TOTVS_PRODUCAO
connect to UNICOOGPS identified by unicoogps
using '(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST = 10.102.0.200)(PORT = 1521))
)
(CONNECT_DATA =
(SERVICE_NAME = totvsgp)
)
)';

-- Create synonym:
create or replace synonym v_migracao_prestador for unicoogps.v_migracao_prestador@TOTVS_PRODUCAO

Entrar na pasta "Progress" e copiar a pasta "migracao" para o mesmo local onde está instalado o TOTVS (mesmo nível onde se encontram as pastas dos produtos gp, ems2, ems5, hcm, fnd, etc). Pela instalação padrão, a pasta se chama ERP.

Obs: Além dos programas Progress, essa pasta possui subpastas, com scripts que serão utilizados em etapa posterior, durante a migração do Financeiro e GPS:

Scripts de execução manual:

_scripts_migracao_ems5

_scripts_migracao_gps

Scripts consumidos automaticamente pelo Jenkins (explicado mais abaixo):

_scripts_migracao_ems5_JK

_scripts_migracao_gps_JK

O arquivo possui variáveis de ambiente que precisam ser configuradas conforme o editor criado no item 2.3:

PROWIN32 - caminho onde se encontra o prowin32.exe na máquina que executará os processos Progress na migração;

PF - caminho onde se encontra o arquivo.pf de conexão aos bancos de dados;

INI - caminho onde se encontra o arquivo.ini. Atenção para adicionar a pasta "migracao"ao início do PROPATH;

CLIENTLOG_CONF - parâmetros de configuração para o CLIENTLOG;

USUARIO - login a ser utilizado nos processos que exigem autenticacao (importação de Clientes, Fornecedores, Títulos, etc);

SENHA - senha do USUARIO;