Макросы - История изменений

Lan: /* Макросы для использования в запросах: */

2015-11-19T10:23:32Z

‎Макросы для использования в запросах:

Lan: /* Максросы для использования в кастомизациях */

2014-11-24T10:55:46Z

‎Максросы для использования в кастомизациях

Lan: /* Макросы для использования в ftl-скриптах: */

2014-11-24T10:33:41Z

‎Макросы для использования в ftl-скриптах:

Soft: /* Макросы для использования в запросах: */ Комментарий-предостережение от использований макросов форматирования

2014-10-28T09:27:16Z

‎Макросы для использования в запросах:: Комментарий-предостережение от использований макросов форматирования

Lan в 10:34, 9 октября 2014

2014-10-09T10:34:10Z

Lan в 04:39, 17 сентября 2014

2014-09-17T04:39:14Z

Asko в 07:09, 2 сентября 2014

2014-09-02T07:09:51Z

Asko: Asko переименовал страницу Макросы (BeanExplorer4) в Макросы

2014-09-02T06:54:40Z

Asko переименовал страницу Макросы (BeanExplorer4) в Макросы

Asko в 09:11, 22 августа 2014

2014-08-22T09:11:21Z

Asko в 08:53, 22 августа 2014

2014-08-22T08:53:05Z

Внесённые изменения

@@ Строка 28: / Строка 28: @@
   SELECT 'complete'
 * '''<@_enumList 'columnName'/>''': создаёт SQL-предложение, выдающее одну колонку со списком вариантов типа ENUM для колонки columnName, определённой в текущей таблице. Удобно использовать для quick filter.
 '''Совет''': если макрос допускает вложенные элементы (например, <@'''_'''bold>), завершать его можно либо </@'''_'''bold>, либо просто </@>.

@@ Строка 30: / Строка 30: @@
 '''Совет''': если макрос допускает вложенные элементы (например, <@'''_'''bold>), завершать его можно либо </@'''_'''bold>, либо просто </@>.
-=== Максросы для использования в кастомизациях ===
+=== Макросы для использования в кастомизациях ===
 * '''<@'''_'''onLoad 'functionName'/>''': .js-кастомизация, добавляющая вызов указанной JS-функции при загрузке страницы.
 * '''<@_loadScript 'fileName.js'>code</@>''': загрузить на клиенте указанный js-файл и выполнить указанный код по завершении.

@@ Строка 52: / Строка 52: @@
 :* <code><@_insertInto 'categories'>entity, name, parentID</@></code>
 :* <code><@_insertSelect>'utilitySuppliers', 'Жилищные услуги', ID FROM tmp_cat_table</@></code>
 === Устаревшие макросы ===

@@ Строка 8: / Строка 8: @@
 * '''<@'''_'''copyAllRecordsQuery/>''': скопировать текст запроса All records из текущего entity.
 * '''<@'''_'''str>text</@'''_'''str>''': превратить текст в SQL-строку (альтернатива суффиксу ?str), удобно использовать для запросов второго уровня.
-* '''<@'''_'''bold>SQL</@'''_'''bold>''': добавить SQL-код для выделения текста полужирным. Пример:
+* '''<@'''_'''bold>SQL</@'''_'''bold>''': добавить SQL-код для выделения текста полужирным( '''НО правильнее это делать через CSS!''' ). Пример:
 :* <code>SELECT <@</code><code>'''_'''bold>name</@</code><code>'''_'''bold> FROM myTable </code>-> (в MySQL) SELECT CONCAT( '<nowiki><b>',name,'</b></nowiki>' ) FROM myTable
-* '''<@'''_'''italic>SQL</@'''_'''italic>''': добавить SQL-код для выделения текста курсивом.Пример:
+* '''<@'''_'''italic>SQL</@'''_'''italic>''': добавить SQL-код для выделения текста курсивом( '''НО правильнее это делать через CSS!''' ).Пример:
 :* <code>SELECT <@</code><code>'''_'''bold><@</code><code>'''_'''italic>name</@></@> FROM myTable </code>-> (в MySQL) SELECT CONCAT( '<nowiki><b>',CONCAT( '<i>',name,'</i>' ),'</b></nowiki>' ) FROM myTable
-* '''<@_align 'side'>SQL</@_align>''': добавить SQL-код для выравнивания текста. Параметр 'side' принимает значения 'left', 'center', 'right', 'justify'
+* '''<@_align 'side'>SQL</@_align>''': добавить SQL-код для выравнивания текста( '''НО правильнее это делать через CSS!''' ). Параметр 'side' принимает значения 'left', 'center', 'right', 'justify'
 * '''<@_localize>SQL</@_localize>''': добавить SQL-код для локализации текста. Полезно при сочетании с другими макросами, например:
 :* <code>SELECT <@_bold><@_localize>name</@></@> FROM myTable</code> (в этом случае внутри _localize должен быть самым внутренним макросом)

← Предыдущая		Версия 10:34, 9 октября 2014
Строка 74:		Строка 74:
	:* <code><@_removeQueryRoles entities='_system_' names=['MySQL Variables','MySQL Tables','MySQL Processes'] /></code>		:* <code><@_removeQueryRoles entities='_system_' names=['MySQL Variables','MySQL Tables','MySQL Processes'] /></code>
	:* <code><@_removeQueryRoles entities=['votes','problems','sharedDocuments'] </code><code>roles='Manager,Property Manager' /></code>		:* <code><@_removeQueryRoles entities=['votes','problems','sharedDocuments'] </code><code>roles='Manager,Property Manager' /></code>
		+
		+	[[Категория:Freemarker]]

@@ Строка 9: / Строка 9: @@
 * '''<@'''_'''str>text</@'''_'''str>''': превратить текст в SQL-строку (альтернатива суффиксу ?str), удобно использовать для запросов второго уровня.
 * '''<@'''_'''bold>SQL</@'''_'''bold>''': добавить SQL-код для выделения текста полужирным. Пример:
-** <code>SELECT <@</code><code>'''_'''bold>name</@</code><code>'''_'''bold> FROM myTable </code>-> (в MySQL) SELECT CONCAT( '<nowiki><b>',name,'</b></nowiki>' ) FROM myTable
+:* <code>SELECT <@</code><code>'''_'''bold>name</@</code><code>'''_'''bold> FROM myTable </code>-> (в MySQL) SELECT CONCAT( '<nowiki><b>',name,'</b></nowiki>' ) FROM myTable
 * '''<@'''_'''italic>SQL</@'''_'''italic>''': добавить SQL-код для выделения текста курсивом.Пример:
-** <code>SELECT <@</code><code>'''_'''bold><@</code><code>'''_'''italic>name</@></@> FROM myTable </code>-> (в MySQL) SELECT CONCAT( '<nowiki><b>',CONCAT( '<i>',name,'</i>' ),'</b></nowiki>' ) FROM myTable
+:* <code>SELECT <@</code><code>'''_'''bold><@</code><code>'''_'''italic>name</@></@> FROM myTable </code>-> (в MySQL) SELECT CONCAT( '<nowiki><b>',CONCAT( '<i>',name,'</i>' ),'</b></nowiki>' ) FROM myTable
 * '''<@_align 'side'>SQL</@_align>''': добавить SQL-код для выравнивания текста. Параметр 'side' принимает значения 'left', 'center', 'right', 'justify'
 * '''<@_localize>SQL</@_localize>''': добавить SQL-код для локализации текста. Полезно при сочетании с другими макросами, например:
-** <code>SELECT <@_bold><@_localize>name</@></@> FROM myTable</code> (в этом случае внутри _localize должен быть самым внутренним макросом)
+:* <code>SELECT <@_bold><@_localize>name</@></@> FROM myTable</code> (в этом случае внутри _localize должен быть самым внутренним макросом)
 * '''<@_substring from [to]>SQL</@>''': аналог функции substring. Полезен, если в качестве входной строки подаётся сложное выражение: здесь входная строка задаётся вложенным элементом.
 * '''<@_isInRole 'roles'/>''': добавляет условие для проверки обладает ли текущий пользователь хотя бы одной из указанных ролей. Параметры могут включать конкретные роли и группы ролей через запятую, например '''<@_isInRole '@AllRolesExceptGuest'/>'''
 * '''<@_contains list column/>:''' создаёт IN-предложение для списка элементов list и заданной колонки (column IN ('val1', 'val2', ...)).
 * '''<@_selectRow>SQL</@>:''' добавляет начало и конец SQL-запроса для выбора только одной строки (либо SELECT TOP 1 ..., либо SELECT ... LIMIT 1). Пример:
-** <code><@_selectRow> * FROM myTable</@></code>
+:* <code><@_selectRow> * FROM myTable</@></code>
 * '''<@_staticList 'element1' 'element2' ... />''': создаёт SQL-предложение, выдающее одну колонку с заданными элементами. Удобно использовать для quick filter. Пример:
-** <code><@_staticList 'waiting' 'running' 'complete'/></code> -> (в Postgres):
+:* <code><@_staticList 'waiting' 'running' 'complete'/></code> -> (в Postgres):
   SELECT 'waiting'
   UNION
@@ Строка 36: / Строка 36: @@
 === Макросы для использования в ftl-скриптах: ===
 * '''<@'''_'''systemSetting category key value/>''': добавить системную настройку. Пример:
-** <code><@</code><code>'''_'''systemSetting 'system' 'FORCED_LOCALE' 'ru' /></code>
+:* <code><@</code><code>'''_'''systemSetting 'system' 'FORCED_LOCALE' 'ru' /></code>
-** <code><@</code><code>'''_'''systemSetting category='system' key='FORCED_LOCALE' value='ru' /></code> — то же самое
+:* <code><@</code><code>'''_'''systemSetting category='system' key='FORCED_LOCALE' value='ru' /></code> — то же самое
 * '''<@_jsHandler code name>JavaScript code</@>''': добавить в базу JavaScript-handler. Code — код (машинночитаемое имя), name — человекочитаемое имя, JavaScript code — исходник хэндлера
 * '''<@_isInRole 'roles' 'column'/>''': добавляет условие для проверки,
 входит ли значение в указанной колонке в заданный список ролей roles.
 Пример:
-** <code>DELETE FROM queries_per_role WHERE </code><code><@_isInRole '@DisabledRoles,DbAdmin' 'role_name'/></code> -> DELETE FROM queries_per_role WHERE ( role_name IN ( 'DbAdmin', 'Dispatcher', 'Guest' )) (группа DisabledRoles содержала роли Dispatcher и Guest)
+:* <code>DELETE FROM queries_per_role WHERE </code><code><@_isInRole '@DisabledRoles,DbAdmin' 'role_name'/></code> -> DELETE FROM queries_per_role WHERE ( role_name IN ( 'DbAdmin', 'Dispatcher', 'Guest' )) (группа DisabledRoles содержала роли Dispatcher и Guest)
 * '''<@_operationRoles 'roles' [entities] [names]/>''': создаёт SQL для задания ролей операциям. Каждый параметр необязательный,
 если отсутствует, означает, любое. Использовать только в Pre-meta для
 некастомизированных операций! Примеры:
-** <code><@_operationRoles entities=['documents','addresses','socialEvents2documents'] names='Filter'/></code>
+:* <code><@_operationRoles entities=['documents','addresses','socialEvents2documents'] names='Filter'/></code>
-** <code><@_operationRoles entities='CSPcalls' names=['Insert','Edit'] roles='Passport,ClearingHouse,Reception'/></code>
+:* <code><@_operationRoles entities='CSPcalls' names=['Insert','Edit'] roles='Passport,ClearingHouse,Reception'/></code>
 * '''<@_removeOperationRoles 'roles' [entities] [names]/>''': создаёт SQL для удаления заданных ролей из заданных операций. Каждый параметр необязательный, если отсутствует, означает, любое. Использовать только в Pre-meta для некастомизированных операций! Примеры:
-** <code><@_removeOperationRoles names=['Explain Plan', 'Parent Record']/></code>
+:* <code><@_removeOperationRoles names=['Explain Plan', 'Parent Record']/></code>
-** <code><@_removeOperationRoles roles='Accountant' entities='utilityRates' names=['Insert', 'Edit']/></code>
+:* <code><@_removeOperationRoles roles='Accountant' entities='utilityRates' names=['Insert', 'Edit']/></code>
 * '''<@_queryRoles 'roles' [entities] [names]/>''': создаёт SQL для задания ролей представлениям. Каждый параметр необязательный,
 если отсутствует, означает, любое. Использовать только в Pre-meta для
 некастомизированных представлений! Примеры:
-** <code><@_queryRoles entities=['documents','addresses','socialEvents2documents'] names='All records'/></code>
+:* <code><@_queryRoles entities=['documents','addresses','socialEvents2documents'] names='All records'/></code>
 * '''<@_removeQueryRoles 'roles' [entities] [names]/>''': создаёт SQL для удаления заданных ролей из заданных представлений. Каждый параметр необязательный, если отсутствует, означает, любое. Использовать только в Pre-meta для некастомизированных представлений! Примеры:
-** <code><@_removeQueryRoles entities='messages'/></code>
+:* <code><@_removeQueryRoles entities='messages'/></code>
-** <code><@_removeQueryRoles entities='_system_' names=['MySQL Variables','MySQL Tables','MySQL Processes'] /></code>
+:* <code><@_removeQueryRoles entities='_system_' names=['MySQL Variables','MySQL Tables','MySQL Processes'] /></code>
-** <code><@_removeQueryRoles entities=['votes','problems','sharedDocuments'] </code><code>roles='Manager,Property Manager' /></code>
+:* <code><@_removeQueryRoles entities=['votes','problems','sharedDocuments'] </code><code>roles='Manager,Property Manager' /></code>
-* '''<@_insertInto table [idCol]>columns</@>''': добавить начало предложения INSERT INTO для таблицы с автоинкрементной колонкой idCol (по умолчанию 'ID'). Columns — список колонок через запятую. Далее должно следовать <@_insertValues> или <@_insertSelect>
-* '''<@_insertValues>values</@>''': продолжение INSERT INTO. Values — список значений через запятую (должно быть столько же, сколько колонок в _insertInto. Пример:
-** <code><@_insertInto myTable>col1, col2</@> <@_insertValues>'val1', 'val2'</@></code> — сгенерирует
-<code>INSERT INTO myTable(col1, col2) VALUES ('val1', 'val2'); (в Oracle будет сложнее)</code>
-−
-* '''<@_insertSelect>statement</@>''': продолжение INSERT INTO. Statement — SQL-предложение SELECT (без самого слова SELECT). Пример:
-** <code><@_insertInto 'categories'>entity, name, parentID</@></code>
-** <code><@_insertSelect>'utilitySuppliers', 'Жилищные услуги', ID FROM tmp_cat_table</@></code>

← Предыдущая		Версия 07:09, 2 сентября 2014
Строка 70:		Строка 70:
	** <code><@_insertInto 'categories'>entity, name, parentID</@></code>		** <code><@_insertInto 'categories'>entity, name, parentID</@></code>
	** <code><@_insertSelect>'utilitySuppliers', 'Жилищные услуги', ID FROM tmp_cat_table</@></code>		** <code><@_insertSelect>'utilitySuppliers', 'Жилищные услуги', ID FROM tmp_cat_table</@></code>
−	~~----~~
−	~~=== Категории ===~~
−	* [[:Category:BeanExplorer4]]

← Предыдущая	Версия 06:54, 2 сентября 2014
(нет различий)

← Предыдущая		Версия 09:11, 22 августа 2014
Строка 70:		Строка 70:
	** <code><@_insertInto 'categories'>entity, name, parentID</@></code>		** <code><@_insertInto 'categories'>entity, name, parentID</@></code>
	** <code><@_insertSelect>'utilitySuppliers', 'Жилищные услуги', ID FROM tmp_cat_table</@></code>		** <code><@_insertSelect>'utilitySuppliers', 'Жилищные услуги', ID FROM tmp_cat_table</@></code>
		+	----
		+	=== Категории ===
		+	* [[:Category:BeanExplorer4]]