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

AXINCLUI()

AxInclui( <cAlias>, <nReg>, <nOpc>, [aAcho], [cFunc], [aCpos], [cTudoOk], [lF3], [cTransact], [aButtons], [aParam], [aAuto], [lVirtual], [lMaximized] )

Configura inclusión de registros en interfaz legada.

AXINCLUI()AdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

AxInclui presenta interfaz de inclusión según diccionario Protheus. Alias registrado en SX2, campos y validaciones en SX3; llamador proporciona registro y contexto browse. nOpc es posición de opción en aRotina, distinta del código de operación de cuarta columna: 3 en este ejemplo. Argumentos opcionales difieren entre funciones Ax; no trasladar posiciones de AxAltera a AxInclui ni AxDeleta. Ficha no formaliza retorno. Fragmento solo configura opción de rutina legada preparada, sin ejecutarla. (TOTVS, s.f., ref. 1) Definir cCadastro como Private en llamador. cTudoOk es string de función validadora, no bloque.

02 · SINTAXIS

Sintaxis

AxInclui( <cAlias>, <nReg>, <nOpc>, [aAcho], [cFunc], [aCpos], [cTudoOk], [lF3], [cTransact], [aButtons], [aParam], [aAuto], [lVirtual], [lMaximized] )

Parámetros

cAlias
CarácterObligatorio

Alias registrado en SX2 y disponible en contexto.

nReg
NuméricoObligatorio

RecNo del registro en contexto browse.

nOpc
NuméricoObligatorio

Posición de opción en aRotina, no código universal de operación.

aAcho
ArrayOpcional

Campos mostrados; NOUSER puede impedir agregar campos de usuario.

cFunc
CarácterOpcional

Función para cargar variables de memoria.

aCpos
ArrayOpcional

Campos editables; en AxDeleta, campos mostrados.

cTudoOk
CarácterOpcional

Nombre de función validadora como string, no bloque.

lF3
LógicoOpcional

Indica llamada desde consulta F3.

cTransact
CarácterOpcional

Función llamada dentro de transacción AxFunction.

aButtons
ArrayOpcional

Botones adicionales: bitmap, bloque y título.

aParam
ArrayOpcional

Funciones antes de pantalla, validación, dentro y fuera de transacción, en ese orden.

aAuto
ArrayOpcional

Campos, valores y validaciones de modo automático; requiere análisis propio.

lVirtual
LógicoOpcional

Archivo virtual; documentación lo relaciona con cFunc.

lMaximized
LógicoOpcional

Maximización del diálogo.

Retorno

La ficha consultada no especifica contrato de retorno; el ejemplo no lo usa.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

// Fragmento: aRotina ya existe en llamador legado.
// Framework proporciona alias, registro y posicion de opcion.
AAdd(aRotina, {"Inclusión", "AxInclui", 0, 3})
Resultado esperado

Agrega entrada de menú; no abre pantalla ni modifica datos por sí sola. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Probar en tabla propia con permisos y validación. Funciones genéricas no sustituyen reglas completas de negocio ni diseño MVC.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. AXINCLUI(). TDN. Contrato da função e exemplo aRotina. Consulta el 2026-10-26.
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