¶ Основные информации
Основной функционал раздела Формы – создание оконной формы для ввода данных пользователями веб-страницы.
¶ Структура раздела
¶ Создание формы
Чтобы создать форму, перейдите в раздел формы навигационной панели платформы Platon. На этой открытой странице отображается список ранее открытых форм на платформе Platon. Нажмите кнопку Добавить внизу этой страницы, и откроется следующее окно («форма»):
¶ Содержимое окна создания формы
Окно состоит из следующих ячеек:
- name: название формы (форма также будет находиться в URL с этим названием);
- source_table_name: имя файла в базе данных (Database), в котором хранятся данные, введенные в форму;
- data_source: Это может управлять сохранением из выбора в базу данных platon или проекта (Database);
- sequence_name: используется для записи последовательности в базу данных формы (Database);
- data_filter: используется для фильтрации данных в форме;
- unique_fields: выполняет уникальную функцию указанного слова или числа в этой функциональной базе данных, предотвращая повторный ввод другого слова или числа, точно подобного указанному слову или числу;
- focused_field_name: используется для указания информации, которая должна быть сосредоточена на странице формы;
- grid_offset: служит для того, чтобы оставить пространство с обеих сторон формы;
- next_link: используется для записи адреса страницы, которую следует открыть после заполнения формы и нажатия кнопки сохранения. Специальный URL-адрес
backиспользуется для закрытия модального или пустого окна после сохранения; - archive_fields
- add_title: используется для написания заголовка адреса веб-страницы (https) этой части формы;
- edit_title: используется для названия заголовка редактирования;
- add_header: используется для написания названия этой формы;
- edit_header: используется для редактирования заголовка этой формы;
¶ Внешний вид записей (кодов), введенных в ячейки:
- name.
// для примера
test_post
- source_table_name.
// для примера
temp_guids
- sequence_name.
// для примера
seq_nimadur
- data_filter.
// для примера
type_id=#type_id
- unique_fields.
// для примера
username
- focused_field_name.
// для примера
reject_type_id
- grid_offset.
// для примера
2
- next_link.
// для примера
back
- archive_fields.
// для примера
Realsoft
Tillarni ozgartirish quyidagi yacheykalardan iborat:
- add_title 1-uz,2-ru,3-la va 4-en.
// для примера
қўшиш
добавить
qo’shish
add
- edit_title 1-uz,2-ru,3-la va 4-en.
// для примера
тахрирлаш
изменить
tahrirlash
edit
- add_header 1-uz,2-ru,3-la va 4-en.
// для примера
фойдаланувчи кўшиш
добавить пользователя
foydalanuvchi qo’shish
add user
- edit_header 1-uz,2-ru,3-la va 4-en.
// для примера
фойдаланувчи малумотини тахрирлаш
изменить информацию о пользователи
foydalanuvchi malumotlarini qo’shish
edit user
Sql formalari
- defaults_sql.
// для примера
select int01 as region_id, int02 as district_id, int03 as sector_id, id as mahalla_id, 2022 as ayear
from lists
where id=#mahalla_id
- params_sql.
// для примера
select l.total_sum, extract(month from now()) as month, m.name1 as mahalla
from credit_limits l
left join lists m on m.type_id=4 and m.state=1 and m.id=l.mahalla_id
where l.id=#id
- before_add_sql.
// для примера
Realsoft
- after_add_sql.
// для примера
call send_user_password_sms(@mobile_phone::bigint, @username, @raw.password);
insert into auth_users_groups (id, created_at, state, version, user_id, group_id) values (nextval('seq_user_group'), now(), 1, 1, @id, (case when #org_type=200 then 13 when #org_type=301 then 94 else 15 end))
- before_edit_sql.
// для примера
Realsoft
- after_edit_sql.
// для примера
call send_user_password_sms(@mobile_phone::bigint, @username, @raw.password);
- before_delete_sql.
// для примера
update auth_users set username=concat('user', @id) where id=@id
- after_delete_sql.
// для примера
Realsoft
- before_restore_sql.
// для примера
Realsoft
- after_restore_sql.
// для примера
Realsoft
JS / CSS
- js.
// для примера
$form.formElementsWithKey.open_sum.maxValue = $form.params.total_sum
});
- css.
// для примера
.platon-form[form-name="mahalla"] .card {
border: none;
}
.platon-form[form-name="mahalla"] .card-body {
padding: 0;
}
- visibility.
// для примера
$user.has_perm('platon.admin')
- can_create_condition.
// для примера
$user.has_perm('platon.admin') || ($user.level ==1 && $user.bank_group_id == 1)
- can_edit_condition.
// для примера
$user.has_perm('platon.admin') || ($user.level ==1 && $user.bank_group_id == 1)
- can_delete_condition.
// для примера
$user.has_perm('platon.admin')
¶ Содержимое страницы формы
После создания формы появится следующее окно:
Это окно содержит следующие кнопки:
¶ Для пользователей
-
При нажатии на эту кнопку данные, введенные в форму, будут сохранены.
-
Нажатие этой кнопки даёт выйти из формы.
¶ Для программистов
-
Эта кнопка используется для внесения изменений в форму.
-
Эта кнопка используется для добавления в форму новых элементов (ячеек, предназначенных для пользовательского ввода).
-
Нажмите эту кнопку, чтобы просмотреть список всех элементов на странице формы.
¶ Добавить новый элемент
Эта кнопка используется для добавления в форму новых элементов (ячеек, предназначенных для пользовательского ввода). При нажатии на эту кнопку откроется следующее окно:
Окно состоит из следующих ячеек:
- form: название формы (форма также будет находиться в URL с этим названием);
- type: функция или тип элемента выглядит следующим образом:
- a)
fieldset- создает новую область для размещения элементов; - b)
text- создает поле для ввода текста; - c)
raw_json- используется только для приема данных типа json; - d)
number- создает вход для ввода числа (натурального числа); - e)
file- создает вход для приема файлов; - f)
image- создает вход для получения изображений; - g)
button- создает кнопку для отправки различных запросов; - h)
date- создает входные данные для принятия дат; - i)
select- создает вход, позволяющий выбрать одно из нескольких данных; - j)
time- создает вход для получения времени; - k)
multiselect- создает входные данные, позволяющие выбрать несколько данных; - l)
checkbox- создает элемент, возвращающий информацию булевого (логического) типа; - m)
textarea- создает вход для ввода больших текстов (для описания); - o)
phone- ввод, используемый для ввода информации в формате номера телефона; - p)
code- позволяет сохранять код на разных языках программирования (js, html, css, sql) - r)
html- через который можно отправить запрос к нужному API и создать дизайн нужного внешнего вида; - s)
geo- по этому типу элемента (map_center, map_zoom) можно ввести геолокацию. В этом случае поле active_map указывает, какую карту выбрать; - t)
geo polygon- этот элемент имеет возможность включать несколько геолокаций типа (map_center, map_zoom, is). В данном случае поле active_map показывает, какую карту выбрать. Кроме того, для кнопкиis_multipleустановлено значение активно, чтобы включать несколько географических позиций; - u)
simple key-value- используется для формирования уникальных значений; - v)
tab- используется для нумерации различной информации; - w)
tab container- обобщение постраничной информации в определенном виде; - x)
markdown editor,monaco_editor,vue_editor,wysiwyg- редактирование контента; - data_field: внутреннее имя столбца. Это внутреннее кодовое имя записывается в запросах SQL;
- parent: родительский элемент, содержащий другие элементы;
- sort_order: положение элемента на странице формы (мелкие числовые элементы располагаются в передней части страницы, крупные числовые элементы располагаются в следующей части страницы);
- default_value: Он используется для установки значения по умолчанию для этого элемента во время создания формы. Здесь значение можно получить по условию и т. д.;
- width: в этой ячейке записывается ширина столбца;
- sql: эта ячейка предназначена для написания SQL-запросов;
- validation_sql
- is_attribute: этот переключатель используется для вставки данных в столбец
attributesбазы данных; - Переключатель is_required : этот переключатель используется для предотвращения сохранения данных в ячейке товара без его ввода (то есть, если этот переключатель включен, пользователь должен ввести информацию в ячейку товара);
- Переключатель is_read_only: если этот переключатель включен, пользователь сможет только читать данные в элементе;
- Переключатель is_disabled: дает возможность не сохранять входную информацию в базу данных;
- label: используется для записи заголовка ячейки элемента;
- hint: используется для записи вспомогательного слова к данным, которые необходимо ввести в элемент;
- placeholder: используется для ввода записи в ячейку элемента (данная запись исчезает, когда пользователь вводит информацию в ячейку);
- visibility: в эту ячейку заносятся пользователи, имеющие право просмотра создаваемой таблицы;
- render_condition: Определяет, видны или нет другие элементы формы, в зависимости от того, вставлены ли элементы формы. Если в поле render_condition записано значение, введенная информация сохраняется в базе данных. В противном случае он сохраняет значение
nullв базе данных; - style: предназначен для написания css кода
- class: используется для написания кодов, формирующих свойства элемента (цвет и т. д.);