Skip to main content

Order_Line_New_String

Order_Line_New_String = 'New'

Example

procedure ScriptEvent(var Value: variant);
begin
Value := GetOrderLineStatusNum(Order_Line_New_String); // 1
end;

Usage

Order_Line_New_String provides the exact New text paired with order-line comparison state value 1 and recognised by its Velox converter.

Value

PropertyValue
Script typeString
Exact literalNew
Numeric partner1
Database representationOrder_Line_Status.Description
Numeric fieldOrder_Line.StatusNum

Additional Technical Info

Order_Line_New_String is the canonical script-visible text New paired with order-line comparison state value Order_Line_New = 1. It is a fixed conversion token, not an instruction to change order data.

Implementation

Velox declares and registers the exact string New. GetOrderLineStatusNum uses Delphi SameText, so recognised ASCII text is case-insensitive but is not trimmed. GetOrderLineStatusCode returns this exact casing for value 1.

The fresh-build Order_Line_Status row 1 stores New in Description. The converter is compiled and does not read that table at runtime.

Behaviour

Use Order_Line_New_String for canonical order-line comparison state output or as input to the matching reverse converter. Different letter casing is recognised; leading or trailing whitespace produces Null.

The String name is not registered in the Velox tag map. Use numeric Order_Line_New in an <!...!> configuration tag.

Edge cases and quirks

  • New can appear in another order status family. The correct converter and target field determine its domain.
  • Line and response Changed share number 3 and text Changed, but remain distinct identifiers and database domains.
  • Response number 2 means Rejected; line number 2 means Same. Do not infer meaning from the number alone.
  • Direct string comparison may not reproduce the converter's case handling; use the converter when normalising external input.

Side effects

Reading or comparing Order_Line_New_String has no I/O or state-changing effect. Conversion does not query or update the database.

Errors

Reading the constant does not raise an error. The converter returns Null for unknown or whitespace-padded text instead of raising a domain-specific exception.

Performance and concurrency

This immutable compiled string and its small fixed mapping require no persistent resource and carry no shared mutable state.

Remarks

The example is source-reviewed and non-destructive. Use the exact constant casing when emitting canonical text.

Related entries

Created 2026-07-15