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.
Prepare Environment - [ EMPRESA ] [ FILIAL ] [ USER ] [ PASSWORD ] [ TABLES ] [ MODULO ]
| Nome | Tipo | Descrição | Default | Obrigatório |
| EMPRESA | caracter | Código da empresa. | ||
| FILIAL | caracter | Código da filial. | ||
| USER | caracter | Nome de usuário. | ||
| PASSWORD | caracter | Senha do usuário. | ||
| TABLES | caracter | Nomes das tabelas. | ||
| MODULO | caracter | Sigla do módulo. | FAT |
PREPARE ENVIRONMENT EMPRESA '01' FILIAL '01' USER 'Administrador' PASSWORD '' TABLES 'SE1,SA1,SE2' MODULO ‘FAT’
/*******COMANDOS *********/
RESET ENVIRONMENT
Um ambiente não deve inicializado em rotinas de menu, pois o ambiente do Protheus já estará aberto e utilizar de uma nova inicialização pode gerar problemas diversos. Isso aplica-se também a encerrar o ambiente.
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:
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas