cAliasCharacterRequired
Alias registered in SX2 and available in context.
FUNCTIONUnder review
AXINCLUI()
AxInclui( <cAlias>, <nReg>, <nOpc>, [aAcho], [cFunc], [aCpos], [cTudoOk], [lF3], [cTransact], [aButtons], [aParam], [aAuto], [lVirtual], [lMaximized] )Configures record insertion in a legacy interface.
Overview
AxInclui supplies the record insertion interface according to the Protheus dictionary. The alias must exist in SX2 with fields and validations in SX3; the caller supplies record and browse context. nOpc is the option position in aRotina. It differs from the operation code in the fourth menu column: 3 in this example. Optional argument positions differ across Ax functions; do not transfer AxAltera positions to AxInclui or AxDeleta. The page does not formalize a return. The fragment only configures an option in an already prepared legacy routine without executing the operation. (TOTVS, n.d., ref. 1) The caller must define cCadastro as Private. cTudoOk is a validation-function string rather than a block.
Syntax
AxInclui( <cAlias>, <nReg>, <nOpc>, [aAcho], [cFunc], [aCpos], [cTudoOk], [lF3], [cTransact], [aButtons], [aParam], [aAuto], [lVirtual], [lMaximized] )Parameters
nRegNumericRequired
Record RecNo in browse context.
nOpcNumericRequired
Option position in aRotina, not a universal operation code.
aAchoArrayOptional
Displayed fields; NOUSER can prevent user-defined fields being added.
cFuncCharacterOptional
Function for loading memory variables.
aCposArrayOptional
Editable fields; in AxDeleta, displayed fields.
cTudoOkCharacterOptional
Validation function name as a string, not a block.
lF3LogicalOptional
Indicates a call from an F3 lookup.
cTransactCharacterOptional
Function called inside the AxFunction transaction.
aButtonsArrayOptional
Additional buttons: bitmap, block and title.
aParamArrayOptional
Functions before the screen, validation, inside and outside the transaction, in that order.
aAutoArrayOptional
Automatic-mode fields, values and validations; requires separate analysis.
lVirtualLogicalOptional
Virtual file; documentation relates it to cFunc.
lMaximizedLogicalOptional
Dialog maximization.
Return value
The consulted page does not specify a return contract; the example does not use it.
Commented example
// Fragment: aRotina already exists in the legacy caller.
// The framework supplies alias, record and option position.
AAdd(aRotina, {"Insertion", "AxInclui", 0, 3})Expected result
Adds one menu entry; it does not independently open a screen or modify data. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.
- Test on a custom test table with permissions and validation. Generic functions do not replace complete business-routine rules or an MVC design.
- Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.
Comments
There are no approved comments yet.
Sign in with Google or Microsoft to comment.