Usina BRAdvPL Guia
Entrar
← Todos os tópicos
COMANDOEm revisão

PREPARE ENVIRONMENT

PREPARE ENVIRONMENT EMPRESA cEmpresa FILIAL cFilial MODULO cModulo

Define o contexto de uma execução automática que ainda não tem ambiente.

PREPARE ENVIRONMENTAdvPL
01 · VISÃO GERAL

Visão geral

A referência histórica mostra empresa, filial e módulo no comando. A documentação atual de RpcSetEnv, usado para abertura de ambiente automático, exige atenção ao contexto: rotinas de menu já têm ambiente; REST/SOAP com PrepareIn e schedules também podem estar preparados. Não abrir, trocar ou encerrar novamente esse contexto. Desde 12.1.2510, RpcSetEnv pode gerar exceção em serviços com ambiente já aberto. O exemplo registra somente a sintaxe histórica comentada, sem abrir ambiente ou reproduzir usuário/senha ilustrativos das fontes. (Fontes: refs. 1–2.)

02 · SINTAXE

Sintaxe

PREPARE ENVIRONMENT EMPRESA cEmpresa FILIAL cFilial MODULO cModulo

Parâmetros

cEmpresa
CaractereObrigatório

Empresa autorizada para o processo.

cFilial
CaractereObrigatório

Filial compatível com a empresa.

cModulo
CaractereObrigatório

Módulo do contexto automático.

Retorno

Comando: não há retorno de função nesta sintaxe. RpcSetEnv tem contrato próprio de retorno lógico.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed596()
    // Somente sintaxe: abertura, autenticacao e limpeza exigem contrato do chamador.
    // PREPARE ENVIRONMENT EMPRESA cEmpresa FILIAL cFilial MODULO "FAT"
    ConOut("PREPARE ENVIRONMENT")
Return Nil
Resultado esperado

Imprime o nome do comando; não troca empresa, filial ou usuário. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Em job próprio, definir identidade autorizada, conferir falha de abertura e garantir limpeza apenas do ambiente que a rotina abriu. Resolver credenciais fora do fonte e não usar administrador/senha vazia como padrão. Conferir includes e release antes de ativar o comando.
  • 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. Waterloo Ferreira da Silva. AdvPL — O Manual, versão 1.0, p. 405. Referência histórica. Consulta em 2026-10-27.
  2. TOTVS. RpcSetEnv. TDN. Consulta em 2026-10-27.
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