Versões comparadas

Chave

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

Índice


       

Índice
exclude.*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


Antes da utilização do Executor de Scripts é necessário:

    1. A instalação da Lib DN; versão mínima XXX;

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:

Expandir
titleExterna
  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;
    Image Modified
  4. Utilize um usuário supervisor do Sistema para realizar o Login;
    Image Modified
  5. Informe o usuário e senha para login no banco de dados;
    Image Modified
  6. Clique em Testar Conexão;
  7. Clique em OK;
Expandir
titleInterna
  1. Acesse o Sistema RM com um usuário supervisor;
  2. No menu de Módulos, clique em Serviços Globais;
    Image Modified

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

    Aviso
    titleImportante

    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.


    Image Modified

  4. Informe o usuário e senha para login no banco de dados;
    Image Added
  5. Clique em Testar Conexão;
  6. Clique em Ok;

Importando Scripts

Ao abrir o programa,

clique na opção Importar script.

Image Removed

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

Image Removed

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

Image Removed

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.

Image Removed

é necessário Importar os scripts que serão executados:

  1. Clique em importar arquivo;
    Image Added
  2. Selecione os scripts a serem importados;
  3. Clique em abrir;
    Image Added
  4. Será apresentada mensagem de sucesso ao importar os scripts;
  5. O a visão de scripts será atualizada;
    Image Added


Executando Scripts

Para Executar os scripts é necessário se atentar ao status dos mesmos:

Image Added - Script pendente (pronto para a execução);

Image Added - Script executado com sucesso;

Image Added - Script com erro;

Sabendo dos status, para executar os scripts siga os passos abaixo:

  1. Selecione apenas um script para a execução;
  2. Clique em Executar Script;
    Image Added

  3. Será apresentada mensagem de sucesso ou erro na execução do script;
    Image Added

  4. Em caso de erro, através do botão Log é possível verificar qual o erro foi apresentado;
10. Após a execução do script é importante verificar se a coluna status foi modificada de acordo com o resultado da execução.


Informações
iconfalse
Informações
iconfalse

Produto: Customizações

Informações
iconfalse

Versão: 12.1.17 ou Superiores

Data: 

Informações
iconfalse
titleAutores
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.