cRpcEmpCaractereOpcional
Código de empresa.
FUNçãOEm revisão
RpcSetEnv
RpcSetEnv([cRpcEmp],[cRpcFil],[cEnvUser],[cEnvPass],[cEnvMod],[cFunName],[aTables],[lShowFinal],[lAbend],[lOpenSX],[lConnect]) -> lRetAbre ambiente automático com empresa, filial e identidade.
Visão geral
Retorna .T. se conseguiu preparar o ambiente e .F. em falha, sem substituir o tratamento de exceções. O TDN proíbe reinicializar ou encerrar ambientes de rotinas de menu e alerta para Schedule e REST com PrepareIn. Desde 12.1.2510, REST/SOAP já preparado pelo framework pode gerar exceção. cEnvPass aceita token de autenticação somente a partir da LIB 20251117, conforme contrato citado; não é qualquer token externo. O exemplo do GitHub contém credencial literal e não encerra o ambiente no recorte: esses padrões não foram transportados. (Fontes: refs. 1–2.)
Sintaxe
RpcSetEnv([cRpcEmp],[cRpcFil],[cEnvUser],[cEnvPass],[cEnvMod],[cFunName],[aTables],[lShowFinal],[lAbend],[lOpenSX],[lConnect]) -> lRetParâmetros
cRpcFilCaractereOpcional
Código de filial.
cEnvUserCaractereOpcional
Usuário autorizado obtido fora do fonte.
cEnvPassCaractereOpcional
Senha ou token apenas no contrato suportado pela LIB; nunca registrar.
cEnvModCaractereOpcional
Módulo; padrão documentado FAT.
cFunNameCaractereOpcional
Identificação da rotina e auditoria; padrão RPC.
aTablesArrayOpcional
Aliases a abrir; padrão {}.
lShowFinalLógicoOpcional
Controla lMsFinalAuto; padrão .F.
lAbendLógicoOpcional
Mensagem de falha de licença; padrão .T.
lOpenSXLógicoOpcional
Abertura de SXs/primeira filial quando não informada; padrão .T.
lConnectLógicoOpcional
Conexão ao banco; padrão .T.
Retorno
Lógico de abertura; exceções continuam possíveis.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed637()
// Bloco nao invocado; contexto e segredo pertencem ao chamador autorizado.
Local bAbrir := {|cEmpresa,cFilial,cUsuario,cSegredo,cModulo| ;
RpcSetEnv(cEmpresa,cFilial,cUsuario,cSegredo,cModulo)}
ConOut(ValType(bAbrir))
Return NilResultado esperado
Cria bloco B. Não autentica, abre ambiente ou imprime segredo. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Só encerre com RpcClearEnv um ambiente aberto e controlado pela sua rotina. Testar licenças, direitos e falhas.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.