Skip to main content

Party_Agent

Party_Agent = 8

Example

procedure ScriptEvent(var Value: variant);
begin
Value := GetReferenceTableForPartyType(Party_Agent); // 'Party_Agent'
end;

Usage

Party_Agent provides deprecated Agent party-role alias value 8 used by legacy scripts, party tags and role helper functions.

Value

PropertyValue
Script typeLongInt
Numeric value8
Preferred identifierType_Agent
Canonical textType_Agent_String = Agent
Database domainParty_Type.Num and Party.TypeNum
Reference-table helper resultParty_Agent
Issue helper result1035

Additional Technical Info

Party_Agent is a deprecated compatibility alias for the Agent party role. Its fixed LongInt value is 8, identical to Type_Agent. Prefer the Type_* identifier in new or revised scripts, while retaining this alias only where legacy compatibility or a helper's documented party-role input requires it.

Reading the alias identifies a role. It does not look up a party, create a role-table record, change Party.TypeNum or validate a transaction.

Implementation

Current native source places Party_Agent in an explicitly deprecated block and registers it with PascalScript as 8. It also keeps this exact deprecated name in the numeric tag map, so <!Party_Agent!> expands to 8; preferred Type_Agent is registered separately with the same value.

GetReferenceTableForPartyType cases on Party_Agent and returns Party_Agent. GetIssueForPartyType cases on it and returns integer 1035. The text/number converters instead use preferred Type_Agent and Type_Agent_String.

A fresh VxData database seeds Party_Type value 8 as Agent, and Party.TypeNum references that table. The role-specific reference table is Party_Agent.

Behaviour

The alias and preferred identifier are numerically indistinguishable after evaluation. The reference-table helper returns a fixed table-name string; it does not open that table or return a dataset. The issue helper returns a fixed integer issue number; it does not create or persist an issue.

Edge cases and quirks

  • There is no Party_Agent_String alias. Use Type_Agent_String for canonical text and the preferred converters.
  • Despite deprecation, current product helpers and the tag map still refer to Party_* names. Deprecation therefore means "prefer the replacement for authoring", not "currently unavailable".
  • The generated index lacks a deprecation flag even though native source marks the family deprecated.
  • Party-role numbers overlap many other numeric families. PascalScript does not retain the domain after evaluation.
  • GetIssueForPartyType returns an integer such as 1035, whereas the exposed Ixxxx issue-code constants are strings. Do not substitute one representation without checking the receiving API.

Side effects

Reading Party_Agent, comparing it or expanding its tag has no I/O or state-changing effect. The two helpers are fixed in-process case mappings and do not query the database.

Errors

Reading the alias does not raise an error. An unsupported party-role number makes GetReferenceTableForPartyType return Unknown and makes GetIssueForPartyType return its generic fallback 1029; this page's value uses the recognised branch.

Performance and concurrency

This is an immutable compiled value. Access, tag lookup and the fixed helper cases are constant-time for practical purposes and carry no shared mutable role state.

Remarks

The example is source-reviewed and non-destructive. Treat the returned table name as reference metadata; it does not authorise arbitrary SQL or prove that a matching row exists.

Related entries

Created 2026-07-15