Связи и сообщения карточки

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

Виджет поиска

Текстовый виджет "Связи и сообщения карточки"
Рисунок 1. Текстовый виджет "Связи и сообщения карточки"
Виджет содержит следующие элементы:

  1. Заголовок с названием виджета. Заголовок является ссылкой. По нажатию на заголовок открывается страница сообщений с фильтрацией по умолчанию (отображаются все сервисы и все состояния).

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

    Информация будет обновлена только по нажатию кнопки Круглая стрелка или при обновлении страницы.

  3. Список соединений с Docsvision. Данные будут загружаться из выбранного соединения.

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

  4. Строка для указания идентификатора карточки.

  5. Таблица с указанием результатов поиска. В первом столбце указывается Состояние найденной карточки, во втором — Количество сообщений.

    На виджете отображается количество сообщений в каждом состоянии: Обработано, Не обработано, Пауза, Ошибка, Блокировано. Количество сообщений в состоянии Блокировано означает сообщения, имеющие блокировку, но не количество самих блокировок.

    Нажатие на таблицу или заголовок переводит на страницу "Сообщения и связи карточки".

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

Если в строку поиска ввести идентификатор карточки Документа, в виджете отобразятся сообщения с согласованяими карточки. При нажатии на виджет откроется страница "Сообщения и связи карточки".

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

Полная информация по найденной карточке доступна на странице Сообщения и связи карточки.

В таблице со списком сообщений могут отображаться следующие сообщения:

  • Карточка не найдена!, если карточка не найдена в системе.

  • Введён некорректный идентификатор, если указанный идентификатор некорректен.

  • Число сообщений = 0 в каждой строке таблицы, если карточка найдена, но не найдены сообщения.

  • Сообщения не поддерживаются, если введён идентификатор карточки, для которой не может быть создана карточка сообщений.

Страница "Сообщения и связи карточки"

Страница "Сообщения карточки"
Рисунок 2. Страница "Сообщения карточки"

Страница содержит информацию по всем входящим и исходящим сообщениям, выбранной карточки. Данные на странице будут обновлены только при обновлении страницы.

Страница состоит из нескольких элементов:
Заголовок и вкладки

В верхней части страницы отображается заголовок страницы и вкладки Входящие сообщения и Исходящие сообщения. В зависимости от выбранной вкладки можно посмотреть информацию о входящих или исходящих сообщениях карточки.

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

Область "Текущая карточка"

В центральной области отображается карточка, для которой выводится список входящих и исходящих сообщений, а также исходных (область Зависит от слева) или дочерние карточки (область Подчинённые). Текущей карточкой является карточка, ID которой был введён в поле виджета Связи и сообщения карточки.

Область "Текущая карточка"содержит:

  • ID карточки — идентификатор карточки в системе Docsvision.

  • Вид карточки — понятный для человека вид карточки в системе Docsvision.

  • Дайджест — сообщение было зарегистрировано для карточки с данным названием в системе Docsvision.

  • Соединение — подключенный экземпляр соединения соответствующего типа (например, соединение типа Docsvision).

Область "Зависит от"

В области отображаются карточки, из которых была создана текущая карточка. Например, Исходящий, из которого была создана группа заданий или группа заданий, из которой было создано задание на исполнение.

При нажатии правой кнопкой мыши в строке карточки вызывается контекстное меню со следующими пунктами:

  • Скопировать ID карточки — копирует идентификатор в буфер обмена.

  • Открыть карточку в Web-клиенте — открывает карточку в Web-клиенте.

  • Открыть карточку в Windows-клиенте — открывает карточку в Windows-клиенте.

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

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

Область "Подчинённые"

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

Подчинённые карточки сортируются по дате создания, самые новые карточки выводятся сверху.

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

Область "Сообщения"

В центральной области, под данными текущей карточки, отображаются все Входящие или Исходящие сообщения (в зависимости от вкладки) для текущей карточки.

У каждого входящего сообщения есть набор параметров, часть из которых выводится в данной области:

  • Дата создания — дата и время, когда сообщение было зарегистрировано. По умолчанию таблица отсортирована по дате создания сообщения.

  • Состояние — состояние обработки сообщения. Сообщение может быть заблокировано в состоянии Не обработано, Пауза, Ошибка. В этом случае через запятую с состоянием выводится слово блокировка. Доступно только для входящих сообщений.

    При нажатии на строку сообщения, содержащую Ошибки и/или Блокировки открывается страница "Ошибки и блокировки".

  • Дата создания — дата и время, когда сообщение было зарегистрировано. По умолчанию таблица отсортирована по дате создания сообщения.

  • Сервис обработки — фоновая операция Службы фоновых операций, предназначенная для выполнения определённых задач. Например, сервис обработки Backoffice предназначен для обработки задач, связанных с функционированием модуля Базовые объекты, а именно: создание заданий по группе заданий, изменений состояния заданий при выполнении и др.

  • Тип сообщения — идентификатор типа сообщения, полученного сервисом обработки.

  • Событие — краткое описание события.

  • Дайджест — сообщение было зарегистрировано для карточки с данным названием в системе Docsvision.

  • Отложенная отправка и Дата активации — сообщения могут быть активированы через заданный промежуток времени. Поля заполняются сервисом, генерирующим сообщения. Текущими сервисами не используются. Доступно только для исходящих сообщений.

  • Кнопка Информация — при нажатии на кнопку появляется всплывающее окно с информацией по событию в формате XML.

При нажатии на строку области Зависит от или Подчиненные данные изменяются. В области Текущая карточка отображается подробная информация о выбранной карточке, а в областях Зависит от и Подчиненные отображаются зависимые карточки. Для области Зависит от — родительтская карточка, от которой зависит текущая. Для области Подчиненные — карточки, которые зависят от выбранной Текущей карточки — дочерние.

Карточки отображаются в одном из поддерживаемых форматов:

  • Тип карточки — Дайджест (ID) — если у карточки есть дайджест.

  • Тип карточки — Вид карточки (ID) — если дайджест отсутствует, но есть вид карточки.

  • Тип карточки (ID) — если отсутствуют дайджест и вид карточки.

В областях Зависит от или Подчиненные отображаются карточки, которые поддерживают работу с сообщениями, а также те, которые не поддерживают.

Пример изменения данных в зависимости от выбранной карточки
Если в виджете был указан ID карточки группы заданий:

  • В области Текущая карточка будет отображаться информация о карточке группы заданий.

  • В области Зависит от — входящий документ, из которого была создана группа заданий.

  • В области Подчиненные — задания на исполнения, сформированные группой заданий.

После нажатия на одно из заданий на исполнение:

  • В области Текущая карточка будет отображаться информация о задании на исполнение 1.

  • В области Зависит от — группа заданий, из которой было создано задание на исполнение.

  • В области Подчиненные — подчиненные задания данного задания на исполнение.

Использование виджета

  1. Выберите подключение к Docsvision, из которого будут загружаться данные.

  2. В поле Идентификатор карточки введите идентификатор карточки, для которой нужна статистика обработки сообщений, нажмите кнопку Найти. В графиках отобразится статистка обработки сообщений карточки.

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

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

  1. Администратор должен получить ID проблемного задания из Web-клиент или Windows-клиент.

  2. Перейти в Консоль управления Docsvision, ввести ID в поле ввода данного виджета, чтобы получить сведения о сообщениях.

  3. Наличие сообщений в состоянии Обработано может говорить о том, что карточка начала обрабатываться даже если далее есть ошибки или блокировки.

  4. Наличие сообщений в состоянии Не обработано может говорить о том, что логика карточки Задания возможно была ещё не до конца выполнена, в связи с чем пользователю не приходит задание.

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

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

  7. На вкладке будут отображены все сообщения карточки, включая Ошибки и блокировки.

  8. Наличие блокировок говорит о том, что часть сообщений были заблокированы внешними событиями. Заблокированы могут быть сообщения в состоянии Не обработано и Ошибка.

  9. При блокировке процесс останавливается. Чтобы процесс возобновился, необходимо открыть страницу Сообщений карточки, на ней вкладку Входящих сообщений карточки. Затем перейти на страницу Ошибок и блокировок и снять все блокировки.

  10. После разрешения ошибок входящее сообщение, ожидающее обработку может изменить свой статус один раз: из Не обработано в Ошибку или в Обработано.

    Сообщение в состоянии Ошибка, не поменяет статус и все равно будет отображаться.