TYPO3 10.x.y后台编辑记录时添加TCA操作按钮的方法

你提到的processDatamap_preProcessFieldArray钩子之所以效果不理想，是因为它和记录保存动作强绑定，只能在用户点击保存时触发逻辑，无法实现「点击按钮即时调用API填充字段，用户自主决定是否保存」的交互需求。下面提供两种更贴合需求的实现方案：

方案一：自定义FormEngine按钮元素（推荐） #

通过创建自定义的FormEngine元素，在编辑表单内添加独立按钮，配合AJAX实现点击后调用API并填充字段的交互。

1. 注册自定义FormEngine元素 #

在扩展的ext_localconf.php中添加注册配置：

$GLOBALS['TYPO3_CONF_VARS']['SYS']['formEngine']['nodeRegistry'][1620000000] = [
    'nodeName' => 'apiFillButton',
    'priority' => 40,
    'class' => \Vendor\YourExtension\FormEngine\Element\ApiFillButtonElement::class,
];

2. 编写自定义按钮元素类 #

创建Classes/FormEngine/Element/ApiFillButtonElement.php文件：

<?php
namespace Vendor\YourExtension\FormEngine\Element;

use TYPO3\CMS\Backend\Form\Element\AbstractFormElement;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Core\Page\PageRenderer;

class ApiFillButtonElement extends AbstractFormElement
{
    public function render()
    {
        $resultArray = $this->initializeResultArray();
        
        // 构建AJAX请求路由
        $ajaxUrl = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Routing\UriBuilder::class)
            ->buildUriFromRoute('your_extension_api_fill');
        
        // 绑定按钮点击事件的JS逻辑
        $jsCode = <<<JS
document.addEventListener('DOMContentLoaded', function() {
    const fillBtn = document.getElementById('api-fill-btn');
    fillBtn.addEventListener('click', async function() {
        const recordId = this.dataset.recordId;
        const table = this.dataset.table;
        
        try {
            const response = await fetch('{$ajaxUrl}', {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/json',
                    'X-TYPO3-CSRF-Token': TYPO3.settings.csrfToken
                },
                body: JSON.stringify({table, uid: recordId})
            });
            
            const resData = await response.json();
            if (resData.success) {
                // 遍历填充表单字段
                Object.keys(resData.fields).forEach(field => {
                    const input = document.querySelector('[data-formengine-input-name="data[' + table + '][' + recordId + '][' + field + ']"]');
                    if (input) {
                        input.value = resData.fields[field];
                        input.dispatchEvent(new Event('change'));
                    }
                });
                alert('字段填充完成');
            } else {
                alert('填充失败：' + resData.message);
            }
        } catch (err) {
            alert('请求出错：' + err.message);
        }
    });
});
JS;
        
        $pageRenderer = GeneralUtility::makeInstance(PageRenderer::class);
        $pageRenderer->addJsInlineCode('apiFillBtnLogic', $jsCode);
        
        // 渲染按钮HTML
        $buttonHtml = '<button type="button" id="api-fill-btn" class="btn btn-primary" 
            data-record-id="' . $this->data['databaseRow']['uid'] . '" 
            data-table="' . $this->data['tableName'] . '">调用API填充字段</button>';
        
        $resultArray['html'] = $buttonHtml;
        return $resultArray;
    }
}

3. 配置AJAX路由与CSRF白名单 #

继续在ext_localconf.php中添加：

// 注册AJAX路由
$GLOBALS['TYPO3_CONF_VARS']['BE']['routes'][] = [
    'route' => '/your-extension/api-fill',
    'target' => \Vendor\YourExtension\Controller\ApiFillController::class . '::fillAction'
];

// 加入CSRF令牌白名单
$GLOBALS['TYPO3_CONF_VARS']['BE']['csrfTokenWhitelist'][] = 'your_extension_api_fill';

4. 编写AJAX控制器处理API调用 #

创建Classes/Controller/ApiFillController.php文件：

<?php
namespace Vendor\YourExtension\Controller;

use Psr\Http\Message\ResponseInterface;
use TYPO3\CMS\Core\Http\JsonResponse;
use TYPO3\CMS\Core\Database\ConnectionPool;

class ApiFillController
{
    public function fillAction(\Psr\Http\Message\ServerRequestInterface $request): ResponseInterface
    {
        $requestData = json_decode($request->getBody()->getContents(), true);
        $table = $requestData['table'] ?? '';
        $uid = (int)$requestData['uid'] ?? 0;
        
        // 权限校验
        if (!$GLOBALS['BE_USER']->check('tables_modify', $table) || !$GLOBALS['BE_USER']->checkRecord($table, $uid)) {
            return new JsonResponse(['success' => false, 'message' => '无操作权限']);
        }
        
        // 调用外部API获取数据（自行实现具体逻辑）
        $apiData = $this->fetchExternalApiData();
        if (!$apiData) {
            return new JsonResponse(['success' => false, 'message' => 'API调用失败']);
        }
        
        // 映射API数据到表单字段（根据实际需求调整）
        $fieldsToFill = [
            'title' => $apiData['title'],
            'description' => $apiData['desc'],
            'price' => $apiData['amount']
        ];
        
        return new JsonResponse([
            'success' => true,
            'fields' => $fieldsToFill
        ]);
    }
    
    private function fetchExternalApiData()
    {
        // 示例：调用外部API
        $apiUrl = 'https://your-api-domain.com/get-data';
        $response = file_get_contents($apiUrl);
        return json_decode($response, true);
    }
}

5. 在TCA中添加按钮字段 #

在目标表的TCA配置（如Configuration/TCA/Overrides/your_table.php）中添加按钮字段：

$GLOBALS['TCA']['your_table']['columns']['api_fill_button'] = [
    'label' => 'API填充操作',
    'config' => [
        'type' => 'apiFillButton',
        'renderType' => 'apiFillButton'
    ]
];

// 将按钮加入表单显示项
$GLOBALS['TCA']['your_table']['types']['default']['showitem'] .= ',--div--;API操作,api_fill_button';

方案二：后端模块配合编辑页跳转（备选） #

如果不想自定义FormEngine元素，可创建一个后端模块：

1. 在模块中提供记录选择下拉框和「API填充」按钮
2. 点击按钮后调用API更新记录数据
3. 跳转回该记录的编辑页面
   这种方式无需修改表单结构，但交互流畅度略低于方案一。

内容的提问来源于stack exchange，提问作者alex999