..  include:: /Includes.rst.txt
..  _columns-flex-properties-ds-tablefield:

==============
ds\_tableField
==============

..  note::
    This configuration option will not be handled anymore with TYPO3 v13+.
    Beginning with TYPO3 v12 you can migrate to PSR-14 events to manipulate the
    data structure lookup logic:

*   :ref:`t3coreapi:AfterFlexFormDataStructureIdentifierInitializedEvent`
*   :ref:`t3coreapi:AfterFlexFormDataStructureParsedEvent`
*   :ref:`t3coreapi:BeforeFlexFormDataStructureIdentifierInitializedEvent`
*   :ref:`t3coreapi:BeforeFlexFormDataStructureParsedEvent`

..  confval:: ds_tableField

    :Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']
    :type: string
    :Scope: Display  / Proc.

    Contains the value "[table]:[field name]" from which to fetch Data Structure XML.

    :ref:`ds_pointerField <columns-flex-properties-ds-pointerfield>` is in this case the pointer which
    should contain the uid of a record from that table.

Examples
========

This is used by TemplaVoila extension for instance where a field in the "tt\_content" table points to
a TemplaVoila Data Structure record:

.. code-block:: php

   'tx_templavoila_flex' => [
      'label' => '...',
      'displayCond' => 'FIELD:tx_templavoila_ds:REQ:true',
      'config' => [
         'type' => 'flex',
         'ds_pointerField' => 'tx_templavoila_ds',
         'ds_tableField' => 'tx_templavoila_datastructure:dataprot',
      ],
   ],