Skip to main content

DATA_Basket

DATA_Basket: TvxClientDataSet

Example​

procedure ScriptEvent(var Value: variant);
begin
  CreateData(DATA_Category, ['Code,string,100', 'Description,string,255']);
  DATA_Category.Append;
  DATA_Category['Code'].AsString := 'GROUP-001';
  DATA_Category['Description'].AsString := 'Sample group';
  DATA_Category.Post;
  Value := DATA_Basket.RecordCount;
end;

Usage​

DATA_Basket provides an alternate basket name for the exact same special-purpose dataset object as DATA_Category.

Conventional VxData context

DATA_Basket is another name for DATA_Category, and this dataset is not linked to a standard Velox Data table. Use it only as a reusable in-memory or query container with an explicitly created or loaded schema. Neither name guarantees a Category or Basket record model or persistence path. Error messages can refer to DATA_Category.

That convention is guidance for choosing queries and field names, not a guarantee. A configured source/destination or customer extension may expose a different subset or additional columns. Use FindField for optional columns and never assume a named field merely because this page describes the current base schema.

Behaviour, lifecycle and side effects

  • Velox loads all returned rows into memory and preserves fetched string whitespace. Large results can use substantial memory.
  • Field access, navigation, filtering, indexing, inserts, edits, posts and deletes mutate this shared object. Closing or recreating it invalidates retained fields and record positions.
  • Post updates the client dataset; it is not proof of an external database write or transaction commit. SQL/file effects belong to the function used to populate or persist it.
  • Data helper functions generally catch and log SQL/creation failures, potentially leaving the object inactive or reset. Direct invalid field, conversion or dataset-state operations can raise.
  • Action cleanup closes every friendly dataset. Velox owns the object; never free it or depend on records surviving another action execution.
  • The mutable dataset and cursor are not thread-safe. Do not hand the reference to asynchronous work or let nested code reposition it without an explicit contract.

Alias and naming cautions

Because DATA_Basket and DATA_Category share object identity, a query, CreateData, Close, cursor move, filter or edit through either name immediately changes the other. Choose one name consistently within a script to make ownership and intent clear.

Additional Technical Info​

DATA_Basket is an alternate basket-oriented name for the current action's DATA_Category object. It is a live TvxClientDataSet reference; the friendly name does not load data, choose a connection, execute SQL or impose a field layout.

Runtime binding and identity

Velox constructs the object with the action and binds DATA_Basket to TvxActionMan.FData49. It is the exact same object as DATA_Category, not a copy or linked view.

The dataset begins inactive and without fields. CreateData, the Data query helpers and load methods can each replace its current schema/records. All scripts using this action see the same live cursor, filters, indexes and edits until the dataset is closed or repopulated.

Related entries

External references

Created 2026-07-15