Skip to main content

Configure Variable Groups

A Variable Group stores named child variables for use by tags and scripts. Shared codes are an API: changing a code or type can break consumers without changing their module reference.

Properties

SettingDefaultEffect
Variable Group nameNew Variable GroupModule identity. Non-default group code is derived from the configured prefix plus module name with spaces removed. Review the effective group code after rename.
Variable codeEmptyUnique code within the group used by runtime lookup. Duplicate codes are rejected by validation.
ValueNullPersisted value returned through group/tag/script access.
Item nameEmptyHuman-readable description/name for the variable.
Operator=Stored operator metadata used by applicable parameter/criteria contexts.
Parameter typeStringDelphi field type used to interpret/format the value. Test conversion, nulls, dates and locale-sensitive numbers.
EncryptedClearedMarks the value for encrypted persistence/display handling. It remains sensitive configuration; restrict database/export/log access.

Variable access and the global Variable Group cache are thread-safe. Save/delete invalidates cached group state and module relations record consumers. A running execution may have already evaluated a value, so changes are not a transactional broadcast to work already in progress.

Do not use ordinary variables for long-lived credentials when a dedicated credential/key-vault mechanism exists. Avoid embedding secrets in logs or examples. Use Check Usage, preserve the prior value/type, test each consumer and verify the runtime refresh boundary before production activation. See variables and Scriptlets.