## Overview

The Template Placeholders widget shows the placeholders that can be used in the target document that result from the configured mappings. When a template file is uploaded to a Report Configuration page, this widget parses the document and displays a table of all detected placeholders that can be populated with data through cplace.js scripts.

The widget displays format-specific information: slide numbers for PowerPoint, cell locations for Excel, and placeholder types for all formats. It serves as a reference tool for developers configuring report templates.

## Use Cases

- **Template validation**: Verify that a newly uploaded template contains the expected placeholders before writing the population script
- **Script development**: Reference the exact placeholder names while writing cplace.js report scripts to ensure correct spelling and casing
- **Template maintenance**: Review changes to placeholder lists when updating existing report templates
- **Troubleshooting**: Diagnose report generation issues by comparing template placeholders against script-defined values

## Design Considerations

This widget is specifically designed for Report Configuration pages and cannot be embedded elsewhere. It is a read-only display widget that automatically refreshes when the template file changes. The widget adapts its table columns based on the document format (PPT shows slide numbers, Excel shows cell locations).

Use this widget alongside the Script Placeholders widget to provide a complete view of both template-based and dynamically-defined placeholders on report configuration pages.

## Related Widgets

- **Script Placeholders** (`cf.cplace.officeReports.scriptPlaceholders`) - Shows placeholders defined in the report script code, complementing the template-based placeholders shown by this widget
- **Generate Report** (`cf.cplace.cplaceReportGeneration.generateReportWidget`) - Triggers report generation using the placeholders configured through template and script widgets
- **Headline for Reports** (`cf.cplace.officeReports.headlineForReports`) - Provides UI elements for report configuration pages in the Office Reports suite