Notation Types

Appendix A — Configuration Reference

Notation types define the structured text fields that can be attached to mappings, tables, and columns. Each notation type represents a distinct kind of information — transformation logic, mapping notes, validation queries, historical context — and appears as its own tab in the notation panel.

Fields

Short Name — A brief identifier used internally as a key when referencing this notation type in source paths, auto-mapping rules, and AI prompts. Should be concise and unambiguous (e.g., TransLogic, MappingNote). Must be unique. Renaming after mappings exist will not update notation data already stored under the old name.

Full Name — The display label shown on the notation tab and in the properties panel.

Display Order — Controls the left-to-right order of notation tabs. Lower numbers appear first.

Applies To — Controls which entity types can carry this notation: Source Tables, Target Tables, Source Columns, Target Columns, and Mappings. Multiple scopes can be selected. A notation scoped to Mapping will not appear on table or column properties, and vice versa.

Format — A forward-looking field reserved for future use. Currently has no effect on application behavior. Set to Text by default.

Trans Logic — Designates this notation type as the transformation logic field. Exactly one notation type must be marked. The designated type is used by the validation script generator when building SQL queries, by auto-mapping rules, and by the AI modelfile and context export. If no notation type is marked, validation and AI features will not function correctly.

Icon — A single character displayed next to mappings, tables, or columns in the tree when a notation of this type has content. Enter a Unicode character directly by pasting the glyph into the cell, or type the escape sequence (e.g., \uE70B). New notation types default to a standard note glyph.

Notes

The Short Name is used as a key in source paths and in the AI modelfile. Plan notation type names carefully before the team begins mapping work.

The TC- prefix is a convention for validation-related notation types (TC-Minus, TC-Counts, TC-Default, TC-Manual). The validation script generator recognizes these by name to determine which query templates to apply. See Chapter 7.