¶ Asosiy ma'lumotlar
Formalar bo'limining asosiy funksionali web-sahifa foydalanuvchilari tomonidan ma'lumotlar kiritilishi uchun mo'ljallangan oyna shaklini yasash hisoblanadi.
¶ Bo'lim tuzilishi
¶ Forma yaratish
Forma yaratish uchun Platon platformasi navigatsiya panelining Formalar bo'limiga o'tiladi. Ushbu ochilgan sahifada Platon platformasida ilgari ochilgan formalar ro'yxati aks etadi. Ushbu sahifa pastgi qismida joylashgan Qo'shish tugmasi bosiladi va quyidagi oyna ("forma") ochiladi:
¶ Forma yaratish oynasi tarkibi
Oyna quyidagi yacheykalardan iborat:
- name: formaning nomi (shuningdek, forma URLda ham shu nom bilan joylashadi);
- source_table_name: ma'lumotlar bazasi (Database)dagi faylning nomi bo'lib, formaga kiritilgan ma'lumotlar ushbu jadvalda saqlanadi;
- data_source: Bu selectdan platon yoki project ma'lumotlar bazasiga (Database)ga saqlashni nazorat qilishi mumkin;
- sequence_name: formaning ma'lumotlar bazasi (Database)dagi sequenceni yozish uchun foydalaniladi;
- data_filter: formadagi ma'lumotlarga filter qo'yish uchun foydalaniladi;
- unique_fields: ushbu funksional ma'lumotlar bazasidagi belgilangan so'z yoki raqamni unikallashtirish funksiyasini bajarib, belgilangan so'z yoki raqamga aynan o'xshash boshqa so'z yoki raqamni qayta kiritishning oldini oladi;
- focused_field_name: forma sahifasidagi diqqat qaratilishi lozim bo'lgan ma'lumotni belgilash uchun foydalaniladi;
- grid_offset: formaning ikki tomonidan joy tashlab berish uchun xizmat qiladi;
- next_link: forma to'ldirilib, saqlash tugmasi bosilganidan so'ng ochilishi lozim bo'lgan sahifa manzilini yozish uchun foydalaniladi. Saqlashdan so'ng modal yoki blank oyna yopilishi uchun
backnomli maxsus url dan foydalaniladi; - archive_fields:formading edit Modi ochilganda kelmasligi kerak bo'lgan qiymatlar.
- add_title: ushbu forma web-sahifasi manzili (https) qismining sarlavhasini yozish uchun foydalaniladi;
- edit_title: tahrirlash sarlavhasini nomlash uchun ishlatiladi;
- add_header: ushbu forma sarlavhasini yozish uchun foydalaniladi;
- edit_header: ushbu forma sarlavhasini taxrirlash uchun foydalaniladi;
¶ Yacheykalarga kiritilgan yozuvlar (kodlar) ning ko'rinishi:
- name.
// misol uchun
test_post
- source_table_name.
// misol uchun
temp_guids
- sequence_name.
// misol uchun
seq_nimadur
- data_filter.
// misol uchun
type_id=#type_id
- unique_fields.
// misol uchun
username
- focused_field_name.
// misol uchun
reject_type_id
- grid_offset.
// misol uchun
2
- next_link.
// misol uchun
back
- archive_fields.
// misol uchun
Realsoft
Tillarni ozgartirish quyidagi yacheykalardan iborat:
- add_title 1-uz,2-ru,3-la va 4-en.
// misol uchun
қўшиш
добавить
qo’shish
add
- edit_title 1-uz,2-ru,3-la va 4-en.
// misol uchun
тахрирлаш
изменить
tahrirlash
edit
- add_header 1-uz,2-ru,3-la va 4-en.
// misol uchun
фойдаланувчи кўшиш
добавить пользователя
foydalanuvchi qo’shish
add user
- edit_header 1-uz,2-ru,3-la va 4-en.
// misol uchun
фойдаланувчи малумотини тахрирлаш
изменить информацию о пользователи
foydalanuvchi malumotlarini qo’shish
edit user
Sql formalari
- defaults_sql.
// misol uchun
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.
// misol uchun
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.
// misol uchun
Realsoft
- after_add_sql.
// misol uchun
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.
// misol uchun
Realsoft
- after_edit_sql.
// misol uchun
call send_user_password_sms(@mobile_phone::bigint, @username, @raw.password);
- before_delete_sql.
// misol uchun
update auth_users set username=concat('user', @id) where id=@id
- after_delete_sql.
// misol uchun
Realsoft
- before_restore_sql.
// misol uchun
Realsoft
- after_restore_sql.
// misol uchun
Realsoft
JS / CSS
- js.
// misol uchun
$form.formElementsWithKey.open_sum.maxValue = $form.params.total_sum
});
- css.
// misol uchun
.platon-form[form-name="mahalla"] .card {
border: none;
}
.platon-form[form-name="mahalla"] .card-body {
padding: 0;
}
- visibility.
// misol uchun
$user.has_perm('platon.admin')
- can_create_condition.
// misol uchun
$user.has_perm('platon.admin') || ($user.level ==1 && $user.bank_group_id == 1)
- can_edit_condition.
// misol uchun
$user.has_perm('platon.admin') || ($user.level ==1 && $user.bank_group_id == 1)
- can_delete_condition.
// misol uchun
$user.has_perm('platon.admin')
¶ Forma sahifasi tarkibi
Forma yaratib olinganidan so'ng quyidagi oyna paydo bo'ladi:
Ushbu oynada quyidagi tugmalar mavjud:
¶ Foydalanuvchilar uchun
-
Ushbu tugmani bosish orqali formaga kirilgan ma'lumotlar saqlanadi.
-
Ushbu tugmani bosish orqali forma shaklidan chiqib ketiladi.
¶ Dasturchilar uchun
-
Ushbu tugmadan formaga o'zgartirishlar kiritish uchun foydalaniladi.
-
Ushbu tugmadan formaga yangi elementlar (foydalanuvchi tomonidan ma'lumotlar kiritishga mo'ljallangan yacheykalar) qo'shish uchun foydalaniladi
-
Ushbu tugmani bosish orqali forma sahifasidagi barcha elementlar ro'yxatini ko'rish mimkin.
¶ Yangi element qo'shish
Ushbu tugmadan formaga yangi elementlar (foydalanuvchi tomonidan ma'lumotlar kiritishga mo'ljallangan yacheykalar) qo'shish uchun foydalaniladi. Ushbu tugma bosilganida quyidagi oyna ochiladi:
Oyna quyidagi yacheykalardan iborat:
- form: formaning nomi (shuningdek, forma URLda ham shu nom bilan joylashadi);
- type: element funksiyasi yoki turi bo'lib quyidagilardan iborat:
- a)
fieldset- elementlarni joylashtirish uchun yangi maydon shakllantirib beradi; - b)
text- tekst kiritish uchun input yaratadi; - c)
raw_json- faqat json turidagi ma'lumotlarni qabul qilish uchun ishlatiladi; - d)
number- son (natural son) kiritish uchun input yaratadi; - e)
file- fayllar qabul qilish uchun input yaratadi; - f)
image- rasmlar qabul qilish uchun input yaratadi; - g)
button- turli xil so'rovlarni yuborish uchun tugma yaratadi; - h)
date- sanalarni qabul qilish uchun input yaratadi; - i)
select- bir nechta ma'lumotlardan birini tanlash imkoniyatini beruvchi input yaratadi; - j)
time- vaqtni qabul qilish uchun input yaratadi; - k)
multiselect- bir nechta ma'lumotlarni tanlash imkoniyatini beruvchi input yaratadi; - l)
checkbox- boolean turidagi ma'lumot qaytaradigan element yaratadi; - m)
textarea- katta hajmdagi tekstlarni kiritish uchun input yaratadi(description uchun); - o)
phone- telefon raqami formatidagi ma'lumotni kiritish uchun ishlatiladigan input; - p)
code- turli xil dasturlash tilidagi kodni saqlash imkoniyatini beradi (js, html, css, sql) - r)
html- bu orqali hohlagan API ga so'rov yuborish va hohlagan ko'rinishdagi dizayn yaratish mumkin; - s)
geo- ushbu element turi bo'yicha geopozitsiyani kiritish imkoniyati mavjud (map_center, map_zoom). Bunda qaysi karta orqali tanlashniactive_mapmaydonida ko'rsatib ketiladi; - t)
geo polygon- ushbu elementda turi bo'yicha bir nechta geopozitsiyani kiritish imkoniyati mavjud (map_center, map_zoom, is). Bunda qaysi karta orqali tanlashniactive_mapmaydonida ko'rsatib ketiladi. Bundan tashqari bir nechta geopozitsiyalarni kiritish uchunis_multipletugmasi active holatga keltiriladi; - u)
simple key-value- unikal qiymatlarni shakllantirish uchun qo'llaniladi; - v)
tab- turli xil ma'lumotlarni sahifaviy joylashtirish uchun ishlatiladi; - w)
tab container- sahifaviy joylashtirilgan ma'lumotlarni ma'lum bir ko'rinishda jamlash; - x)
markdown editor,monaco_editor,vue_editor,wysiwyg- kontentlarni tahrirlash; - data_field: ustunning ichki nomi. SQL so'rovlarida ushbu ichki kod nomi yoziladi;
- parent: boshqa elementlarni o'z ichiga oluvchi bosh element;
- sort_order: elementning forma sahifasidagi joylashgan o'rni (kichik raqamli elementlar sahifaning oldingi qismida, katta raqamli elementlar sahifaning keyingi qismida joylashadi);
- default_value: forma shakllantirish jarayonida ushbu element uchun default qiymat berish u/n ishlatiladi. Bu yerda shartga ko'ra qiymat olish mumkin va h.k;
- width: ushbu yacheykaga ustun kengligi yoziladi;
- sql: ushbu yacheyka SQL so'rovlari yozish uchun mo'ljallangan;
- validation_sql: inputdagi ma'lumotlarni validatsiya qilish.
Yani bu yerda shart yoziladi va agar shu shartga to'g'ri kelmasa post bo'lmaydi masalan:
SELECT
not EXISTS (SELECT 1 FROM table_name WHERE name = @name)
Bu yerda agar kiritilayotgan name aval kiritlgan bo'lsa xatolik qaytaradi!
- is_attribute: ushbu svitchdan ma'lumotlar bazasi 'attributes' ustuniga ma'lumotlar kiritish uchun foydalaniladi;
- is_required svitchi: ushbu svitch element yacheykasiga ma'lumotni kirgizmasdan turib saqlash imkonini bermaslik uchun foydalaniladi (yani ushbu svitch yoqilsa foydalanuvchi element yacheykasiga ma'lumot kirgizish shart hisoblanadi);
- is_read_only svitchi: ushbu svitch yoqilsa foydalanuvchi elementdagi ma'lumotlarni faqat o'qish imkoniga ega bo'ladi;
- is_disabled: svitchi: inputga kiritilgan ma'lumotni bazaga saqlamaslik imkoniyatini beradi;
- label: element yacheykasining sarlavhasini yozish uchun foydalaniladi;
- hint: elementga kiritiladigan ma'lumotlar bo'yicha yordamchi so'z yozish uchun foydalaniladi;
- placeholder: element yacheykasiga yozuv kiritilish uchun foydalaniladi (foydalanuvchi tomonidan yacheykaga ma'lumot kiritilganida ushbu yozuv o'chib ketadi);
- visibility: ushbu yacheykaga yaratilayotgan jadvalni ko'rish huquqiga ega bo'lgan foydalanuvchilar kiritiladi;
- render_condition: Forma elementlarining kiritilganligiga qarab boshqa elementlarni ko'rinishi yoki ko'rinmasligini hal qiladi. Agar render_condition maydoniga qiymat yozilsa, ma'lumotlar bazasida kiritilgan ma'lumotni saqlaydi. Aks holda ma'lumotlar bazasida
nullqiymatni saqlaydi; - style: css kod yozish uchun mo'ljallangan
- class: element xususiyatlarini (rangi va boshqa) shakllantiruvchi kodlar yozish uchun foydalaniladi;
¶ Formada Javascript metodlarini ishlatilishi hamda Platon metodlari.
Platon formalarning JS qismiga JavaScript ES6 kodlari yoziladi vue emas
- beforeSave
Ushbu funktsiya formadagi malumotlar saqlanishidan oldin ishladi. Odatda saqlashdan oldin inputlardagi ma'lumotlarni tekshirish , validatsiya qilish va boshqa turlixil maqsadlarda ishlatiladi. Masalan:
// Ishlatilishi.
this.beforeSave=()=>{
// javascript codlar
// ushbu funkisya ichidagam fetch apilarni o'zimiz hohlaganimizdak ishlatishimiz mumkin. Masalan:
// this.$api.get('api-url').then(res=>{})
return true
}
Agar beforeSave da retrun false qaytsa formadagi ma'lumotlar saqlanmaydi.
- afterSave
Ushbu funktisya yuqoridagi beforeSave singari ishlaydi faqat formadagi ma'lumotlar saqlanganidan so'ng ishlaydi.
// Ishlatilishi
this.afterSave=(id)=>{
// bu yerda ham biz JavaScript kodlarimizni yozishimiz mumkin .
// id bu forma saqlangandagi malumotlar bazasiga tushgana qaytgan id
}
- setVal
Ushbu metod platon formadagi inputlarga default ma'lumot yoki boshqa holatlarda ma'lumotlar yozish uchun ishlatiladi. Masalan:
$setVal('Data_field' , 'value')
// Data_field qaysi inputga ma'lumot yozishi kerakligi
// value yozilishi kerak bo'lgan ma'lumot
- editId
Ushbu metod formaning edit (taxrirlanayotgan) yoki yangi saqlanayotganligini tekshirishimiz uchun ishlatiladi. Ishlatilishi this.editId. Masalan:
if(this.editId != null){
// Ushbu holatda ushbu forma edit yoki edit emasligini tekshirilmoqda
}
Platon formalarning edit (taxrirlash) oynasini ochish uchun linkda formadan so'ng id berish orqali ochishimiz mumkin. Masalan
forms/add_car/idid yani formaning ID raqami.
- Toast
- $w
$w orqali Platon formadagi inputlarning o'zgarishini ushlab olishimiz mumkin. Masalan username Data_field inputini o'zgarganida qandaydir funktsiyani avtomatik ishlatmoqchi bo'lsak.
const testFunc = () => {
// odatiy JavaScript funktsiyasi
}
$w('username', testFunc);
- Parametr dagi qiymatlar
Platon formalar ochilayotganda linkga qo'shimcha qiymatlarham berishimiz mumkin.
Masalan qayerdandur forma uchun link bor va u linkga userning user_id parametrini berishimiz kerak bo'lsa:
forma linkiga 'forms/my-user?user_id=22'
// user_id ni formaning SQL qismida ushlamoqchi bo'lsa #user_id orqali murojat qilamiz.
// user_id ni formaning Javascript qismida ushlamoqchi bo'lsa this.q('user_id') orqali murojat qilamiz.