6.3.2 Custom Serial Format Token Reference

Token Syntax

All tokens use the syntax ${<token_type>:<parameters>}. Anything outside the ${...} delimiters is treated as literal text and included as-is in the serial number.

Available Tokens

1. Sequential Numeric—${num:<places>,<start>}

   • <places>—The number of digits (zero-padded)
   • <start>—The starting number for the sequence (increments by 1 for each device)
   • Constraint: <start> must be less than 10^places (e.g., for two places, the start value must be less than 100)
   • Wraps around when the maximum value is reached

   Format String	Device 1	Device 2	Device 3
   SN_${num:3,1}	SN_001	SN_002	SN_003
   ${num:5,123}	00123	00124	00125

2. Random Numeric—${num:<places>,rand}

   • <places> — The number of digits (zero-padded)
   • rand — A literal keyword that triggers random generation
   • Generates a random, zero-padded number for each device

   Example: ${num:7,rand} → 0384721 (random)

3. Sequential Alphabetic—${alpha:<places>,<start>}

   • <places>—The length of the alphabetic string
   • <start>—The starting uppercase letter sequence (A–Z only)
   • Increments like a base-26 counter (A→B→...→Z→AA→AB...)
   • If <start> is shorter than <places>, it is right-padded with A
   • Constraint: The length of <start> must not exceed <places>

   Format String	Device 1	Device 2	Device 3
   ${alpha:3,ABC}	ABC	ABD	ABE
   ${alpha:2,AZ}	AZ	BA	BB

4. Random Alphabetic—${alpha:<places>,rand}

   • <places>—The length of the alphabetic string
   • rand—A literal keyword that triggers random generation
   • Each character is independently and randomly chosen from A–Z

   Example: ${alpha:6,rand}→QMXBFT (random)

5. Current Date—${date}

   • No parameters
   • Inserts the current date in ISO 8601 format: YYYY-MM-DD (ten characters)

   Example: ${date}→2026-04-01

6. Plain Text

   • Any characters outside ${...} delimiters are treated as literal text

   Example: PREFIX_→PREFIX_

Tokens and plain text can be freely combined in a single format string.

Table 6-2. Validation Rules

Rule	Severity	Description
Invalid token	Error	Any ${...} content that does not match a known token pattern
Alpha start exceeds places	Error	The start string length is greater than places value
Numeric start exceeds places	Error	Start number ≥ 10^places
Serial exceeds 30 characters	Error	Any generated serial number longer than 30 characters
Non-unique serials	️ Warning	Generated serial numbers for the selected devices are not all unique
Empty format	️ Warning	Empty format string—serial numbers will be cleared