.. _auto_text_parameterize_by_dataset:

*PARAMETERIZE INPUT BY DATASET*
===============================

Replaces placeholder tokens in a text string with corresponding values drawn from a dataset, producing a parameterized output string. Use this worker to dynamically inject dataset-driven values (e.g., variable names, numeric results) into template text within a workflow.

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

Classification: **process**.

Tagged: ``dataset``, ``parameterize``, ``string_interpolation``, ``template``, ``text_substitution``, ``transformations``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Text
     - text
     - text
     - —
     - 
     - Template text string containing placeholder tokens (e.g., {column_name}) to be substituted with values from the dataset; leave empty if no template text is needed.
   * - Dataset
     - dataset
     - scalar
     - —
     - 
     - Dataset (scalar/tabular) whose column names and values are used to replace matching placeholders in the template text; typically a single-row dataset or key-value mapping.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - text_parameterize_by_dataset_output_1
     - text_parameterize_by_dataset_output_1
     - text
     - Resulting text string after all dataset-driven placeholder tokens have been substituted into the input template.

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

- data.dataset.transform
- data.io.csv
- 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_parameterize_by_dataset</code>. Schema hash: <code>11513dd4119e</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>