Pagetitle |
---|
| RpcSetEnv - Abertura do ambiente em rotinas automáticas |
---|
| RpcSetEnv - Abertura do ambiente em rotinas automáticas |
---|
|
Função: RpcSetEnv - Abertura do ambiente em rotinas automáticas Abrangências: | Microsiga Protheus 8.11 , Protheus 10 | Versões: | Microsiga Protheus 8.11 , Protheus 10 | Compatível Países: | Todos | Sistemas Operacionais: | Todos | Compatível às Bases de Dados: | Todos | Nível de Acesso: | Nível 1 (Acesso Clientes) |
Descrição:OA comandofunção RpcSetEnv() é utilizadoutilizada 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.
Sintaxe:RpcSetEnv - Abertura do ambiente em rotinas automáticas ( [ cRpcEmp ] [ cRpcFil ] [ cEnvUser ] [ cEnvPass ] [ cEnvMod ] [ cFunName ] [ aTables ] [ lShowFinal ] [ lAbend ] [ lOpenSX ] [ lConnect ] ) --> lRet
Retorno:lRet(logico)- Retorna .T. se setou corretamente o ambiente com a empresa e filial. Se .F. não conseguiu setar.
ExemplosLocal 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 CTBRpcSetEnvCTB RpcSetEnv( "99","01", "Administrador", " ", "CTB", "CTBA102", aTables, , , , ) /****** COMANDOS *************/ RpcClearEnv() //Limpa o ambiente, liberando a licença e fechando as conexões
Parâmetros:Nome | Tipo | Descrição | Default | Obrigatório | Referência | 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. |