Перейти к содержанию
Документация Визографа

Руководство пользователя

Работа с браузерным интерфейсом, задачами распознавания и результатами

ПО «Визограф»2026

УТВЕРЖДЕН

приказом ООО «ФТ-СОФТ» от 12.01.2026 № 45

ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ «ВИЗОГРАФ»

РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ

Работа с браузерным интерфейсом, задачами распознавания и результатами обработки документов

Версия документа: 1.0

2026

1. Назначение руководства

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

Основной пользовательский процесс включает:

  • выбор доступного проекта;

  • загрузку документа;

  • выбор сценария распознавания;

  • создание и асинхронное выполнение задачи;

  • классификацию документа;

  • получение распознанного текста;

  • извлечение структурированных атрибутов;

  • просмотр исходного документа и результатов обработки;

  • работу с историей задач, отменой и повторным распознаванием.

Отдельный раздел содержит краткую инструкцию по использованию интеграционного программного интерфейса. Административные функции приведены справочно и доступны только пользователям с соответствующими полномочиями.

2. Условия начала работы

Перед началом работы должны быть выполнены следующие условия:

  • экземпляр «Визограф» установлен, настроен и доступен по сети;

  • пользователю предоставлена действующая учётная запись;

  • пользователю доступен активный проект;

  • в проекте назначена доступная неархивная конфигурация по умолчанию;

  • настроены необходимые службы распознавания и/или языковой модели в зависимости от используемого сценария;

  • лицензионное состояние разрешает запуск новой обработки;

  • подготовлен документ поддерживаемого формата.

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

Расположение отдельных элементов интерфейса может меняться в зависимости от версии системы. При выполнении операций следует ориентироваться прежде всего на названия разделов и команд.

5. Вход в систему

1. Откройте веб-интерфейс системы по адресу, предоставленному администратором.

2. В форме авторизации укажите ваш логин и пароль.

3. Нажмите кнопку «Войти».

4. После успешного входа убедитесь, что доступны предусмотренные вашей ролью разделы, например «Конфигурации», «Распознавание» и «Настройки».

Ожидаемый результат: пользователь успешно вошёл в приложение; доступные для его роли разделы интерфейса отображаются.

6. Создание задачи распознавания

6.1. Выбор проекта

1. Откройте переключатель проектов.

2. Выберите нужный активный проект.

3. Убедитесь, что название выбранного проекта отображается в интерфейсе.

Ожидаемый результат: система перешла в контекст выбранного проекта, раздел распознавания доступен.

6.2. Открытие формы новой задачи

1. Перейдите в раздел «Распознавание».

2. Если открыта ранее созданная задача, нажмите «Новая задача на распознавание».

3. Убедитесь, что открыта форма создания новой задачи.

Ожидаемый результат: отображается форма выбора сценария и добавления документов.

6.3. Выбор сценария распознавания

В зависимости от конфигурации могут быть доступны следующие сценарии:

Сценарий Назначение
Классификация и извлечение через LLM Определение типа документа, получение текста и извлечение атрибутов.
Только классификация Определение типа документа без извлечения атрибутов.
Только извлечение через LLM Извлечение атрибутов для заранее выбранного точного типа.
Только OCR-текст Получение текста средствами распознавания.
Извлечение LLM с OCR-доказательствами Извлечение атрибутов с возможностью перехода к подтверждающим текстовым фрагментам и областям страницы.
Извлечение с опорой на OCR-источник Использование распознанных текстовых блоков как источника контекста для извлечения.

Для типового комплексного пользовательского сценария выберите «Классификация и извлечение через LLM».

6.4. Добавление документа

1. В блоке «Документы» добавьте один или несколько файлов.

2. Дождитесь появления имени каждого файла в форме.

3. Убедитесь, что расширение файла входит в отображаемый каталог поддерживаемых форматов.

Каждый выбранный файл обрабатывается как отдельная задача и имеет собственное состояние и результат. Для простой проверки рекомендуется загружать один документ.

Ожидаемый результат: файл отображается в форме и готов к отправке.

6.5. Запуск и ожидание обработки

1. Нажмите «Отправить на распознавание».

2. Дождитесь перехода к созданной задаче.

3. Наблюдайте за состоянием задачи до её завершения.

В интерфейсе могут последовательно отображаться состояния:

  • «Подготавливаем документ»;

  • «Документ ожидает распознавания»;

  • «Распознаём документ»;

  • «Готово» или «Готово · из кеша».

Обработка выполняется асинхронно. Некоторые промежуточные состояния могут завершаться быстро и не отображаться пользователю.

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

7. Просмотр результатов

Выберите обработанный файл в панели «Задачи на распознавание».

7.1. Классификация

Проверьте заголовок результата. Для успешно классифицированного документа отображается название определённого типа.

Ожидаемый результат: определён тип документа, соответствующий фактическому содержимому загруженного файла.

7.2. Распознанный текст

1. Откройте вкладку «Текст».

2. Сопоставьте отображаемый текст с содержимым исходного документа.

Ожидаемый результат: отображается текстовое содержимое документа; особенности форматирования могут зависеть от структуры и качества исходного файла.

7.3. Извлечённые атрибуты

1. Откройте вкладку «Атрибуты».

2. Убедитесь, что отображаются поля настроенного типа документа.

3. Сопоставьте значения основных полей с исходным документом.

Ожидаемый результат: отображаются структурированные значения полей, настроенных для определённого типа документа.

7.4. Структурированный результат

Если доступна вкладка «JSON», откройте её для просмотра результата в структурированном виде. Наличие отдельных полей зависит от выбранного сценария и фактически полученных данных.

7.5. Просмотр страниц

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

8. Работа с историей задач

1. Откройте панель «Задачи на распознавание».

2. Выберите доступную активную или завершённую задачу.

3. Откройте нужный файл и его результат.

Состав доступной истории определяется проектом и правами пользователя. Глобальный администратор и администратор проекта могут видеть задачи проекта; обычный пользователь проекта — задачи в пределах предоставленных ему прав.

9. Отмена и повторное распознавание

9.1. Отмена активной задачи

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

1. Выберите активную задачу.

2. Нажмите «Отменить задачу».

3. Дождитесь окончательного состояния отмены.

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

9.2. Повторное распознавание

Для завершённого документа может быть доступна команда «Распознать заново». Она повторно запускает обработку выбранного документа. Во время активной обработки команда недоступна.

10. Работа с OCR-доказательствами

Для сценария «Извлечение LLM с OCR-доказательствами» система может связывать извлечённые значения с исходными текстовыми фрагментами и областями документа.

1. Создайте новую задачу.

2. Выберите сценарий «Извлечение LLM с OCR-доказательствами».

3. Добавьте документ и запустите обработку.

4. После завершения откройте вкладки «Текст» и «Атрибуты».

5. Для атрибута, имеющего подтверждение, нажмите «Источник».

После выбора источника система:

  • показывает связанный текстовый фрагмент;

  • при наличии координат выделяет соответствующую область страницы.

Ожидаемый результат: извлечённое значение может быть сопоставлено с исходным фрагментом документа.

12. Справочные административные возможности

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

Область Возможности
Проекты Создание, изменение, архивирование, восстановление, удаление и выбор конфигурации по умолчанию в пределах полномочий.
Участники Добавление и удаление участников, назначение проектных ролей и доступа к конфигурациям.
Пользователи Создание, блокировка, разблокировка, сброс пароля и управление глобальными административными правами.
Конфигурации Создание, изменение, дублирование, архивирование, восстановление, импорт и экспорт JSON.
Типы документов Настройка ключа, названия, правил классификации, полей и правил извлечения.
Службы языковых моделей Создание и изменение профиля, проверка подключения, активация, архивирование и восстановление.
Службы распознавания текста Создание и изменение профиля, проверка подключения, активация, архивирование и восстановление.
Интеграционные ключи Создание проектного ключа, однократное получение полного секретного значения и отзыв.
Лицензия Просмотр состояния, формирование запроса активации и применение подписанного файла лицензии.
Профиль Просмотр имени пользователя, изменение пароля и завершение сеанса.
13. Типовые ошибки и способы устранения
Ситуация Наблюдаемый признак Действие пользователя
Проект не выбран Форма распознавания недоступна или отображается просьба выбрать проект. Выберите доступный активный проект. Если нужного проекта нет, проверьте учётную запись и обратитесь к администратору.
Файл не добавлен Система просит добавить хотя бы один файл. Добавьте документ поддерживаемого формата.
Не выбран обязательный тип Система просит выбрать тип документа для извлечения. Выберите точный тип документа либо используйте сценарий с автоматической классификацией.
Каталог форматов недоступен Не удаётся загрузить список поддерживаемых форматов. Повторите позже или обратитесь к сопровождающему специалисту.
Распознавание не настроено Отображается сообщение о ненастроенном распознавании. Проверьте выбранный проект; не изменяйте служебные настройки самостоятельно без соответствующих прав.
Файл не поддерживается Сообщение о неподдерживаемом формате или невозможности подготовить документ. Проверьте расширение, целостность файла и повторите с поддерживаемым документом.
Тип не определён Сообщение о неподдерживаемом типе или ошибке классификации. Убедитесь, что документ соответствует одному из типов активной конфигурации.
Атрибуты отсутствуют Нет вкладки «Атрибуты» или нет настроенного извлечения. Проверьте сценарий распознавания, тип документа и наличие полей в конфигурации.
Задача завершилась ошибкой Интерфейс показывает ошибку обработки. Зафиксируйте имя файла, проект, идентификатор задачи и видимый текст ошибки; затем повторите с корректным документом либо передайте сведения сопровождению.
API вернул 401 Ошибка аутентификации. Проверьте схему Bearer и действительность используемого проектного ключа.
API вернул 404 Задача не найдена. Проверьте идентификатор задачи и используйте ключ того же проекта.
14. Требования информационной безопасности
  • Не передавайте логин и пароль третьим лицам.

  • В инструкциях и отчётах вместо учётных данных используйте формулировку «укажите ваш логин и пароль».

  • Не включайте полные API-ключи и иные секретные значения в снимки экрана и документы.

  • Храните API-ключи только в защищённом месте и отзывайте их после завершения использования, если они больше не нужны.

  • При обращении в техническую поддержку не передавайте пароли, интеграционные ключи и секреты подключённых служб.

  • Содержимое рабочих документов передавайте сопровождению только в согласованном порядке.

15. Завершение работы

1. Убедитесь, что активные задачи завершились либо были отменены.

2. При необходимости вернитесь к списку задач и проверьте окончательное состояние обработки.

3. Не изменяйте административные настройки без необходимости.

4. Завершите пользовательский сеанс штатной командой «Выйти».

5. Закройте вкладку браузера.

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

Ничего не найдено. Измените поисковый запрос.