[comment]: # translation:outdated

[comment]: # aside:1

[comment]: # ({ee4a2645-28092341})
# Објекат макроа корисника

Следећи објекти су директно повезани са `usermacro` API-јем.

[comment]: # ({/ee4a2645-28092341})

[comment]: # ({a64219c9-e654cd12})
### Глобални макро

Глобални макро објекат има следећа својства.

|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|globalmacroid|ID|ID глобалног макроа.<br><br>[Понашање својства](/manual/api/reference_commentary#property-behavior):<br>- *само за читање*<br>- *обавезно* за операције ажурирања|
|description|string|Опис макроа.|
|macro|string|Стринг макроа.<br><br>[Понашање својства](/manual/api/reference_commentary#property-behavior):<br>-*потребно* за операције креирања|
|type|integer|Тип макроа.<br><br>Могуће вредности:<br>0 - *(подразумевано)* Текстуални макро;<br>1 - Тајни макро;<br>2 - Тајна вредност трезора.|
|value|string|Вредност макроа.<br><br>[Понашање својства](/manual/api/reference_commentary#property-behavior):<br>- *само за писање* ако је `type` подешен на " Тајни макро"<br>- *обавезан* за операције креирања|

[comment]: # ({/a64219c9-e654cd12})

[comment]: # ({a86faee8-5a3a9f9f})
### Макро домаћина

Макро објекат домаћина дефинише макро доступан на домаћину, домаћину
прототипа или шаблон. Има следећа својства.

|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|hostmacroid|ID|ID макроа домаћина.<br><br>[Понашање својства](/manual/api/reference_commentary#property-behavior):<br>- *само за читање*<br>- *потребно* за операције ажурирања|
|automatic|integer|Дефинише да ли се макро контролише правилом откривања.<br><br>Могуће вредности:<br>0 - *(подразумевано)* Макроом управља корисник;<br>1 - Макроом управља правило откривања.<br><br>Кориснику није дозвољено да креира аутоматски макро.<br>Да би се ажурирао аутоматски макро, мора бити [конвертован у ручни](/manual/api/reference/usermacro/update#change-macro-value-that-was-created-by-discovery-rule).|
|config|object/array|[Конфигурација макроа](#macro-configuration) одговоран за начин приказивања макроа у [Чаробњаку за домаћина](/manual/config/hosts/host_wizard#configure-host).|
|description|string|Опис макроа.|
|hostid|ID|ID домаћина којем макро припада.<br><br>[Понашање својства](/manual/api/reference_commentary#property-behavior):<br>- *константа*<br>- *потребно* за операције креирања|
|macro|string|Макро стринг.<br><br>[Понашање својства](/manual/api/reference_commentary#property-behavior):<br>- *потребно* за операције креирања|
|type|integer|Тип макроа.<br><br>Могуће вредности:<br>0 - *(подразумевано)* Текст макро;<br>1 - Тајни макро;<br>2 - Тајна трезора.|
|value|string|Вредност макроа.<br><br>[Понашање својства](/manual/api/reference_commentary#property-behavior):<br>- *само за писање* ако је `type` подешен на "Тајни макро"<br>- *потребно* за операције креирања|

[comment]: # ({/a86faee8-5a3a9f9f})

[comment]: # ({6087909b-2d3baa1d})
#### Конфигурација макроа

Објекат конфигурације макроа дефинише како се макро приказује у [Чаробњаку за домаћина](/manual/config/hosts/host_wizard#configure-host).

|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|type|integer|Тип поља за унос макроа.<br><br>Могуће вредности:<br>0 - Макро се не користи у Чаробњаку за домаћина;<br>1 - Поље за текст;<br>2 - Листа;<br>3 - Поље за потврду.<br><br>[Понашање својства](/manual/api/reference_commentary#property-behavior):<br>- *обавезно*|
|label|string|Ознака за поље за унос макроа.<br><br>[Понашање својства](/manual/api/reference_commentary#property-behavior):<br>- *обавезно* ако је `type` подешен на "Textbox", "List", или "Checkbox"|
|description|text|Текст помоћи који се приказује поред поља за унос макроа. Подржава Markdown форматирање.|
|priority|integer|Позиција поља за унос макроа на листи макроа.<br><br>Ако `priority` није подешено, макро се додаје на крај негруписане листе макроа.|
|required|integer|Означава макро као обавезан.<br><br>Могуће вредности:<br>0 - Није обавезно;<br>1 - Обавезно.<br><br>[Понашање својства](/manual/api/reference_commentary#property-behavior):<br>- *подржано* ако је `type` подешен на "Textbox" или "List"|
|regex|string|Регуларни израз за валидацију корисничког уноса у поље за текст.<br><br>[Понашање својства](/manual/api/reference_commentary#property-behavior):<br>- *подржано* ако је `type` подешен на "Textbox"|
|section\_name|string|Ознака склопивог одељка где је макро груписан.<br><br>Ако `section_name` није подешен, макро се разгрупише. Негруписани макрои се приказују први; груписани макрои се приказују испод, поређани по њиховом `priority` унутар сваког склопивог одељка.|
|options|text|JSON стринг који дефинише ставке листе или вредности поља за потврду.<br><br>За листе: низ објеката са својствима `value` и `text`.<br>Пример: `[{"value": "http", "text": "HTTP"}, {"value": "https", "text": "HTTPS"}]`<br><br>За поља за потврду: објекат са својствима `checked` и `unchecked`.<br>Пример: `{"checked": true, "unchecked": false}`<br><br>[Понашање својства](/manual/api/reference_commentary#property-behavior):<br>- *обавезно* ако је `type` подешено на "Листа" или "Поље за потврду"|

[comment]: # ({/6087909b-2d3baa1d})