Библиотека работы с MongoDB для 1С и OneScript

Открытый Пакет Интеграций (ОПИ, OpenIntegrations) - это open-source набор методов для простой и быстрой интеграции с различными популярными API. Он состоит из аналогичных по функционалу 1С-расширения (CFE), OS-пакета и консольного приложения для Windows и Linux, которые предоставляют готовые функции для работы с целым набором различных онлайн-сервисов.

• ОПИ бесплатен и имеет открытый исходный код на GitHub. Вы всегда можете получить последнюю версию библиотеки на странице репозитория, а подписавшись - узнавать о выходе обновлений. Все релизы сопровождаются статьями на Инфостарт и разделами единой документации. На Инфостарт вы можете подписаться уже хоть сейчас, а про документацию я расскажу далее.

• Удобная единая документация. Она расположена на сайте openintegrations.dev и содержит в себе всю информацию, необходимую для работы: инструкции по предварительным действиям для начала интеграции, описания всех методов с параметрами и возвращаемыми значениями, примеры кода и т.д. Каждый API имеет там свой раздел.

• Простая установка. ОПИ распространяется во множестве вариантах: как XML файлы расширения, как EDT проект расширения, как файл расширения формата .cfe (версия 1С 8.3.9), как файл пакета для OneScript и еще в целом наборе пакетов и файлов для Windows и Linux. Из этого набора вы всегда сможете выбрать тот способ установки, который лучше подойдет для вашей конкретной задачи

На момент последнего обновления данной статьи, доступны следующие API:

Наиболее актуальную информацию можно посмотреть в репозитории или на вводной странице документации.

    Адрес  = "127.0.0.1:1234";
    Логин  = "bayselonarrend";
    Пароль = "12we...";

    ПараметрыПодключения = Новый Структура("authSource", "admin");
    СтрокаПодключения    = OPI_MongoDB.СформироватьСтрокуПодключения(Адрес, , Логин, Пароль, ПараметрыПодключения);
    Соединение           = OPI_MongoDB.ОткрытьСоединение(СтрокаПодключения);

    Наименование = "test_collection";
    База         = "test_database";

    Параметры = Новый Соответствие;
    Выражение = Новый Соответствие;
    ГруппаИ   = Новый Массив;

    Условие1  = Новый Соответствие; // Итог >= 0
    Элементы1 = Новый Массив;
    Элементы1.Добавить("$total");
    Элементы1.Добавить(0);
    Условие1.Вставить("$gte", Элементы1);

    Условие2  = Новый Соответствие; // Статус <= 3
    Элементы2 = Новый Массив;
    Элементы2.Добавить("$status");
    Элементы2.Добавить(3);
    Условие2.Вставить("$lte", Элементы2);

    ГруппаИ.Добавить(Условие1);
    ГруппаИ.Добавить(Условие2);

    Выражение.Вставить("$expr", ГруппаИ);
    Параметры.Вставить("validator", Выражение);

    Результат = OPI_MongoDB.СоздатьКоллекцию(Соединение, Наименование, База, Параметры);

    Адрес  = "127.0.0.1:1234";
    Логин  = "bayselonarrend";
    Пароль = "12we...";
    База   = "main";

    ПараметрыПодключения = Новый Структура("authSource", "admin");
    СтрокаПодключения    = OPI_MongoDB.СформироватьСтрокуПодключения(Адрес, , Логин, Пароль, ПараметрыПодключения);
    Соединение           = OPI_MongoDB.ОткрытьСоединение(СтрокаПодключения);

    Коллекция        = "new_collection";
    МассивДокументов = Новый Массив;

    // С неявным приведением типов
    СтруктураДокумента = Новый Структура;

    ТестовыйМассив = Новый Массив;
    ТестовыйМассив.Добавить("Значение1");
    ТестовыйМассив.Добавить("Значение2");

    ТестоваяСтруктура = Новый Структура("text,number", "Текст", 10);
    ТестовыеДвоичные  = ПолучитьДвоичныеДанныеИзСтроки("Текст");
    ТекущаяДата       = OPI_Инструменты.ПолучитьТекущуюДату();

    СтруктураДокумента.Вставить("stringField", "Текст");
    СтруктураДокумента.Вставить("intField"   , 200);
    СтруктураДокумента.Вставить("doubleField", 123.456);
    СтруктураДокумента.Вставить("boolField"  , Истина);
    СтруктураДокумента.Вставить("arrayField" , ТестовыйМассив);
    СтруктураДокумента.Вставить("docField"   , ТестоваяСтруктура);
    СтруктураДокумента.Вставить("dateField"  , ТекущаяДата);
    СтруктураДокумента.Вставить("nullField");

    МассивДокументов.Добавить(СтруктураДокумента);

    // С явным приведением типов
    СтруктураДокумента = Новый Структура;

    RegExp = Новый Структура("pattern,options", "[a-z]+@[a-z]+\.[a-z]+", "i");
    КодJS  = "const result = [1, 2, 3].map(x => x * 2).filter(x => x > 3);";

    СтруктураДокумента.Вставить("stringField", Новый Структура("__OPI_STRING__"   , "Текст"));
    СтруктураДокумента.Вставить("oidField"   , Новый Структура("__OPI_OBJECTID__" , "63ceed18f71dda7d8cf21e8e"));
    СтруктураДокумента.Вставить("jsField"    , Новый Структура("__OPI_JS__"       , КодJS));
    СтруктураДокумента.Вставить("symbolField", Новый Структура("__OPI_SYMBOL__"   , "Y"));
    СтруктураДокумента.Вставить("int32Field" , Новый Структура("__OPI_INT32__"    , 10));
    СтруктураДокумента.Вставить("int64Field" , Новый Структура("__OPI_INT64__"    , 1000));
    СтруктураДокумента.Вставить("doubleField", Новый Структура("__OPI_DOUBLE__"   , 124.456));
    СтруктураДокумента.Вставить("boolField"  , Новый Структура("__OPI_BOOLEAN__"  , Истина));
    СтруктураДокумента.Вставить("dateField"  , Новый Структура("__OPI_DATETIME__" , "1763204141"));
    СтруктураДокумента.Вставить("tsField"    , Новый Структура("__OPI_TIMESTAMP__", ТекущаяДата));
    СтруктураДокумента.Вставить("regexpField", Новый Структура("__OPI_REGEXP__"   , RegExp));
    СтруктураДокумента.Вставить("binaryField", Новый Структура("__OPI_BINARY__"   , ТестовыеДвоичные));
    СтруктураДокумента.Вставить("nullField"  , Новый Структура("__OPI_NULL__"));
    СтруктураДокумента.Вставить("minkeyField", Новый Структура("__OPI_MINKEY__"));
    СтруктураДокумента.Вставить("maxkeyField", Новый Структура("__OPI_MAXKEY__"));

    ТестовыйМассив = Новый Массив;
    ТестовыйМассив.Добавить(Новый Структура("__OPI_SYMBOL__", "A"));
    ТестовыйМассив.Добавить(Новый Структура("__OPI_MINKEY__"));

    ТестоваяСтруктура = Новый Структура("code,number"
        , Новый Структура("__OPI_JS__", "const result = 1")
        , Новый Структура("__OPI_DOUBLE__", 10));

    // Документы и массивы в структуру не оборачиваются
    СтруктураДокумента.Вставить("docField"   , ТестоваяСтруктура);
    СтруктураДокумента.Вставить("arrayField" , ТестовыйМассив);

    МассивДокументов.Добавить(СтруктураДокумента);

    Результат = OPI_MongoDB.ВставитьДокументы(Соединение, Коллекция, МассивДокументов, База);

    Адрес  = "127.0.0.1:1234";
    Логин  = "bayselonarrend";
    Пароль = "12we...";
    База   = "main";

    ПараметрыПодключения = Новый Структура("authSource", "admin");
    СтрокаПодключения    = OPI_MongoDB.СформироватьСтрокуПодключения(Адрес, , Логин, Пароль, ПараметрыПодключения);
    Соединение           = OPI_MongoDB.ОткрытьСоединение(СтрокаПодключения);

    Коллекция = "new_collection";

    // __4 = $
    Фильтр     = Новый Структура("stringField,doubleField", "Текст", Новый Структура("__4gte, __4lte", 100, 150));
    Сортировка = Новый Структура("doubleField", -1);
    Параметры  = Новый Структура("limit", 2);

    Результат = OPI_MongoDB.ПолучитьДокументы(Соединение, Коллекция, База, Фильтр, Сортировка, Параметры);