creator/cc-1c-skills
1
0
Fork 0
mirror of https://github.com/Nikolay-Shirokov/cc-1c-skills.git synced 2026-08-02 17:57:45 +03:00
Code Issues Packages Projects Releases Wiki Activity

docs(specs,db-guide): лестница версий формата 2.17-2.18-2.19-2.20

Browse Source 
Спеки утверждали, что за 2.17 (8.3.20-8.3.24) сразу идёт 2.20 (8.3.27+),
и приписывали версии 2.20 всю дельту. Промежуточные версии существуют:
8.3.25 пишет 2.18, 8.3.26 - 2.19.

Атрибуция изменений исправлена по замеру одной конфигурации, выгруженной
четырьмя платформами: TypeReductionMode и TextToSpeech - 2.18, отказ ролей
писать право, равное setForNewObjects, - 2.19, LineNumberLength - 2.20.

Два утверждения о «дельте 2.20» в 1c-configuration-spec § 7 были ошибочны и
удалены. Сжатая шапка xmlns оказалась артефактом стороннего сериализатора в
эталонном дампе, а не форматом: платформа во всех версиях пишет полную шапку.
Стиль пустых элементов признаком версии не является - он различается и между
дампами одной версии.

Добавлено: ConfigurationExtensionCompatibilityMode платформа при выгрузке
подставляет свой собственный даже при неизменной конфигурации; три свойства
форм из 2.18 - изменение дефолта эмиссии, а не новые свойства (8.3.24
принимает их и сохраняет при роундтрипе, в отличие от TypeReductionMode).

В db-guide зафиксировано побайтовое совпадение выгрузок конфигуратором и
ibcmd - с оговоркой, что на разбор EPF/ERF это не переносится: там результат
определяется базой разбора, а не движком.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
2026-08-01 17:38:13 +03:00
co-authored by Claude Opus 5
parent 2e5289a88f
commit b92aad519c
9 changed files with 64 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/1c-config-objects-spec.md
+12 -6
View File
@@ -1,7 +1,7 @@
# Спецификация формата XML объектов метаданных конфигурации 1С
Формат: XML-выгрузка конфигурации 1С:Предприятие 8.3 (Конфигуратор → Конфигурация → Выгрузить конфигурацию в файлы).
Версии формата: `2.17` (платформа 8.3.20–8.3.24), `2.20` (платформа 8.3.27+).
Версии формата: `2.17` (платформа 8.3.20–8.3.24), `2.18` (8.3.25), `2.19` (8.3.26), `2.20` (8.3.27+).
Источники: выгрузки ERP 2, Бухгалтерия предприятия (платформы 8.3.20, 8.3.24, 8.3.27).
@@ -1698,11 +1698,11 @@ XML-элемент: `<WebService>`. Трёхуровневая вложенно
## 26. Различия версий платформы
### 26.1. Версия 2.17 → 2.20
### 26.1. Лестница версий 2.17 → 2.18 → 2.19 → 2.20
Атрибут `version` корневого элемента `<MetaDataObject>`.
Атрибут `version` корневого элемента `<MetaDataObject>` задаёт платформа, которой выгружают: 8.3.20–8.3.24 → `2.17`, 8.3.25 → `2.18`, 8.3.26 → `2.19`, 8.3.27 → `2.20`. От режима совместимости конфигурации он не зависит.
**Изменения в версии 2.20 (платформа 8.3.27):**
**Изменения в версии 2.18 (платформа 8.3.25):**
1. **TypeReductionMode** — новый элемент в каждом стандартном реквизите:
@@ -1713,7 +1713,13 @@ XML-элемент: `<WebService>`. Трёхуровневая вложенно
</xr:StandardAttribute>
```
Значения: `TransformValues` (преобразовывать значения) | `Deny` (запретить).
Значения: `TransformValues` (преобразовывать значения) | `Deny` (запретить). У измерений его пишут только регистры сведений.
Свойство именно новое: платформа 8.3.24 при загрузке молча его отбраковывает («Свойство не входит в состав объекта метаданных»), сообщая при этом об успехе.
**Изменения в версии 2.19 (платформа 8.3.26):** новых элементов нет; изменилась только выгрузка ролей — право, совпадающее с `setForNewObjects`, больше не пишется (см. [1c-role-spec.md](1c-role-spec.md#версии-формата)).
**Изменения в версии 2.20 (платформа 8.3.27):**
2. **LineNumberLength** — длина поля номера строки в табличных частях:
@@ -1728,7 +1734,7 @@ XML-элемент: `<WebService>`. Трёхуровневая вложенно
### 26.2. Стабильные элементы
Между версиями 8.3.20 → 8.3.24 → 8.3.27:
Между версиями 8.3.20 → 8.3.24 → 8.3.25 → 8.3.26 → 8.3.27:
- Структура каталогов **без изменений**
- Пространства имён **без изменений**
- UUID объектов **сохраняются**
docs/1c-configuration-spec.md
+26 -19
View File
@@ -1,7 +1,7 @@
# Спецификация корневой структуры конфигурации 1С
Формат: XML-выгрузка конфигурации 1С:Предприятие 8.3 (Конфигуратор → Конфигурация → Выгрузить конфигурацию в файлы).
Версии формата: `2.17` (платформа 8.3.20–8.3.24), `2.20` (платформа 8.3.27+).
Версии формата: `2.17` (платформа 8.3.20–8.3.24), `2.18` (8.3.25), `2.19` (8.3.26), `2.20` (8.3.27+).
Источники: выгрузки Бухгалтерия предприятия (платформы 8.3.20, 8.3.24, 8.3.27), ERP 2 (8.3.24).
@@ -962,42 +962,49 @@ ChildObjects содержат `IntegrationServiceChannel` (каналы) — inl
---
## 7. Различия версий 2.17 → 2.20
## 7. Различия версий формата 2.17 → 2.18 → 2.19 → 2.20
### 7.1. Атрибут version
### 7.1. Лестница версий
Версию формата задаёт **платформа, которой выгружают**; от режима совместимости конфигурации она не зависит. Промежуточных версий не пропускается:
| Платформа | Версия формата |
|-----------|----------------|
| 8.3.20–8.3.24 | `2.17` |
| 8.3.25 | `2.18` |
| 8.3.26 | `2.19` |
| 8.3.27 | `2.20` |
```xml
<!-- 2.17 -->
<MetaDataObject ... version="2.17">
<!-- 2.20 -->
<MetaDataObject ... version="2.20">
```
### 7.2. Configuration.xml — Properties
### 7.2. Что появилось в каждой версии
Набор свойств Properties **идентичен** в обеих версиях. Отличия только в значениях:
| Версия | Изменения |
|--------|-----------|
| `2.18` | `TypeReductionMode` у стандартных реквизитов и измерений регистров сведений; `TextToSpeech` в `UsedMobileApplicationFunctionalities`; три редких свойства форм (`ViewModeApplicationOnSetReportResult`, `ReportResultViewMode`, `UseForFoldersAndItems`) |
| `2.19` | Новых тегов нет. Роли перестали писать право, совпадающее с `setForNewObjects` |
| `2.20` | `LineNumberLength` у табличных частей |
| Свойство | Изменение |
|----------|-----------|
| `CompatibilityMode` | `Version8_3_24` → `Version8_3_24` / `Version8_3_27` (зависит от конфигурации) |
| `ConfigurationExtensionCompatibilityMode` | аналогично |
| `UsedMobileApplicationFunctionalities` | В v2.20 добавлена функциональность `TextToSpeech` |
Три свойства форм — не новые возможности, а изменение **дефолта эмиссии**: платформа 8.3.24 их принимает и сохраняет при роундтрипе, просто не пишет сама. `TypeReductionMode`, наоборот, свойство новое — 8.3.24 молча отбраковывает его при загрузке («Свойство не входит в состав объекта метаданных», при этом exit 0).
### 7.3. Configuration.xml — ChildObjects
### 7.3. Configuration.xml — Properties
Набор типов объектов в ChildObjects **идентичен** между версиями 2.17 и 2.20.
Набор свойств Properties **идентичен** во всех версиях. `ConfigurationExtensionCompatibilityMode` платформа при выгрузке подставляет **свой собственный** (8.3.25 пишет `Version8_3_25`, 8.3.27 — `Version8_3_27`) даже если конфигурация не менялась, — при диффе двух дампов это выглядит как правка конфигурации, но ею не является.
### 7.4. ConfigDumpInfo.xml
### 7.4. Configuration.xml — ChildObjects
Атрибут `version` меняется на `2.20`. Структура записей не изменилась.
Набор типов объектов в ChildObjects **идентичен** между версиями.
### 7.5. Ext/ файлы
### 7.5. ConfigDumpInfo.xml и Ext/ файлы
В файлах `CommandInterface.xml`, `HomePageWorkArea.xml` атрибут `version` меняется на `2.20`. Структура не изменилась.
В `ConfigDumpInfo.xml`, `CommandInterface.xml`, `HomePageWorkArea.xml` меняется только атрибут `version`. Структура не изменилась.
### 7.6. Форматирование XML
В v2.20 пустые элементы записываются без пробела: `<Comment/>` вместо `<Comment />`. Это косметическое отличие, не влияющее на парсинг.
Стиль пустых элементов (`<Comment/>` против `<Comment />`) признаком версии **не является** — он различается и между дампами одной версии формата. Платформа принимает оба варианта; опираться на него нельзя.
---
docs/1c-form-spec.md
+1 -1
View File
@@ -182,7 +182,7 @@ CommonForms регистрируются в `Configuration.xml`:
</Form>
```
Все 17 namespace-деклараций **идентичны** во всех формах конфигурации. Атрибут `version` всегда `"2.17"`.
Все 17 namespace-деклараций **идентичны** во всех формах конфигурации. Атрибут `version` одинаков во всей выгрузке и определяется платформой (`2.17` для 8.3.20–8.3.24, далее `2.18` / `2.19` / `2.20`); примеры ниже приведены для `2.17`.
### Назначение namespace-префиксов
docs/1c-role-spec.md
+6 -2
View File
@@ -1,6 +1,6 @@
# Спецификация формата ролей 1С:Предприятия 8.3
Полное описание XML-формата ролей в выгрузке конфигурации. Версии формата: 2.17 (платформа 8.3.20–8.3.24), 2.20 (8.3.27+). Структура идентична, отличается только атрибут `version`.
Полное описание XML-формата ролей в выгрузке конфигурации. Версии формата: 2.17 (платформа 8.3.20–8.3.24), 2.18 (8.3.25), 2.19 (8.3.26), 2.20 (8.3.27+). Структура идентична; отличается атрибут `version`, а с 2.19 — ещё и набор выгружаемых прав (см. «Версии формата»).
## Файловая структура
@@ -840,6 +840,10 @@ RLS применяется к правам `Read`, `Update`, `Insert`, `Delete`
|-----------|:--------------------:|:--------------------:|-----------|
| 8.3.20 | 2.17 | 2.17 | Базовая |
| 8.3.24 | 2.17 | 2.17 | Без изменений |
| 8.3.27 | 2.20 | 2.20 | Только номер версии, структура идентична |
| 8.3.25 | 2.18 | 2.18 | Только номер версии |
| 8.3.26 | 2.19 | 2.19 | Право, совпадающее с `setForNewObjects`, больше не пишется (см. ниже) |
| 8.3.27 | 2.20 | 2.20 | Только номер версии |
Начиная с `2.19` платформа **опускает право, значение которого совпадает с `<setForNewObjects>`** в шапке `Rights.xml`: роль с `setForNewObjects=true` теряет из выгрузки права со значением `true`, роль с `false` — со значением `false`. Возможности не удалялись: право отсутствует в выгрузке, но действует по умолчанию роли. Структура файла при этом не менялась.
Namespace Rights.xml (`http://v8.1c.ru/8.2/roles`) и namespace метаданных (`http://v8.1c.ru/8.3/MDClasses`) не менялись.
docs/1c-specs-index.md
+1 -1
View File
@@ -158,7 +158,7 @@
| Стандартные реквизиты | [1c-config-objects-spec.md § 5](1c-config-objects-spec.md#5-стандартные-реквизиты-standardattributes) |
| Дочерние объекты (Attribute, TabularSection, Form, Template, Command) | [1c-config-objects-spec.md § 6](1c-config-objects-spec.md#6-дочерние-объекты-childobjects) |
| Формат ссылок на объекты | [1c-config-objects-spec.md § 28](1c-config-objects-spec.md#28-формат-ссылок-на-объекты-метаданных) |
| Различия версий 2.17 → 2.20 | [1c-config-objects-spec.md § 26](1c-config-objects-spec.md#26-различия-версий-платформы) |
| Различия версий формата 2.17 → 2.18 → 2.19 → 2.20 | [1c-config-objects-spec.md § 26](1c-config-objects-spec.md#26-различия-версий-платформы) |
---
docs/1c-spreadsheet-spec.md
+3 -1
View File
@@ -434,11 +434,13 @@
|-----------|---------|
| 8.3.20 | 2.17 |
| 8.3.24 | 2.17 |
| 8.3.25 | 2.18 |
| 8.3.26 | 2.19 |
| 8.3.27 | 2.20 |
### Form.xml (управляемая форма)
Содержимое `Form.xml` идентично между 8.3.20 и 8.3.24. Между 8.3.24 и 8.3.27 различается **только** атрибут `version` в корневом элементе `<Form>`: `"2.17"` → `"2.20"`. Пространства имён и структура не изменились.
Содержимое `Form.xml` идентично между 8.3.20 и 8.3.24. Дальше различается **только** атрибут `version` в корневом элементе `<Form>` (`2.17` → `2.18` → `2.19` → `2.20` по платформам). Пространства имён и структура не изменились.
### BSL-модули
docs/1c-subsystem-spec.md
+4 -4
View File
@@ -1,7 +1,7 @@
# Спецификация формата XML подсистем и командного интерфейса 1С
Формат: XML-выгрузка конфигурации 1С:Предприятие 8.3 (Конфигуратор → Конфигурация → Выгрузить конфигурацию в файлы).
Версии формата: `2.17` (платформа 8.3.20–8.3.24), `2.20` (платформа 8.3.27+).
Версии формата: `2.17` (платформа 8.3.20–8.3.24), `2.18` (8.3.25), `2.19` (8.3.26), `2.20` (8.3.27+).
Источники: выгрузки Бухгалтерия предприятия (платформы 8.3.20, 8.3.24, 8.3.27), ERP 2 (8.3.24).
@@ -883,15 +883,15 @@ CommandGroup.<ИмяГруппы>
## 10. Различия версий формата
| Аспект | `2.17` (8.3.20–8.3.24) | `2.20` (8.3.27+) |
| Аспект | `2.17` (8.3.20–8.3.24) | `2.18`–`2.20` (8.3.25–8.3.27) |
|---|---|---|
| Атрибут `version` | `2.17` | `2.20` |
| Атрибут `version` | `2.17` | `2.18` / `2.19` / `2.20` по платформе |
| BOM (UTF-8 BOM) | Нет | Да (EF BB BF) |
| Набор элементов | Идентичный | Идентичный |
| Набор свойств подсистемы | Идентичный | Идентичный |
| Секции CommandInterface | Идентичные | Идентичные |
> Между версиями `2.17` и `2.20` структурных различий в формате подсистем и командного интерфейса не обнаружено. Меняется только атрибут `version` и наличие BOM.
> Структурных различий в формате подсистем и командного интерфейса между версиями не обнаружено ни на одном шаге лестницы. Меняется только атрибут `version` и наличие BOM.
---
docs/1c-xdto-spec.md
+1 -1
View File
@@ -1,7 +1,7 @@
# Спецификация формата XML пакетов XDTO 1С
Формат: XML-выгрузка конфигурации 1С:Предприятие 8.3 (Конфигуратор → Конфигурация → Выгрузить конфигурацию в файлы).
Версии формата: `2.17` (платформа 8.3.20–8.3.24), `2.20` (платформа 8.3.27+).
Версии формата: `2.17` (платформа 8.3.20–8.3.24), `2.18` (8.3.25), `2.19` (8.3.26), `2.20` (8.3.27+).
Источники: выгрузки Бухгалтерия предприятия (8.3.24), ERP 2 (8.3.24) — 760 пакетов.
docs/db-guide.md
+10
View File
@@ -118,6 +118,16 @@ Claude вызовет `/db-run dev`.
и со всеми расширениями), `db-load-cf`/`db-dump-cf`, `db-load-dt`/`db-dump-dt`, `db-update`,
`db-load-git`, `epf-build`/`epf-dump`, `erf-build`/`erf-dump`.
При выгрузке **конфигурации** выбор движка на результат не влияет: выгрузка одной и той же базы
конфигуратором и `ibcmd` совпадает **побайтно** (проверено на полной выгрузке типовой конфигурации —
91807 файлов из 91807). Дампы конфигурации, снятые разными движками, сравнимы напрямую.
Это НЕ распространяется на разбор внешних обработок и отчётов (`epf-dump`/`erf-dump`): там результат
определяется не движком, а **базой, в которой идёт разбор**. Если ссылочные типы реквизитов в этой
базе не разрешаются (в конфигурации нет соответствующих объектов), в исходники попадают
идентификаторы вместо имени типа. Поэтому для разбора нужна база с матч-конфигурацией — и при
работе через `ibcmd` за этим надо следить отдельно, чтобы разбор не ушёл в пустую или чужую базу.
Ограничения:
- только **файловые** базы (для серверных используйте конфигуратор);
- если запрошен режим, который `ibcmd` не поддерживает (например, выгрузка в «плоском» формате),