Tags

ProcessingSteps, WorkData, and Jobs support tags, allowing users or the system to attach metadata for better organization and resource discovery.

Tag Types

At its simplest level, a tag is a string limited to 1024 characters. Examples:

• Approved
• 2026
• 018c0b59-1234-7c64-aca4-1f5408ab621d

Key-Value Tags (Smart Tags)

PineXQ supports Key-Value tags to enable sophisticated filtering and queries. These follow the format: <key>=<value>

• Both key and value are limited to 1024 characters each.
• Examples: year=2026, approved=true, project_id=A12

---

Tag Decomposition

When a tag is assigned to a resource, the system processes and “decomposes” it using the following logic:

1. Structure Detection: If an = is present, the right side is treated as the value. If no = exists, the tag is categorized as KeyOnly.
2. Trimming: Leading and trailing whitespace is removed from both the key and value.
3. Type Detection: The value is inspected to determine its data type.
4. Normalization: The value is reformatted to a standard system format.

Recognized Value Types

Type	Description	Examples	Normalization / Notes
KeyOnly	A simple tag with no assigned value.	draft
String	The default type for non-numeric/special text.	status=gold
Integer	Standard integer values.	offset=-1
Float	Floating point numbers (Double).	temp=-1.23	1. becomes 1.0. Precision up to 16 decimal places.
Boolean	Logical True/False values.	fog=true	Mapped to lowercase (e.g., tRuE → true).
Date	A specific calendar date.	day=2025-10-31	Format: yyyy-MM-dd
Time	A specific time or duration.	time=100:20:30 time=-10:20:30	Milliseconds are appended for consistency: 10:00:00 → 10:00:00:00.
Timestamp	ISO 8601 with time zone info.	timestamp_utc= 2024-10-01T12:00Z timestamp= 2026-01-16T11:12:35+05:30	Required: Must include “Z” or offset. Local time (no zone) is rejected.