.. _auto_vault_copy_file:

*COPIES THE FILES TO A DIRECTORY ON THE SERVER*
===============================================

Copies one or more uploaded or attached files into a target directory on the d3VIEW SimVault server, creating the directory if it does not exist, and automatically extracts any archives (e.g. zip/tar) after copying. Use this worker to stage simulation files or datasets into a persistent vault location for downstream processing.

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

Tagged: ``archive``, ``file_copy``, ``file_management``, ``simulation``, ``simvault``, ``staging``, ``vault``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Files
     - files
     - file
     - —
     - ✓
     - One or more uploaded or workflow-attached files to be copied to the vault; accepts a single file object or a comma-separated list of file references.
   * - Vault Location
     - vault_location
     - text
     - /vault
     - ✓
     - Relative subdirectory path within the SimVault root (SIMVAULT_DIR) where files will be stored; defaults to '/vault' — override with a custom path such as '/vault/project_x/run_01' to organise files into project-specific folders.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Path Simulation
     - path
     - text
     - Comma-separated list of absolute server-side file paths for each successfully copied file, e.g. '/simvault/vault/run_01/model.k,/simvault/vault/run_01/results.binout'; use this as input to downstream workers that need the physical file location.

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

- data.io.archive
- data.io.file
- platform.integration

.. raw:: html

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