.. _auto_text_template_keyvalue:

*TEMPLATE WITH KEYVALUE*
========================

Renders a plain-text template by substituting named placeholders with user-supplied key-value pairs. Use this worker whenever a downstream step requires a dynamically assembled text string — such as a file path, command line, or keyword block — built from variable parameters at runtime.

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

Classification: **process**.

Tagged: ``keyvalue``, ``placeholder_substitution``, ``string_interpolation``, ``template``, ``text_generation``, ``transformation``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Template
     - template
     - textarea
     - —
     - 
     - Text body containing named placeholders (e.g. {{key}} or ${key}) that will be replaced at runtime; enter the template source directly in the code editor — leave blank only if the substituted text is to be provided entirely by the parameters map.
   * - Parameters
     - parameters
     - keyvalue
     - —
     - 
     - Key-value map whose keys match the placeholder names in the template and whose values supply the substitution strings; add one entry per placeholder that needs to be resolved.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - text_template_output_1
     - text_template_output_1
     - text
     - Fully rendered plain-text string produced after all placeholder keys in the template have been replaced with their corresponding values from the parameters map.

Disciplines
-----------

- data.dataset.transform
- platform.workflow

.. raw:: html

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