Алгоритм получения настроек с сервера во внешнюю обработку

ВО СБИС поддерживает два варианта хранения файлов настроек: "в каталоге" и "в СБИС". В первом варианте настройки находятся на локальном диске, путь до папки указывается в настройках обработки, и сохраняется в пользовательских параметрах 1С. Основной недостатком является необходимость общего доступа к каталогу и более сложная настройка в Linux и клиент-серверных версиях 1С, не работает в веб клиентах 1С.

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

Алгоритм загрузки файла настроек из СБИС

1. Идентификатор настройки (ConnectionId) отсутствует в пользовательских параметрах

1.1. Проверяем имеется ли для данной базы 1С общие настройки .

• Получаем список настроек ReadConnectionList
  • Параметры вызова:
    • service - идентификатор сервиса ВО 1С - Com1C82
    • URL - строка соединения базы данных.
    • ini - массив со структурой, вида: ключ - строка "ini_type", значение - строка "Меню".
• Если список соединений пуст, переходим к процедуре выбора подходящих стандартных настроек (Пункт 3).

1.2. Берём первое соединение из полученного списка.

• Кэшируем меню выбранного соединения.

1.3. Переходим к пункту 2.

2. Идентификатор настройки (ConnectionId) указан в пользовательских настройках

2.2. Составляем список файлов Получает меню соединения.

• Проверяет наличие сбисМеню в кэше по выбранному ID, берёт его.
• Если меню нет, то получает его:
  • Вызывает метод readConnection
    • Параметры вызова:
      • id - 128 битный идентификатор соединения.
      • version - числовое представление версии системы, где каждый разряд версии, кроме первого, дополнен нулями до 4 символов. Пример: 3.2.0.11 = 3000200000011
      • ini - массив со структурой, вида: ключ - строка "ini_type", значение - строка "Меню".
    • Кэширует полученное меню.

Шаг 2. Получает данные настроек и сбисПараметров.

• Собирает список включенных ини по меню соединения.
  • Включенной считается ини с установленным флагом в поле "enable".
  • Структура элементов списка:
    • Массив "ini" с элементами:
    • Ключ - "ini_type", значение - тип ини.
    • Ключ - "ini_name", значение - системное имя ини.
• Проверяет наличие настроек в кэше по идентификатору и сформированному списку.
• Вызывает метод readConnection
  • Параметры вызова:
    • id - 128 битный идентификатор соединения.
    • version - числовое представление версии системы, где каждый разряд версии, кроме первого, дополнен нулями до 4 символов. Пример: 3.2.0.11 = 3000200000011.
    • ini - массив объектов "ini", которые не удалось найти кэше. Если все файлы найдены, не передаётся.
  • Кэширует полученные настройки.
• Получает структуру сбисПараметров из поля "json_connection"

Шаг 3. Выполняет проверку настроек.

• Проверяет необходимость проверки.
  • Проверка выполняется при изменении версии конфигурации базы данных:
    • Сравнивает значение узла "ВерсияКонфигурации" в сбисПараметрах и текущую версию конфигурации - Метаданные.Версия.
  • Проверка выполняется при создании нового подключения:
    • Выбранные настройки являются общими - поле "user" пусто.
  • Проверка выполняется при изменении файлов настроек:
    • Сравнивает дату последней проверки каждой включенной настройки в сбисПараметрах и поле соединения "update_date".
• Выполняет проверку, если требуется.
  • Выполняет функцию ПроверитьИниФайлы на формаНастроекОбщее.
  • Обновляет дату проверки в сбисПараметрах.
  • Обновляет поле "ВерсияКонфигурации" на текущую версию конфигурации - Метаданные.Версия.

Шаг 4. Сохраняет выбранное соединение.

• Если проверка настроек проводилась.
  • Готовит структуру на запись.
    • Поле "ini" не указывается.
    • Все поля остальные поля берутся из выбранного соединения.
  • Записывает сбисПараметры:
    • В поле "json_connection" записываются сбисПараметры с учетом изменений.
  • Определяет необходимость создания нового подключения.
    • Если выбранное соединение является общим, то его идентификатор указывается в качестве параметра "parent". Поле "id" очищается.
  • Сохраняет изменения.
    • Вызывает метод WriteConnection.
• Сохраняет ID соединения в обработку
  • ID выбранного соединения записывается в пользовательский параметр "ConnectionID".

Шаг 5. Выполняет переход в раздел(Пункт 3).

Пункт 3. Переход в раздел:

Если полученные файлы ини прошли проверку:

• Выполняет переход в раздел, установленный по-умолчанию.

Если настройки полученного соединения не прошли проверку:

• Шаг 1. Если были ошибки при проверке, показывает протокол об ошибках.
  • ВывестиПротоколПроверкиИниФайлов на форме ФайлыНастроекОбщее.

• Шаг 2. Переходит в "Настройки", подраздел "Файлы настроек".
  • ПерейтиВРаздел на форме ГлавноеОкно

• Шаг 3. Заполняет список доступных конфигураций.
  • ОбновитьКонтент на форме Раздел_Настройки_ФайлыНастроек
    • Вызывает ReadConfigList.
      • Параметры вызова:
        • service - идентификатор сервиса ВО 1С - Com1C82
    • Заполняет список, кэширует.

• Шаг 4. Проверяет наличие выбранного соединения.
  • Если соединение не выбрано:
    • а. Подбирает подходящую типовую конфигурацию.
      • ОпределитьТипНастроекПоПрефиксу на форме ФормаНастроекОбщее.
    • б. Получает меню выбранной конфигурации.
      • Проверяет меню в кэше. Если есть, берёт.
      • Если в кэше нет, получает:
        • Вызывает ReadConfig
          • Параметры вызова:
            • service - идентификатор сервиса ВО 1С - Com1C82.
            • subsystem - поле "subsystem" выбранной конфигурации.
            • version - поле "version" выбранной конфигурации.
            • ini - массив со структурой, вида: ключ - строка "ini_type", значение - строка "Меню".
        • Кэширует полученное меню.
    • в. Формирует массив имен и типов включенных ини по меню.
      • Включенной считается ини с установленным флагом в поле "enable".
      • Структура элементов массива "ini":
        • Ключ - "ini_type", значение - тип ини.
        • Ключ - "ini_name", значение - системное имя ини.
    • г. Получает ини выбранной конфигурации.
      • Проверяет ини в кэше по сформированному массиву. Если есть, берёт.
      • Если в кэше нет, вызывает ReadConfig
        • Параметры вызова:
          • service - идентификатор сервиса ВО 1С - Com1C82
          • subsystem - поле "subsystem" выбранной конфигурации.
          • version - поле "version" выбранной конфигурации.
          • ini - массив объектов "ini", которые не удалось найти кэше.
      • Кэширует полученные настройки
    • д. Выбранная конфигурация назначается выбранным соединением с пометкой создания нового при записи.
    • е. Выполняется проверка выбранного соединения.

• Шаг 5. Находит конфигурацию выбранного соединения.
  • ОпределитьТипНастроекПоПрефиксу на форме ФормаНастроекОбщее.

• Шаг 6. Получает меню выбранной конфигурации.
  • Проверяет меню в кэше. Если есть, берёт.
  • Если в кэше нет, вызывает ReadConfig
    • Параметры вызова:
      • service - идентификатор сервиса ВО 1С - Com1C82
      • subsystem - поле "subsystem" выбранной конфигурации.
      • version - поле "version" выбранной конфигурации.
      • ini - массив со структурой, вида: ключ - строка "ini_type", значение - строка "Меню".
    • Кэширует полученное меню

• Шаг 7. Строит список доступных ини.
  • ПолучитьМассивФайловДляКонфигурации на форме ФайлыНастроекСервер.
  • ПолучитьМассивУстановленныхИниФайлов на форме ФайлыНастроекСервер.

• Шаг 8. Отображает выбранные ини соединения и конфигурации.
  • сбисОбновитьТаблицыИниФайлов на форме ГлавноеОкно.
    • В левой колонке список ини полученной конфигурации.
    • В правой колонке список ини выбранного соединения.