Lexicon - General

Edit the properties and/or contents of a Lexicon.

Remarks

The Lexicon General tab provides a unified workspace for configuring, editing, and reviewing the properties and contents of a Lexicon in Grooper. This control is designed for solution designers, administrators, and subject matter experts who need to manage lookup lists, vocabulary, translations, and other dictionary-based resources used throughout extraction, validation, and normalization workflows.

Purpose

Use this tab to view and edit the properties of the selected Lexicon, modify its contents, and manage its configuration. The workspace streamlines the process of building, validating, and maintaining lexicons, supporting rapid updates and review of dictionary entries.

UI Components

• Properties Panel:
  • Displays all configurable properties of the current Lexicon in a categorized, interactive grid.
  • Supports inline editing, drop-down lists, checkboxes, and expandable sections for complex properties.
  • Provides contextual help and validation for each property, with a help window that updates as you select different fields.
  • Right-click to access context menu commands such as Clear, Reset, Copy, and Paste.
• Lexicon Editor:
  • Presents the contents of the lexicon in a multi-line text editor.
  • Supports syntax highlighting for key-value pairs, vocabulary, or translation entries, depending on lexicon type.
  • Includes toolbar buttons for saving and canceling edits, as well as word wrap and control character toggles.
  • Keyboard shortcuts for editing actions (see below).
  • Read-only mode is enforced for lexicons marked as read-only.
• Toolbar and Buttons:
  • {save}: Save changes to the properties or contents of the lexicon.
  • {cancel}: Discard unsaved changes and revert to the last saved state.
  • Button states and tooltips provide guidance for available actions and indicate when unsaved changes are present.

Workflow and Scope

• The tab is available for any Lexicon node in the design tree.
• Edit properties in the properties panel to configure lexicon type, included lexicons, connection, query, and other options.
• Use the editor to add, remove, or modify lexicon entries.
• Click {save} to commit changes, or {cancel} to revert to the previous state.
• Contextual help and validation are provided for all properties and editor actions.

Example

The following diagram illustrates the typical layout of the Lexicon General tab:

┌──────────────────────────────────────────────────────────┐
│ General                                  {save} {cancel} │
├──────────────────────────────────────────────────────────┤
│ {Properties}                │ {Editor}                   │
│ ┌─────────────────────────┐ │ ┌────────────────────────┐ │
│ │ Property Grid           │ │ │ AK=Alaska              │ │
│ │ - Name                  │ │ │ AL=Alabama             │ │
│ │ - Type                  │ │ │ AR=Arkansas            │ │
│ │ - Included Lexicons     │ │ │ CA=California          │ │
│ │ - Connection            │ │ │ CO=Colorado            │ │
│ │ - Query                 │ │ │ CT=Connecticut         │ │
│ │ ...                     │ │ │ ...                    │ │
│ └─────────────────────────┘ │ └────────────────────────┘ │
└──────────────────────────────────────────────────────────┘

• {Properties}: Edit and configure all properties of the lexicon in a Property Grid.
• {Editor}: View and edit lexicon entries with syntax highlighting and editing tools.
• {save}, {cancel}: Command buttons for saving and discarding changes.

Accessibility

• Fully navigable by keyboard and mouse.
• Contextual help and validation are provided for all properties and editor actions.
• Tooltips and context menus offer guidance for available actions.

Advanced Features

• Syntax Highlighting: Lexicon entries are highlighted according to type (vocabulary, key-value, translation).
• Read-Only Enforcement: Lexicons marked as read-only cannot be edited; the editor is disabled.
• Contextual Help: Access documentation and usage guidance for each property and editor feature.
• Keyboard Shortcuts: Efficient editing with shortcuts for select all, word wrap, control character visibility, undo, comment, and more.

Command Buttons

Button	Shortcut Key		Summary
save save		►	Save changes to the properties. The save button commits all changes made to the properties or contents of the current Lexicon. Applies edits to lexicon configuration and dictionary entries. The button is only enabled when there are unsaved changes. Tooltips provide guidance on saving and versioning.
cancel cancel		►	Discard changes to the properties. The cancel button reverts all unsaved changes to the properties or contents of the current Lexicon. Restores all properties and entries to their last saved state, discarding any edits made since the last save. The button is only enabled when there are unsaved changes. Tooltips provide guidance on canceling and data loss prevention.

Child Controls

Name	Type		Summary
Properties	Property Grid	►	Displays the properties of the lexicon and allows user editing. The Properties control presents all configurable properties of the current Lexicon in a categorized, interactive grid. Properties are grouped by category and shown as rows with their name, value, and optional description. Supports inline editing, drop-down lists, checkboxes, and expandable sections for complex or list properties. Provides contextual help and validation for each property, with a help window that updates as you select different fields. Right-click any property to access context menu commands such as Clear, Reset, Copy, and Paste. Validation errors are visually indicated, and error messages are shown in the help window. Keyboard navigation and multi-property selection are supported for efficient editing. Read-only mode is enforced for lexicons marked as read-only. Use this control to configure all aspects of the lexicon, including type, included lexicons, connection, query, abbreviations, and advanced options.
Editor	Text Editor	►	Displays the lexicon contents in an editor. The Editor control presents the contents of the lexicon in a multi-line text editor. Supports syntax highlighting for key-value pairs, vocabulary, or translation entries, depending on lexicon type. Includes toolbar buttons for saving and canceling edits, as well as toggles for word wrap and control character visibility. Keyboard shortcuts are available for efficient editing (select all, undo, comment, etc.). Provides contextual help and validation for editor actions. Read-only mode is enforced for lexicons marked as read-only. Automatically updates to reflect changes in the underlying lexicon. Use this control to add, remove, or modify lexicon entries, review dictionary content, and maintain lookup lists or translation tables.

Used By

Design Tab Host