Problem
Users report errors when generating PDF documents that use the KT Agenda component. The error typically manifests as a PDF generation failure, often with ‘Attempt to de-reference a null object’ messages or blank/incomplete agenda sections in the output.
What We Found
KT Agenda PDF errors commonly occur when: (1) Itinerary items have missing or incomplete data that the agenda handler expects, (2) Template configuration has a KT Agenda Handler that references fields not present on certain service types, (3) Custom items or service configurations create null references during PDF rendering.
Solution
- Identify the specific itinerary where the PDF error occurs and note which template is being used
- Check the Template__c record for the KtAgendaHandler__c field - this defines the Apex class creating the agenda query
- Review itinerary items for any services with missing required fields (dates, locations, service names)
- Test PDF generation on a simpler itinerary to isolate whether the issue is data-specific or template-wide
- If a custom KT Agenda Handler is configured, verify it handles null values gracefully for all service types
- Check for any recent changes to service configurations or content that may have introduced null references
Notes
- KT Agenda issues have been reported across multiple customers since 2016, indicating this is a complex component with various edge cases
- The KtAgendaHandler__c field on Template__c defines an Apex class which creates custom queries for Itinerary Items and Custom Items used in KT Agenda components
- Related tickets include KHELP-11647 (null object on PDF print), KHELP-10984 (KTAgenda showing duplicate info), KHELP-11674 (same day car hire in agenda)
Warnings
⚠️ Do not modify KT Agenda Handler Apex classes without understanding the full impact on PDF generation across all templates ⚠️ Changes to service type configurations may affect how items appear in KT Agenda across all itineraries
Source: KHELP-11425