Refcall rule

Official Content
This documentation is valid for:

Calls a program whenever a referential integrity check fails.


Refcall('PgmName', par1 , ... , parN);


Is the name of the program to be called when referential integrity check fails.

par1 , ... , parN 
It is a list of attributes or variables. The attributes form the foreign key (simple o compound by several attributes) for which the referential integrity check fails. Variables are used to give additional information to the program.


Objects: Transaction


You can define this rule in a Transaction object to call a program when a referential integrity check fails. All attribute parameters are used, maintaining the order given by the parameter list, to form the foreign key. So, when the referential integrity check fails for that foreign key, the object indicated by you is called.


  • The called program must receive the same parameter list specified by the Refcall rule.
  • In Transactions, the Refcall cannot call an object with form (Web Panel or Transaction).
  • This rule implicitly reads the referenced table twice: the first time to verify that the reference was incorrect and the second time to control that the values returned by the called program are a valid reference.

See Also

Refmsg rule
Prompt rule