Chapter 08

When it breaks

Nearly every problem with the engine comes down to a name that does not match, a missing pyWorkPage prefix, or a header and footer set in the wrong place. Find what you see, then tick everything off.

Pega 24 – 26

Words you will meet

  • Symptoms
  • Checklist

Symptom, cause, fix

Find your symptom.

Type a word or pick what you see. Each entry gives the most likely cause and the fix.

Symptom finderTry it: type “blank”, “PDF” or “decision”

You see

Document ID undefined

Most likely cause

No section rows for that document ID, or a stale cache.

Fix

Check the Section table has the correct Document ID, then clear all caches.

Before you call it done

The finishing checklist.

Fifteen checks that cover the whole set-up. Your ticks are remembered in this browser only.

Quick checklistTry it: tick each one as you confirm it

0 of 15 done

Your turn

Questions and comments

Stuck on something, or have a thought? Write it here. To talk about one part, use the Comment button under that section's heading.

A hands-on guide by Sanjeev Kujur. Independent, and not affiliated with or endorsed by Pegasystems.

Tested against Pega Infinity v26 / Constellation v26 · Updated 5 Nov 2026