TesLab Sync: подключение локального агента

В документации мы постарались ответить на частые вопросы по работе TesLab, с которыми сталкиваются пользователи.
Если Вы не нашли ответ на свой вопрос, напишите нам.

Личный кабинет

TesLab Sync: подключение локального агента

Локальный агент TesLab Sync FSA запускают на том же компьютере, где открыт TesLab. Расширение TesLab Sync в текущем профиле браузера передаёт агенту авторизацию ФГИС. После подключения проверьте название и номер лаборатории, затем выполните контрольное чтение справочника.

В этой статье

Краткий порядок подключения

  1. Проверьте режим «TesLab SyncFSA сервер (локальный агент)».
  2. Запустите агент ФГИС на этом компьютере. Убедитесь, что расширение TesLab Sync включено в используемом профиле браузера.
  3. В TesLab нажмите кнопку с подсказкой «Подключиться к локальному агенту».
  4. При запросе выберите «Открыть ФГИС», выполните обычный вход в нужную лабораторию и вернитесь в TesLab.
  5. Дождитесь подтверждения агента. Сверьте название и номер подключённой организации.
  6. Проверьте получение списка сотрудников или СИ, не меняя сопоставления.

Установленная программа, открытое локальное соединение и подтверждённая авторизация лаборатории являются разными этапами. Подключение и получение справочника не подтверждают публикацию протокола.

Передача авторизации ФГИС через расширение и TesLab локальному агенту
Расширение получает действующую сессию ФГИС и передаёт её в TesLab. Программа передаёт сведения локальному агенту и ждёт подтверждения подключения.

Выбор режима и права

  1. Откройте «Лаборатория» → «Синхронизация» → «Настройки».
  2. В блоке «Подключение к ФГИС» найдите «Режим синхронизации ФГИС».
  3. Для этого маршрута выберите «TesLab SyncFSA сервер (локальный агент)».
  4. Дождитесь успешного сохранения настройки, затем перейдите на «К публикации».

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

Для локального агента API-ключ не вводят. «TesLab Sync plugin (расширение браузера)», XML и API являются отдельными маршрутами. Если лаборатория уже использует другой способ, согласуйте переключение с ответственным за обмен. Выбор способа описан в обзоре обмена с ФГИС; для API есть отдельная инструкция подключения.

Выбор режима TesLab SyncFSA сервер (локальный агент)
1. Режим локального агента в настройках подключения.

Подготовка компьютера и браузера

  1. Откройте официальную страницу загрузок TesLab. Для локального компонента там предлагается Windows-пакет TesLab Sync.
  2. Установите и запустите компонент TesLab Sync FSA на компьютере с браузером TesLab. Компонент резервного копирования из того же набора не заменяет агент ФГИС.
  3. Установите расширение TesLab Sync и включите его в текущем профиле браузера.
  4. Проверьте доступ расширения к сайту TesLab и ФГИС. Установка в другом профиле или у другого пользователя компьютера не делает его доступным в текущем окне.
  5. После установки или включения расширения заново откройте TesLab. Войдите под своей учётной записью и проверьте доступ к нужной лаборатории во ФГИС обычным способом вашей организации.

Версия агента должна быть совместима с используемым TesLab. При сообщении о старой версии обновляйте именно компонент SyncFSA. После обновления закройте прежний экземпляр и запустите установленную версию.

Ручной ввод токенов и копирование ключей из инструментов разработчика не требуются. Авторизацию передаёт расширение.

Подключение и проверка лаборатории

  1. На вкладке «К публикации» нажмите кнопку с подсказкой «Подключиться к локальному агенту».
  2. Если появится окно «Необходимо авторизоваться во ФГИС ФСА», нажмите «Открыть ФГИС».
  3. Дождитесь полного входа во внешний кабинет и проверьте выбранную организацию.
  4. Вернитесь в TesLab и дождитесь подтверждения локального агента.
  5. В подзаголовке страницы «Синхронизация со ФГИС» проверьте «Подключено: название (номер)». Сведения должны соответствовать нужной лаборатории.
Запрос авторизации ФГИС с кнопкой Открыть ФГИС
1. Кнопка «Открыть ФГИС» в окне авторизации.
Кнопка подключения к агенту и подтверждённая учебная лаборатория
1. Кнопка подключения. 2. Подзаголовок с названием и номером подключённой лаборатории.

Если агент уже подтвердил действующее подключение, повторный запрос авторизации может не понадобиться. Кнопка подключения также проверяет состояние существующего соединения.

Если показана другая лаборатория, не переходите к рабочим действиям. Закройте агент, восстановите правильный вход во ФГИС, запустите агент заново и повторите подключение. Сохранённые связи сотрудников и приборов не подтверждают текущую организацию внешнего кабинета.

Если подключение не установлено

Сообщение или ситуацияЧто проверить
«Не запущен сервер TesLab Sync FSA»Проверьте, что нужный агент установлен и запущен на этом компьютере, а браузер может обратиться к нему.
«Локальный агент не открыл соединение» или «не ответил на проверку состояния»Проверьте окно агента, дождитесь завершения его запуска и повторите подключение. При повторном отказе сохраните точный текст сообщения.
«Не найдено расширение TesLab Sync!»Проверьте установку и включение расширения именно в текущем профиле. После установки или включения заново откройте TesLab.
«Расширение не передало сессию ФГИС»Проверьте расширение, его доступ к обоим сайтам и завершённый вход в нужную лабораторию. Повторите подключение.
«Сессия передана локальному агенту, но он не подтвердил подключение»Проверьте сообщения агента и доступ к ФГИС с этого компьютера. Передача сессии ещё не является подтверждением соединения.
«Сессия ФГИС ФСА завершена» или сообщение о недействительной сессииВыполните обычный повторный вход во ФГИС, дождитесь рабочего кабинета и подключитесь из TesLab заново.
«Установлена старая версия SyncFSA»Получите совместимую версию официального компонента. Закройте прежний экземпляр и запустите обновлённый агент.
Отказ защищённого соединения или доверенного сертификатаПередайте точный текст администратору. Проверьте сетевой доступ и доверенные сертификаты на этом компьютере.
Ошибка получения справочникаПовторите контрольное чтение после проверки подключения. Отличайте сообщение об ошибке от корректного пустого списка.

Срок ожидания локального соединения и ожидание авторизации расширения являются разными этапами. При сообщении об отказе сначала выясните причину и повторите подключение, а не запускайте отправку протоколов.

Для администратора: браузер обращается к локальному процессу по ws://localhost:1980. Это рабочий компьютер, а не удалённый сервер лаборатории. Порт не требуется открывать во внешнюю сеть.

Контрольное чтение и учебный пример

  1. После подтверждения нужной лаборатории откройте «Настройки» → «Сервисные действия».
  2. Нажмите «Сотрудники: синхронизация» или «Средства измерения: синхронизация».
  3. Дождитесь результата чтения. Проверьте записи своей организации либо явное сообщение, что справочник пуст.
  4. Для проверки связи не меняйте значения селектов, не запускайте сопоставление, сброс или импорт. Выбор связи в этих окнах может сохраняться сразу.
  5. Закройте окно после проверки. Для дальнейшей настройки используйте статью «Сотрудники и оборудование в обмене с ФГИС».
Контрольное чтение справочника сотрудников учебной лаборатории
1. Полученные записи ФГИС в окне сопоставления. Для проверки связи достаточно прочитать результат, не меняя выбранные связи.

Учебный пример: специалист запустил агент, проверил расширение и вошёл в нужную лабораторию. В TesLab появились её название и номер. Затем он получил список сотрудников и сверил несколько записей, не меняя сопоставления. Проверка связи завершена; протоколы при этом не отправлялись.

Если вместо списка показана ошибка, сначала устраните её. Бессрочное ожидание и явный пустой результат не являются одним и тем же состоянием.

Смена пользователя, обновление и поддержка

После смены пользователя TesLab, сервера или способа обмена выполните подключение и проверку организации заново. Новое соединение не следует считать продолжением авторизации другого пользователя. На общем компьютере отдельно проверяйте запущенный агент, профиль браузера и выбранную лабораторию во ФГИС.

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

Для обращения в сопровождение укажите режим обмена, версии агента и расширения, браузер, время и точный текст ошибки. Не включайте ключи и данные авторизации в передаваемые материалы.

Продолжение работы