DevelopmenOnTheEdge - Вклад участника [ru]

Сборка BE4 и BE-SQL

2016-08-16T08:25:04Z

Lan: /* Сборка версии BE4 */

== Сборка BE-SQL ==

BE-SQL — полноценный Maven-проект. Смотрите настройку доступа в Maven [https://sites.google.com/a/developmentontheedge.com/wiki/home/sistemnoe-administrirovanie/maven-repozitorij-nexus во внутренней вики]. Все этапы сборки выполняются с помощью maven, включая компиляцию javacc-грамматики. Для сборки новой версии:

* Выкачать проект dote/dote_modules
* Зайти в dote_modules/sql
* Изменить номер версии в pom.xml:

<version>0.0.24</version>

* Запустить mvn deploy.

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

Чтобы воспользоваться новой версией BE-SQL в BE4, вам придётся выпустить также новую версию BE4 с обновлёнными зависимостями (см. ниже).

== Структура BE4 ==

Проект BE4 состоит из двух частей. Исходный код по историческим причинам лежит вместе, но разделён по проектам:

* BE4 Core: ядро BE4, необходимое для работы через [[Использование ant|Ant]]. Состоит из пакетов (включая подпакеты):
** com.beanexplorer.enterprise.be4core
** com.beanexplorer.enterprise.metadata
* BE Eclipse IDE: плагины для Eclipse, реализующие пользовательский интерфейс. Включает в себя все остальные пакеты и зависит от BE4 Core.

BE4 Core содержит меньше зависимостей и является полноценным Maven-проектом (все зависимости есть в Maven). Pom-файл расположен в be4/pom/pom.xml.

BE Eclipse IDE собирается через Eclipse с помощью Ivy. При этом некоторые зависимости присутствуют явно в виде jar (каталоги be4/lib и be4/plugins — кое-что из BioUML), но большая часть зависимостей выкачивается автоматом через Ivy. Конфигурация ivy в be4/src/ivy.xml. Проект в Eclipse настроен так, что зависимости скачиваются в каталог be4/dep и потом оттуда используются. По факту с точки зрения сборки BE Eclipse IDE включает в себя BE4 Core.

== Добавление/обновление зависимости в BE4 ==

Рассмотрим как обновить версию зависимости BE4 на примере BE-SQL. Предположим, требуется обновить версию BE-SQL с 0.0.24 на 0.0.25.

1. Обновите версию в be4/pom/pom.xml (необходимо для сборки BE4 Core; этот шаг не нужен для зависимостей, которые требуются только BE Eclipse IDE):

<dependency>
<groupId>com.developmentontheedge</groupId>
<artifactId>sql</artifactId>
<version>0.0.24</version> --> 0.0.25
</dependency>

2. Обновите версию в be4/src/ivy.xml (необходимо для компиляции BE Eclipse IDE)

<dependency org="com.developmentontheedge" name="sql" rev="0.0.24" />
-->
<dependency org="com.developmentontheedge" name="sql" rev="0.0.25" />

3. Обновите версию в be4/META-INF/MANIFEST.MF в разделе Bundle-ClassPath (необходимо для работы BE Eclipse IDE):

dep/sql-0.0.24.jar, --> dep/sql-0.0.25.jar,

Следует делать все изменения одновременно. Даже если вы не используете Eclipse-версию, пользователи Eclipse могут пострадать, если ограничиться первым пунктом.

После любых изменений зависимостей, как и после изменений исходного кода, необходимо выпустить новую версию BE4, чтобы другие пользователи могли увидеть ваши изменения (см. ниже). Исключение составляют только пользователи BE Eclipse IDE, которые не обновляются с Update-site, а используют режим с двумя Eclipse-инсталляциями. Желательно со временем перевести этих пользователей на Eclipse Update site.

== Сборка версии BE4 ==

Предположим, последняя выпущенная версия 0.1.46 и мы хотим выпустить версию 0.1.47.

1. Сборка Maven-артефакта. Аналогично BE-SQL: идём в файл be4/pom/pom.xml, меняем версию <code><nowiki><version>0.1.46</version></nowiki></code> на <code><nowiki><version>0.1.47</version></nowiki></code> и запускаем команду mvn deploy. После этого BE4 попадает в Nexus.

2. Обновление версии по умолчанию. Ant-скрипты по умолчанию пользуются версией BE4, которая указана в файле be4/src/be4version.properties, который выглядит так:

BE4_VER=0.1.46

Чтобы все пользователи перешли на новую версию, замените здесь на 0.1.47 и закоммитьте. Если вдруг в новой версии обнаружатся критические проблемы, достаточно будет просто вернуть здесь версию на стабильную. Также при запуске любого ant-таргета можно указать версию явно. Например, так: <code>ant -DBE4_VER=0.1.46</code>. Таким образом можно сравнивать поведение в разных версиях.

Обратите внимание, что хотя Java-код BE4 используется из стабильных сборок, опубликованных через Maven (код из Git не используется), ftl-макросы используются из be4/macro. Поэтому там ошибки повлияют на работу коллег.

3. Обновление Eclipse Update Site. Для этого делаются следующие шаги:

3.1. Обновляем версию в be4/META-INF/MANIFEST.INF в строчке Bundle-Version:

Bundle-Version: 0.1.46

3.2. Импортируем в Eclipse проекты be4/.project, be4/com.beanexplorer.be4.feature/.project, be4/com.beanexplorer.be4.site/.project

3.3. Открываем /com.beanexplorer.be4.feature/feature.xml в Feature Manifest Editor.

3.4. Во вкладке Overflow меняем версию 0.1.46.qualifier на 0.1.47.qualifier.

3.5. Во вкладке Plugins нажимаем правой кнопкой на com.beanexplorer.enterprise.eclipse, Synchronize Versions, Copy versions from plug-in and fragment manifests, Finish

3.6. Сохраняем feature.xml (обязательно сейчас, не позже!)

3.7. Открываем /com.beanexplorer.be4.site/site.xml в Site Manifest Editor

3.8. Во вкладке Site Map разворачиваем beanexplorer4 и удаляем features/com.beanexplorer.be4.feature_0.1.46.qualifier.jar. Затем нажимаем Add feature, пишем com.beanexplorer и выбираем в списке com.beanexplorer.be4.feature.

3.9. Сохраняем и нажимаем Build All.

3.10. После этого каталог be4/com.beanexplorer.be4.site является полноценным update site'ом Eclipse. Скопируйте его в \\logrus.dote.ru\pub2\be4\com.beanexplorer.be4.site (лучше старую версию переименовать, чтобы если что можно было откатиться.

Сборка BE4 и BE-SQL

2016-08-16T08:17:29Z

Lan:

Сборка BE4 и BE-SQL

2016-08-16T07:50:50Z

Lan:

Сборка BE4 и BE-SQL

2016-08-16T07:23:56Z

Lan: Новая страница: «== Сборка BE-SQL == BE-SQL — полноценный Maven-проект. Смотрите настройку доступа в Maven [https://sites.google…»

Заглавная страница

2016-08-16T07:20:01Z

Lan:

=== BeanExplorer4 ===
* [[BeanExplorer4]]
** [[Для разработчиков BE4]]
* [[Установка BeanExplorer4]] (для пользователей)
* [[Компиляция и запуск BeanExplorer4]] (для разработчиков)
* [[Сборка BE4 и BE-SQL]] (для разработчиков)
* [[Использование ant]]
* [[Поддержка СУБД]]
* [[Типы колонок]]
* [[Структура проекта]]
* [[Usecases|Usecases с картиночками]]
* [[JavaScript Debugger]]
* [[Extras]]
* [[Entity template|Шаблоны для сущностей]]

=== Freemarker ===
* [[Freemarker]]
* [[Встроенные функции]]
* [[Макросы]]
* [[Объекты]]
* [[Пользовательские макросы]]
* [[Создание своих макросов]]
* [[Built-ins]]

=== BeanExplorer5 ===
* [[:Category:BeanExplorer5|Категория BeanExplorer5]]
* [[BeanExplorer5|BeanExplorer5]]
* [[BeanExplorer5 API|BeanExplorer5 API]]
* [[BE-SQL|SQL-диалект BeanExplorer5]]
----

=== Внешние ссылки ===
* BeanExplorer4 на Edge Wiki [https://sites.google.com/a/developmentontheedge.com/wiki/home/proektnaadokumentacia/beanexplorer4]
----
Количество статей в вики: '''[[:Special:Statistics|{{NUMBEROFARTICLES}}]]'''.

Установка BeanExplorer4

2016-06-21T11:05:07Z

Lan:

Для установки BeanExplorer4 надо иметь установленный Eclipse Luna и воспользоваться Eclipse Update Site по следующему адресу:

\\logrus.dote.ru\pub2\be4\com.beanexplorer.be4.site

Help -> Install New Software -> Add..., указать любое имя и этот путь:

[[Файл:BE4InstallationUpdateSite.png]]

Если ничего не видно, снять галочку Group items by category. Должно быть такое окошко:

[[Файл:BE4InstallationInstall.png]]

Выделить BeanExplorer4Feature, нажать Next, со всем согласиться, установить и перезапустить Eclipse.

После установки можно почитать [[BeanExplorer4|вводную статью про BeanExplorer4]].

BeanExplorer4

2016-06-21T11:04:36Z

Lan:

== Как начать работу с BeanExplorer 4 ==
Для установки: смотрите «[[Установка BeanExplorer4]]».

Есть три способа начать работать с проектом BeanExplorer 4.
# Взять готовый проект. В таком случае просто откройте перспективу BeanExplorer, сделайте импорт проекта обычным способом, а затем кликните на проект или project.yaml правой кнопкой мыши (во view Project Explorer) и выберите "BeanExplorer -> Open BeanExplorer Project". Проект появится во view с названием Model.
# Преобразовать старый BeanExplorer-проект. Для этого выберите File->New->Project..., BeanExplorer->New BeanExplorer Project Using Database Connection (более короткий способ это сделать - это выбрать пункт меню BeanExplorer->Quick Load Using Database Connection, если уже есть профиль для подключения к базе данных). Если нет ни одного профиля для подключения к СУБД, его надо создать, нажав "Create a new connection profile" и введя всю необходимую информацию для подключения, а также выбрав JDBC драйвер. Пароль обязательно сохранить. Можно это [[BeanExplorer4#Как создать новый профиль подключения к БД|сделать до начала создания проекта, обычными средставми Eclipse DTP]]. После нажатия на кнопку "Finish" загруженный проект должен отобразиться во view "Model". Преобразование может быть неточным и придётся его доделывать вручную. Кроме того, не сохранятся никакие M4 макросы.
# Создать новый проект.
#* File -> New -> Project...
#* BeanExplorer -> BeanExplorer Project, Next
#* Ввести имя проекта, изначальный список ролей, допустимых в проекте, и набор поддерживаемых языков (роли и языки всегда можно будет добавить ещё).
#* Выбрать набор используемых модулей и фитч. Модули аналогичны самим BeanExplorer4 проектам. Модуль 'beanexplorer' всегда добавляется в проект безусловно, поэтому его нельзя выбрать самому.
#* Заполнить параметры подключения к базе данных. У нас в проектах всегда используются connection profiles и Eclipse DTP, поэтому для начала работы с BeanExplorer4 сначала необходимо создать базу данных и connection profile для её использования. Тестовый пользователь - одновременно и администратор базы данных и пользователь-администратор из создаваемого BeanExplorer4 приложения.
# Создать новый проект возможно и из консоли. Для этого запускается Ant target с именем 'wizard' (зайти в консоли в папку 'be4/src' и напечатать 'ant wizard', если у вас установлен Ant).

== Описание по каждому редактору и view ==
* Model (view). Дерево проекта.
* Properties (view). Свойства выделенного в дереве проекта элемента.
* Documentation (view). Документация к выделенному в дереве проекта элементу.
* Tasks (view). Отображает все маркеры @todo и @check, найденные в документации ко всем элементам проекта и при необходимости скачивает задачи с ERP или Bugzilla. Для того, чтобы связать открытый проект с ERP, необходимо в его свойствах (Properties view!) заполнить поле 'ERP project identifier'. Аналогично для связи с Bugzilla имеется поле 'Bugzilla product name'. Помимо этих полей потребуеются логин и пароль, которые возможно ввести на странице BeanExplorer в настройках (Window->Preferences) (если они не введены, при попытке подключиться к ERP или Bugzilla BeanExplorer4 предложит вам ввести их в диалоговом окошке). Для того, чтобы связать какое-нибудь задание из документации с багом в Bugzilla или ERP, в начале его текста нужно указать номер бага с префиксом 'bug' или 'erp' соответственно: например, в тексте документации будет "@todo bug12345 исправить систему подсчёта X".
* Security (view). Таблица с правами ролей для каждого запроса и каждой операции. Реагирует на то, какой редактор открыт или какой элемент в дереве проектов выбран, и в соответствии с последним выбранным элементов фильтрует таблицу. Если в дереве проектов выбран модуль, то будут отображаться только операции и запросы из этого модуля, если entity, то отображаются только те операции и запросы, что относятся к данной entity. Фильтр по ролям позволяет выбрать все операции и запросы, которые может выполнять выбранная роль.
* Diagram (editor). Редактор диаграмм. Позволяет открывать .dml файлы и редактировать несколько их видов. Диаграммы каждого вида возможно создать пустыми выбором соответствующего пункта в основном меню BeanExplorer (BeanExplorer->Create *** Diagram/Board). Поддерживаемые виды диаграмм:
** ER модели. Могут быть открыты посредством клика на модуль и выбора "Create Diagram From This Module".
** EPC (Event-Process Chain) диаграммы.
** CFF (Cross-Functional Flowchart) диаграммы.
** Planning boards - доски с задачами.
* Diagram Layout (view). Позволяет перераспределить элементы ER диаграмы. Всегда относится к диаграмме из редактора ER, которым пользовались последним.
* SQL Editor (editor). Позволяет редактировать SQL запросы - открывается при клике на запросы в дереве проекта. Почти то же самое, что и SQL редактор из Eclipse DTP. Позволяет запускать SQL запросы (правый щелчок мышью->Execute All). Отличается от оригинального тем, что, во-первых, не сохраняет изменения в файл (при попытке сохранить изменения окажутся в модели BeanExplorer 4), а, во-вторых, позволяет запускать SQL с учётом макропроцессора FreeMarker и [https://sites.google.com/a/developmentontheedge.com/wiki/home/proektnaadokumentacia/beanexplorer/beanexplorerdocrus плейсхолдеров BeanExplorer] (правый щелчок мышью->Run или "Run BeanExplorer SQL Query" на toolbar'е).
* Query Executor (view).
** Позволяет определить контекст выполнения SQL запроса - посредством выбора своих параметров запроса или сессии (при этом запрос пока выполняется только под администратором).
** Позволяет посмотреть результаты запуска SQL запроса. Автоматически активируется при SQL запросе. Позволяет посмотреть результаты запроса как в виде простой таблицы, так и в виде HTML после обработки в BeanExplorer, а также посмотреть обработанные представления запроса — после макропроцессора FreeMarker и в чистом SQL виде.
* JavaScript Editor (editor). Позволяет редактировать JavaScript скрипты - открывается при клике на JavaScript/server операции в дереве проекта. Почти то же самое, что и обычный JavaScript редактор из Eclipse JSDT. Отличается тем, что позволяет запускать Rhino JavaScript ("Run JavaScript" на toolbar'е или "Execute" в Operation Parameters view). Результат вызова операции открывается в браузере.
* Operation Parameters (view). Позволяет определить контекст выполнения JavaScript/server операции посредством задания параметров и выбранных строчек. Также позволяет выбрать метод для запуска: getParameters(), invoke() или getRedirectURL() (последний пока не поддерживается).
* Localization (view). [[Localizations|Локализация]], относящаяся к выделенному в дереве проектов элементу. Отображается при выборе entity, operation или query.

== Основная информация для понимания BeanExplorer 4 ==
# Основное представление проекта BeanExplorer 4 - это не база данных, не YAML проект, а дерево проекта в Model view. При открытии BeanExplorer 4 проекта, он оказывается в Model view. И только при сохранении он сериализуется в YAML
# Основные простейшие действия с проектом - создание/удаление сущностей (entities), операций (operation) и запросов (query) - делаются из контекстного меню (pop-up) в Model view.
# Если с каким-нибудь узлом дерева проекта может быть связан редактор, то при выделении этого узла открывается редактор. Например, для JavaScript/server операции открывается JavaScript редактор, для 1D запроса - SQL редактор, для custom step - текстовый редактор, для Java операции открывается Java редактор (если .java файл с соответствующим именем находится в рабочем пространстве Eclipse). Некоторые редакторы при сохранении никак не меняют файлы - файлы будут изменены только при сохранении проекта.
# У большинство элементов из дерева проекта есть свойства, которые возможно редактировать в Properties view.
# Для любого подключения к базе данных необходим connection profile ([http://help.eclipse.org/helios/index.jsp?topic=%2Forg.eclipse.datatools.connectivity.doc.user%2Fdoc%2Fhtml%2Fasc1229700343352.html в документации по Kepler]). При импорте готового проекта connection profile создаётся автоматически, однако вручную всё же необходимо выбрать к нему JDBC Connector (если СУБД для подключения используется впервые). Connection Profile необходим как для SQL запросов из обычного SQL редактора Eclipse DTP, так и для запросов BeanExplorer. Настройки connection profiles находятся в разделе проекта "Connection profiles", в "папочках" Local и Remote. Эти настройки сохраняются в XML при сохранении BeanExplorer 4 проекта, а при его открытии воссоздаются, и если Eclipse DTP не имеет connection profiles с соответствующими именами, то они будут созданы. Конкретнее - эти настройки хранятся в двух файлах: connectionProfiles.local.xml и connectionProfiles.remote.xml, причём предполагается, что .local вписан в .gitignore, а .remote - нет. Для возможности подключиться к базе данных всегда должен быть выбран в качестве текущего какой-нибудь connection profile. Выбирается он в свойствах проекта (Properties view, "Connection profile name") - в соответствующем combo box отображаются только те профили, которые есть в Local или Remote. Добавить новый connection profile в проект BeanExplorer 4 возможно через контекстное меню (для этого его сначала необходимо создать в Data Source Explorer view (из Eclipse DTP)).

== Работа с BeanExplorer 4 для аналитиков ==
Для некоторых типов элементов из дерева проектов возможно приписывать комментарии/документацию. На данный момент это следующие типы элементов:
* проект,
* модули (в т.ч. application),
* сущности (entities - всё, что находится внутри модуля в папках Collections, Dictionaries, Tables, Generic Collections, Metadata),
* операции,
* запросы.
Документация отображается в Documentation view. Если в документации элемента есть маркер @todo или @check, то строка с этим маркером окажется и в другом view: Tasks. При клике на какую-либо строчку из Tasks будет выделен соответствующий ей элемент в Model view.

[[Файл:Analyst1.png]]

=== Возможности назначения ролей ===
* Все роли перечислены в свойствах проекта. При клике на список ролей ("Project roles" в Properties view при выбранно проекте) появляется панель, позволяющая добавлять роли.
* Для операций и запросов роли назначаются во view Security.

[[Файл:Analyst2.png]]

== Usecases ==
Перенесены [[Usecases|сюда]].

== Компиляция и запуск Eclipse с плагином BeanExplorer4 ==
Здесь: [[Компиляция и запуск BeanExplorer4]] (инструкции для тех, кто запускает Eclipse BeanExplorer4 из под другого экземпляра Eclipse).

== Структура проекта BeanExplorer 4 ==
[[Структура проекта|Структура]] проекта BeanExplorer 4

== Процесс разработки ==
=== Использование Ant ===
[[Использование ant|Использование Ant]]

=== Использование шаблонов Freemarker ===
Использование шаблонов [[Freemarker|Freemarker]]

=== JavaScript Debugger ===
Текущее состояние [[JavaScript Debugger|JavaScript Debugger]]

=== Поддержка СУБД ===
Поддержка [[Поддержка СУБД|различных СУБД]]

== Полезная информация, которая может помочь при работе с BeanExplorer 4 ==
=== Как устанавливать плагины/фитчи из архива ===
# Заходим в... Help->Install New Software. Add...->Archive... выбрать архив, OK.
# Снять галочку "Group items by category", если не видно пунктов для установки. Это может занять продолжительное время, т.к. с основного репозитория Eclipse будут скачиваться недостающие плагины.

=== Где взять редактор YAML ===
Update site: <code>http://dadacoalition.org/yedit</code>

(Site: [https://code.google.com/p/yedit/ https://code.google.com/p/yedit/])

=== Где взять редактор FreeMarker ===
Update site: <code>http://download.jboss.org/jbosstools/updates/stable/kepler/</code>

Или:

Help->Eclipse Marketplace... ищем "JBoss Tools", жмём Install у JBoss Tools (Kepler), снимаем галочку со всего и выбираем JBoss Tools (Kepler)->FreeMarker IDE.

=== Как настроить Tomcat для возможности подгрузить изменения в class-файлах. ===
1. Add the following lines into /conf/tomcat-users.xml (inside the root element <tomcat-users>):
<role rolename="manager-script"/>
<user username="tomcat" password="tomcat" roles="manager-script"/>

2. Create /conf/Catalina/localhost/manager.xml with the following content:
<Context privileged="true" antiResourceLocking="false"
docBase="${catalina.home}/webapps/manager">
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
allow="127\.0\.0\.1" />
</Context>

Подробнее [http://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html здесь] и [http://www.mulesoft.com/tcat/tomcat-reload здесь].

3. You can change the username or the password, but you should ensure that your connection profile uses these username and password. Beside this you can change the URL that will be called to refresh Tomcat. Note that this action uses the Tomcat application name from the connection profile. Tomcat path should be set too.

=== Как создать новый профиль подключения к БД ===
* Переключиться в перспективу Database Development. (В Eclipse почти в правом верхнем углу нажать квадратную кнопку с плюсиком "Open Perspective" и выбрать там "Database Development").
* Во view Data Source Explorer кликнуть правой кнопкой мыши на Database Connections, New....
* Выбрать в диалоговом окне тип используемой БД (напр., PostgreSQL), ввести нормальное имя для подключения (например, "condo"), Next.
* Ввести параметры подключения, их можно узнать у администратора БД. При первом создании профиля подключения с данным типом СУБД необходимо выбрать драйвер СУБД (для этого нажать круглишок с плюсиком у combo "Driver", а в появившемся диалоге на второй вкладке обычно необходимо удалить выбранный драйвер и выбрать свой - мы для удобство поместили все драйвера в папку lib из be4).
* Next, Finish.
* Новый профиль появится в списке Database Connections во view Data Source Explorer.

= Для разработчиков =
[[Для разработчиков BE4|Сюда]]

Файл:BE4InstallationInstall.png

2016-06-21T11:03:53Z

Lan:

Файл:BE4InstallationUpdateSite.png

2016-06-21T11:03:35Z

Lan:

2016-03-15T07:24:57Z

=== Основные функции ===
Для удобства работы предопределены некоторые функции:
* '''addDays''': создаёт SQL-предложение для получения даты, отличающейся от заданной на указанное количество дней. Требуется два параметра: дата и количество дней
* '''addMillis''': создаёт SQL-предложение для получения даты, отличающейся от заданной на указанное количество миллисекунд. Требуется два параметра: дата и количество миллисекунд.
* '''addMonths''': создаёт SQL-предложение для получения даты, отличающейся от заданной на указанное количество месяцев. Требуется два параметра: дата и количество месяцев.
* '''chr''': создаёт SQL-предложение для нахождения символа по коду (обычно пригождаться не должно, сейчас используется для идентичных метаданных со старым BE).
* '''coalesce''': создаёт SQL-предложение COALESCE.
* '''concat''': создаёт SQL-предложения для конкатенации переданных строк. Пример:
** <code>SELECT ${concat('name', ' = '?str, 'value')} FROM myDictionary</code> -> (в MySQL) <code>SELECT CONCAT( name, ' = ', value ) FROM myDictionary</code>
* '''genericRef''': создаётся generic-ссылка. Требуется два аргумента: entity и колонка-идентификатор.
* '''if''': создаёт SQL-предложение IF. Требуется три аргумента: условие, значение, если условие истинно, и значение, если условие ложно. Если третий опущен, предполагается пустая строка.
* '''indexOf''': создаёт SQL-предложение для поиска подстроки в строке. Требуется два аргумента: строка и подстрока.
* '''joinGenericRef''': создаёт JOIN-предложение для подключения таблицы через generic reference. Требудется три аргумента: целевая таблица, алиас для неё и колонка-идентификатор.
* '''length''': создаёт SQL-предложение для подсчёта количества символов в строке. Не путайте со стандартным Freemarker-суффиксом ?length, который вычислит длину поданной строки во время выполнения скрипта.
* '''limit''': создаёт SQL-предложение для ограничения числа строк в запросе (если это позволяет СУБД)
* '''lpad''': создаёт SQL-предложение LPAD. Требудется три аргумента: исходная строка, требуемая длина и строка-заполнитель, которая будет использована для удлиннения исходной строки слева в случае необходимости.
* '''replace''': создаёт SQL-предложение REPLACE. Требуется три аргумента: исходная строка, искомая подстрока, строка замены.
* '''substring''': создаёт SQL-предложение SUBSTRING. Требуется три аргумента: исходная строка, номер начального символа, количество символов.

=== Функции для DDL-манипуляций ===
Обычно таблицы задаются в BE4 в декларативном стиле в файлах [[entity|сущностей]], и новые таблицы добавляются автоматически при синхронизации. DDL-манипуляции из FTL-скриптов могут потребоваться для обновления таблиц, определённых в старых m4-модулях. В целом манипулировать схемой таблиц из FTL не рекомендуется.

* '''columnDef(columnName, columnDefinition)''': создаёт фрагмент SQL-предложения CREATE TABLE или ALTER TABLE для определения колонки. Первый параметр — имя колонки, второй — хэш с её свойствами. Свойства в точности такие же, как в structure.yaml. Пример:
** <code>ALTER TABLE test ADD COLUMN ${columnDef('myCol', {'type': 'BOOL', 'canBeNull': true})}</code> -> (в Postgres) <code>ALTER TABLE test ADD COLUMN mycol VARCHAR(3) CHECK(mycol IN ('no', 'yes') )</code>
* '''tableDef(tableName, columns[, indices])''': создаёт SQL-предложение для создания новой таблицы (если таблица уже существовала, старая удаляется). Первый параметр — имя таблицы, второй — хэш, где ключи — имена колонок, а значения — хэш со свойствами колонок (как в columnDef). Необязательный третий параметр: список индексов (ключи — имена индексов, значения — хэш, описывающий индекс так же, как в structure.yaml). Пример:
**
${tableDef('uiSocialBlocks', {
'CODE': {'type': 'VARCHAR(2)', 'primaryKey': true},
'name': {'type': 'VARCHAR(250)'},
'parentCode': {'type': 'VARCHAR(2)', 'canBeNull': true}
})}
*** Результат в '''Postgres''':
DROP TABLE IF EXISTS uisocialblocks;
CREATE TABLE uisocialblocks (
code VARCHAR(2) NOT NULL PRIMARY KEY,
name VARCHAR(250) NOT NULL,
parentcode VARCHAR(2));
*** Результат в '''Oracle''':
call drop_if_exists( 'uiSocialBlocks' );
CREATE TABLE UISOCIALBLOCKS (
CODE VARCHAR2(2 CHAR) NOT NULL PRIMARY KEY,
NAME VARCHAR2(250 CHAR) NOT NULL,
PARENTCODE VARCHAR2(2 CHAR)); 

[[Категория:Freemarker]]