A função RpcSetEnv() é utilizada para abertura de ambiente em rotinas automáticas, permitindo 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.
RpcSetEnv - Abertura do ambiente em rotinas automáticas ( [ cRpcEmp ] [ cRpcFil ] [ cEnvUser ] [ cEnvPass ] [ cEnvMod ] [ cFunName ] [ aTables ] [ lShowFinal ] [ lAbend ] [ lOpenSX ] [ lConnect ] ) --> lRet
Local aTables := {"CT1","CT2","CT3","CT4","CT5","CTF","CTE"}
//seta o ambiente com a empresa 99 filial 01 com os direitos do usuário administrador, módulo CTB
RpcSetEnv( "99","01", "Administrador", " ", "CTB", "CTBA102", aTables, , , , )
/****** COMANDOS *************/
RpcClearEnv() //Limpa o ambiente, liberando a licença e fechando as conexões
Nome | Tipo | Descrição | Default | Obrigatório |
cRpcEmp | Caracter | Código da empresa. | ||
cRpcFil | Caracter | Código da filial. | ||
cEnvUser | Caracter | Nome do usuário. | ||
cEnvPass | Caracter | Senha do usuário. | ||
cEnvMod | Caracter | Código do módulo. | 'FAT' | |
cFunName | Caracter | Nome da rotina que será setada para retorno da função FunName(). É também utilizado na gravação da rotina que executou as inclusões/alterações na tabela de auditoria | 'RPC' | |
aTables | Vetor | Array contendo as tabelas a serem abertas. | {} | |
lShowFinal | Lógico | Alimenta a variável publica lMsFinalAuto. | .F. | |
lAbend | Lógico | Se .T., gera mensagem de erro ao ocorrer erro ao checar a licença para a estação. | .T. | |
lOpenSX | Lógico | SE .T. pega a primeira filial do arquivo SM0 quando não passar a filial e realiza a abertura dos SXs. | .T. | |
lConnect | Lógico | Se .T., faz a abertura da conexão com servidor As400, SQL Server etc. | .T. |
Observação:
O ambiente não deve ser inicializado ou encerrado em rotinas de menu do Protheus, o Protheus já entrega o ambiente aberto e preparado para a correta execução da rotina, caso o ambiente seja aberto ou fechado em rotinas de menu erros diversos podem ocorrer.