[ICP CON import, manual] Update manual on importing ICP CON projects

docs/user_manual/ReadMe.md

@@ -18,9 +18,12 @@
 + [Настройка диапазона IP-адресов проекта](#31-Настройка-диапазона-IP-адресов-проекта)
 + [Настройка тестирования проекта](#32-Настройка-тестирования-проекта)
 + [Импортирование старых проектов](#33-импортирование-старых-проектов)
-    + [Как получить описание старого проекта](#331-как-получить-описание-старого-проекта)
-    + [Как настроить правильную работу импорта проектов](#332-как-настроить-правильную-работу-импорта-проектов)
-    + [Как импортировать описание старого проекта](#333-как-импортировать-описание-старого-проекта) 
+    + [Описание старого проекта](#331-описание-старого-проекта)
+    + [Настройка правильной работы импорта устройств](#332-настройка-правильной-работы-импорта-старых-проектов)
+    + [Переименование старых устройств](#333-переименование-старых-устройств)
+    + [Импорт описания старого проекта на ФСА](#334-импорт-описания-старого-проекта-на-фса)
+    + [Документ соответствия названий устройств](#335-документ-соответствия-названий-устройств)
+
 #### Оборудование IO
 + [Настройка узлов и модулей ввода-вывода](#41-Настройка-узлов-и-модулей-ввода-вывода)
 + [Привязка устройств к модулям IO](#42-Привязка-устройств-к-модулям-IO)
@@ -264,15 +267,26 @@ ProjectTestEnabled=True
 
 ### 3.3 Импортирование старых проектов ###
 
-#### 3.3.1 Как получить описание старого проекта ####
+Для импорта старых проектов (ICP CON) в меню EPlanner есть следующие функции:
+  - `Импорт ICP CON проекта` - 
+  функция для импорта проекта<sup>[[3.3.4]](#334-импорт-описания-старого-проекта-на-фса)</sup>.
+
+  - `Создать/изменить файл переименования устройств` - 
+  функция для переименования старых устройств для последующего импортирования 
+  проекта<sup>[[3.3.3]](#333-переименование-старых-устройств)</sup>.
+
+  - `Документ соответствия названий устройств CSV` - создает csv-документ со схемой соответствия названий устройств 
+  в старом и новом проекте<sup>[[3.3.5]](#335-документ-соответствия-названий-устройств)</sup>.
+
+#### 3.3.1 Описание старого проекта ####
 
 Для импортирования проекта понадобится файл `main.wago.plua`. Чтобы получить данный файл, необходимо приложением `wprg4` открыть нужный проект с расширением `.ds4`, после чего экспортировать его: `Устройства` -> `Экспорт для WAGO 750-860` - как показано на рисунке ниже. После чего в папке с проектом появится нужный файл (`Внимание`: файл с описанием при экспорте заменяет старый файл описания другого проекта).
 
 <p align="center"><img src="images/wprg4_export.png"></p>
 
 <p align="center"><b>Рисунок</b> - <i>Экспорт проекта для WAGO</i></p>
 
-#### 3.3.2 Как настроить правильную работу импорта проектов ####
+#### 3.3.2 Настройка правильной работы импорта старых проектов ####
 
 Для корректной работы импорта описания старых проектов необходимо в файле конфигурации (`configuration.ini`) 
 указать путь к EPLAN макросам модулей ввода-вывода, если такой настройки еще не установлено:
@@ -282,21 +296,49 @@ ProjectTestEnabled=True
 
 Первый каталог с макросами используется для макросов со специальными настройками для корректного импорта,
 второй - путь к основному каталогу с макросами. Для корректного автоматического импорта и настройки модулей
-необходимо скопировать макрос клеммникка в каталог `wago_macros_import_path`с установленной "Главной функцией". 
+необходимо скопировать макрос клеммника в каталог `wago_macros_import_path`с установленной "Главной функцией". 
 Иначе клеммники будут импортироваться без переименования, и название модуля придется менять в ручную. 
-При этом в логе можно будет увидеть ошибку `"Не удалось проиндксировать модуль -Axxx на странице n"`.
+При этом в логе можно будет увидеть ошибку `"Не удалось проиндексировать модуль -Axxx на странице n"`.
 
 Сама папка с макросами должна быть структурирована в соответствие с последними изменениями в этой папке, а именно:
 они должны быть разбиты по папкам соответствующим своим группам и именоваться по следующему формату `750-x00` (**x** - номер группы). Макрос выбирается по названию `WAGO.750-xyy.ema` (**xyy** - номер модуля).
 
 Если у макроса есть какая-то модификация(вариация) типа `WAGO.750-xyy_025-000.ema`, то такой макрос выбран не будет, требуется строгое название макроса, который будет использоваться.
 
-#### 3.3.3 Как импортировать описание старого проекта ####
+#### 3.3.3 Переименование старых устройств ####
+
+Перед импортированием старого проекта можно заранее составить файл с настройкой переименования устройств.
+Для этого необходимо в меню выбрать функцию: `EPlaner` -> `Создать/изменить файл переименования устройств`.
+В открывшемся окне проводника необходимо выбрать файл проекта `main.wago.plua`. Далее появится следующее окно:
+
+<p align="center"><img src="images/DeviceRenamingMap.png"></p>
+
+<p align="center"><b>Рисунок</b> - <i>Настройка переименования старых устройств</i></p>
+
+В данном окне можно настроить переименование устройств.
+Все ячейки редактируются по двойному щелчку (кроме первых двух столбцов).
+Далее файл переименования необходимо сохранить, нажав кнопку применить или закрыв окно.
+В дальнейшем изменить настройки переименования можно непосредственно в сохраненном файле,
+либо повторив все действия описанные выше и нажав на кнопку в окне `Использовать файл переименования`,
+что подгрузит сохраненный файл и можно продолжить его редактирование.
+
+**Примечание:**
+На вкладке `Параметры по умолчанию` настраиваются стандартные значения параметров
+для определенных типов устройств, но в файл они не сохраняются, поэтому на текущем этапе
+данная вкладка не используется.
+
+#### 3.3.4 Импорт описания старого проекта на ФСА ####
 
 Для импортирования описания старого проекта необходимо в меню выбрать следующую функцию: `EPlaner` -> `Импорт ICP-CON проекта`.
 В открывшемся окне проводника необходимо выбрать файл проекта `main.wago.plua`. После этого начнется импорт старого проекта.
 
-Примечания по импорту проекта: 
+Во время импортирования вызывается окно переименования устройств как и в пункте [3.3.3](#333-переименование-старых-устройств).
+Работа с этим окном проводится также как описано в данном пункте. 
+После нажатия кнопки `Применить` или закрытия окна, применяется переименование устройств и продолжается импорт устройств. 
+Также на данном этапе настраиваются параметры по умолчанию для устройств на соответствующей вкладке: 
+параметры настраиваются в пределах типов устройств.
+
+**Примечания по импорту проекта:** 
  - В старых проектах использовались 4 типа узла:
      + 750-315 - RS-485
      + 750-815 - RS-485 (Programmable)
@@ -317,25 +359,24 @@ ProjectTestEnabled=True
 
  - В логах указываются некоторые ошибки при импортировании проекта.
 
+#### 3.3.5 Документ соответствия названий устройств ####
 
-#### 3.3.4 Модификация базы каналов на основе старой базы ####
+Для того, чтобы создать документ соответствия названий устройств между старым (ICP CON) и новым проектом, 
+необходимо в меню выбрать следующую функцию: `EPlaner` -> `Документ соответствия названий устройств CSV`.
+Данная функция предлагает сохранить файл в формате `*.csv` - текстовый формат табличных данных.
+Для открытия данного файла в Excel необходимо выбрать вкладку `Данные` -> `Из текстового/CSV-файла` (зависит от версии excel).
+Так же при импорте CSV-файла необходимо выбрать кодировку `UTF-8`.
 
-Чтобы не менять проект **Monitor**, модифицируется новая база каналов, а именно изменяются *ID* каналов новой базы на *ID* старой.
-Данный функционал доступен из меню: `EPlaner` -> `Модификация базы каналов`. 
+<p align="center"><img src="images/CsvToExcel.png"></p>
 
-<p align=center><img src="images/ModifyChbase.png"><p>
+<p align="center"><b>Рисунок</b> - <i>Открытие документа соответствия названий устройств в Excel</i></p>
 
-<p align="center"><b>Рисунок</b> - <i>Окно модификации базы каналов</i></p>
+**Примечание**:
+Для корректной работы данного функционала необходимо, чтобы в устройствах на ФСА было прописано доп. поле[10],
+где устанавливается старое название устройства в ICP CON. Данное поле заполняется автоматически на этапе [3.3.4](#334-импорт-описания-старого-проекта-на-фса), Однако если устройства создаются вручную, то необходимо вручную проставить данное поле. Либо в дальнейшем дополнить данное поле уже в Excel.
 
-На рисунке выше представлено окно для модификации базы каналов:
-  1. Для начала нужно выбрать исходную базу каналов (старого ICP-CON/wprg проекта) - из нее будут браться *ID* каналов;
-  2. Выбираем новую базу каналов, здесь есть 2 варианта: 
-       - если сохраняем новый файл, то открываются 2 доп.настройки для экспорта базы каналов, в этом случае экспортируется новая база каналов c измененными *ID*;
-       - если же выбираем уже существующий файл базы каналов, то в этом файле меняются *ID*, а сохранение происходит в новый файл с пометкой *_reindex* (прим. *T1-project_reindex.cdbx*);
-  3. После нажимаем на кнопку **Модифицировать**, при этом открывается окно логов, в котором можно увидеть некоторые ошибки:
-       - "*Канал устройства не найден*" - данная ошибка возникает, если не удается найти канал этого устройства в старой или новой базе каналов (чаще старой);
-       - "*Канал с таким ID уже существует*" - возникает, если в новой модифицированной базе каналов повторяются *ID*;
-  4. *Примечание*: названия для старых каналов прописываются при импорте ICP-CON проекта в EPLAN в **доп. поле. [10]** или конвертируются из нового имени (не всегда успешно).
+**Дополнительно**:
+Надстройка также предлагает сохранить данный файл на этапе [3.3.4](#334-импорт-описания-старого-проекта-на-фса), тут уже не требуется наличие доп. поле[10]. Но если названия в дальнейшем будут меняться, то в данной функции нет необходимости.
 
 ## 4 Оборудование IO ##