[comment]: # translation:outdated

[comment]: # ({856c911b-856c911b})
# 1 Format klucza pozycji

Format klucza pozycji, w tym parametry klucza, musi być zgodny z regułami składni. Poniższe ilustracje przedstawiają obsługiwaną składnię. Dozwolone elementy
i znaki w każdym miejscu można określić, podążając za strzałkami —
jeśli do jakiegoś bloku można dotrzeć po linii, jest on dozwolony, jeśli nie —
nie jest dozwolony.

![](../../../../../assets/en/manual/config/item_key_2.png){width="600"}

Aby utworzyć prawidłowy klucz pozycji, należy zacząć od określenia nazwy klucza,
następnie można wybrać, czy mają występować parametry, czy nie — jak pokazano
przez dwie linie, którymi można podążać.

[comment]: # ({/856c911b-856c911b})

[comment]: # ({63ccf8e4-63ccf8e4})
#### Nazwa klucza

Sama nazwa klucza ma ograniczony zakres dozwolonych znaków, które
mogą występować jeden po drugim. Dozwolone znaki to:

    0-9a-zA-Z_-.

Co oznacza:

-   wszystkie cyfry;
-   wszystkie małe litery;
-   wszystkie wielkie litery;
-   podkreślenie;
-   myślnik;
-   kropka.

![](../../../../../assets/en/manual/config/key_name.png)

[comment]: # ({/63ccf8e4-63ccf8e4})

[comment]: # ({7262f26f-af5ae7f1})
#### Kluczowe parametry

Klucz pozycji może mieć wiele parametrów oddzielonych przecinkami.

![](../../../../../assets/en/manual/config/key_parameters.png)

Każdy parametr klucza może być ujętym w cudzysłów ciągiem znaków, ciągiem znaków bez cudzysłowów albo
tablicą.

![](../../../../../assets/en/manual/config/item_parameter.png)

Parametr można również pozostawić pusty, używając w ten sposób wartości domyślnej. W
takim przypadku należy dodać odpowiednią liczbę przecinków, jeśli określono
jakiekolwiek dalsze parametry. Na przykład klucz pozycji
**icmpping\[,,200,,500\]** oznacza, że interwał między
poszczególnymi pingami wynosi 200 milisekund, limit czasu - 500 milisekund,
a wszystkie pozostałe parametry pozostają ustawione na wartości domyślne.

Możliwe jest użycie makr w parametrach. Mogą to być [makra użytkownika](/manual/appendix/macros/supported_by_location_user#items-item-prototypes) lub niektóre z wbudowanych makr.
Aby sprawdzić, które konkretne wbudowane makra są obsługiwane w parametrach klucza pozycji,
wyszukaj na stronie [Obsługiwane makra](/manual/appendix/macros/supported_by_location) frazę „item key parameters”.

[comment]: # ({/7262f26f-af5ae7f1})

[comment]: # ({816c672d-b4a70ec9})
#### Parametr - ciąg znaków w cudzysłowie

Jeśli parametr klucza jest ciągiem znaków ujętym w cudzysłów, dozwolony jest dowolny znak Unicode. Jeśli ciąg parametru klucza zawiera znak cudzysłowu, parametr ten musi być ujęty w cudzysłów, a każdy cudzysłów będący częścią ciągu parametru musi zostać poprzedzony znakiem ukośnika odwrotnego (`\`). Jeśli ciąg parametru klucza zawiera przecinek, parametr ten musi być ujęty w cudzysłów.

![](../../../../../assets/en/manual/config/key_param_quoted_string.png)

::: notewarning
Do ujmowania parametrów klucza pozycja w cudzysłów używaj wyłącznie podwójnych cudzysłowów. Pojedyncze cudzysłowy nie są obsługiwane.
:::

::: noteimportant
Wielopoziomowe tablice parametrów, np.
`[a,[b,[c,d]],e]`, nie są dozwolone.
:::

[comment]: # ({/816c672d-b4a70ec9})

[comment]: # ({3376836e-3376836e})
#### Parametr - ciąg znaków bez cudzysłowu

Jeśli parametr klucza jest ciągiem znaków bez cudzysłowu, dozwolony jest dowolny znak Unicode
z wyjątkiem przecinka i prawego nawiasu kwadratowego (\]). Parametr bez cudzysłowu
nie może zaczynać się od lewego nawiasu kwadratowego (\[).

![](../../../../../assets/en/manual/config/key_param_unquoted_string.png)

[comment]: # ({/3376836e-3376836e})

[comment]: # ({43e6bef7-5289a973})
#### Parametr - array

Jeśli parametr klucza jest tablicą, jest on ponownie ujmowany w nawiasy
kwadratowe, gdzie poszczególne parametry są zgodne z zasadami i
składnią określania wielu parametrów.

![](../../../../../assets/en/manual/config/key_param_array.png)

[comment]: # ({/43e6bef7-5289a973})