# Входни видове NEWACTION

> Изберете типове за вход, парами, заявки и дефиниции за изход, включително конверсии и отхвърлени стойности.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: bg
Content-SHA256: 91e449881364eff884f58a84c67db1ba80e0f854fc7edbcd335e53cbc1aca397
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

Дефиницията е списък от `name:Type`, разделени със запетаи, например `*email:Email, age:Number`. `*` пред името прави полето задължително. Същият формат се използва от `input` (тялото), `params`, `query` и `output`. **Типът преобразува стойността**: действието получава преобразуваната стойност, а не изпратения текст.

Имената на типовете не различават главни и малки букви. Всеки тип по-долу е проверен чрез изпращане на стойността от втората колона.

| Тип | Изпратена стойност | Получена стойност | Бележки |
|---|---|---|---|
| `String` | `  hello  ` | `hello` | Текст; интервалите в началото и в края се премахват. |
| `Text` | `  text  ` | `  text  ` | Текст, запазен точно както е изпратен. |
| `Email` | ` A@B.CZ ` | `a@b.cz` | Валиден имейл адрес, с малки букви; всичко друго се отхвърля. |
| `Phone` | `+421 900 123 456` | `+421900123456` | Телефонен номер; интервалите се премахват. |
| `URL` | `https://totaljs.com/x` | `https://totaljs.com/x` | Валиден URL; всичко друго се отхвърля. |
| `Name` | `john smith` | `John Smith` | Главна първа буква на всяка дума. |
| `Capitalize` | `hello big world` | `Hello Big World` | Главна първа буква на всяка дума. |
| `Capitalize2` | `HELLO big WORLD` | `Hello big world` | Главна само първата буква, останалите малки. |
| `Lowercase` | `ABC` | `abc` | Малки букви. |
| `Uppercase` | `abc` | `ABC` | Главни букви. |
| `Search` | `Žluťoučký Kůň` | `zlutoucki kun` | Малки букви без диакритики, за търсене. |
| `SafeString` | `plain text` | `plain text` | Текст; стойност с HTML тагове като `<b>` се отхвърля. |
| `Color` | `#FF0000` | `#FF0000` | [schema-enums-and-formats](/en/total5/schema-enums-and-formats/) |
| `Base64` | `SGVsbG8=` | `SGVsbG8=` | [schema-enums-and-formats](/en/total5/schema-enums-and-formats/) |
| `Zip` | `81101` | `81101` | [schema-enums-and-formats](/en/total5/schema-enums-and-formats/) |
| `Icon` | `ti ti-home` | `ti ti-home` | [schema-enums-and-formats](/en/total5/schema-enums-and-formats/) |
| `Number` | `12.5` | `12.5` | Число; текстът се преобразува. |
| `Float` | `3.14` | `3.14` | Число; текстът се преобразува. |
| `Decimal` | `2.5` | `2.5` | Число; текстът се преобразува. |
| `Boolean` | `true` | `true` | `true` или `false`; текстът `true` се преобразува. |
| `Date` | `2026-01-05` | `2026-01-05T00:00:00.000Z` | Дата. В JSON се изпраща като ISO текст. |

Други форми:

| Форма | Пример | Бележки |
|---|---|---|
| `[String]`, `[Number]` | `ze_arr:[String]` | Масив от този тип: всеки елемент се преобразува. |
| `{ x:Number, y:String }` | `zg_obj:{ x:Number, y:String }` | Вложен обект, валидиран със собствените си полета. |
| `String(5)` | `zd_max:String(5)` | Текст от най-много 5 знака; по-дълъг текст се отхвърля. |

Стойност, която не отговаря на типа, се отхвърля със статус 400 и името на полето в грешката. При проверките бяха отхвърлени тези стойности: `SafeString` с `<b>x</b>`, `String(5)` с десет знака, `UID` с `abc` и `GUID` с `not-guid`. Рецептата за граници проверява `Int`, `SmallInt`, `TinyInt`, `Number2`: [numeric-schema-boundaries](/en/total5/numeric-schema-boundaries/). В тази версия `Int` не отрязва: `7.9` остава `7.9`.

`UID` и `GUID` приемат стойностите, които създават `UID()` и `GUID()`.

```js definitions/types.js
NEWACTION('Types/all', {
	name: 'Every type',
	input: 'a_string:String, b_text:Text, c_email:Email, d_phone:Phone, e_url:URL, f_name:Name, g_capitalize:Capitalize, h_capitalize2:Capitalize2, i_lowercase:Lowercase, j_uppercase:Uppercase, k_search:Search, l_safestring:SafeString, m_color:Color, n_base64:Base64, o_zip:Zip, p_icon:Icon, q_number:Number, r_float:Float, s_decimal:Decimal, t_boolean:Boolean, u_date:Date, ze_arr:[String], zf_nums:[Number], zg_obj:{ x:Number, y:String }, zd_max:String(5)',
	action: function($, model) {
		$.callback(model);
	}
});

NEWACTION('Types/ids', {
	name: 'UID and GUID',
	input: '*id:UID, *key:GUID',
	action: function($, model) {
		$.callback(model);
	}
});
```

```js controllers/types.js
exports.install = function() {
	ROUTE('POST /types/ @json --> *Types/all');
	ROUTE('POST /ids/ @json --> *Types/ids');
	ROUTE('GET /newids/', ids);
};

function ids($) {
	$.json({ id: UID(), key: GUID() });
}
```