1
0
mirror of https://github.com/1C-Company/v8-code-style.git synced 2025-04-02 17:49:02 +02:00
v8-code-style/docs/tools/autosort.md

3.5 KiB

Авто-сортировка метаданных

Все метаданные верхнего уровня должны быть отсортированы по алфавиту.

Расширение позволяет автоматически сортировать коллекции метаданных при любой модификации, например:

  • Добавление нового метаданного - автоматически устанавливает его на нужной позиции в Навигаторе 1С.
  • Переименование метаданного - так же перемещает его на новую позицию согласно новому имени.
  • Слияние веток, сравнение-объединение так же могут приводить изменениям имени и запускают сортировку.

Включение настройки

  • Для новых создаваемых проектов авто-сортировка включается по умолчанию.
  • Для существующего проекта включить автосортировку можно в настройках проекта Свойства - V8 - Авто сортировка - Все верхнеуровневые объекты метаданных (Англ. Properties -> V8 -> Auto sort -> All top metadata objects)

Дополнительные возможности

  • Не сортируются объекты, порядок которых влияет на реструктуризацию БД (измерения регистров, общие реквизиты конфигурации)
  • Сортировка подчиненных объектов метаданных (реквизиты, формы, макеты и т.д.) - настройка по умолчанию не включена

Запуск из командной строки (CLI)

Доступен запуск сортировки проекта из командной строки. Команда может выполнять импорт проекта в рабочее пространство и сортировку проекта. Если в проекте не настроена сортировка - будет включена авто-сортировка с настройками по умолчанию.

Пример:

// вывод справки по команде сортировки
1cedtcli -data ./ws -command help sort-project

// запуск сортировки по проекту с импортом в рабочую область
1cedtcli -data ./ws -command sort-project --project-list "${PWD}/myproject"

// запуск сортировки по проекту существующему в рабочей области
1cedtcli -data ./ws -command sort-project --project-name-list "myproject"

Отключение настройки

  • Отключить настройку автосортировки можно в настройках проекта Свойства - V8 - Авто сортировка - Все верхнеуровневые объекты метаданных (Англ. Properties -> V8 -> Auto sort -> All top metadata objects)
  • Удалить файл в настройках проекта ProjectName/.settings/com.e1c.v8codestyle.autosort.prefs

См. также