Índice

       

Objetivo

Orientar o usuário quanto à instalação do Executor de Scripts e execução de scripts customizados da linha TOTVS RM.

Utilizando o Executor de scripts customizados


Formas de Acesso

Através do Executor de Scripts Customizados é possível executar scripts na base de dados da linha TOTVS RM, acessando-o de duas formas:

Externa

  1. Acesse o diretório "...\CorporeRM\RM.Net\Custom";
  2. Caso não possua o arquivo "RM.Cst.Script.ExecutorV2.exe.config", arquivo de configuração deverá ser gerado manualmente. Para isso, basta apenas:
    • Realizar uma cópia do arquivo RM.Script.ExecutorV2.exe.config;
    • Renomear o mesmo para RM.Cst.Script.ExecutorV2.exe.config;

  3. Execute o aplicativo RM.Cst.Script.ExecutorV2.exe;
  4. Utilize um usuário supervisor do Sistema para realizar o Login;
  5. Informe o usuário e senha para login no banco de dados;

Interna

  1. Acesse o Sistema RM com um usuário supervisor;
  2. No menu de Módulos, clique em Serviços Globais;


  3. Na aba Customização clique em Executor de script;

    O usuário utilizado para acessar o Sistema precisa ter permissão de acesso ao menu. As permissões de acesso ao Executor de Scripts ficam atreladas aos perfis do módulo de Serviços Globais.






  1. Ao abrir o programa, clique na opção Importar script.



6. O usuário deverá selecionar um arquivo com a extensão .TotvsCustomScript



7. Verifique pela coluna Status aqueles que estão com o ícone:  (Script pendente, aguardando execução).



8. Selecione o script e clique na opção Executar Script.


9. Ao término da execução será apresentada a mensagem para verificar o arquivo de log. Clique em Sim para verificar o log.



10. Após a execução do script é importante verificar se a coluna status foi modificada de acordo com o resultado da execução.






Produto: Customizações

Versão: 12.1.17 ou Superiores

Data:  

André Oliveira De Souza

Definição das colunas

Nome da colunaDescrição

Status

Exibe 4 variações: “Executado com sucesso”, “Executado com erros”, “Pendente” e “Bloqueado”. Sendo que o único status que permite que o script seja executado é o “Pendente”, demonstrando que o mesmo ainda não foi executado na base de dados.

Código do script

Exibe a identificação ou marcação do script.

Descrição

Exibe a descrição do script obtida a partir do arquivo de “leia-me” que acompanha o script.

CNPJ

Exibe o CNPJ do cliente a qual o script é destinado, ou então exibe “nulo” ou “00.000.000/0000-00” para scripts destinados a todos os clientes.

Data de solicitaçãoExibe a data de solicitação do script.
Data de validadeExibe a data de validade do script.
Data de execuçãoExibe a data na qual o script foi executado na base de dados.
SGBDInforma para qual SGBD o script é destinado.
ObservaçõesExibe observações sobre o script.




Erros comuns

Execução em ambiente 3 camadas

Problema: Não importa o script selecionado.

Solução: Executar em ambiente local.

Execução de scripts Oracle

Problema: Alguns scripts Oracle que possuem dois “COMMIT WORK” no final do arquivo exibe o erro “A propriedade CommandText não foi inicializada. ”
Solução: Se não houver outros erros além deste no log, o script foi executado com sucesso.