..  include:: /Includes.rst.txt

..  _deprecation-107562-1736193200:

=======================================================================
Deprecation: #107562 - IP Anonymization Task configuration via $GLOBALS
=======================================================================

See :issue:`107562`

Description
===========

The :php:`\TYPO3\CMS\Scheduler\Task\IpAnonymizationTask` has been migrated to
use TYPO3's native TCA-based task configuration system. As part of this
migration, the previous configuration method using
:php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['scheduler']['tasks'][IpAnonymizationTask::class]['options']['tables']`
has been deprecated and will be removed in TYPO3 v15.0.

Impact
======

Using the old configuration method will trigger a PHP deprecation warning.
The functionality continues to work for now, with the deprecated configuration
being merged with the new TCA-based configuration automatically.

Affected installations
======================

Any installation that configures custom tables for the
:php-short:`\TYPO3\CMS\Scheduler\Task\IpAnonymizationTask` using the deprecated
:php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']` configuration.

The extension scanner will report any usage as a **weak match**.

Migration
=========

Instead of configuring tables via :php:`$GLOBALS['TYPO3_CONF_VARS']`, tables
should now be configured in TCA using the :php:`taskOptions` configuration of
the corresponding record type within
:file:`Configuration/TCA/Overrides/`.

Before (deprecated):

..  code-block:: php
    :caption: ext_localconf.php

    use TYPO3\CMS\Scheduler\Task\IpAnonymizationTask;

    $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['scheduler']['tasks'][IpAnonymizationTask::class]['options']['tables']['tx_myextension_my_table'] = [
            'dateField' => 'tstamp',
            'ipField' => 'private_ip',
        ];

After (new method):

..  code-block:: php
    :caption: Configuration/TCA/Overrides/scheduler_ip_anonymization.php

    use TYPO3\CMS\Scheduler\Task\IpAnonymizationTask;

    if (isset($GLOBALS['TCA']['tx_scheduler_task'])) {
        $GLOBALS['TCA']['tx_scheduler_task']['types'][IpAnonymizationTask::class]['taskOptions']['tables'] ['tx_myextension_my_table'] = [
                'dateField' => 'tstamp',
                'ipField' => 'private_ip',
            ];
    }

It is also possible to modify the tables added by TYPO3, for example changing
the :php:`dateField` of :sql:`sys_log`:

..  code-block:: php

    use TYPO3\CMS\Scheduler\Task\IpAnonymizationTask;

    if (isset($GLOBALS['TCA']['tx_scheduler_task'])) {
        $GLOBALS['TCA']['tx_scheduler_task']['types'][IpAnonymizationTask::class]['taskOptions']['tables']['sys_log']['dateField']
            = 'custom_date';
    }

The new TCA-based configuration provides the same functionality while
integrating better with TYPO3's native scheduler task system and FormEngine.

..  index:: PHP-API, Scheduler, TCA, FullyScanned, ext:scheduler