Настройки

Пункт меню Экстрактора 1С «Настройки» открывает окно глобальных настроек.

В этой статье мы рассмотрим настройки Экстрактора 1С.

Чтобы открыть интерфейс «Настройки Экстрактора 1С» зайдите в меню Экстрактора, а затем выберите пункт «Настройки» в меню «Сервис».

В окне настроек Экстрактора 1С доступны следующие вкладки:

Планировщик;
Подписки на события;
Настройки очереди;
Обновление;
Прокси;
Логирование;
Данные;
Центр управления (DCC).

Рассмотрим подробнее каждую из вкладок.

Планировщик

Начиная с версии 3.11.1.35, настройка регламентных заданий вынесена в настройки Экстрактора 1С, при этом само регламентное задание создается в рамках каждого отдельного проекта.

Начиная с версии 3.12.1.122, была реализована работа в «копии» базы. Настроить данный функционал возможно с помощью разрешений. Он полезен, например, если необходимо разнести нагрузку при выполнении проектов по расписанию. Работает он следующим образом: при установке флага «Запрет выполнения регламентных заданий» проекты не будут выполняться по установленному расписанию, если данный флаг не установлен, то проекты будут выполняться только в случае, если имя базы в поле «База для выполнения регламентных заданий» соответствует названию текущей базы или если оно не заполнено. Флаг «Игнорировать запрет на работу с внешними ресурсами» относится к копиям баз, где работа с внешними ресурсами заблокирована, то есть при его установке будет разрешена работа в копии базы.

Также в версии 3.12.1.122 была добавлена кнопка «Применить ко всем регламентным заданиям», которая позволяет применить параметров планировщика к уже созданным регламентным заданиям.

Подписки на события

Во вкладке «Подписки на события» можно выключить подписки, установив флаг рядом с наименованием соответствующей функции.

Примечание

По умолчанию, подписки на события в Экстракторе 1С включены.

Флаг «Включить замеры времени» рекомендуется использовать в рамках нагрузочного тестирования или для формирования отчета «Замеры времени выполнения подписок», после чего сразу отключать, а также очищать регистр «Замеры времени» в меню «Сервис» Экстрактора с помощью соответствующей кнопки.

Настройки очереди

Вкладка «Настройки очереди» позволяет настроить очередь выгрузки.

Флаг «Продолжать выполнение проекта при ошибках» позволяет включить функцию выполнения проекта при возникновении ошибок.

Числовое поле «Количество попыток выгрузки» позволяет указать количество попыток выгрузки, если при выполнении проекта возникает ошибка. Попытка выгрузки указанное количество раз будет выполняться нова при запуске проекта по расписанию или при ручном запуске проекта. Как только будет достигнуто предельное количество запусков.

Примечание

При установке количества “0“ — попытки выгрузки будут повторяться бесконечно.

Внешняя очередь Valkey для версий 3.12 и выше

Для Экстрактора 1С версии 3.12 и выше внешняя очередь регистрации изменений настраивается как работа с Valkey. Записи очереди хранятся во внешнем хранилище вместо регистра сведений 1С. Порядок подключения и принцип работы описаны в статье «Внешняя очередь регистрации изменений на Valkey».

Доступны два способа подключения: через HTTP-сервис http-api-redis и, начиная с 3.15.1.50, напрямую через внешнюю компоненту. Имена драйверов «Redis» и «Redis (Native DLL)» в интерфейсе сохраняются и используются для подключения к Valkey.

Valkey через внешнюю компоненту Native DLL

В релизе 3.15.1.50 добавлен вариант «Redis (Native DLL)». Он использует внешнюю компоненту для прямого подключения к Valkey и работы с очередью регистрации изменений. Для этого варианта HTTP-сервис http-api-redis не требуется.

Начиная с этого релиза выбор, загрузка и обновление библиотеки Redis выполняются через справочник «Внешние компоненты» согласно общей инструкции.

Что важно: этот вариант работы (native dll) является наиболее скоростным.

Откройте вкладку «Настройки очереди». В группе «Внешняя очередь» в поле «Драйвер» выберите «Redis (Native DLL)».
В поле компоненты выберите Redis и откройте её карточку. Проверьте поддержку платформы сервера 1С, нажмите «Обновить из облака» или «Загрузить из файла», затем выполните «Проверить подключение» в карточке компоненты. Вернитесь в настройки очереди.
Заполните адрес сервера, порт, номер базы, пользователя и пароль. Укажите таймаут подключения в миллисекундах, количество попыток подключения и паузу между ними в миллисекундах.
Сохраните настройки и проверьте регистрацию и обработку изменений на тестовом проекте.

Для загрузки из внешней очереди количество записей по умолчанию ограничено 100. При настройке очереди учитывайте это ограничение.

Количество записей задаётся в поле «Лимит получаемых записей». На изображении показан пример настройки; адрес сервера и параметры доступа замените на свои.

Настройки внешней очереди Valkey через драйвер Redis (Native DLL)

Следующий раздел описывает отдельный вариант подключения к Valkey через HTTP-сервис.

Valkey через HTTP-сервис

В версиях 3.12 и выше для подключения к Valkey через HTTP используется сервис http-api-redis. В группе «Внешняя очередь» выберите драйвер «Redis», укажите адрес и порт HTTP-сервиса и включите запись изменений во внешнюю очередь. Адрес HTTP-сервиса и адрес сервера Valkey — разные настройки: Экстрактор обращается к сервису, а сервис — к Valkey. Внешняя компонента для этого способа не требуется.

Начиная с релиза 3.12.1.82 Экстрактора 1С, улучшена работа с сервисом http-api-redis.

В поле «Таймаут» можно указать таймаут в секундах.

Поле «Лимит получаемых записей» позволяет ограничить количество записей, извлекаемых за один запрос.

Флаг «При выгрузке получить все записи». Если установить этот флаг, то при выгрузке будут загружены все записи из «внешней» очереди или один лимит.

Чтобы использовать эти изменения, обновите сервис http-api-redis и Экстрактор 1С до версии 3.12.1.82 и выше.

Инструкция по обновлению сервиса http-api-redis

Переходим в каталог сервиса (туда, где лежит docker-compose.yml)
Останавливаем сервис: docker compose down
Меняем 1 строку в docker-compose.yml с image: git.denvic.ru:5050/pub/rest-api-redis/redisapiweb:1.0.7 на image: git.denvic.ru:5050/pub/rest-api-redis/redisapiweb:latest
Запускаем: docker compose up -d

Обновление

Установите флаг «Проверять обновление», если хотите получать оповещения об обновлениях. При необходимости, можно добавить пользователей, которым должно поступать оповещение.

Прокси

Примечание

Начиная с версии 3.4.2.1, настройка прокси для всех http-подключений вынесена в меню “Настройки” Экстрактора 1С, на вкладку «Прокси». Раньше по умолчанию производилась попытка инициализировать объект ИнтернетПрокси() значениями из файла inetcfg.xml. Если файл не существовал, то значения брались из системных настроек. При работе в ОС Windows использовались системные настройки, задаваемые через Internet Explorer. При работе в ОС Linux настройки брались из следующих переменных среды: http_proxy, https_proxy, ftp_proxy, ftps_proxy.

Вкладка «Прокси» позволяет:

отключить использование прокси, с помощью переключателя «Не используется»;
включить использование прокси по умолчанию, с помощью переключателя «По умолчанию»;
использовать собственные настройки прокси, выбрав вариант «Настройка».

Логирование

Вкладка «Логирование» позволяет настроить логирование запросов выгрузки, например, для последующего анализа ошибок в запросах выгрузки. Вы можете выбрать подходящий уровень логирования с помощью выпадающего списка:

Уровень логирования	Описание
Экстренная ситуация	Наивысший критический уровень, указывающий на то, что система неработоспособна, произошел катастрофический сбой, требующий немедленного вмешательства. В лог будут записаны все ошибки при запросах к базе-приемнику, находящиеся на этом уровне логирования.
Тревога	Высокий уровень критичности, указывающий на серьезную неисправность, которая ставит под угрозу работоспособность системы в краткосрочной перспективе. В лог будут записаны все ошибки при запросах к базе-приемнику, находящиеся на этом уровне логирования и выше.
Критическое состояние	Критическое состояние системы, при котором произошла очень серьезная ошибка, препятствующая нормальной работе. В лог будут записаны ошибки при запросах к базе-приемнику, находящиеся на этом уровне логирования и выше.
Ошибка	Уровень логирования указывающий на серьезные проблемы, из-за которых нарушается работа функционала, требующие вмешательства. В лог будут записаны все ошибки при запросах к базе-приемнику, находящиеся на этом уровне логирования и выше.
Предупреждение	Уровень логирования, сообщающий о потенциальных проблемах, которые могут привести к ошибкам, но не препятствуют дальнейшей работе приложения. В лог будут записаны все ошибки при запросах к базе-приемнику, находящиеся на этом уровне логирования и выше.
Сообщение	Уровень логирования, обозначающий важные, но штатные события в работе системы, не являющиеся ошибками. В лог будут записаны все ошибки при запросах к базе-приемнику, находящиеся на этом уровне логирования и выше.
Информационное	Стандартный уровень логирования, используемый для записи важных, штатных событий в работе приложения. В лог будут записаны все ошибки при запросах к базе-приемнику, находящиеся на этом уровне логирования и выше. Для данного уровня логирования также актуальны настройки: Выводить в лог количество удаленных записей; Выводить в лог количество добавленных записей.
Отладка	Уровень логирования, использующийся разработчиками для фиксации максимально детальной информации о работе приложения, который помогает находить причины ошибок и анализировать выполнение алгоритмов. В лог будут записаны все ошибки при запросах к базе-приемнику, находящиеся на этом уровне логирования и выше. Для данного уровня логирования также актуальны настройки: Выводить в лог количество удаленных записей; Выводить в лог количество добавленных записей.

Примечание:

при настройке и отладке Экстрактора 1С рекомендуется устанавливать уровень логирования «Отладка», а после, когда всё работает корректно — повысить его, оптимальным вариантом будет уровень логирования «Ошибка».

Выгрузка логов производится в DCC, а также они отображаются в истории выполнения проекта.

Данные

Начиная с версии 3.12.1.78: будет добавлена настройка пользовательских полей. Ниже в таблице описаны все настройки данной вкладки.


Настройка	Описание
Тайм зона в датах	Позволяет включить функционал, при котором в помощнике для полей с типом данных «Дата» будут выбираться типы с поддержкой временных зон, а при выгрузке будет подставляться временная зона базы 1С.
Тайм зона данных	Начиная с версии 3.6.5.57: появилась возможность указывать тайм зону выгрузки данных. Это можно сделать в данном поле. После применения новых настроек необходимо пересоздать таблицу.
Расширенная проверка данных	Начиная с версии 3.6.5.49: появилась возможность осуществлять расширенную проверку данных. Данный функционал осуществляет проверку данных на их соответствие указанному для них типу приемника данных, при этом выдает понятную для пользователя ошибку (а не ответ от сервера), чтобы эту ошибку можно было исправить или обойти в процессе конструирования проекта. Расширенную проверку данных можно установить по умолчанию для всех проектов использующих подключение к СУБД Clickhouse или можно использовать для конкретного проекта или строки проекта.
Выгружать строку при отсутствии данных	Начиная с версии 3.12.1.126: Настройка строки проекта «Выгружать строку при отсутствии данных» может заполняется из общих настроек на вкладке «Данные».
Настройки именования	Начиная с версии 3.12.1.93: были расширены настройки именования. Позволяет указать общие настройки именования (объект, поля): способ именования: «Имя» или «Имя хранения»; Транслитерация; Преобразование имени: Нижний регистр; Верхний регистр; camelcase; PascalCase; snake_case; SNAKE_CASE. А также, отдельно настройки именования объектов: Префикс; Постфикс; Вариант именования; Разделитель имени.
Префикс объектов	Позволяет указать префикс объектов в выгрузке.
Вариант именования объекта	Позволяет выбрать вариант именования объекта: Имя.Таблица; Вид.Имя.Таблица.
Разделитель имени объекта	Позволяет выбрать разделитель имени объекта.
Транслитерация	Позволяет включить транслитерацию.
Выгружать представления	Позволяет выбрать представления, которые будут выгружаться в таблицу-приемник: ссылочные типы; перечисления; составные типы.
Выгружать гуиды	Включает выгрузку гуидов, которые будут выгружаться в таблицу-приемник: ссылочные типы; перечисления. Для которых в свою очередь можно выбрать: Тип значения; Функцию; Постфикс имени. Начиная с версии 3.12.1.93: появился флаг «Выгрузка пустой ссылки как Null».
Выгружать имена перечислений	Включает выгрузку имен перечислений, для них необходимо указать постфикс имени.
Выгружать типы значений составных типов	Включает выгрузку типов значений составных типов, для них необходимо указать постфикс имени.
Выгружать составные типы раздельно	Включает выгрузку составных типов раздельно. Ранее такие поля мы могли в одном проекте выгрузить только в какой-то один тип данных (например, в строку). Начиная с версии 3.12.1.78 Экстрактора 1С, можно получить автоматическое разбиение составных типов (то есть, при использовании данной настройки, «простые» типы (строка, число, дата, булево) будут выгружены в отдельные колонки, а все «непростые» (ссылочные) типы (ссылки на документы , справочники и т.п.) будут выгружены в поле «Составной».
Исключение полей по имени	Позволяет исключить из выгрузки поля с указанными именами. Начиная с версии 3.12.1.126: реализовано исключение полей по маске. Исключение полей можно задать по маске «Удалено*», в таком случае выбранное поле добавляется в исключение при обновлении.
Исключение полей по типу	Позволяет исключить из выгрузки поля с указанными типами. Обратите внимание, что при исключении типов данных этой настройкой — данные будут исключены отовсюду. (не только колонки с этим типом данных не будут выводиться, но и в столбцах с составным типом данных, в которых встречается исключаемый тип, данные этого исключаемого типа будут превращены в значение «NULL»).
Автоматически добавляемые поля (в новом проекте)	Начиная с версии 3.6.3.76: появилась возможность добавлять вычисляемые поля «метаданных» регистрации изменений. Для этого в разделе «Автоматически добавляемые полях (в новом проекте)» необходимо заполнить «Метаданные.Очередь», которые включают в себя следующие поля из таблицы-приемника: Пользователь; Время записи; Операция.
Дата выгрузки	Позволяет добавить в выгрузку время выгрузки данных. Для этого надо указать наименование нужного поля таблицы-приемника.
Пользовательские данные	Позволяет добавить пользовательские данные в выгрузку.

Центр Управления (DCC)

В версии 3.15 вкладка настроек переименована в «DCC». В иллюстрациях предыдущих версий могут встречаться названия «Центр Управления» и «ЦУМ» — это настройки того же подключения.

Примечание

Начиная с версии 3.6.3 в Экстракторе 1С реализован функционал Коннектора к DCC.

Во вкладке «Центр Управления» можно указать параметры подключения к DCC и использовать предложенный функционал. Подробнее о DCC (Denvic Control Center) читайте в документации.

О том, как зарегистрировать DCC в Экстракторе 1С читайте в статье.

Начиная с версии 3.12.1.93: добавлена настройка выбора языка выгрузки типов метаданных.

«Толстый» клиент 1С

Данный объект Экстрактора 1С в «Толстом» клиенте можно найти в разделе «Операции», пункт «Обработка».

Ключ лицензирования

Настройка Экстрактора 1С