Lexicon - Subtract

Removes all entries from this lexicon which appear in a reference lexicon.

Remarks

The Subtract command creates a new version of the selected Lexicon with all entries that are also present in a specified reference Lexicon removed. This is useful for eliminating duplicates, filtering out unwanted values, or isolating unique entries between two dictionaries.

When to Use

• To remove entries from a Lexicon that are already present in another Lexicon, such as filtering out deprecated or previously processed values.
• When you need to isolate new, unique, or unapproved entries for review or further processing.
• For quality control, deduplication, or dictionary maintenance tasks.

How It Works

• Select the source Lexicon and specify a reference Lexicon using the 'Reference Lexicon' property.
• Optionally, use the 'Include References' property to control whether only local entries or all referenced entries in the reference Lexicon are considered.
• The command removes all entries from the source Lexicon that are also found in the reference Lexicon.
• If no unique entries remain, the command will display an error and make no changes.

> Note: The operation is permanent and cannot be undone. Consider exporting a backup before subtracting.

For more information about dictionary management and comparison, see the documentation for Lexicon.

Properties

Name	Type		Description
Reference Lexicon	Lexicon	►	The reference Lexicon to subtract from the source. EditorNode Reference Editor Requiredtrue Specifies the Lexicon whose entries will be removed from the source Lexicon. Only entries unique to the source will remain after the operation. Usage Guidance Use the object selector to choose the reference Lexicon. The comparison is case-sensitive or case-insensitive depending on the configuration of the source Lexicon. The reference Lexicon should have the same 'Lexicon Type' as the source for meaningful results. > Tip: Use this property to filter out entries that have already been processed, approved, or are otherwise not needed.
Include References	Boolean	►	Specifies whether entries from referenced lexicons will be subtracted. DefaultFalse Controls whether only local entries or the full runtime content (including included or referenced lexicons) of the reference Lexicon are considered for subtraction. Usage Guidance Set to false to subtract only the local entries from the reference Lexicon. Set to true to subtract all entries, including those from any included or referenced lexicons. > Example: > If the reference Lexicon includes other lexicons (such as language variants or composite dictionaries), enabling this > option ensures all referenced entries are considered for subtraction.

See Also

Lexicon