[comment]: # translation:outdated

[comment]: # aside:1

[comment]: # ({ee4a2645-28092341})
# Obiekt makra użytkownika

Następujące obiekty są bezpośrednio powiązane z API `usermacro`.

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

[comment]: # ({0a76e75e-e654cd12})
### Makro globalne

Obiekt makra globalnego ma następujące właściwości.

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|globalmacroid|ID|ID makra globalnego.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*<br>- *wymagane* dla operacji aktualizacji|
|description|string|Opis makra.|
|macro|string|Ciąg makra.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|type|integer|Typ makra.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Makro tekstowe;<br>1 - Makro sekretne;<br>2 - Sekret Vault.|
|value|string|Wartość makra.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do zapisu*, jeśli `type` jest ustawione na „Makro sekretne”<br>- *wymagane* dla operacji tworzenia|

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

[comment]: # ({52a5aa5d-5a3a9f9f})
### Makro hosta

Obiekt makra hosta definiuje makro dostępne na hoście, prototypie hosta lub szablonie. Ma następujące właściwości.

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|hostmacroid|ID|ID makra.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*<br>- *wymagane* dla operacji aktualizacji|
|automatic|integer|Określa, czy makro jest kontrolowane przez regułę wykrywania.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Makro jest zarządzane przez użytkownika;<br>1 - Makro jest zarządzane przez regułę wykrywania.<br><br>Użytkownik nie może tworzyć automatycznego makra.<br>Aby zaktualizować automatyczne makro, musi ono zostać [przekształcone na ręczne](/manual/api/reference/usermacro/update#change-macro-value-that-was-created-by-discovery-rule).|
|config|object/array|[Konfiguracja makra](#macro-configuration) odpowiedzialna za sposób wyświetlania makra w [Kreatorze hosta](/manual/config/hosts/host_wizard#configure-host).|
|description|string|Opis makra.|
|hostid|ID|ID hosta, prototypu hosta lub szablonu, do którego należy makro.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *stała*<br>- *wymagane* dla operacji tworzenia|
|macro|string|Ciąg makra.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|type|integer|Typ makra.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Makro tekstowe;<br>1 - Makro tajne;<br>2 - Sekret z magazynu.|
|value|string|Wartość makra.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do zapisu*, jeśli `type` jest ustawione na „Makro tajne”<br>- *wymagane* dla operacji tworzenia|

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

[comment]: # ({17133911-2d3baa1d})
#### Konfiguracja makr

Obiekt konfiguracji makr definiuje sposób wyświetlania makra w [Kreatorze hosta](/manual/config/hosts/host_wizard#configure-host).

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|type|integer|Typ pola wejściowego makra.<br><br>Możliwe wartości:<br>0 - Makro nie jest używane w Kreatorze hosta;<br>1 - Pole tekstowe;<br>2 - Lista;<br>3 - Pole wyboru.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|label|string|Etykieta pola wejściowego makra.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na „Pole tekstowe”, „Lista” lub „Pole wyboru”|
|description|text|Tekst pomocy wyświetlany obok pola wejściowego makra. Obsługuje formatowanie Markdown.|
|priority|integer|Pozycja pola wejściowego makra na liście makr.<br><br>Jeśli `priority` nie jest ustawione, makro jest dodawane na końcu listy niepogrupowanych makr.|
|required|integer|Oznacza makro jako obowiązkowe.<br><br>Możliwe wartości:<br>0 - Nieobowiązkowe;<br>1 - Obowiązkowe.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na „Pole tekstowe” lub „Lista”|
|regex|string|Wyrażenie regularne służące do walidacji danych wejściowych użytkownika w polu tekstowym.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na „Pole tekstowe”|
|section\_name|string|Etykieta zwijanej sekcji, w której makro jest grupowane.<br><br>Jeśli `section_name` nie jest ustawione, makro nie jest grupowane. Niepogrupowane makra są wyświetlane jako pierwsze; pogrupowane makra są wyświetlane poniżej, uporządkowane według ich `priority` w obrębie każdej zwijanej sekcji.|
|options|text|Ciąg JSON definiujący elementy listy lub wartości pola wyboru.<br><br>Dla list: tablica obiektów z właściwościami `value` i `text`.<br>Przykład: `[{"value": "http", "text": "HTTP"}, {"value": "https", "text": "HTTPS"}]`<br><br>Dla pól wyboru: obiekt z właściwościami `checked` i `unchecked`.<br>Przykład: `{"checked": true, "unchecked": false}`<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na „Lista” lub „Pole wyboru”|

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