Attention

TYPO3 v11 has reached end-of-life as of October 31th 2024 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v10 here: TYPO3 ELTS.

Data structure (ds)

ds

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

Data Structure(s) defined in an array.

Each key is a value that can be pointed to by ds_pointerField. Default key is "default" which is what you should use if you do not have a ds_pointerField value of course.

If you specified more than one ds_pointerField, the keys in this "ds" array should contain comma-separated value pairs where the asterisk * matches all values (see the example below). If you don't need to switch for the second ds_pointerField, it's also possible to use only the first ds_pointerField's value as a key in the "ds" array without necessarily suffixing it with ",*" for a catch-all on the second ds_pointerField.

For each value in the array there are two options:

Either enter XML directly
Make a reference to an external XML file

Examples

Example with XML directly entered

'config' => [
   'type' => 'flex',
   'ds_pointerField' => 'list_type',
   'ds' => [
      'default' => '
         <T3DataStructure>
            <ROOT>
               <type>array</type>
               <el>
                  <xmlTitle>
                     <TCEforms>
                        <label>The Title:</label>
                        <config>
                           <type>input</type>
                        </config>
                     </TCEforms>
                  </xmlTitle>
               </el>
            </ROOT>
         </T3DataStructure>
      ',
   ],
],

Example with XML in external file

'config' => [
   'type' => 'flex',
   'ds_pointerField' => 'list_type',
   'ds' => [
      'default' => 'FILE:EXT:mininews/Configuration/FlexForms/Mininews.xml',
   ],
],