Skip to content

CAT Scan

The CAT Scan screen provides a diagnostic overview of your project metadata. Think of it as a health check for your data solution — it scans your metadata and highlights potential issues or areas that need attention.

The CAT Scan reviews your project metadata and checks for common issues such as:

  • Missing connections — Data objects that aren’t assigned to a connection.
  • Incomplete definitions — Objects or items that are missing key properties.
  • Mapping issues — Mappings that reference objects or items that don’t exist or are incomplete.
  • Consistency checks — Items that don’t follow your project’s conventions or standards.

The scan results give you a clear list of things to look at. From here, you can navigate directly to the affected objects and make corrections.

As your project grows, it’s easy for small issues to slip in — a data object without a connection, a mapping that references a deleted column, or a template mapping that points to a missing template. The CAT Scan catches these things before they cause problems during code generation.

It’s especially useful:

  • Before generating output — Run a scan to make sure everything is in order.
  • After importing metadata — Verify that imported structures are complete and consistent.
  • During project reviews — Get a quick overview of project health.
  • Run it regularly — A quick scan before generating output can save you from tracking down confusing errors later.
  • Address issues in order — Start with connection and object issues before worrying about mappings, since mappings depend on objects being correctly defined.