Переименование элементов и объектов модели

Переименовать какой-либо элемент или объект модели можно двумя способами.

Первый способ: вы просто изменяете имя элемента или объекта в панели Свойства.

Второй способ: AnyLogic поддерживает механизм переименования, производящий также соответствующее переименование всех ссылок на этот элемент (объект) в данной модели. Такое переименование не влияет на поведение модели, оставляя ее семантику прежней.

Например, пусть вам нужно переименовать переменную, задействованную в системно-динамической диаграмме потоков и накопителей (т.е. эта переменная используется в формулах других системно-динамических переменных). Тогда, если вы переименуете эту переменную первым способом, соответствующие формулы станут некорректны, а если воспользуетесь вторым способом, механизмом переименования с заменой всех ссылок на элемент, то имя этой переменной будет изменено и во всех соответствующих формулах, поэтому семантика диаграммы потоков и накопителей останется прежней.

Рассмотрим на примере переименование параметра Q_ вторым способом, имеющим в свою очередь два варианта. Рассмотрим первый вариант.

• 1. Откройте диаграмму агента Main.
• 2. Выделите параметр Q_.
• 3. На панели Свойства в иоле Имя введите новое имя производСервера и, не убирая фокус из этого ноля, нажмите комбинацию клавиш Ctrl+Enter.
• 4. Появится диалоговое окно Предварительный просмотр переименований (рис. 1.61).
• 5. На рис. 1.61 вы видите, что внесены изменения в формулу расчета времени обработки запроса. Щелкните ОК.

Рис. 1.61. Окно Предварительный просмотр переименований

Теперь перейдем ко второму варианту.

• 1. Откройте диаграмму агента Main.
• 2. В панели Проекты щелчком раскройте дерево агента Main.
• 3. Щелчком раскройте дерево элементов Параметры.
• 4. Щелкните правой кнопкой мыши по параметру Q_.
• 5. В контекстном меню выберите Переименовать (рис. 1.62).
• 6. В открывшемся диалоговом окне введите в поле Новое имя новое имя параметра производСервера. Щелкните Переименовать.
• 7. Появится диалоговое окно Предварительный просмотр переименований (см. рис. 1.61). Щелкните ОК.

На рис. 1.63 вы видите переименование и в дереве модели.

• 1. Запустите эксперимент Simulation. Модель остановится из-за наличия одной ошибки (рис. 1.64).
• 2. В панели Ошибки приведено описание ошибки и ее местоположение.
• 3. Дважды щелкните по описанию ошибки. Раскроется дерево эксперимента Parameters Variation с указанием ошибки в text 9.

Рис. 1.62. Выбор в контекстном меню Переименовать

Рис. 1.63. Переименование параметра Q_ в дереве модели.

Рис. 1.64. В модели обнаружена одна ошибка.

• 4. Ошибка в эксперименте Parameters Variation, который базируется на эксперименте Simulation. В этом эксперименте мы только что переименовали параметр Q_. Следовательно, переименовать нужно и в эксперименте Parameters Variation, так как автоматическое переименование всех ссылок производится в рамках одного агента одного эксперимента.
• 5. В дереве эксперимента выделите элемент text9 и на панели Свойства в секции Текст вместо имени Q_ в функцию format введите производСервера (рис. 1.65).

Рис. 1.65. Замена имени параметра Q_ именем производСервера.

• 6. Теперь в дереве эксперимента выделите элемент text8 и на панели Свойства в секции Текст вместо имени Q_ введите производСервера.
• 7. Запустите эксперимент Simulation. Теперь ошибок не будет. Результаты эксперимента будут аналогичны полученным ранее результатам (см. рис. 1.54). Незначительные отличия связаны с уникальностью (невоспроизводимостью) прогонов модели. Вместо параметра с именем вы увидите параметр с именем производСервера.
• 8. Запустите эксперимент Parameters Variation. Он также запустится без ошибок. Результаты эксперимента представлены на рис. 1.66. Они аналогичны полученным ранее и представленным на рис. 1.60. Причина их незначительных отличий также заключается в уникальности прогонов. И также вместо параметра с именем Q_ вы увидите параметр с именем производСервера.

В заключение нужно отметить следующее. Если вы попытаетесь переименовать элемент, предварительно не скомпилировав модель с помощью команды Построить модель oYp, то возможно появление в диалоговом окне сообщения «This refactoring cannot be performed correctly due to syntax errors in compilation unit», т. е. переименование не было выполнено вследствие того, что в данном элементе (чаще всего в классе активного объекта) есть ошибки компиляции. Это означает, что вы пытались произвести переименование с заменой ссылок на меняемое имя в тот момент, когда в классе имелись критические ошибки. Эти ошибки сделали класс некомпилируемым, и поэтому AnyLogic не смог произвести переименование и перекомпилировать код класса заново.

Поэтому рекомендуется вначале скомпилировать модель, исправить все критические ошибки, а уже затем произвести переименование с заменой всех ссылок на меняемое имя.