The Workflow Library

Library / Data quality / data-quality-049

Custom object property normalization (picklist mapping from free text)

Data qualityCustomData Hub EnterpriseAdvanced~45 min to buildFull spec

Outcome. A free-text field on a custom object that different people or import sources fill in inconsistently gets mapped to a small, standard set of categories automatically, the same lookup-table pattern used for standard-object fields in data-quality-014, applied here to a custom object.

Workflow map Enrollment, branches and actions at a glance data-quality-049
flowchart TD
    A[Equipment type (raw) known or changed] --> B[Custom code: normalize and look up mapping table]
    B --> C{Match found?}
    C -->|yes| D[Set Equipment category]
    C -->|no| E[Category: Other - needs mapping]
    E --> F[Add to unmapped review list]
action or delay branch public on every spec, paid or not

When to use it, when not to

  • UseUse it whenever a custom object carries a free-text field that really only has a handful of meaningful values underneath the inconsistent spelling, a raw equipment-type field variously entered as laptop, Laptop computer, LAPTOPS, all meaning the same category.
  • UseUse it once you have reviewed a real sample of the raw values and built a mapping table that covers the actual variants in your data, not a guessed list.
  • SkipDo not use it if the free-text field genuinely needs open-ended detail beyond a small category set. Forcing every raw value into a narrow picklist loses information some reports may still need; keep the raw field alongside the categorized one rather than replacing it.
  • SkipDo not use it on a custom object where records are created faster than someone reviews new unmapped raw values appearing. An unmaintained mapping table just accumulates a growing unmapped bucket nobody looks at.
The preview ends here. Six sections are in the library. counted, not blurred
PrerequisitesEvery property with its label, internal name, type and options, plus the assets the workflow needs before you start.6 items
EnrollmentThe trigger, the criteria exactly as they are ticked in the UI, the re-enrollment rule and the suppression list.4 parts
StepsEach action in order with its parameters, its branches and its delays, written as you tick them.5 numbered actions
Known pitfallsTraps seen in production, each with what breaks and what to do instead.4 pitfalls
Test plan, variants and build specHow to prove it works in a test portal, where to look when it does not, the variants for other objects or tiers, and the YAML build spec.3 variants, 3 sections
FilesThe properties JSON creates the fields in one API call, the workflow JSON documents the build, and the custom coded action ships as a ready-to-paste .js file.PDF, Markdown, JSON, code
Install1 click. The installer creates the properties this spec declares and the workflow itself, switched off, then opens a task for the prerequisites that are assets rather than properties, such as a team, a static list or a marketing email. What it created is listed on the install page.1 click, switched off
Unlock the full library, 149 EUR

or the data quality pack, 39 EUR

One-time, excl. VAT. 30-day refund, no questions asked. Founding prices until 31 October, then 199 and 59 EUR. Includes every spec added later, up to the full 500, and the one-click installer on the full library. Building on client portals? The agency licence at 449 EUR covers unlimited client portals.