Add documentation about start of generated applications

_data/sidebars/flexberry-ember-3_sidebar.yml

@@ -25,11 +25,26 @@ entries:
         output: web, pdf
 
         folderitems:
+          - title: Generation of Flexberry Ember Application
+            title_ru: Генерация приложений
+            url: /efd3_app-generation.html
+            output: web, pdf
+
           - title: Structure of Flexberry Ember Application
             title_ru: Обзор структуры сгенерированных приложений
             url: /efd3_generated-app-structure.html
             output: web, pdf
 
+          - title: Start of Flexberry Ember Application 
+            title_ru: Запуск сгенерированных приложений
+            url: /efd3_generated-app-start.html
+            output: web, pdf
+
+          - title: Regeneration of Flexberry Ember Application 
+            title_ru: Перегенерация приложений
+            url: /efd3_generated-app-regeneration.html
+            output: web, pdf
+
       - title: Forms and routing
         title_ru: Формы и роутинг
         output: web, pdf

pages/products/flexberry-ember/3.x/app-generation/efd3_generated-app-regeneration.ru.md

@@ -0,0 +1,54 @@
+---
+title: Перегенерация приложений
+sidebar: flexberry-ember-3_sidebar
+keywords: Flexberry Ember
+toc: true
+permalink: ru/efd3_generated-app-regeneration.html
+lang: ru
+summary: Обзор возможностей перегенерации сгенерированных приложений
+---
+
+> Изменять настройки объектов данных (представления, названия полей, новые классы, связи и прочее), форм и всего приложения настоятельно рекомендуется во [Flexberry Designer](fd_flexberry-designer.html), эти изменения при перегенерации могут идти как в клиентское, так и серверное приложение. Однако изменения средствами [Flexberry Designer](fd_flexberry-designer.html) способны затереть пользовательский код.
+
+## Правила перегенерации серверного приложения
+
+Серверное приложение состоит из объектов данных и непосредственно OData-бакенда.
+Весь пользовательский код в объектах данных следует располагать в [скобки программиста](fo_programmer-brackets.html), чтобы он не был затёрт при перегенерации. Для OData-бакенда такого механизма не предусмотрено.
+
+Для перегенерации серверного приложения из меню стадии следует выбрать `Ember -> Backend -> ASP.Net -> Генерировать`.
+
+![Перегенерация серверного приложения из Flexberry Designer](/images/pages/products/flexberry-ember/ember-flexberry/generation/FE-regenerate-backend.png)
+
+В настоящее время не существует способа перегенерации отдельных классов на бэкенде, поэтому она запускается целиком для всех классов. Однако можно запустить перегенерацию не всего серверного приложения, а исключительно объектов данных или непосредственно OData-бакенда.
+
+![Выбор перегенерируемой части серверного приложения из Flexberry Designer](/images/pages/products/flexberry-ember/ember-flexberry/generation/FE-regenerate-backend-choise.png)
+
+## Правила перегенерации клиентского приложения
+
+Нужно всегда четко понимать, какие файлы затрагивает перегенерация того или иного класса.
+
+При перегенерации модели перезаписываются метаданные в папке `vendor/flexberry` сгенерированного Ember-приложения, [модель](efd3_model.html) и [сериализатор](efd3_serializer.html) в папке `mixins/regererated`, а также [модель](efd3_model.html) в папке `app/models`.
+
+При перегенерации формы изменяются метаданные в папке `vendor/flexberry` сгенерированного Ember-приложения, а также соответствующие [контроллер, роут, шаблон и файлы локализации](efd3_form.html).
+
+Любые способы перегенерации могут повредить пользовательские изменения в исходном коде. Не рекомендуется производить перегенерацию, особенно, перегенерацию приложения целиком, непосредственно в папку проекта: рекомендуется сгенерировать приложение в стороннюю папку и оттуда перенести нужные изменения в проект, или генерировать только метаданные, а по ним при помощи соответствующих команд генерации из командной строки изменять требуемые файлы приложения.
+
+> Не запускать перегенерацию клиентского приложения без уверенности, что это не затрет сделанные ранее изменения в исходном коде. В случае, если нужный пользовательский код всё-таки был затерт при перегенерации, рекомендуется откатить соответствующие изменения средствами системы контроля версий и выполнить повторную перегенерацию согласно изложенным инструкциям.
+
+Для выполнения полной перегенерации клиентского приложения из [Flexberry Designer](fd_flexberry-designer.html), можно воспользоваться контекстным меню стадии `Ember -> Frontend -> EmberJS -> Генерировать всё` (либо выполнить команду `Генерировать метаданные`, после чего [перегенерировать приложение из командной строки](efd3_app_generation.html)).
+
+![Перегенерация клиентского приложения из Flexberry Designer](/images/pages/products/flexberry-ember/ember-flexberry/generation/FE-regenerate-frontend-full.png)
+
+### Перегенерация отдельных моделей и форм
+
+Средствами [Flexberry Designer](fd_flexberry-designer.html) доступна перегенерация отдельных моделей и форм, для этого у соответствующего элемента на диаграмме трубуется выбрать в контекстном меню пункт `Генерировать frontend`.
+
+![Перегенерация отдельного класса клиентского приложения из Flexberry Designer](/images/pages/products/flexberry-ember/ember-flexberry/generation/FE-regenerate-frontend.png)
+
+> Из-за особенностей отображения проекций в [моделях](efd3_model.html) если, например, во [Flexberry Designer](fd_flexberry-designer.html) было изменено представление детейла, то требуется перегенерация как детейлового класса, так и класса-агрегатора.
+
+Также перегенерация отдельных моделей и форм возможна посредством специальных команд командной строки.
+
+### Использование дополнительных команд командной строки для перегенерации нескольких моделей и форм
+
+В настоящий момент, помимо [возможности генерации из командной строки](efd3_app-generation.html), ведётся доработка дополнительных команд командной строки для перегенерации нескольких [моделей](efd3_model.html) и [форм](efd3_form.html) одновременно.