TP_SEI_Project/arm_PDFGenerator.md
2025-04-15 15:16:14 +02:00

2.4 KiB

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