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

[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]

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

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