Чтобы изменить имя поля и сохранить его значения, используйте Rename в Generator UI. Удаление поля и создание нового не считается переименованием и может привести к потере данных.
Переименуйте поле в генераторе
Откройте Content → нужная сущность → поле. Сначала сохраните или отмените остальные правки в редакторе. Затем:
- Нажмите Rename и введите новое имя.
- Нажмите Preview rename. Проверьте новое имя в API, имя колонки БД и ссылки на поле внутри модели.
- Если изменения верны, нажмите Confirm rename.
Что делать после подтверждения
- Откройте Generate → Preview changes.
- Проверьте файлы и миграцию переименования.
- Выполните Generate.
- Адаптируйте собственный код и внешние клиенты, использующие старое имя API.
- Примените миграции при обновлении окружения.
Например, вы переименовали Article.shortText в Article.summary. Генератор запомнит, что это то же поле с новым именем. Колонка в БД переименуется позже — когда вы примените созданную миграцию. Для production следуйте процессу обновления, который включает резервную копию.
Ограничения
В текущей версии Rename не переименовывает первичные ключи и физические ключи отношений. Если предварительный просмотр показывает зависимость, которая мешает действию, сначала устраните её. Ссылки на старое имя в custom-коде исправьте самостоятельно: генератор не редактирует ваши файлы.
Если после подтверждения пропало соединение, нажмите Refresh field и проверьте, сохранилось ли новое имя. Только после этого решайте, нужно ли повторять действие. Если за это время кто-то изменил модель, снова откройте предварительный просмотр.
Все настройки поля описаны в статье «Редактор полей». Переименование доступно и через CLI, с таким же предварительным анализом изменений. Команды приведены в разделе «CLI интерфейс».