#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 , 6 years ago
follow-up: 3 comment:2 by , 6 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
На данный момент это уже лучше, чем было.
Этого достаточно, чтобы поставить статус "Готово"?
comment:3 by , 6 years ago
comment:4 by , 6 years ago
| Resolution: | → готово | 
|---|---|
| Status: | new → closed | 
Будем считать, что "Готово", 
но при удобном случае попробую сделать вариант на 4 уровня,
чтобы посмотреть и сравнить.
4 уровня мне сделать сложнее (3 уровня делал не я :-)  ),
т.к. мелкие пункты 4-го уровня надо сделать невидимыми для Ворда
при автоматическом обновлении оглавления. 
![[MC-04 logo]](/mc-04/chrome/site/logo.png)

Структура сложилась исторически:
с Версии-1 2012 года по версию-29 апрель.2018 года
структура была 3-уровневая, оглавление было на 2 листах.
Затем МВН потребовал сделать более подробное оглавление,
но АЕН высказал пожелание оставить 3-уровневое оглавление,
которое существует по сей деть и число страниц оглавления
увеличилось с 2 до 5.
Сейчас в некоторых местах РЭ есть мелкие пункты 4-уровня,
но они умышленно не отображаются в оглавлении,
а их номера предназначены только для организации ссылок внутри РЭ,
но если их вывести в Оглавление, то оно займёт ещё больше места.
Относительно пунктов с одинаковыми названиями типа "7.4.2 и 7.4.14"
то я добавлю в конце названия его конкретный тип.
В будущем попробую сделать вариант с 4-уровневым оглавлением.