.. meta::
    :description: Extensions XSLT

XSLT
====

This section explains how to create and edit XSLT (Extensible Stylesheet Language Transformations) files.

Usage
-----
XSLT files are used during the report generation.

.. seealso::
    :ref:`reports`

.. _filesLocationXSLTExtension:

Files location
--------------
To be recognized by the application, XSLT files should be located in one of these folders:

- %LocalAppData%/ORS/Dragonfly(*version*)/pythonUserExtensions/XSLTs (available for the current user)
- %ProgramData%/ORS/Dragonfly(*version*)/pythonAllUsersExtensions/XSLTs (available for all users)
- %ProgramData%/ORS/Dragonfly(*version*)/python/orsxslt (distributed with the application)

File creation
-------------
To create a XSLT file:

#. copy one of the existing .xsl files (see :ref:`XSLT extension folder <filesLocationXSLTExtension>`);
#. update the contents of the ``<ors:bibliography>`` node, especially the one for the uuid, by getting the value of
   ``generatedUUIDNoDash`` from::

    import uuid
    generatedUUID = str(uuid.uuid1())
    generatedUUIDNoDash = generatedUUID.replace('-', '')

#. update the contents of the ``<ors:support>`` node;
#. update the contents of the ``<xsl:template match="/orsresults">`` node.

File edition
------------
Open the file in a text editor.