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

[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 уже записал множественное число ...

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

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

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

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