@opengis/fastify-table 1.1.51 → 1.1.53

package/docs/templates/forms.md

@@ -1,139 +1,139 @@
----
-sidebar_position: 6
-title: Форми
-displayed_sidebar: devDocsSidebar
----
-
-# Форми
-
-Використовується для створення та редагування даних у таблицях бази даних для користувачів. В папці `server/templates/form`
-
-[Документація Form](https://apidocs.softpro.ua/v3-core/form/)
-
-## Створення форми
-
-Використовуємо компоненти форм на основі Vue.
-
-Для формування форми створити у відповідній папці файл у форматі JSON, приклад:
-
-``` json
-   {
-    "schema": {
-        "user_name": {
-            "type": "Text",
-            "ua": "ПІБ",
-            "i": "Заповніть у форматі Петренко Петро Петрович"
-        },
-        "contact.email": {
-            "type": "Email",
-            "ua": "Email",
-            "placeholder": {
-                "ua": "Email",
-                "en": "Email"
-            }
-        },
-        "message": {
-            "type": "richtext",
-            "title": false,
-            "ua": "Повідомлення",
-            "en": "Message",
-            "i": "Опишіть проблему, пропозицію чи коментар в даному полі",
-            "validators": [
-                "required"
-            ]
-        }
-    },
-    "style": {
-        "label": "vertical",
-        "buttonPosition": "bottom-center"
-    }
-}
-```
-
-::: details Типи полів
-
-Значення типу форми бажано вказувати в нижньому регістрі. Хоча форма приймає значення в будь-якому регістрі.
-
-- **`Text`** - Основний тип в формі - приймає текстові значення
-- **`TextArea`** - Застосовується найчастіше для тізерів, коротких описів
-- **`Number`** - Для числових значень, в т.ч. і для десяткових
-- **`MarkedText`** - Передаються маска, якими мають бути значення. Може застосовуватися, наприклад, для мобільних номерів
-- **`Password`** - Спеціальний тип форми для вводу та перевірки паролю
-- **`Email`** - Спеціальний тип для email
-- **`DataTable`** - Таблиця в формі
-- **`File`** - Вибір файлів з можливістю перетягуванння елементів.
-- **`FileList`** - Вибір файлів зі зручним переглядом всіх файлів.
-- **`Checkbox`** - Вибір декількох значень без випадаючого списку
-- **`Switcher`** - Переключення між значеннями false/true
-- **`Radio`** - Вибір один одного значення без випадаючого списку
-- **`Autocomplete`** - Вибір декількох значень із випадаючого списку
-- **`Date`** - Вибір дати
-- **`Datetime`** - Вибір дати та часу
-- **`Timepicker`** - Вибір часу
-- **`Colorpicker`** - Вибір кольору
-- **`Richtext`** - Текстовий редактор з підтримкою markdown розмітки
-- **`Geom`** - Створення геометрії (позначки на карті) для об'єкта
-- **`Camera`** - Додавання живого фото з веб-камери
-- **`Slider`** - Числове значення, що встановлюється по лінії-повзунку
-- **`Tree`** - Створення значень поля у форматі деревоподібного структурованого списку
-
-:::
-
-::: details Параметри поля
-
-- `pin` - для основних полів, можна прикріприти в правій частині. Допустимі значення: `true`, `false`
-- `col` - ширина поля в формі. Допустимі значення: `діапазон від 1 до 12`, цілі числа.
-- `title` - показ назви поля (ua) в формі. За замовчуванням `false`. Допустимі значення: `true`, `false`
-- `i` - інформація. Приймається будь-який текстовий масив. HTML не читається.
-- `help` - блок допомоги в полі форми. Приймається будь-який текстовий масив. HTML не читається.
-- `multi` - можливість вибору декількох значень. Допустимі значення: `true`, `false`
-- `default` - значення поля за замовчуванням. Значення відрізняються в залежності від типу поля форми.
-- `min` - мінімальне значення
-- `max` - максимальне значення
-- `behavior` - показ/приховання певного поля.
-- `mask` - маска для `type: MarkedText`
-- `parent` - батьківське поле форми.
-- `validators`
-- `placeholder` - текст, що виводиться в полі
-
-:::
-
-### Параметри стилів
-
-Форма може змінювати зовнішній вигляд, нижче наведені параметри стилів. Працює як через вміст style{...}, так і як самостійні значення на одному рівні із schema
-
-``` json
-{
-    "schema": {},
-    "style": {
-        "layout": "tabs", // accordion, wizard, default,
-        "label": "inline" // vertical, horizontal        
-    }
-}
-```
-
-## Вивід форми
-
-Існує декілька опцій, за допомогою яких можна виводити форму.
-
-**handlebars**
-
-```hbs
-{{{__form form="form_name" model='table_name' id=id}}}
-{{{_vue "vs-form" form="form_name"}}}
-```
-
-**html attribute - add, edit**
-
-```html
-<a add="{{_token id=id model=table form=form}}"> Стаття</a>
-```
-
-**В таблиці у форматі**
-
-``` json
-{
-    "table": "billing.service",             // Таблиця 
-    "add_form": "web.customize_menu.form"   // Назва форми
-}
-```
+---
+sidebar_position: 6
+title: Форми
+displayed_sidebar: devDocsSidebar
+---
+
+# Форми
+
+Використовується для створення та редагування даних у таблицях бази даних для користувачів. В папці `server/templates/form`
+
+[Документація Form](https://apidocs.softpro.ua/v3-core/form/)
+
+## Створення форми
+
+Використовуємо компоненти форм на основі Vue.
+
+Для формування форми створити у відповідній папці файл у форматі JSON, приклад:
+
+``` json
+   {
+    "schema": {
+        "user_name": {
+            "type": "Text",
+            "ua": "ПІБ",
+            "i": "Заповніть у форматі Петренко Петро Петрович"
+        },
+        "contact.email": {
+            "type": "Email",
+            "ua": "Email",
+            "placeholder": {
+                "ua": "Email",
+                "en": "Email"
+            }
+        },
+        "message": {
+            "type": "richtext",
+            "title": false,
+            "ua": "Повідомлення",
+            "en": "Message",
+            "i": "Опишіть проблему, пропозицію чи коментар в даному полі",
+            "validators": [
+                "required"
+            ]
+        }
+    },
+    "style": {
+        "label": "vertical",
+        "buttonPosition": "bottom-center"
+    }
+}
+```
+
+::: details Типи полів
+
+Значення типу форми бажано вказувати в нижньому регістрі. Хоча форма приймає значення в будь-якому регістрі.
+
+- **`Text`** - Основний тип в формі - приймає текстові значення
+- **`TextArea`** - Застосовується найчастіше для тізерів, коротких описів
+- **`Number`** - Для числових значень, в т.ч. і для десяткових
+- **`MarkedText`** - Передаються маска, якими мають бути значення. Може застосовуватися, наприклад, для мобільних номерів
+- **`Password`** - Спеціальний тип форми для вводу та перевірки паролю
+- **`Email`** - Спеціальний тип для email
+- **`DataTable`** - Таблиця в формі
+- **`File`** - Вибір файлів з можливістю перетягуванння елементів.
+- **`FileList`** - Вибір файлів зі зручним переглядом всіх файлів.
+- **`Checkbox`** - Вибір декількох значень без випадаючого списку
+- **`Switcher`** - Переключення між значеннями false/true
+- **`Radio`** - Вибір один одного значення без випадаючого списку
+- **`Autocomplete`** - Вибір декількох значень із випадаючого списку
+- **`Date`** - Вибір дати
+- **`Datetime`** - Вибір дати та часу
+- **`Timepicker`** - Вибір часу
+- **`Colorpicker`** - Вибір кольору
+- **`Richtext`** - Текстовий редактор з підтримкою markdown розмітки
+- **`Geom`** - Створення геометрії (позначки на карті) для об'єкта
+- **`Camera`** - Додавання живого фото з веб-камери
+- **`Slider`** - Числове значення, що встановлюється по лінії-повзунку
+- **`Tree`** - Створення значень поля у форматі деревоподібного структурованого списку
+
+:::
+
+::: details Параметри поля
+
+- `pin` - для основних полів, можна прикріприти в правій частині. Допустимі значення: `true`, `false`
+- `col` - ширина поля в формі. Допустимі значення: `діапазон від 1 до 12`, цілі числа.
+- `title` - показ назви поля (ua) в формі. За замовчуванням `false`. Допустимі значення: `true`, `false`
+- `i` - інформація. Приймається будь-який текстовий масив. HTML не читається.
+- `help` - блок допомоги в полі форми. Приймається будь-який текстовий масив. HTML не читається.
+- `multi` - можливість вибору декількох значень. Допустимі значення: `true`, `false`
+- `default` - значення поля за замовчуванням. Значення відрізняються в залежності від типу поля форми.
+- `min` - мінімальне значення
+- `max` - максимальне значення
+- `behavior` - показ/приховання певного поля.
+- `mask` - маска для `type: MarkedText`
+- `parent` - батьківське поле форми.
+- `validators`
+- `placeholder` - текст, що виводиться в полі
+
+:::
+
+### Параметри стилів
+
+Форма може змінювати зовнішній вигляд, нижче наведені параметри стилів. Працює як через вміст style{...}, так і як самостійні значення на одному рівні із schema
+
+``` json
+{
+    "schema": {},
+    "style": {
+        "layout": "tabs", // accordion, wizard, default,
+        "label": "inline" // vertical, horizontal        
+    }
+}
+```
+
+## Вивід форми
+
+Існує декілька опцій, за допомогою яких можна виводити форму.
+
+**handlebars**
+
+```hbs
+{{{__form form="form_name" model='table_name' id=id}}}
+{{{_vue "vs-form" form="form_name"}}}
+```
+
+**html attribute - add, edit**
+
+```html
+<a add="{{_token id=id model=table form=form}}"> Стаття</a>
+```
+
+**В таблиці у форматі**
+
+``` json
+{
+    "table": "billing.service",             // Таблиця 
+    "add_form": "web.customize_menu.form"   // Назва форми
+}
+```

package/docs/templates/index.md

@@ -1,28 +1,28 @@
----
-order: -1
----
-
-# Список шаблонів
-
-- **[card](card.md)** - картка таблиці.
-- **[cls](cls.md)** - класифікатори.
-- **[select](select.md)** -  селекти.
-- **[filters](filters.md)** - фільтри.
-- **[forms](forms.md)** - створення та редагування даних у таблицях бази даних для користувачів.
-- **[table](table.md)** - для виводу інформації з бази даних.
-
-::: details Типова структура проекту GIT
-
-Всі шаблони знаходяться в GIT проекті в папці `templates`
-
-```bash
-
-server                      # module SITE
-└── templates               # шаблони
-    ├── cls                 # незмінні класифікатори
-    ├── select              # класифікатори запити
-    ├── form                # форми json    
-    └── table               # таблиці
-```
-
-:::
+---
+order: -1
+---
+
+# Список шаблонів
+
+- **[card](card.md)** - картка таблиці.
+- **[cls](cls.md)** - класифікатори.
+- **[select](select.md)** -  селекти.
+- **[filters](filters.md)** - фільтри.
+- **[forms](forms.md)** - створення та редагування даних у таблицях бази даних для користувачів.
+- **[table](table.md)** - для виводу інформації з бази даних.
+
+::: details Типова структура проекту GIT
+
+Всі шаблони знаходяться в GIT проекті в папці `templates`
+
+```bash
+
+server                      # module SITE
+└── templates               # шаблони
+    ├── cls                 # незмінні класифікатори
+    ├── select              # класифікатори запити
+    ├── form                # форми json    
+    └── table               # таблиці
+```
+
+:::

package/docs/templates/select.md

@@ -1,90 +1,90 @@
-# Select
-
-Зберігаються файли у форматі .sql. Принцип виклику відрізняється від класифікаторів - запит значень йде у базу даних до конкретної таблиці.
- В папці `server/templates/select`
-
-Складається з 1 або 2-х файлів
-
-1. `select.sql`   - SQL запит
-2. `select.json`  - Налаштування select
-
-```sql
-select conformity from data_barlessness.entrance_group
-```
-
-## Налаштування + Оптимізація
-
-```json
-{
- "db": "geo_atu",           // інша база
-
- // для оптимізації
- "only": "sql",  // sql, redis
- "searchColumn": "name_nominative,katottg", // колонки пошуку 
- "minLengthSql": 4,       // 
- "limit": 20,             // максимальний ліміт пошуку
- "count": 0,              // загальна кількість число, не буде робити запит кількості
- "minLength": 4           // мінімальна кількість символів пошуку
-}
-```
-
-::: details Приклад `edrato.atu.katottg`
-
-```sql
-select atu_id,
-      coalesce(edrato.atu_full_name(atu_id),'')||coalesce(' #'||katottg,''),  
-      name_nominative, 
-      katottg
-      from edrato.atu a 
-      where version=(select max(version) from edrato.atu where atu_id=a.atu_id)
-```
-
----
-
-```json
-{
-    "only": "sql",
-    "searchColumn1": "name_nominative,katottg",
-    "limit": 2,
-    "minLength": 4
-}
-```
-
-:::
-
-::: warning
-
-1. Якщо запит працює більше 100ms - це баг і треба робити оптимізацію.
-2. searchColumn - пошук має бути по нативній колонці щоб індекс спрацював. Порядок searchColumn = `searchColumn`  || колонка `search` || колонка `text`
-3. не намагатись загаянти статистику в пошук
-:::
-
-## Використання API
-
-Викликається через команду [suggest](../api/fastify-table/table/suggest.md) `/api/suggest/{name}` на конкретному порталі.
-
-Повертаються значення **id** та **text**. Приклад:
-
-```json
-{
-  "limit": 50,
-  "count": 2,
-  "mode": "array",
-  "time": 2,
-  "data": [
-    {
-        "id": "1",
-        "text": "Комунальна"
-    },
-    {
-        "id": "2",
-        "text": "Державна"
-    },
-    {
-        "id": "3",
-        "text": "Приватна"
-    }
- ]
-}
-
-```
+# Select
+
+Зберігаються файли у форматі .sql. Принцип виклику відрізняється від класифікаторів - запит значень йде у базу даних до конкретної таблиці.
+ В папці `server/templates/select`
+
+Складається з 1 або 2-х файлів
+
+1. `select.sql`   - SQL запит
+2. `select.json`  - Налаштування select
+
+```sql
+select conformity from data_barlessness.entrance_group
+```
+
+## Налаштування + Оптимізація
+
+```json
+{
+ "db": "geo_atu",           // інша база
+
+ // для оптимізації
+ "only": "sql",  // sql, redis
+ "searchColumn": "name_nominative,katottg", // колонки пошуку 
+ "minLengthSql": 4,       // 
+ "limit": 20,             // максимальний ліміт пошуку
+ "count": 0,              // загальна кількість число, не буде робити запит кількості
+ "minLength": 4           // мінімальна кількість символів пошуку
+}
+```
+
+::: details Приклад `edrato.atu.katottg`
+
+```sql
+select atu_id,
+      coalesce(edrato.atu_full_name(atu_id),'')||coalesce(' #'||katottg,''),  
+      name_nominative, 
+      katottg
+      from edrato.atu a 
+      where version=(select max(version) from edrato.atu where atu_id=a.atu_id)
+```
+
+---
+
+```json
+{
+    "only": "sql",
+    "searchColumn1": "name_nominative,katottg",
+    "limit": 2,
+    "minLength": 4
+}
+```
+
+:::
+
+::: warning
+
+1. Якщо запит працює більше 100ms - це баг і треба робити оптимізацію.
+2. searchColumn - пошук має бути по нативній колонці щоб індекс спрацював. Порядок searchColumn = `searchColumn`  || колонка `search` || колонка `text`
+3. не намагатись загаянти статистику в пошук
+:::
+
+## Використання API
+
+Викликається через команду [suggest](../api/fastify-table/table/suggest.md) `/api/suggest/{name}` на конкретному порталі.
+
+Повертаються значення **id** та **text**. Приклад:
+
+```json
+{
+  "limit": 50,
+  "count": 2,
+  "mode": "array",
+  "time": 2,
+  "data": [
+    {
+        "id": "1",
+        "text": "Комунальна"
+    },
+    {
+        "id": "2",
+        "text": "Державна"
+    },
+    {
+        "id": "3",
+        "text": "Приватна"
+    }
+ ]
+}
+
+```