Opened 5 years ago

Closed 5 years ago

Last modified 22 months ago

#474 closed улучшение (готово)

РЭ: странное структурирование информации о канальных окончаниях плат VE-01/VE-02

Reported by: alx Owned by: Vladimir
Priority: major Component: Руководство по эксплуатации
Keywords: Cc:

Description

В РЭ аппаратуры MC04-DSL-3U редакции 37 я заметил странность в структурировании информации о канальных окончаниях плат VE-01/VE-02. Странность заключается в том, что на одном и том же уровне иерархии смешаны разные части описания одного и того же канального окончания, и описания разных типов канальных окончаний, что неудобно. Например, вот фрагмент оглавления:

7.4.1 Вкладка SIP окончания / Подключение к шлюзу окончания FXS ........ 191
7.4.2 Вкладка SIP окончания / Описание работы канального окончания ..... 195
7.4.3 Вкладка SIP окончания / Прием вызова со стороны сети IP .......... 195
7.4.4 Вкладка SIP окончания / Вызов в сторону сети IP   ................ 196
7.4.5 Вкладка SIP окончания / Ограничение некоторых видов связи ........ 196
7.4.6 Вкладка SIP окончания / Отбой соединения ......................... 197
7.4.7 Вкладка SIP окончания / Удержание вызова ......................... 197
7.4.8 Вкладка SIP окончания / Управление двумя соединениями ............ 199
7.4.9 Вкладка SIP окончания / Передача вызова (Call Transfer) .......... 199
7.4.10 Вкладка SIP окончания / Объединение соединений в конференцию .... 201
7.4.11 Вкладка SIP окончания / Дополнительные виды обслуживания (ДВО) .. 201
7.4.12 Вкладка SIP окончания / Параметры конфигурации канального окончания FXS .. 206
7.4.13 Вкладка SIP окончания / Подключение к шлюзу окончания FXO ....... 209
7.4.14 Вкладка SIP окончания / Описание работы канального окончания .... 210
7.4.15 Вкладка SIP окончания / Входящий вызов .......................... 210
7.4.16 Вкладка SIP окончания / Исходящий вызов ......................... 211
7.4.17 Вкладка SIP окончания / Отбой ................................... 211
7.4.18 Вкладка SIP окончания / Автоматическая блокировка при неисправности линии .... 212
7.4.19 Вкладка SIP окончания / Параметры конфигурации канального окончания FXO ...... 212
7.4.20 Вкладка SIP окончания / Состояния канального окончания FXO ...... 214
7.4.21 Вкладка SIP окончания / Подключение канального окончания 1IND (индуктивный код) ... 216
7.4.22 Вкладка SIP окончания / 1IND / Вызов со стороны TDM ............ 217
7.4.23 Вкладка SIP окончания / 1IND / Определение номера вызывающего абонента ..... 219
7.4.24 Вкладка SIP окончания / 1IND / Вызов со стороны IP ............. 221
7.4.25 Вкладка SIP окончания / 1IND / Определение номера вызывающего абонента ......... 222
7.4.26 Вкладка SIP окончания / 1IND / Встречное занятие ............... 225
7.4.27 Вкладка SIP окончания / 1IND / Отбой ........................... 226
7.4.28 Вкладка SIP окончания / 1IND / Состояния канального окончания 1IND .... 228
7.4.29 Вкладка SIP окончания / PRI / Подключение к шлюзу окончания PRI .... 229
7.4.30 Вкладка SIP окончания / PRI / Выбор шлюзом канального окончания при входящем вызове ... 232

Здесь, например, пункты 7.4.13, 7.4.14, 7.4.15, 7.4.16, 7.4.17, 7.4.18, 7.4.19, 7.4.20 описывают канальное окончание FXO, а пункты 7.4.21, 7.4.22, 7.4.23, 7.4.24, 7.4.25, 7.4.26, 7.4.27, 7.4.28 - канальное окончание 1IND.

В оглавлении, например, пункты 7.4.2 и 7.4.14 называются совершенно одинаково, и читателю непонятно, к какому из них ему следует перейти. Пункт 7.4.6 же даже после полного прочтения его текста не позволяет понять, о каком канальном окончании в нем идет речь.

Предлагаю изменить структуру описания канальных окончаний следующим образом:

  • каждый из пунктов 7.4.1, 7.4.2, 7.4.3 и т.д. описывает свой тип канального окончания, например:
    • 7.4.1 - FXO,
    • 7.4.2 - FXS,
    • 7.4.3 - 1IND и т.д.;
  • внутри же каждого из этих пунктов создать подпункты, описывающие разные функции одного типа канального окончания, например:
    • 7.4.3.1 - вызов со стороны TDM;
    • 7.4.3.2 - вызов со стороны IP;
    • 7.4.3.3 - отбой;
    • 7.4.3.4 - встречное занятие... и т.д.

Change History (5)

comment:1 by Vladimir, 5 years ago

Структура сложилась исторически:
с Версии-1 2012 года по версию-29 апрель.2018 года
структура была 3-уровневая, оглавление было на 2 листах.

Затем МВН потребовал сделать более подробное оглавление,
но АЕН высказал пожелание оставить 3-уровневое оглавление,
которое существует по сей деть и число страниц оглавления
увеличилось с 2 до 5.

Сейчас в некоторых местах РЭ есть мелкие пункты 4-уровня,
но они умышленно не отображаются в оглавлении,
а их номера предназначены только для организации ссылок внутри РЭ,
но если их вывести в Оглавление, то оно займёт ещё больше места.

Относительно пунктов с одинаковыми названиями типа "7.4.2 и 7.4.14"
то я добавлю в конце названия его конкретный тип.

В будущем попробую сделать вариант с 4-уровневым оглавлением.

comment:2 by Vladimir, 5 years ago

Относительно одинаковости названий я заметил и без тикета,
поэтому в РЭ-38 у меня все зприси имеют разные названия:

7.4 Вкладка SIP окончания 193
7.4.1 Тип окончания – FXS / Подключение к шлюзу окончания FXS 193
7.4.2 Тип окончания – FXS / Описание работы канального окончания 197
7.4.3 Тип окончания – FXS / Прием вызова со стороны сети IP 197
7.4.4 Тип окончания – FXS / Вызов в сторону сети IP 198
7.4.5 Тип окончания – FXS / Ограничение некоторых видов связи 198
7.4.6 Тип окончания – FXS / Отбой соединения 199
7.4.7 Тип окончания – FXS / Удержание вызова 199
7.4.8 Тип окончания – FXS / Управление двумя соединениями 201
7.4.9 Тип окончания – FXS / Передача вызова (Call Transfer) 201
7.4.10 Тип окончания – FXS / Объединение соединений в конференцию 203
7.4.11 Тип окончания – FXS / Дополнительные виды обслуживания (ДВО) 203
7.4.12 Тип окончания – FXS / Параметры конфигурации канального окончания 208
7.4.13 Тип окончания – FXO / Подключение к шлюзу окончания FXO 211
7.4.14 Тип окончания – FXO / Описание работы канального окончания 212
7.4.15 Тип окончания – FXO / Входящий вызов 212
7.4.16 Тип окончания – FXO / Исходящий вызов 213
7.4.17 Тип окончания – FXO / Отбой 213
7.4.18 Тип окончания – FXO / Автоматическая блокировка при неисправности линии 214
7.4.19 Тип окончания – FXO / Параметры конфигурации 214
7.4.20 Тип окончания – FXO / Состояния канального окончания 216
7.4.21 Тип окончания – 1IND / Подключение канального окончания 1IND (индуктивный код) 2
7.4.22 Тип окончания – 1IND / Вызов со стороны TDM 219
7.4.23 Тип окончания – 1IND / Определение номера вызывающего абонента 221
7.4.24 Тип окончания – 1IND / Вызов со стороны IP 223
7.4.25 Тип окончания – 1IND / Определение номера вызывающего абонента 224
7.4.26 Тип окончания – 1IND / Встречное занятие 227
7.4.27 Тип окончания – 1IND / Отбой 228
7.4.28 Тип окончания – 1IND / Состояния канального окончания 1IND 230
7.4.29 Тип окончания – PRI / Подключение к шлюзу окончания PRI 231
7.4.30 Тип окончания – PRI / Выбор канального окончания при входящем вызове 234
7.4.31 Тип окончания – MFC R2 / Подключение к шлюзу канального окончания 236
7.4.32 Тип окончания – MFC R2 / Входящий вызов 236
7.4.33 Тип окончания – MFC R2 / Исходящий вызов 239
7.4.34 Тип окончания – MFC R2 / Отбой соединения 241
7.4.35 Тип окончания – MFC R2 / Параметры конфигурации канального окончания 241
7.4.36 Тип окончания – MFC R2 / Состояния канального окончания 242
7.4.37 Тип окончания – R2DTMF / Подключение к шлюзу канального окончания 244
7.4.38 Тип окончания – R2DTMF / Сигналы межрегистровой сигнализации 244
7.4.39 Тип окончания – R2DTMF / Входящий вызов 244
7.4.40 Тип окончания – R2DTMF / Исходящий вызов 246
7.4.41 Тип окончания – R2DTMF / Отбой соединения со стороны IP 247
7.4.42 Тип окончания – R2DTMF / Отбой соединения со стороны TDM 247
7.4.43 Тип окончания – R2DTMF / Параметры конфигурации канального окончания 248
7.4.44 Тип окончания – R2DTMF / Состояния канального окончания 248
7.4.45 Тип окончания – АДАСЭ / Подключение к шлюзу канального окончания 250
7.4.46 Тип окончания – АДАСЭ / Вызов со стороны TDM 250
7.4.47 Тип окончания – АДАСЭ / Вызов со стороны IP 250
7.4.48 Тип окончания – АДАСЭ / Приоритетный вызов 251
7.4.49 Тип окончания – АДАСЭ / Отбой 251
7.4.50 Тип окончания – АДАСЭ / Параметры конфигурации канального окончания 251
7.4.51 Тип окончания – АДАСЭ / Состояния канального окончания 253
7.4.52 Тип окончания – МБ / Подключение к шлюзу канального окончания 254
7.4.53 Тип окончания – МБ / Прием вызова со стороны сети IP 254
7.4.54 Тип окончания – МБ / Вызов в сторону сети IP 254
7.4.55 Тип окончания – МБ / Отбой соединения 254
7.4.56 Тип окончания – МБ / Параметры конфигурации канального окончания 254
7.4.57 Тип окончания – МБ / Состояния канального окончания 256
7.4.58 Тип окончания – ППС-Р3 257

На данный момент это уже лучше, чем было.
Этого достаточно, чтобы поставить статус "Готово"?

Version 0, edited 5 years ago by Vladimir (next)

in reply to:  2 comment:3 by alx, 5 years ago

Replying to Vladimir:

Этого достаточно, чтобы поставить статус "Готово"?

Пожалуй, да.

comment:4 by Vladimir, 5 years ago

Resolution: → готово
Status: new → closed

Будем считать, что "Готово",
но при удобном случае попробую сделать вариант на 4 уровня,
чтобы посмотреть и сравнить.

4 уровня мне сделать сложнее (3 уровня делал не я :-) ),
т.к. мелкие пункты 4-го уровня надо сделать невидимыми для Ворда
при автоматическом обновлении оглавления.

comment:5 by san, 22 months ago

milestone: 1 очередь

Milestone deleted

Note: See TracTickets for help on using tickets.