OnRelationalPromptListError - cDbCJGridPromptList

Sent to generate an error when a relational prompt list can not be used in a relational manner

Type: Event

Syntax

Procedure OnRelationalPromptListError

Description

If your prompt list is relational (peUpdateMode is umPromptRelational) and the prompt list is being used in a context where the relational link cannot be found between the invoking object and the prompt list, the OnRelationalPromptListError event is sent. Since this type of usage is considered to be a programming error, this events generates an unhandled error.

If you wish, you could choose to not consider this an error and handle this by changing the peUpdateMode to another mode and proceed.

Procedure OnRelationalPromptListError
    Set peUpdateMode to umPromptValue
End_Procedure

The above strategy makes your prompt list more flexible but introduces the risk that a real error will remain undetected. For example, if you used a relational customer prompt list with a vendor invoking data entry object (DEO), this is almost certainly a programming error. If you make the above change, this error will not be reported and the prompt list will be used improperly in a way that may be hard to detect. It is for that reason that we encourage you to change update modes in the invoking object's Prompt_Callback event, where the programmer's intent it is clear.