Utilizando a funcionalidade de Cópia de Dados é possível copiar parâmetros e entidades entre Coligadas. Pode ser utilizado tanto para a primeira configuração de uma nova Coligada ou para replicar dados entre Coligadas existentes.
É possível criar templates determinando quais entidades do sistema devem ser copiadas.
Veja a seguir os cadastros utilizados pelo sistema para utilizar a Cópia de Dados. Menu disponível em: Serviços Globais > Administração > Cópia de Dados.
Obs.: Em versões anteriores, o menu de Cópia de Dados era apresentado como 'Cópia de Coligada.'
02. CADASTRO DE ENTIDADE
O cadastro de entidade representa os vários cadastros que o sistema tem e que pode ser copiado. As entidades são disponibilizadas pela Totvs RM.
Alguns templates são disponibilizados pela Totvs RM. Também é permitido criar novos templates de acordo com a sua necessidade. Não é permitido alterar/excluir templates padrão do sistema, mas ele pode ser clonado e editado, conforme descrito no passo 04. Cópia de Template.
Para criar um novo Template, após clicar em Novo, os seguintes campos devem ser informados:
Descrição do Template: Informe um nome para identificação do template;
Buscar dados na base aceleradora o externa:
Existe um parâmetro no cadastro de base externa "Habilitar para buscar os dados de origem" que é responsável pela habilitação automática da utilização da base externa quando o usuário marcar o parâmetro "Buscar dados na base aceleradora o externa". |
Versão: Campo para inserir a versão do objeto. Exemplo: Se a liberação se dará na versão 12.1.2209, deve se informar 12.1.
O campo "Versão" só pode ser modificado pela TOTVS. |
A partir da versão 12.1.2209
|
Selecione a entidade para associar ao template: Selecione a entidade que será copiada entre uma Coligada e outra. Estarão disponíveis para cópia as entidades do tópico 'Cadastro de Entidade' deste documento. Neste exemplo vamos realizar a cópia das Fórmulas.
Ordem Execução: É possível configurar a ordem de execução de cada entidade adicionada ao template; Representa a ordem que cada entidade será copiada (primeira, segunda...). Por padrão todas são adicionas com Ordem de Execução = 1.
Transação: Se o ambiente estiver configurado para executar o job de Cópia de Dados de forma fracionada, leia mais em: Segurança de Jobs Fracionáveis, a transação pode ser informada para separar um conjunto de cópias dentro de uma transação. Para cada transação será gerada um job no job fracionado, por isso os conjuntos de cópias precisam ser independentes umas das outras.
Ex.: Entidade Cópia de Fórmulas com transação = 1 e entidade Relatórios com transação = 2 no mesmo template.
Ao executar a cópia com o fracionamento de jobs, a cópia de fórmulas será feita na primeira transação (job) do fracionamento e a cópia de relatórios na segunda.
Iniciando execução do job principal - com fracionamento Onde o job 102830-1 foi a execução de cópia das fórmulas e o job 102831-1 foi a execução de cópia do relatório. |
Cada template é representado por um job, quando um processo for executado com erro dentro de um template, todos os outros processos (pertencentes a esse mesmo template) que foram executados com sucesso, serão feitos rollback, ou seja, o template (Job) será mostrado como "Erro na execução" (como mostra o "Exemplo de log" no expandir acima).
Caso haja outros templates separados que não deram erros, o fluxo correto é que eles sejam executados normalmente (com sucesso).
Após a correção do erro detectado na execução do processo, o usuário poderá executar normalmente o processo, pois quando executado só será considerado a execução daquele template que ocorreu o erro, desconsiderando os que já foram executados com sucesso.
Filtro para buscar os registros: Podem ser criados filtros nos registros de cada uma entidade. O cadastro de filtro é similar ao cadastro das demais telas do sistema. Saiba mais em: Filtros da Visão e Utilização de Filtros. Se nenhum filtro for cadastrado, todos dados serão copiados.
Cópia Obrigatória: Quando esse campo está marcado no template de origem, ao criar uma cópia desse template outros usuários não poderão excluir essa entidade.
Incluir Selecionada: Inclui a nova entidade selecionada em 'Parâmetros do template' no template aberto.
Incluir Todas: Essa opção inclui todas as entidades cadastradas no sistema no template aberto.
Após incluir a entidade, é possível alterar algumas informações no próprio grid de listagem do template:
Depois de criar o template, use o processo Cópia de dados descrito neste documento, para execução da cópia das entidades.
A partir da versão 12.1.2209 Patch 151, houve uma alteração para adequar a permissão de edição de um template para seguir o mesmo padrão dos objetos gerenciais.
O controle de segurança e edição passou a ser realizado pelo Perfil de Segurança.
Caso seja usado o argumento #objetos_gerenciais
Os templates versionados serão possíveis de editar e o campo de versão estará liberado.
A permissão de segurança deve sobrepor as demais, exatamente como descrito mais acima.
Como dentro dessa funcionalidade existem regras específicas com relação aos templates, a sua exclusão deve ser feita sempre pelo processo Exclusão de Template, no menu processos.
É um cadastro onde é possível cadastrar uma base externa, para buscar dados de uma coligada diferente da base que está sendo utilizada.
Ao realizar a comunicação com a base externa, é necessário que o usuário que fará a conexão esteja vinculado a um código de acesso que tenha permissão na base de dados de origem. |
Na tela de cadastro de base interna, temos os seguintes campos:
Quando marcado o a parâmetro "Habilitar para buscar os dados de origem" é possível visualizar em dois momentos que o mesmo está habilitado:
Quando utilizada a base externa como origem dos dados, é mostrado um novo campo "Coligada Origem" no processo de Cópia de Dados, que consiste na escolha de qual coligada será buscado os dados para a cópia, a marcação dele é obrigatória.
|
05. CÓPIA DE TEMPLATE
Para facilitar a criação de templates semelhantes, é possível duplicar um template existente. Para editar um template padrão é necessário criar uma cópia para customizá-la.
Basta selecionar o template desejado, menu Processos > Cópia de templates:
A ordem de execução, transação e cópias obrigatórias não podem ser alteradas em um template copiado por um usuário diferente de quem criou o template.
Para executar a cópia das entidades, selecione o template desejado, clique em Processos >> Cópia de Dados.
Depois, selecione a(s) Coligada(s) que receberão as cópias da Coligada corrente no contexto:
Marque a opção 'Substitui registros no destino se eles já existirem' se for desejado que os dados copiados prevaleçam sobre os dados já existentes na Coligada.
Observação: Algumas entidades não podem sobrescrever os dados de mesma chave, mesmo com o parâmetro habilitado, como por exemplo, na entidade de Relatórios. Caso isso ocorra, o processo pode retornar erro de índice existente.
Depois de executar o processo, veja o log da execução:
Aba Execução:
Após a execução, todas as Fórmulas da Coligada 1 foram copiadas para a Coligada 6. No Log de execução é possível identificar se o registro foi incluído, atualizado ou não alterado (se já existir na Coligada destino e não foi marcado para substituí-lo).
Observação: Esse job deve ter permissão de fracionamento de jobs em ambientes 3 camadas. Veja mais sobre Segurança de Jobs Fracionáveis.
Para visualizar o histórico de execução dos templates, acesse Anexos > Logs de execuções do template:
No anexo é possível consultar se a cópia foi realizada com sucesso ou falha. É possível reexecutar o processo pelo menu Processos > Reprocessamento de Cópia de Dados:
Após executar este processo, será retornado no log de execução o ID do job que fará o reprocessamento. Exemplo:
O status desse novo job pode ser consultado na própria tela de Anexo, ou na tela de Gerenciamento de Jobs (Configuração do Jobserver na Linha RM):
O reprocessamento de Cópia irá executar apenas a parte da Cópia que retornou erro e não executadas dentro de um conjunto de cópias , como uma nova tentativa de sucesso, caso algum ajuste na base tenha sido feito. Os conjuntos de cópias executados com sucesso na execução original não é reprocessado, pois os dados já foram salvos, visto que os conjuntos de cópias são independentes.
Exemplo ao tentar reprocessar um job de status de sucesso:
Exemplo ao tentar reprocessar uma cópia com 2 transações, onde a primeira foi executada com sucesso e a segunda com erro:
Apenas a cópia com erro foi reprocessada.
