# cee::rep::ReportCreatorHtml

class `ReportCreatorHtml`

  Report creator for an HTML report.

  The report creator contains the necessary information and data to create an HTML report based on a given template.

  The report creator object must be given a repository and a template file name upon creation. Additional settings such as a reference repository, generic snapshots indices and media type in the generated report are also available.

  After applying the necessary settings, the report is created using generate() specifying the name of the generated report.

  For some scenarios it can be convenient to create a report using images instead of 3D models. For instance if the receiver is not able to go online for the Ceetron Cloud or just a report where the 3D interaction is not needed. Instead of having to create a new template using images, set setUse3dPlugin(false) and all 3D model objects in the template will be replaced with snapshot if these are available within the VTFx file. Default is to use the 3D model for VTFx snapshots.

  Generic snapshots will default unroll for all snapshots with matching type in the repository. If only a sub-set of these should be used, you can specify this using setGenericSnapshotIndices().

  Note! In PowerPoint and Word, the VTFx file is embedded into the .pptx/.docx file. But for HTML reports, we put the VTFx in the cloud using Ceetron Cloud (https://cloud.ceetron.com) and reference this in the report. To enable the cloud integration, the user need to specify the url to the VTFx model in the Snapshot object using Snapshot::setCloudViewerUrl() instead of (or in addition to) Snapshot::setModelVtfx(). See Ceetron Cloud: Add a Send-To-Cloud Button to Your App for how to upload the VTFx to cloud. The QtRepositoryManager and WinFormsReport examples provided in the distribution has example code for this.

  See also

  Repository

  Public Functions

  `ReportCreatorHtml`(Repository *repository, const Str &templateFile)

    Creates a report creator for an HTML document based on the given repository and template file.

  bool `generate`(const Str &reportFile) const

    Generates a report and save it to the file name given by reportFile.

    Returns true if the report was successfully created. Returns false if an error occurred.

  bool `validate`(Str *summary) const

    Validates the template and creates a summery of the compatibility between the template and the repository.

  void `setReferenceRepository`(Repository *repository)

    Sets a reference repository to be used for this report generation.

  void `setGenericSnapshotIndices`(const std::vector<unsigned int> &indices)

    Sets the array of indices used for generic snapshots.

  void `setUse3dPlugin`(bool use)

    Sets whether the report should use the 3D plugin/cloud integration.

    Setting use to false will replace all VTFx tagged objects in the template with images.

  Public Static Functions

  static bool `summarize`(const Str &templateFile, Str *summary)

    Summarizes the content of the template file.

Conversation saved
HOOPSY BETA

### Hello! I'm HOOPSY

Your multilingual generative AI assistant for documentation. Ask me anything about HOOPS Envision for Desktop in your own language, or choose a sample question below to start a conversation:

What is HOOPS Envision for Desktop?
What are the latest release notes for HOOPS Envision for Desktop?
How do I start evaluating HOOPS Envision for Desktop?
How do I write my first sample application?
How can I get assistance?

HOOPSY may store conversations according to OpenAI's policy. Responses may not always be accurate.

HOOPSY is thinking...