Чтение метаданных 1С в SQL Server

Файл DBNames располагается в таблице Params. Его содержание можно получить следующим запросом SQL:

SELECT [BinaryData] FROM [Params] WHERE [FileName] = N'DBNames';

Файл сжат по алгоритму deflate. Начинается с указания количества содержащихся в нём элементов. Содержит список структур DBNameEntry, которые описывают объекты хранения данных в СУБД: основные и вспомогательные таблицы, таблицы настроек, поля этих таблиц и т.п.

Список полей структуры DBNameEntry:

Нулевой UUID является системным объектом метаданных, а не нулевой - объектом метаданных, созданным пользователем. Системные объекты метаданных описывают структуры хранения таких данных как, например, настройки регистров накопления и т.п. Пользовательские объекты метаданных описывают структуры хранения пользовательских данных прикладного решения.

Значения UUID в списке объектов метаданных могут повторяться. В таких случаях такие объекты метаданных являются связанными между собой отношениями главный-подчинённый.

Примерами таких объектов могут быть:

- таблица регистра накопления и его таблица итогов;

- таблица справочника и его таблица изменений;

- табличная часть и её поле "НомерСтроки" (LineNo);

- и т.д. и т.п.

Типы объектов метаданных могут быть следующими:

- Reference (справочник);

- Document (документ);

- Fld (реквизит объекта);

- Node (план обмена);

- ReferenceChngR (таблица изменений справочника);

- и т.д. и т.п.

Идентификатор объекта метаданных это целочисленное, которое генерируется платформой 1С по порядку по мере формирования файла DBNames. Этот идентификатор уникален в пределах этого списка, а, следовательно, и в пределах каждой отдельно взятой конфигурации 1С. В случае выгрузки и загрузки конфигурации при помощи файла dt значения этих идентификаторов могут быть пересчитаны и изменены.

В редких случаях файл DBNames может содержать уже не существующие объекты конфигурации. В таких случаях файл объекта метаданных в таблице Config отсутствует.

Наименование соответствующего объекта СУБД обычно формируется из конкатенации значения второго и третьего полей структуры DBNameEntry с добавлением, в случае SQL Server, знака нижнего подчёркивания перед названием. Например, так: "_Reference22".

Фрагмент файла DBNames (начало и конец):

{106,
{100,
{00000000-0000-0000-0000-000000000000,"ODataSettings",1},
{00000000-0000-0000-0000-000000000000,"SystemSettings",2},
{00000000-0000-0000-0000-000000000000,"CommonSettings",3},
{00000000-0000-0000-0000-000000000000,"RepSettings",4},
{00000000-0000-0000-0000-000000000000,"RepVarSettings",5},
{00000000-0000-0000-0000-000000000000,"FrmDtSettings",6},
{00000000-0000-0000-0000-000000000000,"DynListSettings",7},
{00000000-0000-0000-0000-000000000000,"ExtensionsInfo",8},
{00000000-0000-0000-0000-000000000000,"UsersWorkHistory",9},
{b6addf15-6508-4218-935b-cf2e8f7966c8,"Document",10},
{00000000-0000-0000-0000-000000000000,"ExtDataSrcPrms",11},
{00000000-0000-0000-0000-000000000000,"CKindsOpt",12},
{00000000-0000-0000-0000-000000000000,"RefOpt",13},
{00000000-0000-0000-0000-000000000000,"Consts",14},
{00000000-0000-0000-0000-000000000000,"ChrcOpt",15},
{00000000-0000-0000-0000-000000000000,"AccOpt",16},
{2f175974-e5f4-4d16-9c48-59e49d6b25af,"InfoRg",17},
{28439047-46ca-4fba-9e2b-a3ac9f95a2c3,"Fld",18},
{4e75ac96-7c81-4c57-af12-a52eebdb576a,"Fld",19},
{60b7ad1c-bb42-4095-90e9-9b24ee68f2fc,"Fld",20},
{58dce880-f8da-40d8-88db-351fcd3a5151,"Reference",22},
{491db2dd-45e3-47fe-8712-4fb321db25b9,"InfoRg",24},
{1c36dbbe-38b1-4c66-81cf-e1a0b32b8779,"Fld",25},
{1b2317b0-bd6f-4381-b308-3b315e284a39,"Fld",26},
{e8d51aac-07d2-46e1-8655-0e120a0dfe0f,"Node",27},
{58dce880-f8da-40d8-88db-351fcd3a5151,"ReferenceChngR",28},
...
...
...
{d75053c5-0407-4071-ba45-bf7f293e18cd,"Const",103},
{d75053c5-0407-4071-ba45-bf7f293e18cd,"Fld",104},
{3297831b-9cb6-4bda-8e0a-f4d2d015c098,"InfoRgChngR",105}
}
}

Файл объекта метаданных располагается в таблице Config. Его содержание можно получить следующим запросом SQL:

SELECT [BinaryData] FROM [Config] WHERE [FileName] = @FileName ORDER BY [PartNo] ASC;

Как видно из запроса, файл объекта метаданных теоретически может состоять из нескольких частей, но на практике я такого не встречал. Файл сжат по алгоритму deflate. Файл содержит описание объекта метаданных. Описание его наименования, реквизитов, табличных частей и многого другого.

...
{932159f9-95b2-4e76-a8dd-8849fe5c5ded,2,
...

...
{0,0,3df19dbf-efe7-4e31-99ad-fafb59ec1329},"Размещение",
{1,"ru","Размещение"},"",0,0}
...

...
{888744e1-b616-11d4-9436-004095e12fc7,7,
...

...
{0,0,baf12d47-fbfe-4563-aa23-26d9f7e83169},"Использование",
{1,"ru","Использование"},"",0,0},
...

...
{0,0,8361991a-0f30-4a03-9a4c-90556b744f53},"Автор",
{1,"ru","Автор"},"",0,0},
{"Pattern",
{"#",3997c341-4065-4af6-813f-99750a01052b},
{"#",bb356e79-e8e6-4912-8561-ad29cca2604f}
}
...

...
{8361991a-0f30-4a03-9a4c-90556b744f53,"Fld",1499},
...

...
{"Pattern",
...

// Описание ссылочного типа данных:
...
{"#",3997c341-4065-4af6-813f-99750a01052b}
...

// Описание строкового типа данных:
...
{"S",256,1}
...

public void ParseDBNames()
{
    using (Stream stream = GetDBNamesFromDatabase())
    using (StreamReader reader = new StreamReader(stream, Encoding.UTF8))
    {
        string line = reader.ReadLine();
        while (line != null)
        {
            line = reader.ReadLine();
        }
    }
}

public Stream GetDBNamesFromDatabase()
{
    SqlBytes binaryData = SelectDBNamesFromDatabase();
    if (binaryData == null) return null;
    return new DeflateStream(binaryData.Stream, CompressionMode.Decompress);
}

public SqlBytes SelectDBNamesFromDatabase()
{
    SqlBytes binaryData = null;
    {
        SqlConnection connection = new SqlConnection(ConnectionString);
        SqlCommand command = connection.CreateCommand();
        SqlDataReader reader = null;
        command.CommandType = CommandType.Text;
        command.CommandText = "SELECT [BinaryData] FROM [Params] WHERE [FileName] = N'DBNames'";
        try
        {
            connection.Open();
            reader = command.ExecuteReader();
            if (reader.Read())
            {
                binaryData = reader.GetSqlBytes(0);
            }
            reader.Close();
        }
        catch { throw; }
        finally { DisposeDatabaseResources(connection, command, reader); }
    }
    return binaryData;
}

Ссылка на GitHub

Пример использования:

Начал работу над проектом генерации JSON Schema для конфигураций на платформе 1С:Предприятие 8.

Полезно для интеграции с внешними не-1С системами.

Исходный код C# на GitHub: dajet-metadata-schema

Класс Configurator, метод OpenInfoBase.

См. также диаграмму в заголовке публикации.

1. Создаётся новый объект класса InfoBase.

2. Загружается файл DBNames из таблицы Params. Файл DBNames содержит следующую информацию:

- FileName (uuid)

- TypeToken (Reference, VT, Fld и т.д.)

- Code (int)

3. Из файла DBNames заполняются словари Properties, TableParts и AllTypes объекта InfoBase. Ключом словаря является FileName, а значением, в зависимости от TypeToken, является объект классов ApplicationObject или MetadataProperty.

4. Загружается файл root из таблицы Config. Файл root содержит ссылку (uuid) на файл описания состава конфигурации (дерева конфигурации). Условно назовём этот файл config.

5. Из файла config в объект InfoBase загружаются основные свойства конфигурации, например, наименование, версия, режимы работы различных аспектов конфигурации.

6. Из файла config в объект InfoBase загружаются следующие объекты метаданных из ветки "Общие" дерева конфигурации:

- Общие реквизиты

- Определяемые типы

Заполняются словари SharedProperties и NamedDataTypeSets. Ключом словарей являются uuid этих объектов, а значениями объекты классов SharedProperty и NamedDataTypeSet.

Объект SharedProperty содержит правила применения общего реквизита для различных прикладных объектов метаданных. Правила применения ссылаются на соответствующие объекты метаданных при помощи FileName.

Объект NamedDataTypeSet идентифицируется по uuid и содержит именованный набор типов данных, применяемый к свойствам различных прикладных объектов метаданных. Ссылка на объект NamedDataTypeSet (uuid) содержится в свойстве PropertyType объекта MetadataProperty.

7. Выполняется загрузка прикладных объектов метаданных в циклах по соответствующим коллекциям объекта InfoBase. Поиск соответствующих файлов в таблице Config осуществляется по FileName.

Свойства (реквизиты, измерения и ресурсы) объектов метаданных, а также их табличных частей, как и сами табличные части, идентифицируются по uuid и сопоставляются с файлом DBNames по FileName, который был ранее загружен в словари Properties и TableParts объекта InfoBase.

Ссылочные типы данных свойств, которые указываются в свойстве PropertyType объекта MetadataProperty, сопоставляются по их uuid, которые были получены в ходе загрузки соответствующих файлов таблицы Config по FileName. В данном случае FileName и идентификатор типа объекта метаданных (uuid) это разные значения. Скорее всего это идентификатор типа, например, "СправочникСсылка.Номенклатура". В отличие от, например, идентификатора типа "СправочникОбъект.Номенклатура".

При указании типом данных свойства "Харакетристика" выполняется поиск соответствующего объекта типа "План видов харакетристик", однако в данном случае uuid и typeUuid (DataTypeSetUuid) для плана видов характеристик это разные значения. Оба эти значения загружаются из соответствующего файла таблицы Config по FileName.

Скорее всего uuid – это тип данных "ПланВидовХаракетристикСсылка", а uuidType – "ОписаниеХарактеристик".

При указании типом данных свойства "Определяемый тип" выполняется поиск соответствующего определяемого типа по его идентификатору uuid (см. описание NamedDataTypeSet выше).

Кроме этого существуют специальные идентификаторы uuid для конкретных типов данных:

- ХранилищеЗначения;

- УникальныйИдентификатор.

А также для обобщённых типов данных:

- ЛюбаяСсылка;

- СправочникСсылка;

- и т.д.

При указании обобщённого типа, например, ДокументСсылка необходимо проверять количество объектов метаданных данного типа в конфигурации, так как если существует только один документ, то значение свойства не может быть составным типом и наоборот.

8. Идентификаторы FileName владельцев справочников содержатся в файле подчинённого объекта метаданных (справочника), который загружается из таблицы Config по FileName.

9. Идентификаторы FileName регистров, по которым выполняются движения, хранятся в файлах соответствующих объектов метаданных (документов). Таким образом конфигурация свойства "Регистратор" регистров накопления и регистров сведений, подчинённых регистратору, выполняется по мере загрузки файлов документов.

Добавлено описание методики исследования файлов объектов метаданных на GitHub.

Добавлена поддержка PostgreSQL.