.. _auto_dataset_convert_paths_to_urls:

*CONVERT PATHS TO URLS*
=======================

Prepends a configurable URL prefix (default `/api/fileexplorer?d=`) to every value in a specified path column, making filesystem paths HTTP-fetchable. Also stamps the target column's schema `dataType` (default `3dview`) so downstream pickers such as Peacock's `modelBy` can discover it. Optionally writes results to a new column, leaving the original untouched.

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

Tagged: ``3dview``, ``column-transform``, ``dataset``, ``fileexplorer``, ``path-to-url``, ``peacock``, ``schema-datatype``, ``url-prefix``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Input Dataset
     - input_dataset
     - dataset
     - —
     - ✓
     - Tabular dataset containing at least one column of raw filesystem paths to be converted to URLs.
   * - Column
     - column
     - text
     - —
     - ✓
     - Name of the column whose cell values are filesystem paths; must match an existing column in `input_dataset` exactly.
   * - URL Prefix
     - url_prefix
     - text
     - /api/fileexplorer?d=
     - 
     - String prepended to every path value to form a full URL; leave at default `/api/fileexplorer?d=` for standard d3VIEW file serving, or supply a custom base URL for other backends.
   * - Output Column dataType
     - new_data_type
     - select
     - 3dview
     - 
     - Schema `dataType` assigned to the output column so downstream pickers can filter on it; choose `3dview` for Peacock model pickers, `image` for image viewers, `file`/`url` for generic downloads — defaults to `3dview`.
   * - Output Column Name
     - output_column
     - text
     - —
     - 
     - Name of the new column to hold the URL-converted values; if left blank the source column is mutated in place, otherwise the original column is preserved unchanged.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Dataset With URL Column
     - output_dataset
     - dataset
     - Copy of the input dataset with the target column's values replaced (or a new column added) containing fully-formed URLs, and the column's schema `dataType` set to the requested value.

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

- data.dataset.transform
- platform.workflow

Runnable example
----------------

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: `/api/workflow/example?id=dataset_convert_paths_to_urls <https://www.d3view.com/api/workflow/example?id=dataset_convert_paths_to_urls>`_

.. raw:: html

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