cc-1c-skills/docs/1c-xdto-spec.md

Спецификация формата XML пакетов XDTO 1С

Формат: XML-выгрузка конфигурации 1С:Предприятие 8.3 (Конфигуратор → Конфигурация → Выгрузить конфигурацию в файлы). Версии формата: 2.17 (платформа 8.3.20–8.3.24), 2.20 (платформа 8.3.27+).

Источники: выгрузки Бухгалтерия предприятия (8.3.24), ERP 2 (8.3.24) — 760 пакетов.

Связанные спецификации:

• Корневая структура конфигурации — 1c-configuration-spec.md
• DSL навыков (XSD как формат описания) — xdto-dsl-spec.md
• Сводный индекс — 1c-specs-index.md

---

1. Структура каталогов

XDTOPackages/
├── ОбменСБанком.xml              # Объект метаданных — 4 свойства, и всё
├── ОбменСБанком/
│   └── Ext/
│       └── Package.bin           # Модель пакета
└── ...

Регистрация в корневом Configuration.xml:

<ChildObjects>
    ...
    <XDTOPackage>ОбменСБанком</XDTOPackage>
</ChildObjects>

Ни форм, ни модулей, ни макетов у пакета XDTO нет.

---

2. Объект метаданных <Имя>.xml

<?xml version="1.0" encoding="UTF-8"?>
<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" ... version="2.17">
    <XDTOPackage uuid="6417d7c8-6436-4907-98eb-44cd7638f3f1">
        <Properties>
            <Name>ApdexExport</Name>
            <Synonym>
                <v8:item>
                    <v8:lang>ru</v8:lang>
                    <v8:content>Apdex export</v8:content>
                </v8:item>
            </Synonym>
            <Comment/>
            <Namespace>www.v8.1c.ru/ssl/performace-assessment/apdexExport</Namespace>
        </Properties>
    </XDTOPackage>
</MetaDataObject>

Свойство	Описание
Name	Имя объекта метаданных. Должно быть валидным идентификатором 1С
Synonym	Многоязычное представление
Comment	Комментарий
Namespace	URI целевого пространства имён. Дублирует targetNamespace в Package.bin

Других свойств у пакета XDTO нет.

---

3. Ext/Package.bin — модель пакета

Несмотря на расширение .bin, это текстовый XML: UTF-8 с BOM, перевод строки CRLF, отступ — символы табуляции.

<package xmlns="http://v8.1c.ru/8.1/xdto"
         xmlns:xs="http://www.w3.org/2001/XMLSchema"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         targetNamespace="urn:1C.ru:ClientBankExchange">
    <property xmlns:d2p1="urn:1C.ru:ClientBankExchange" name="ClientBankExchange" type="d2p1:ClientBankExchange"/>
    <valueType name="СуммаТип" base="xs:decimal" variety="Atomic" totalDigits="18" fractionDigits="2"/>
    <objectType name="ClientBankExchange">
        <property xmlns:d3p1="urn:1C.ru:ClientBankExchange" name="ВерсияФормата" type="d3p1:ВерсияСхемы"/>
        <property name="Отправитель">
            <typeDef xsi:type="ValueType" base="xs:string" variety="Atomic" maxLength="160"/>
        </property>
    </objectType>
</package>

3.1. Вложенность элементов

package > objectType | valueType | property | import
objectType > property
valueType  > enumeration | pattern | typeDef
property   > typeDef
typeDef    > property | enumeration | pattern

Всего восемь имён элементов. typeDef — анонимный (встроенный) тип; его разновидность задаёт xsi:type = ValueType либо ObjectType.

Порядок элементов верхнего уровня обязателен:

import* → property* → valueType* → objectType*

Ему удовлетворяют все 760 пакетов корпуса. Нарушение порядка платформа не прощает — db-update падает с «Ошибка преобразования данных XDTO: Чтение объекта типа {http://v8.1c.ru/8.1/xdto}Package… Проверка свойства 'property'». Это существенно при сборке из XML-схемы, где порядок объявлений верхнего уровня произвольный.

3.2. <package>

Атрибут	Значения	Описание
targetNamespace	URI	Целевое пространство имён
elementFormQualified	true | false	Умолчание при отсутствии — true
attributeFormQualified	true | false	Умолчание при отсутствии — false

Порядок атрибутов: targetNamespace, elementFormQualified, attributeFormQualified.

3.3. <import>

<import namespace="URI"/> — объявление зависимости от другого пакета. Разрешается по namespace среди пакетов конфигурации; schemaLocation в модели XDTO нет.

3.4. <objectType> и <typeDef xsi:type="ObjectType">

Атрибут	Значения	Описание
name	идентификатор	Только у именованного objectType
base	QName	Базовый тип (наследование)
open	true | false	Допускает произвольные элементы и атрибуты
abstract	true | false	Абстрактный тип
mixed	true | false	Смешанное содержимое
ordered	true | false	false — выбор одного из вариантов (аналог xs:choice)
sequenced	true	Последовательное содержимое

Порядок атрибутов objectType: name, base, open, abstract, mixed, ordered, sequenced. Порядок атрибутов typeDef: xsi:type, base, mixed, open, ordered, sequenced, далее атрибуты простого типа.

3.5. <valueType> и <typeDef xsi:type="ValueType">

Атрибут	Значения
name	идентификатор (только у именованного valueType)
base	QName базового типа
variety	Atomic | List | Union
itemType	QName — тип элемента списка (variety="List")
memberTypes	список типов объединения (variety="Union")

Фасеты задаются атрибутами, а не дочерними элементами: length, minLength, maxLength, totalDigits, fractionDigits, minInclusive, maxInclusive, minExclusive, maxExclusive, whiteSpace (preserve | collapse).

Базовый тип может задаваться не атрибутом base, а вложенным анонимным typeDef без xsi:type — соответствует анонимному xs:simpleType внутри xs:restriction:

<valueType name="INN12Type" variety="Atomic" length="12">
    <typeDef base="xs:string" variety="Atomic"/>
    <pattern>[0-9]{12}</pattern>
</valueType>

Дочерними элементами идут только <pattern> и <enumeration> — значение в тексте узла:

<valueType name="НомерСчетаТип" base="xs:string" variety="Atomic" length="20">
    <pattern>[0-9]{20}</pattern>
</valueType>

У <enumeration> встречается атрибут xsi:type (например xs:string), указывающий тип литерала.

3.6. <property>

Атрибут	Значения	Описание
name	идентификатор	Имя свойства
ref	QName	Ссылка на глобальное свойство вместо собственного объявления
type	QName	Тип свойства. При отсутствии и type, и вложенного typeDef — произвольный тип
lowerBound	0 | 1	Минимальная кратность. Умолчание при отсутствии — 1
upperBound	число | -1	Максимальная кратность; -1 — неограниченно. Умолчание — 1
nillable	true | false	Допускает xsi:nil
fixed	значение	Фиксированное значение
default	значение	Значение по умолчанию
form	Element | Attribute | Text	Форма представления в XML. Умолчание — Element
localName	строка	Исходное XML-имя, если оно не является валидным идентификатором 1С
qualified	true | false	Переопределение *FormQualified для конкретного свойства

Порядок атрибутов: name, ref, type, lowerBound, upperBound, nillable, fixed, default, form, localName, qualified.

form="Text" — свойство хранит собственное значение элемента (аналог xs:simpleContent). Такое свойство платформа всегда называет __content:

<objectType name="Error">
    <property name="code" type="xs:NCName" lowerBound="1" form="Attribute"/>
    <property name="__content" type="xs:string" form="Text"/>
</objectType>

Наличие form="Text" не отменяет флагов самого типа — mixed, sequenced и прочие задаются как обычно:

<objectType name="Account" mixed="true" sequenced="true">
    <property name="bic" type="d3p1:BicType" lowerBound="1" form="Attribute"/>
    <property name="__content" type="d3p1:AccNumType" form="Text"/>
</objectType>

localName — при импорте XML-схемы имя, недопустимое как идентификатор 1С, санируется, а оригинал сохраняется:

<property name="isFixPlaceResidence_" type="xs:boolean" localName="isFixPlaceResidence "/>

3.7. Порядок свойств внутри типа

Свойства с form="Attribute" обычно идут перед остальными — так записаны 96.5% типов корпуса. Оставшиеся 3.5% содержат произвольное чередование; порядок значим и сохраняется платформой как есть.

---

4. Схема префиксов пространств имён

Каждая ссылка на тип из пространства имён, отличного от xs:/xsi:, требует объявления префикса вида dNpM:

<property xmlns:d3p1="urn:1C.ru:ClientBankExchange" name="ВерсияФормата" type="d3p1:ВерсияСхемы"/>

• N — глубина узла: package = 1, его прямые потомки = 2, свойство внутри objectType = 3, свойство внутри typeDef = 5, глубже — 7, 9 и т.д.
• M — порядковый номер нового пространства имён, объявляемого на этом узле (с 1).

Префикс объявляется на первом узле, которому он нужен; потомки переиспользуют его из области видимости, а не объявляют заново:

<objectType xmlns:d2p1="…/Permissions/1.0.0.1" name="InternetConnectionBase" base="d2p1:PermissionBase">
    <property name="Protocol" type="d2p1:NetworkProtocols" lowerBound="0" nillable="true"/>
</objectType>

Целевое пространство имён самого пакета исключением не является — ссылка на собственный тип тоже требует локального объявления.

Частоты по корпусу: d3p1 — 109 738, d2p1 — 13 108, d5p1 — 9 581, далее по убыванию до d16p1.

4.1. Нотация Кларка в memberTypes

Значения memberTypes записываются нотацией Кларка {URI}Локальное, без префикса (125 случаев из 135 в корпусе; остальные — обычные префиксные QName):

<valueType xmlns:d2p1="http://v8.1c.ru/8.1/data/core" name="UUID" variety="Union"
           memberTypes="{http://v8.1c.ru/8.1/data/core}UUID {http://www.w3.org/2001/XMLSchema}base64Binary"/>

Обратите внимание: объявление xmlns:d2p1 присутствует, хотя в значении не используется — пространство имён всё равно проходит через общий механизм выделения префиксов. Если оно уже объявлено предком, нового объявления не появляется.

Остальные атрибуты-QName (type, base, ref, itemType) всегда префиксные.

4.2. Осмысленные префиксы

Изредка вместо сгенерированного dNpM встречается содержательный префикс — например dcsset для настроек компоновки данных:

<property xmlns:dcsset="http://v8.1c.ru/8.1/data-composition-system/settings"
          name="Настройка" type="dcsset:Filter" lowerBound="0"/>

4.3. Свойство с qualified сериализуется с префиксом

Если у свойства задан qualified, платформа пишет и сам тег, и имя атрибута с явным префиксом пространства имён модели XDTO (хотя по умолчанию оно и так объявлено как xmlns=):

<d3p2:property xmlns:d3p1="http://bssys.com/upg/request" xmlns:d3p2="http://v8.1c.ru/8.1/xdto"
               name="numCheck" type="d3p1:BoolType" lowerBound="0" form="Attribute"
               d3p2:qualified="false"/>

Префикс для XDTO выделяется последним, после префиксов типов. Такое встречается редко (16 узлов на весь корпус) и появляется при импорте XML-схемы, где form задан на объявлении в unqualified-пакете.

---

5. Умолчания записываются непоследовательно

Один и тот же смысл в корпусе встречается в двух написаниях: nillable="false" присутствует явно 6 899 раз, objectType open="false" — 6 раз, abstract="false" — 2 раза, явное form="Element" — 44 раза. Пакеты, полученные импортом XML-схемы, и пакеты, созданные руками в Конфигураторе, отличаются стилем.

Практическое следствие: приведение пакета к «каноническому» виду меняет байты реальных файлов. Инструменты, которым важен точный round-trip, обязаны сохранять literal-форму.

---

6. Тихая деградация в xs:anyType

При импорте XML-схемы через Конфигуратор тип из чужого пространства имён, для которого в конфигурации нет соответствующего пакета, молча заменяется на xs:anyType — без ошибки и без предупреждения:

<!-- в схеме было type="ns2:contact" -->
<property name="contact" type="xs:anyType"/>

При этом <import namespace="…"/> в пакете остаётся. Признак «объявлен импорт, но ни один тип из этого пространства имён не используется» — надёжный индикатор проблемы.