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.

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ć.

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.

Kluczowe parametry

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

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ą.

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 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 frazę „item key parameters”.

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.

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.

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

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 ([).

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.