Documentation Update (#381)

Finish documentation for template reordering in both server and
serverless, along with JSON in serverless

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Visesh Rajendraprasad <viseshrp@users.noreply.github.com>
Co-authored-by: JennaPaikowsky <98607744+JennaPaikowsky@users.noreply.github.com>

Author: 4 people

doc/source/lowlevelapi/TemplateObjects.rst

@@ -198,7 +198,19 @@ Returns the filter mode of the template. The possible outputs are:
 Sets the filter mode of the template. Takes as input a string. See
 get_filter_mode for the accepted values.
 
-Example of usage. Let's assume you want to create a template like the
+**template.reorder_child(target_child_template, new_position)**
+
+Reorders a child template within the list of children to a specified position.
+
+
+This method moves a child template (identified by its GUID or the template object itself)
+to a new position within the `children` list of the current template. It ensures that
+the specified position is valid and that the target child template exists in the `children` list.
+
+Example of Usage
+^^^^^^^^^^^^^^^^
+
+Let's assume you want to create a template like the
 one shown in the picture (from the documentation example in the
 Ansys Dynamic Reporting installer):
 

doc/source/serverless/templates.rst

@@ -99,6 +99,9 @@ Common methods include:
 - ``set_property(props_dict)``: Replace the “properties” dictionary.
 - ``add_property(props_dict)``: Add/update keys within the “properties” dictionary.
 - ``render(context=None, item_filter="", request=None)``: Render the template to HTML string.
+- ``to_dict()``: Returns a JSON-serializable dictionary of the full template tree.
+- ``to_json(filename)``: Store the template as a JSON file. Only allow this action if this template is a root template.
+- ``reorder_child(target_child_template, new_position_index)``: Reorder the target template in the `children` list to the specified position.
 
 Template Parameters
 -------------------
@@ -285,6 +288,15 @@ Example: Creating a Nested Template Structure
     results_panel.set_filter("A|i_tags|cont|section=results;")
     results_panel.save()
 
+Loading Templates from a JSON file
+----------------------------------
+
+You can load a report with multiple templates from an existing JSON file.
+
+.. code-block:: python
+
+    adr.load_templates_from_file("my_report.json")
+
 Rendering Templates
 -------------------
 

src/ansys/dynamicreporting/core/serverless/template.py

@@ -409,7 +409,7 @@ def to_json(self, filename: str) -> None:
 
     def reorder_child(self, target_child_template: "Template", new_position: int) -> None:
         """
-        Reorder the template.guid in parent.children to the specified position.
+        Reorder the target template in the `children` list to the specified position.
 
         Parameters
         ----------