Usina BRAdvPL Guia
Entrar
← Todos os tópicos
GUIA PRÁTICOEm revisão

RpcSetEnv e preparação de ambiente

Define quem abre, usa e encerra o ambiente automático.

RpcSetEnv e preparação de ambienteAdvPL
01 · VISÃO GERAL

Visão geral

Primeiro identifique o chamador: menu, Schedule e REST com PrepareIn podem entregar ambiente pronto. Nesse caso, use o contexto recebido e preserve suas políticas. Em um job isolado que precisa de ambiente, obtenha credenciais por canal protegido, chame RpcSetEnv, confira o retorno e só processe após sucesso. Registre a propriedade da abertura e encerre com RpcClearEnv apenas o contexto próprio, inclusive no caminho de erro. Select("SX2") isoladamente não comprova identidade, filial ou permissão corretas. O exemplo usa apenas uma marca de propriedade fictícia, sem abrir ou encerrar conexões. (Fontes: refs. 1–2.)

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed638()
    // Marca didatica; na aplicacao real vem da abertura efetiva.
    Local lAmbienteProprio := .F.
    If lAmbienteProprio
        // A limpeza real deve ocorrer tambem em falhas.
        ConOut("LIMPEZA_PROPRIA")
    EndIf
Return Nil
Resultado esperado

Não entra na limpeza porque não abriu ambiente. É um modelo de decisão, não um wrapper pronto de job. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Não trocar empresa nem autenticar novamente em REST/SOAP já preparado pelo framework. Conferir release e LIB.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. RpcSetEnv: preparo, restrições de contexto e versão. Consulta em 2026-10-28.
  2. Atilio. dan-atilio/AdvPL. Maratona de Exemplos/Exemplo_426_Funcao_RPCSetEnv.prw. Arquivo completo consultado; adaptação editorial. Consulta em 2026-10-28.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha