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

Статья описывает алгоритм работы внешней обработки СБИС после изменения способа хранения настроек из "В каталоге" на "В СБИС".

Для видимости переключателя должен быть установлен способ обмена extSDK, либо extSDKCrypto. Переключатель способа хранения настроек доступен:

• На форме настройки соединения, которая открывается на стадии авторизации в СБИС при запуске обработки.
• На форме главного окна, в разделе "Настройки" - подраздел "Файлы настроек".

При изменении способа хранения настроек на "В СБИС", проверяет наличие готового соединения в параметрах - "ConnectionID", где хранится 128-битный идентификатор.

Пункт 1. Если идентификатор отсутствует, то:

Шаг 1. Получает список доступных соединений по URL.

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

Шаг 2. Берёт первое соединение из полученного списка.

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

Шаг 3. Выполняет получение настроек по выбранному идентификатору (Пункт 2).

Пункт 2. Если идентификатор имеется, то:

Шаг 1. Получает меню соединения.

• Проверяет наличие сбисМеню в кэше по выбранному 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. Отображает выбранные ини соединения и конфигурации.
  • сбисОбновитьТаблицыИниФайлов на форме ГлавноеОкно.
    • В левой колонке список ини полученной конфигурации.
    • В правой колонке список ини выбранного соединения.