Frameworksp

Páginas filhas
  • Prepare Environment

Prepare Environment

O comando PREPARE ENVIRONMENT tem o objetivo de realizar a inicialização de um determinado ambiente assim que executado. PREPARE ENVIRONMENT permite definir a empresa e filial no qual desejamos fazer a inicialização do ambiente, especificando o usuário e senha para determinar os direitos e ações a serem realizadas. É possível também especificar quais as tabelas que serão abertas para uso no ambiente e qual módulo será utilizado.

Sintaxe

Prepare Environment - [ EMPRESA ] [ FILIAL ] [ USER ] [ PASSWORD ] [ TABLES ] [ MODULO ]


Parâmetros


NomeTipoDescriçãoDefaultObrigatório
EMPRESAcaracterCódigo da empresa.

FILIALcaracterCódigo da filial.

USERcaracterNome de usuário.

PASSWORDcaracterSenha do usuário.

TABLEScaracterNomes das tabelas.

MODULOcaracterSigla do módulo.FAT


Exemplos
PREPARE ENVIRONMENT EMPRESA '01' FILIAL '01' USER 'Administrador' PASSWORD '' TABLES 'SE1,SA1,SE2' MODULO ‘FAT’
/*******COMANDOS *********/
RESET ENVIRONMENT


Atenção

O ambiente não deve ser inicializado ou encerrado em rotinas de menu do Protheus.

No menu, o ambiente já está aberto e preparado para a correta execução das rotinas, respeitando as políticas de acesso do usuário logado e configuração do módulo atual.
Caso sejam usadas os comandos de manipulação de ambiente (PREPARE ENVIRONMENT e RESET ENVIRONMENT) dentro de rotinas de menu o sistema pode se comportar de maneira inesperada e podem ocorrer problemas na contagem de licenças, falha crítica de segurança entre outros problemas.

Essa situação também pode ocorrer para schedule (exceção para processo especial) e para REST quando já configurado com PrepareIn.



Importante
A partir do release 12.1.2510, a função RpcSetEnv e RpcClearEnv (PREPARE ENVIRONMENT e RESET ENVIRONMENT) passam a gerar exceção caso sejam usadas em REST ou SOAP e o ambiente já esteja aberto pelo Framework com base nos dados informados no PrepareIn:

  • Sem rótulos