117 lines
2.4 KiB
Markdown
117 lines
2.4 KiB
Markdown
# PDFGenerator Documentation
|
|
|
|
## Overview
|
|
|
|
PDFGenerator is a core component that handles the generation of complex PDF documents. It provides a robust foundation for both GestorePDF and PDFGeneratorLetteraBenvenuto, offering advanced PDF rendering capabilities.
|
|
|
|
## Core Features
|
|
|
|
### Layout Management
|
|
|
|
- Complex multi-section layouts
|
|
- A4 vertical and horizontal support
|
|
- Page margins and limits
|
|
- Custom headers and footers
|
|
- Automatic pagination
|
|
|
|
### Supported Elements
|
|
|
|
- Tables (`TablePDF`, `TablePDFEvolution`)
|
|
- Formatted text
|
|
- Images
|
|
- Geometric shapes (rectangles, circles)
|
|
- Lines
|
|
- Custom elements
|
|
|
|
### Advanced Features
|
|
|
|
- Automatic page breaks
|
|
- Page numbering
|
|
- Repeating headers/footers
|
|
- Index and table of contents
|
|
- Color profile management
|
|
|
|
## Report Types
|
|
|
|
1. **Base Reports**
|
|
- `Base_Proposta`
|
|
- `Unica_Diagnosi`
|
|
- `Unica_Monitoraggio`
|
|
- `Unica_Proposta`
|
|
|
|
2. **Real Estate Reports**
|
|
- `Immobiliare_Diagnosi`
|
|
- `Immobiliare_Monitoraggio`
|
|
- `Immobiliare_MappaturaPreliminare`
|
|
- `Immobiliare_Finalita`
|
|
|
|
3. **AMPRO Reports**
|
|
- `AMPRO_Semplificato`
|
|
- `AMPRO_Completo`
|
|
|
|
## Technical Implementation
|
|
|
|
### PDF Generation
|
|
|
|
- Uses `ceTe.DynamicPDF` library
|
|
- ICC color profile support
|
|
- Professional print output intent
|
|
- Configuration via `ConfigurationManager.AppSettings`
|
|
|
|
### Data Management
|
|
|
|
- Multiple data source support
|
|
- Table data binding
|
|
- Conditional formatting
|
|
- ESG data support
|
|
|
|
### Customization
|
|
|
|
- Predefined report styles
|
|
- Customizable colors
|
|
- Configurable fonts and sizes
|
|
- Adaptive layouts
|
|
|
|
## Component Integration
|
|
|
|
### Used By
|
|
|
|
1. **GestorePDF**
|
|
- Financial report generation
|
|
- Portfolio analysis
|
|
- Monitoring reports
|
|
|
|
2. **PDFGeneratorLetteraBenvenuto**
|
|
- Client communication letters
|
|
- Welcome letters
|
|
- Commercial communications
|
|
|
|
## Best Practices
|
|
|
|
1. **Layout Design**
|
|
- Use predefined styles when possible
|
|
- Follow margin and limit guidelines
|
|
- Consider page breaks in data-heavy sections
|
|
|
|
2. **Performance**
|
|
- Optimize image sizes
|
|
- Use appropriate color profiles
|
|
- Manage memory for large documents
|
|
|
|
3. **Maintenance**
|
|
- Document custom styles
|
|
- Version control for templates
|
|
- Regular configuration review
|
|
|
|
## Future Considerations
|
|
|
|
1. **Enhancements**
|
|
- Additional element types
|
|
- Enhanced style management
|
|
- Improved memory handling
|
|
|
|
2. **Integration**
|
|
- New report types
|
|
- Additional data sources
|
|
- Extended customization options
|