Usina BRGuía AdvPL
Ingresar
← Todos los temas
COMANDOEn revisión

PREPARE ENVIRONMENT

PREPARE ENVIRONMENT EMPRESA cEmpresa FILIAL cFilial MODULO cModulo

Define contexto de ejecución automática sin ambiente abierto.

PREPARE ENVIRONMENTAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

Referencia histórica muestra empresa, filial y módulo. Documentación actual RpcSetEnv exige revisar contexto: menú ya tiene ambiente; REST/SOAP con PrepareIn y schedules también pueden tenerlo. No reabrir, cambiar o cerrar ese contexto. Desde 12.1.2510 RpcSetEnv puede generar excepción en servicios ya preparados. Ejemplo conserva sintaxis histórica comentada sin abrir ambiente ni reproducir credenciales ilustrativas. (Fuentes: refs. 1–2.)

02 · SINTAXIS

Sintaxis

PREPARE ENVIRONMENT EMPRESA cEmpresa FILIAL cFilial MODULO cModulo

Parámetros

cEmpresa
CarácterObligatorio

Empresa autorizada para proceso.

cFilial
CarácterObligatorio

Filial compatible con empresa.

cModulo
CarácterObligatorio

Módulo del proceso automático.

Retorno

Comando: sin retorno de función en esta sintaxis. RpcSetEnv tiene contrato lógico propio.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function Ed596()
    // Solo sintaxis: apertura, autenticación y limpieza exigen contrato del llamador.
    // PREPARE ENVIRONMENT EMPRESA cEmpresa FILIAL cFilial MODULO "FAT"
    ConOut("PREPARE ENVIRONMENT")
Return Nil
Resultado esperado

Imprime nombre; no cambia empresa, filial o usuario. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • En job propio definir identidad autorizada, comprobar apertura y limpiar solo ambiente propio. Resolver credenciales fuera del fuente y evitar administrador/contraseña vacía por defecto. Comprobar includes y release.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. Waterloo Ferreira da Silva. AdvPL — O Manual, versão 1.0, p. 405. Referência histórica. Consulta el 2026-10-27.
  2. TOTVS. RpcSetEnv. TDN. Consulta el 2026-10-27.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha