Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add documentation about start of generated applications #118

Open
wants to merge 22 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 20 commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
41abcf7
Add stubbed generated project structure page
Sep 24, 2020
ffd913f
Add stubbed generated model page
Sep 24, 2020
4bc8ad2
Merge branch 'master' of https://github.com/Flexberry/flexberry.githu…
Sep 24, 2020
673b05e
Add some generated structure info
Sep 27, 2020
3eec6b0
Add some generated structure info
Sep 28, 2020
5424b1b
Add stubbed page about start of generated app
Sep 30, 2020
a558b17
Merge with current version
Sep 30, 2020
ddda6e1
Add review of main functions of generated app
Sep 30, 2020
238b52c
Add review of odata api
Oct 2, 2020
fd1ad00
Add stubbed page with docs about regeneration
Oct 5, 2020
b0eae8f
Merge branch 'master' of https://github.com/Flexberry/flexberry.githu…
Oct 5, 2020
e3f234e
Fullfill docs about regeneration
Oct 5, 2020
77f7909
Merge branch 'master' of https://github.com/Flexberry/flexberry.githu…
Oct 5, 2020
683f587
Add extra links to other pages of documentation
Anisimova2020 Jan 22, 2021
dbdaf29
Fix links for docs about app genertion.
hvostya Mar 1, 2021
40f9e3d
Added part of FE-plugin docs
hvostya Mar 5, 2021
66aecf8
Added matadata info and odataservice installing info.
hvostya Mar 9, 2021
ad00f4d
Added docs about backend generation and manual frontend generation .
hvostya Mar 10, 2021
6faf3cb
Added blueprints info.
hvostya Mar 10, 2021
18e3f5b
Small fixes to blueprints info.
Anisimova2020 Mar 10, 2021
d8b0901
Добавила информацию по ген-ции, неб. правки стиля
Nasutya Feb 1, 2024
4b66531
Небольшие правки
Nasutya Feb 2, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions _data/sidebars/flexberry-ember-3_sidebar.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
---
title: Перегенерация приложений
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Часть для вин-дизайнера неактуальна. Надо убрать текст и изображения

sidebar: flexberry-ember-3_sidebar
keywords: Flexberry Ember
toc: true
permalink: ru/efd3_generated-app-regeneration.html
lang: ru
summary: Обзор возможностей перегенерации сгенерированных приложений.
---

{% include note.html content="Изменять настройки объектов данных (представления, названия полей, новые классы, связи и прочее), форм и всего приложения настоятельно рекомендуется во [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-бакенда.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Сейчас уже, вроде как, есть?


![Выбор перегенерируемой части серверного приложения из 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).

Любые способы перегенерации могут повредить пользовательские изменения в исходном коде. Не рекомендуется производить перегенерацию, особенно перегенерацию приложения целиком, непосредственно в папку проекта: рекомендуется сгенерировать приложение в стороннюю папку и оттуда перенести нужные изменения в проект, или генерировать только метаданные, а по ним при помощи [соответствующих команд генерации]() из командной строки изменять требуемые файлы приложения.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"особенно, приложения целиком"


{% include note.html content="Не запускайте перегенерацию клиентского приложения, если не уверены, что это не затрет ваши изменения в исходном коде. В случае, если нужный пользовательский код всё-таки был затерт при перегенерации, рекомендуется откатить соответствующие изменения средствами системы контроля версий и выполнить повторную перегенерацию согласно изложенным инструкциям." %}

Чтобы выполнить полную перегенерацию клиентского приложения из [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)

{% include note.html content="Из-за особенностей отображения проекций в [моделях](efd3_model.html) если, например, во [Flexberry Designer](fd_flexberry-designer.html) было изменено представление детейла, то требуется перегенерация как детейлового класса, так и класса-агрегатора." %}

Также перегенерация отдельных моделей и форм возможна посредством [специальных команд командной строки]().
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ссылка потерялась


### Использование дополнительных команд командной строки для перегенерации нескольких моделей и форм

В настоящий момент, помимо [возможности генерации из командной строки](efd3_app-generation.html), ведётся доработка дополнительных команд командной строки для перегенерации нескольких [моделей](efd3_model.html) и [форм](efd3_form.html) одновременно.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Наверное, уже реализовано?

Loading