Troubleshooting and Debugging15% of the exam

Troubleshooting stale and missing cached data

How to diagnose Omnistudio cache problems: different default lifetimes, caching that never happens in Preview, failed runs that cache nothing, cache headers and resetCache on REST calls, clearing Data Mapper and Integration Procedure caches with the Connect API, and turning off the Flexcard and Scale caches.

Official exam objective
Resolve caching problems.

~6 min read · 4 practice questions ·

What the exam expects

  • Explain why cached data expires sooner or later than expected from each component's Time To Live defaults.
  • Diagnose caching that never happens in Preview or after a failed run, and read the vlcCache nodes or REST headers.
  • Clear Data Mapper or Integration Procedure caches with the Connect API, for one component or all of them.
  • Name the partitions involved, and turn off the Flexcard cache or the Scale Cache when stale or sensitive data must not be cached.

Key terms: Time To Live In Minutes (how long cached data stays), ignoreCache / resetCache (options that skip the cache or force a save), vlcCacheResult (true when data came from the cache), VlocityAPIResponse (the partition for Cache Block output), Scale Cache (how Standard Runtime implements Org and Session Cache).

Key facts

Cache Block TTL
Detail
Minimum 5; default 5; Org max 2,880, Session max 480
Data Mapper Org Cache default
Detail
1,440 minutes (24 hours)
Preview ignoreCache
Detail
Default true; set false to test caching
Failed top-level run
Detail
Its data isn't cached
REST cache values
Detail
vlcCache* nodes come back as headers
Cache Block partition
Detail
VlocityAPIResponse
Clear all Data Mapper metadata
Detail
cacheStorageType Metadata, no dataMapperList
Clear everything for one IP
Detail
CacheStorageType.All with its ipKey
Scale Cache off
Detail
TurnOffScaleCache = true in Omni Interaction Configuration
Sources for this section (7)
  • Why can a Data Mapper's Org Cache stop working after a security change?
  • When does an Integration Procedure with top-level caching save nothing to the cache?
  • Why can a Data Mapper with no caching of its own still return cached data?
  • Where do you turn off the Scale Cache?

The questions are free to read. Answers with their sources and self-grading are included with the pack.

Keep reading with the Omnistudio Developer pack

  • Core concepts
  • Exam traps
  • Worked scenario

The pack includes:

  • All 46 lessons of the Omnistudio Developer guide, with reading progress
  • Interactive decision walks and step-by-step sequence steppers
  • Inline practice questions and one-click topic practice (4 questions for this lesson)
  • An official source cited for every claim
  • An AI tutor that answers from the guide
  • Unlimited timed practice exams

Practice for the Omnistudio Developer exam