Грешки от клиентите

Идея и цел на страницата

Основната цел е операторът да открие повтарящ се или спешен проблем, да прочете техническия контекст, да го предаде за отстраняване и след реално решение да приключи активния сигнал. Екранът е полезен както за единичен клиентски случай, така и за сравнение дали една и съща услуга създава проблеми в много фирми.

Страницата не е исторически журнал и не доказва сама по себе си, че бизнес операцията е успешна или неуспешна. Тя показва текущо активните сигнали. За окончателна диагноза винаги се използват пълният текст на грешката, журналът на съответния модул и проверка на реалната операция при клиента.

Какво показват данните

• Активен сигнал е проблем, който клиентски модул е подал и който още не е изтекъл или изтрит.
• Един сигнал се определя от комбинацията SB_ID + обект + модул + ключ на проблема.
• Повторно подаване на същата комбинация не създава безкрайни дубликати — обновява текущия текст и полето „Последно“.
• При текущата настройка сигналът изтича до около 60 минути след последното подаване, ако модулът не го поднови.
• Данните са оперативни и могат да се изчистят и при рестартиране на услугата. За историческо разследване използвай журналите на конкретния модул.
• Името на фирмата се намира по SB_ID. Ако липсва, може да се покаже „неизвестна“, но SB_ID остава основният идентификатор.

Как е устроен екранът

Горна лента

Съдържа „УКАЗАНИЕ“, „Назад“ и бутон за светла/тъмна тема. „Назад“ връща към предишния екран, когато има такъв.

Състояние

Редът под заглавието показва дали данните се зареждат, дали последното обновяване е успешно или има грешка. Обновяването е ръчно, за да не се размести екранът, докато четеш.

Обобщение

Показва броя на активните грешки, фирмите, обектите и модулите в текущо филтрирания резултат.

Филтри

Ограничават данните веднага. Всички избрани условия работят едновременно.

Невзети / Взети

Двата таба разделят свободните сигнали от тези, по които вече работи оператор. При взет сигнал се виждат името и ID-то на оператора.

Бърз анализ

Показва кои модули и фирми имат най-много сигнали в текущия филтриран набор. Дължината на червената лента е относителна спрямо най-голямата стойност в списъка.

Филтри и очакван резултат

Филтрите се комбинират с логика „И“. Например избрана фирма, модул export-services и „Последните 15 минути“ ще покажат само сигналите, които изпълняват и трите условия.

Когато идваш от Loged.aspx през фирма или последен сигнал, страницата получава предварителни филтри. Съответната фирма и обект се разтварят автоматично. Натисни „Изчисти“, за да премахнеш тези параметри от адреса и да презаредиш всички клиенти.

Правила за показване

Правилата се съхраняват в базата данни и определят кои активни сигнали се показват в основния списък. Правилата действат само за своя модул: когато даден модул има активни правила, от него се показват само сигналите, чийто текст съдържа текста на някое правило. Модули без правила се показват изцяло. Ключът на проблема не участва.

Добави правило

Най-бързо: натисни „Правило“ до конкретен сигнал. Модулът и текстът се попълват от сигнала, а ти избираш обхват (всички фирми, фирмата или обекта), валидност и причина. Пълният списък е зад „Правила за видимост“ в модула ClientNotificationRules.aspx с таблица, филтри и панел за редакция. Модулите export-services и transfer-services са налични винаги; новите модули от текущите резултати се добавят автоматично.

Редактиране

Натисни „Редактирай“ до съответния ред. Във формата ще се покаже ясен „РЕЖИМ РЕДАКЦИЯ“, а „Запази промените“ обновява същото правило, без да създава второ.

Изключване

„Изключи“ спира прилагането на правилото, но не го изтрива. То остава записано и може да се намери с филтъра „Статус: Само изключени“.

Повторно активиране

Смени филтъра „Статус“ на „Само изключени“, намери реда и натисни „Активирай“. Правилото се връща в действие със запазените модул, текст и валидност.

Валидност

„Без срок“ няма дата на изтичане. При правило със срок изтичането спира прилагането му; то не изтрива записа и може да бъде редактирано или активирано отново.

Вземане на проблем и координация

„Вземи“ показва на останалите оператори, че вече работиш по сигнала. Това намалява дублираната работа и дава ясен собственик на текущата проверка.

Препоръчителен процес

1. В таб „Невзети“ отвори фирмата и обекта, прочети целия текст и провери дали сигналът е актуален.
2. Натисни „Вземи“ преди да започнеш проверката. След успех сигналът се премества в „Взети“ и показва твоето име и ID.
3. Продължи диагностиката. Използвай „Копирай“, когато трябва да предадеш точния контекст на колега или разработчик.
4. Ако друг оператор е взел сигнала почти едновременно, сървърът запазва първото успешно вземане. Страницата ще покаже актуалния собственик.
5. Ако не можеш да продължиш, натисни „Откажи“. Само операторът, който е взел сигнала, може да го освободи. Той се връща в „Невзети“.
6. След реално отстраняване провери следващата операция и едва тогава изтрий активния сигнал. Ако само предаваш работата, използвай „Откажи“, а не „Изтрий“.

Повторно подаване

Докато същият активен сигнал съществува, ново съобщение със същия ключ обновява „Последно“, без да премахва оператора, който го е взел.

Изтичане, изтриване или рестарт

Вземането важи само за текущия активен сигнал. Ако той изчезне и по-късно бъде подаден отново, ще се появи като невзет.

Филтър „Оператор“

В таб „Взети“ показва сигналите на избраното име и ID. Така всеки оператор може бързо да намери своите активни проблеми.

Скрити нива, менюта и действия

1. Ниво „Фирма“. В сгънатия ред виждаш името, SB_ID, броя на грешките и броя на засегнатите обекти. Натисни реда или стрелката вляво, за да покажеш обектите на фирмата.
2. Ниво „Обект“. Под отворената фирма се показват имената на устройствата/обектите и броят на сигналите във всеки от тях. Натисни обекта, за да покажеш конкретните грешки.
3. Ниво „Грешка“. Вляво са модулът и техническият ключ. В средата е пълното съобщение, времето „Последно“ и операторът при взет сигнал. Вдясно са наличните действия.

„Разгъни“ отваря всички фирми и обекти в текущия резултат. „Свий“ ги затваря. Тези бутони не променят филтрите и не обновяват данните.

Останали действия в грешката

• Копирай поставя в клипборда фирма, SB_ID, обект, модул, ключ, съобщение и последно засичане. Това е препоръчителният формат за задача или комуникация с разработчик.
• Изтрий премахва само този активен сигнал след потвърждение. Не поправя настройката, файла, мрежата или базата и не изтрива клиентски данни.
• Ако причината продължава и модулът подаде същия ключ отново, сигналът ще се появи отново.

Практически уроци

Урок: бърза проверка на нов проблем

1. Натисни „Обнови“ и избери „Последните 5 минути“.
2. Отвори фирмата и обекта с най-новия сигнал.
3. Натисни „Вземи“, за да е ясно на останалите оператори, че започваш проверка.
4. Прочети първо модула, после целия текст — ключът сам по себе си рядко е достатъчен.
5. Натисни „Копирай“ и приложи информацията към задачата или разговора за проблема.
6. Провери съответната услуга, настройка, файл, мрежова връзка или база според текста.

Урок: анализ на един клиент

1. Избери „Фирма“, а при нужда и „Обект“.
2. Провери дали няколко реда са от един модул или различни модули.
3. Сравни ключовете и полето „Последно“. Един и същ ключ, който постоянно се обновява, показва продължаващ проблем.
4. Ако различни обекти имат еднакъв текст, търси обща настройка, сървър или интеграция.

Урок: търсене на масов проблем

1. Изчисти филтрите и избери проблемния модул.
2. Използвай „Бърз анализ“, за да видиш най-засегнатите фирми.
3. Потърси характерна част от текста — IP адрес, URL, име на файл или код.
4. Ако еднакъв проблем се вижда при много независими фирми, провери първо общата услуга или общата версия.

Урок: правилно приключване

1. Отстрани причината и изпълни или изчакай следващата реална операция на модула.
2. Натисни „Обнови“. Ако „Последно“ продължава да се променя, проблемът още се подава.
3. Когато решението е потвърдено и контекстът е копиран, натисни „Изтрий“.
4. Обнови отново. Ако сигналът се върне, продължи диагностиката — не го изтривай многократно без проверка.

Как да разчиташ грешките

Полето Модул показва кой компонент е изпратил сигнала. transfer-services обикновено е свързан с прехвърляне/синхронизация на данни или файлове, а export-services — с конкретен експорт и неговата конфигурация. Полето Ключ, например transfer-error-14 или export-error-…, служи основно за обединяване на повторенията. То не е достатъчно описание на причината.

Състояния и грешки на самата страница

Няма активна операторска сесия

Влез отново през входа на същия адрес. Сесиите на localhost и portal.yanaksoft.net са отделни.

Грешките не могат да бъдат заредени

Провери връзката до централния API, CORS настройките и дали услугата отговаря. Това не означава, че при клиентите няма грешки.

Няма резултат

Първо натисни „Изчисти“. Ако и без филтри няма данни, в момента няма заредени активни сигнали.

Грешката не можа да бъде изтрита

Не приемай, че е премахната. Провери с „Обнови“, поднови операторската сесия при нужда и опитай отново едва след потвърждение.

Сигналът се появява отново

Източникът продължава да отчита същия проблем. Върни се към причината и журнала на модула, вместо да повтаряш „Изтрий“.

Сигналите са заредени, но липсват „Вземи“ и „Откажи“

Сървърният контролер още не поддържа разпределянето. Можеш да преглеждаш, филтрираш, копираш и изтриваш сигнали, но функциите за вземане ще се появят след обновяване на сървъра.