.. _auto_generate_report_template:

*GENERATE REPORT TEMPLATE*
==========================

Converts a report-template OUTLINE (pages + visualizations) into a validated, renderable Simlytiks v3 layout (the report template). Server-side port of the client generate_report_template tool. Pass `report_template_outline` (and `dataset_variable_id` for column validation); the `reportTemplate` output is the layout JSON to save to memory and submit.

When to use
-----------

Tagged: ``agent``, ``report``, ``simlytiks``, ``template``, ``autonomous``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Report Name
     - report_name
     - string
     - —
     - ✓
     - Name of the report template to generate.
   * - Report Template Outline
     - report_template_outline
     - string
     - —
     - ✓
     - The outline {reporterTitle, pageCollection:[{title, visualizations:[{title, chartType, fields}]}]}. `fields` is a per-chartType JSON string.
   * - Dataset Variable Id
     - dataset_variable_id
     - string
     - —
     - 
     - Optional agent_memory::<name> id of the records dataset; the orchestrator resolves it to real records for column-reference validation.
   * - Records
     - records
     - string
     - —
     - 
     - INJECTED by the orchestrator (the real records dataset) for column validation. Not normally agent-supplied.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Report Template
     - reportTemplate
     - string
     - The validated v3 Simlytiks layout JSON (the report template). Save this to memory and pass its id to submit_deliverable.
   * - Status
     - status
     - string
     - Success or Warning (with the specific column/empty-page issues to fix before saving).

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>generate_report_template</code>. Schema hash: <code>0fb8914a8284</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>