Удобная библиотека для .NET разработчиков, обменивающихся данными с 1с бухгалтерией

Опубликовал Петр Алексеевич (gusev_p@inbox.ru) в раздел Программирование - Внешние компоненты

Мы считываем и записываем информацию для почти 1000 организаций, ведущихся в 1с Бухгалтерии, из своего прикладного кода на C#. Для облегчения этих задач мы написали LINQ-провайдер для работы с базами 1С. Библиотека доступна на github.
LINQ-провайдер поддерживает методы Select и Where, кроме того библиотека позволяет генерировать классы объектной модели непосредственно по конфигурации. Весь исходный код доступен в проекте на GitHub.

Основные возможности

Автоматическая генерация классов объектной модели по 1С-конфигурации:

Generator.exe -connectionString File=C:\my-1c-db;Usr=Администратор;Pwd= -namespaceRoot MyNameSpace.ObjectModel1C -scanItems Документ.СписаниеСРасчетногоСчета -sourcePath C:\sources\AwesomeSolution\ObjectModel1CProject\AutoGenerated 

Такая команда создаст класс СписаниеСРасчетногоСчета в папке Документы. Этот класс будет обладать всеми свойствами исходного 1С-документа СписаниеСРасчетногоСчета, включая все табличные части. По классу так же будет создано для каждого из объектов конфигурации, на которые эти свойства ссылаются (транзитивное замыкание).

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

Не навязываем механизм управления коннекциями. Здесь возможны различные варианты (ThreadLocal, Pool, пересоздание по таймауту, пересоздание при обрыве и т.п.), многое зависит от приложения и конкретных потребностей. Простейший пример чтобы начать работать:

    var connectorType = Type.GetTypeFromProgID("V83.COMConnector");
    dynamic connector = Activator.CreateInstance(connectorType);
    var globalContext = connector.Connect("File=C:\my-1c-db;Usr=Администратор;Pwd=");
    var dataContext = DataContextFactory.CreateCOM(globalContext, typeof(Контрагенты).Assembly);
    var контрагент = new Контрагенты
    {
        ИНН = "1234567890",
        Наименование = "test-counterparty",
        ЮридическоеФизическоеЛицо = ЮридическоеФизическоеЛицо.ЮридическоеЛицо
    };
    dataContext.Save(counterparty);
    var контрагент2 = dataContext.Select<Контрагенты>().Single(x => x.Код == counterparty.Код);
    Assert.That(контрагент2.ИНН, Is.EqualTo("1234567890"));
Документы и справочники Generator.exe превращает в классы, а перечисления - в enum-ы языка C#. В примере выше для создания контрагента мы используем enum ЮридическоеФизическоеЛицо.
Абстрагируем ссылки, про них в прикладном коде можно просто забыть - создаем экемпляры классов объектной модели, присваиваем их свойствам других классов, при маппинге на соответствующие COM-объекты ссылки между ними будут проставлены автоматически.
    var контрагент = new Контрагенты
    {
        ИНН = "1234567890",
        Наименование = "test-counterparty",
        ЮридическоеФизическоеЛицо = ЮридическоеФизическоеЛицо.ЮридическоеЛицо
    };
    dataContext.Save(counterparty);
    var организация = dataContext.Select<Организация>().Single();
    var договор = new ДоговорыКонтрагентов
    {
        ВидДоговора = ВидыДоговоровКонтрагентов.СПокупателем,
        Наименование = "test name",
        Владелец = контрагент,
        Организация = организация
    };
    dataContext.Save(counterparty);
Метод Save сохраняет все объекты, до которых может добраться по ссылкам. Пример выше можно упростить следующим образом
 dataContext.Save(new ДоговорыКонтрагентов { ВидДоговора = ВидыДоговоровКонтрагентов.СПокупателем, Наименование = "test name", Владелец = new Контрагенты { ИНН = "1234567890", Наименование = "test-counterparty", ЮридическоеФизическоеЛицо = ЮридическоеФизическоеЛицо.ЮридическоеЛицо }, Организация = dataContext.Select<Организация>().Single() }); 
В запросах можно использовать стандартные Linq-операторы (Join, GroupBy пока не реализованы)
public decimal GetCurrencyRateToDate(string currencyCode, DateTime date)
{
    return dataContext.Select<КурсыВалют>()
        .Where(x => x.Валюта.Код == currencyCode)
        .Where(x => x.Период <= date)
        .OrderByDescending(x => x.Период)
        .First()
        .Курс;
}
Умеем обновлять отдельные строки табличных частей. Так, например, в таком примере
var поступлениеТоваровУслуг = new ПоступлениеТоваровУслуг
{
    Дата = new DateTime(2016, 6, 1),
    Контрагент = new Контрагенты
    {
        ИНН = "7711223344",
        Наименование = "ООО Тестовый контрагент",
    },
    Услуги = new List<ПоступлениеТоваровУслуг.ТабличнаяЧастьУслуги>
    {
        new ПоступлениеТоваровУслуг.ТабличнаяЧастьУслуги
        {
            Номенклатура = new Номенклатура
            {
                Наименование = "стрижка"
            },
            Количество = 10,
            Содержание = "стрижка с кудряшками"
        },
        new ПоступлениеТоваровУслуг.ТабличнаяЧастьУслуги
        {
            Номенклатура = new Номенклатура
            {
                Наименование = "стрижка усов"
            },
            Количество = 10,
            Содержание = "стрижка бороды"
        }                
    };
dataContext.Save(поступлениеТоваровУслуг);
var t = поступлениеТоваровУслуг.Услуги[0];
поступлениеТоваровУслуг.Услуги[0] = поступлениеТоваровУслуг.Услуги[1];
поступлениеТоваровУслуг.Услуги[1] = t;
dataContext.Save(поступлениеТоваровУслуг);

на втором вызове Save будет сгенерирован единственный вызов метода Сдвинуть, меняющий местами две строки.

Через метод DataContextFactory.CreateInMemory() можно получить inmemory-реализацию интерфейса IDataContext. Это здорово помогает при автоматизированном тестировании безнес-логики. Весь граф сервисных объектов поверх IDataContext можно создать целиком в inmemory-режиме, значительно ускорив этим прохождение тестов по сравнению с работой с настоящей 1С.

Скачать файлы

Наименование Файл Версия Размер
simple1c.zip
.zip 370,54Kb
22.06.16
1
.zip 370,54Kb 1 Скачать

См. также

Комментарии
1. Капитан Немо (capitan) 550 25.06.16 10:20 Сейчас в теме
Есть проект 1С скрипт, на котором системные скрипты пишут на 1С и вот обратная история.
Это очень круто, но ради великих шняг, напишите хотя бы в комментариях - зачем ?
Быстрее, удобнее? Почему не из 1С ?
Оставьте свое сообщение