Skip to main content

DIssue

DIssue: TdaSQLQueryDataView

Example​

procedure ScriptEvent(var Value: variant);
begin
  if DIssue <> nil then
    Value := True
  else
    Value := False;
end;

Usage​

DIssue provides the current issue data view used by standard Velox issue scripts.

Live-view behaviour

Use it to access the configured issue view's parameters, fields, records and query state. Its cursor, filters and edits are shared with later processing, so navigating or changing it affects what subsequent code sees. Assigning the variable does not open the view, select a row, create an issue or save changes.

Check for nil, confirm the view is active and use the configured schema before accessing fields or records. Do not free it or retain it after the current action.

Business and safety boundaries

A current issue row does not by itself prove database persistence, notification delivery, transaction status or complete audit history. Use the explicit helper/action that performs the intended effect, validate keys/current-row context and handle query/database errors according to that contract.

Additional Technical Info​

DIssue is a direct scripting pointer to the current action's issue SQL query dataview. It can be nil and is not owned by the script.

Lifecycle, ownership and compatibility

Deprecated InitialiseInterchange assigns the interchange issue view, while InitialiseIssue can replace it or fall back to DInterchangeIssue when passed nil.

The owning configuration/action supplies the view. Do not construct/free it through this variable, retain it beyond the action/map context or pass it to asynchronous work. Later initialisation/legacy calls can replace the pointer.

Runtime binding and assignment

The script engine binds this pointer to TvxActionMan.DIssue. Action data reset assigns nil. The standard scriptlet Initialise(aDIssue, aDEvent) assigns its aDIssue argument to the field; assigning the public variable directly likewise changes the action field.

Related entries

External references

  • This variable is a Velox pointer binding rather than a Delphi/FPC core function; the source-backed class link is the behavioural reference.
Created 2026-07-15