РЭ: улучшить описание работы параметра "Прекратить поиск после нахождения маршрутов"

[alx]

В платах VE-01 и VE-02 есть конфигурационный параметр "Прекратить поиск после нахождения маршрутов", который определяет поведение прокси-сервера в случае, если вызовы найденных маршрутов SIP были неудачны. Выяснилось (см. ​тикет), что один из пользователей неверно понял описание работы данного параметра - он думал, что обработка вызова прекратится после нахождения первого же совпадающего маршрута SIP из нескольких имеющихся (пользователь настроил резервирование, и у него вызываемый URI совпадал сразу c несколькими маршрутами SIP).

Выяснилось, что в РЭ параметр "Прекратить поиск после нахождения маршрутов" в целом описан правильно, однако там не рассматривается случай, когда вызываемый URI совпадает с несколькими маршрутами сразу, и не делается акцент на том, что поиск прекращается после обработки всех маршрутов (а не после нахождения первого совпадения, как ошибочно подумал пользователь). В примере, использованном в описании этого параметра, вызов совпадает только с одним маршрутом. К тому же в первом предложении описания (см. РЭ-67 п. 7.1.4.2 на странице 249), видимо, по ошибке слово "маршрут" употреблено в единственном, а не множественном числе (предполагаю, что это и запутало пользователя):

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

Или, возможно, имелось в виду "хотя бы один маршрут"...

Чтобы в будущем избежать подобного неверного понимания предлагаю дополнить описание параметра "Прекратить поиск после нахождения маршрутов", специально сделав акцент на том, что обработка вызова прекращается не после нахождения первого совпадающего маршрута, а после нахождения всех совпадающих маршрутов. За основу можно взять ​эту статью - я ее скорректировал и добавил пример с несколькими совпадающими маршрутами.

[Vladimir]

Replying to alx:

... В примере, использованном в описании этого параметра, вызов совпадает только с одним маршрутом. К тому же в первом предложении описания (см. РЭ-67 п. 7.1.4.2 на странице 249), видимо, по ошибке слово "маршрут" употреблено в единственном, а не множественном числе (предполагаю, что это и запутало пользователя):

Не по ошибке, т.к. я и не знал, а просто скопировал из вики,
но в редактируемом РЭ-69 уже записал множественное число ...

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

Или, возможно, имелось в виду "хотя бы один маршрут"...

Что ты имел ввиду, когда сочинял Вики я не знаю, но записал множественное число :-)

Чтобы в будущем избежать подобного неверного понимания предлагаю дополнить описание параметра "Прекратить поиск после нахождения маршрутов", специально сделав акцент на том, что обработка вызова прекращается не после нахождения первого совпадающего маршрута, а после нахождения всех совпадающих маршрутов. За основу можно взять ​эту статью - я ее скорректировал и добавил пример с несколькими совпадающими маршрутами.

Эта ссылка у меня не открывается, а ругается и посылает меня очень далеко::
"Ошибка Trac
Can't view wiki:"unctionsSipRouting". Resource doesn't exist or you don't have the required permission.
TracGuide — The Trac User and Administration Guide".

[alx]

Replying to Vladimir:

...видимо, по ошибке слово "маршрут" употреблено в единственном, а не множественном числе > Не по ошибке, т.к. я и не знал, а просто скопировал из вики,

но в редактируемом РЭ-69 уже записал множественное число ...

Вижу здесь явное нарушение логики... :). Если ты считаешь, что ошибки нет, то зачем же тогда заменил правильное единственное число на множественное? :)

За основу можно взять ​эту статью

Эта ссылка у меня не открывается,

Прошу прощения. Исправил опечатку.

[Vladimir]

Replying to alx:

Replying to Vladimir:

...видимо, по ошибке слово "маршрут" употреблено в единственном, а не множественном числе > Не по ошибке, т.к. я и не знал, а просто скопировал из вики,

но в редактируемом РЭ-69 уже записал множественное число ...

Вижу здесь явное нарушение логики... :). Если ты считаешь, что ошибки нет, то зачем же тогда заменил правильное единственное число на множественное? :)

Считать можешь ты, как Автор харда и софта, а я в основном писатель-редактор с чужих слов,
т.к. ранее с этой темой не был знаком :-) Как скажешь, так я и напишу, я тебе доверяю - плохо не скажешь :-)

За основу можно взять ​эту статью

Эта ссылка у меня не открывается,

Прошу прощения. Исправил опечатку.

Так и снова эта ссылка не открывается, а вот Ссылка из тикета-444 от san на твою вики открылась:
​https://trac.adc-line.ru/sip_ua/wiki/FunctionsSipRouting#%D0%94%D0%B2%D0%B0%D1%80%D0%B5%D0%B6%D0%B8%D0%BC%D0%B0%D0%BF%D0%BE%D0%B8%D1%81%D0%BA%D0%B0%D1%86%D0%B5%D0%BB%D0%B8

Твоя рекомендация "Постарайтесь при этом не допустить создания "закольцованных" маршрутов (когда SIP сообщение снова и снова совпадает с одним и тем же маршрутом)" мне, да и любому юзеру вряд ли понравится:
это же надо помнить всю жизнь и не забывать об этой особенности:
через месяц...год...20 лет (срок службы аппаратуры) все об этом забудут:
разве абсолютно нельзя сделать так, чтобы при попытке случайно закольцевать появлялось бы сообщение,
что так делать нельзя? Интерфейс должен быть дружественным, подсказывать об ошибках и их решении.

[alx]

Replying to Vladimir:

Эта ссылка у меня не открывается,

Прошу прощения. Исправил опечатку.

Так и снова эта ссылка не открывается,

У меня открывается. Думаю, у тебя опять какие-то проблемы с настройками компьютера...

Твоя рекомендация "Постарайтесь при этом не допустить создания "закольцованных" маршрутов (когда SIP сообщение снова и снова совпадает с одним и тем же маршрутом)" мне, да и любому юзеру вряд ли понравится

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

это же надо помнить всю жизнь и не забывать об этой особенности

Во-первых, я ничего помнить не предлагал.

Во-вторых, в том чтобы что-то помнить всю жизнь, нет ничего страшного и/или сверхъестественного. Большинство людей, например, еще в раннем детстве выучивают буквы и цифры и как-то умудряются всю жизнь их потом помнить, и я ни разу не слышал чтобы кто-то на такую необходимость жаловался... :)

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

Если у тебя есть предложение о том, как сделать интерфейс более дружественным, создай тикет в проекте ​sw-01, и мы там обсудим детали твоего предложения.

[san]

У меня открывается. Думаю, у тебя опять какие-то проблемы с настройками компьютера...

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