Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

CONTEÚDO

  1. Visão Geral
  2. Cadastro de Entidade
  3. Cadastro de Template
  4. Cópia de Template
  5. Cópia de Coligada
  6. Anexos - Logs de Execuções do Template

01. VISÃO GERAL

Utilizando a funcionalidade de Cópia de Coligada 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. 

...

Veja a seguir os cadastros utilizados pelo sistema para utilizar a Cópia de ColigadaDados. 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. 

Image RemovedImage Added

03. CADASTRO DE TEMPLATE

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.

Image RemovedImage Added

Para criar um novo Template, após clicar em Novo, os seguintes campos devem ser informados:

Image RemovedImage Added

Descrição do Template: Informe um nome para identificação do template;

...

Aviso
titleImportante

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.

Aviso

O campo "Versão" só pode ser modificado pela TOTVS.

Aviso
titleIMPORTANTE

A partir da versão 12.1.2209

  • Adicionado o cálculo de CRC.
  • Adicionado no Atualizador do RM um script para gerar o CRC nos templates antigos.
  • A partir do Patch 151, controle de segurança e edição passou a ser realizado pelo Perfil de Segurança.


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 Coligadas 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.

...

Após incluir a entidade, é possível alterar algumas informações no próprio grid de listagem do template:

Image RemovedImage Added

Depois de criar o template, use o processo Cópia entre Coligada de dados descrito neste documento, para execução da cópia das entidades.

03.01 Regra de permissão para edição

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.

    • Template versionado não pode ser editado.
      Caso exista alguma informação no campo Versão o template será considerado como versionado e será impedido de ser alterado.
    • Cópia e importação de qualquer template, será editável.
      Para qualquer template, de qualquer usuário que for Copiado ou Importado, este novo template passará a ser de propriedade do usuário logado e será permitido editar.
    • A permissão de segurança deve sobrepor as demais.
      Caso o Perfil de Segurança esteja configurado com restrições de acesso, edição e etc, elas terão prioridade sobre as regras acima.

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.

03.02 Regra de exclusão de template

           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.

04. CADASTRO BASE EXTERNA

        É um cadastro onde é possível cadastrar uma base externa, para buscar dados de uma coligada diferente da base que está sendo utilizada.

Aviso
titleObservação

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.

       Image RemovedImage Added        

        Na tela de cadastro de base interna, temos os seguintes campos:

  • Usuário para Conexão: Usuário que realizara a conexão com a base externa
  • Alias da base externa: Seleção do alias que será utilizado (deve estar cadastrado no gerenciamento de alias)
  • Habilitar para buscar os dados de origem: Parâmetro utilizado para quando o usuário for buscar dados de origem dessa base externa, caso esteja desabilitado os dados serão buscados da base base local ou da base acelerado (depende de como o seu template está configurado).

       Image RemovedImage Added

        Quando marcado o a parâmetro "Habilitar para buscar os dados de origem" é possível visualizar em dois momentos que o mesmo está habilitado:

  • A primeiro momento é na tela de cadastro de template, quando selecionado o parâmetro "Buscar dados na base aceleradora o externa" é possível visualizar na tela que a base externa está ativa.

       Image RemovedImage Added


  • O segundo momento é na execução do processo de Cópia entre coligadasde dados, onde também existe uma mensagem informando: "Origem de Dados: base externa ativa".

       Image RemovedImage Added

Aviso
titleImportante

Quando utilizada a base externa como origem dos dados, é mostrado um novo campo "Coligada Origem" no processo de Cópia de cópia entre coligadasDados, que consiste na escolha de qual coligada será buscado os dados para a cópia, a marcação dele é obrigatória. 


0405CÓ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:

Image RemovedImage Added 

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.

...

06CÓPIA

...

DE DADOS

Para executar a cópia das entidades, selecione o template desejado, clique em Processos >> Cópia entre Coligadasde Dados.

Image RemovedImage Added

Depois, selecione a(s) Coligada(s) que receberão as cópias da Coligada corrente no contexto:

Image RemovedImage Added

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. 

...

Depois de executar o processo, veja o log da execução:

Image RemovedImage Added

Aba Execução:

Image RemovedImage Added

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.

...

07ANEXO - LOGS DE EXECUÇÕES DO TEMPLATE

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 ColigadasDados:

Image RemovedImage Added

Após executar este processo, será retornado no log de execução o ID do job que fará o reprocessamento. Exemplo:

Image RemovedImage Added

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):

...

Exemplo ao tentar reprocessar um job de status de sucesso:

Image RemovedImage Added

Exemplo ao tentar reprocessar uma cópia com 2 transações, onde a primeira foi executada com sucesso e a segunda com erro:

...