Documentation
Table of Contents
1 Indeling van item-sleutel
De indeling van een item-sleutel, inclusief sleutelparameters, moet de syntaxisregels volgen. De volgende illustraties geven de ondersteunde syntaxis weer. Toegestane elementen en tekens op elk punt kunnen worden bepaald door de pijlen te volgen - als een bepaald blok via de lijn kan worden bereikt, is het toegestaan, zo niet, dan is het niet toegestaan.
Om een geldige item-sleutel te construeren, begint men met het specificeren van de sleutelnaam, daarna is er de keuze om al dan niet parameters te hebben - zoals afgebeeld door de twee lijnen die gevolgd kunnen worden.
Sleutelnaam
De sleutelnaam zelf heeft een beperkt bereik van toegestane tekens die elkaar direct opvolgen. Toegestane tekens zijn:
Wat betekent:
- alle cijfers;
- alle kleine letters;
- alle hoofdletters;
- liggend streepje (underscore);
- streepje (dash);
- punt.
Sleutelparameters
Een item sleutel kan meerdere parameters hebben die door komma's worden gescheiden.
Elke sleutelparameter kan een geciteerde tekenreeks, een niet-geciteerde tekenreeks of een reeks zijn.
De parameter kan ook leeg worden gelaten, waarbij de standaardwaarde wordt gebruikt. In dat geval moeten indien verdere parameters worden gespecificeerd, het juiste aantal komma's worden toegevoegd. Bijvoorbeeld, item sleutel icmpping[,,200,,500] zou aangeven dat het interval tussen individuele pings 200 milliseconden is, de time-out 500 milliseconden is, en alle andere parameters worden op hun standaardwaarden gelaten.
Het is mogelijk om macro's op te nemen in de parameters. Dit kunnen gebruikersmacro's zijn of enkele van de ingebouwde macro's. Om te zien welke specifieke ingebouwde macro's worden ondersteund in item sleutelparameters, zoek op de pagina Ondersteunde macro's naar "item sleutelparameters".
Parameter - geciteerde tekenreeks
Als de sleutelparameter een geciteerde tekenreeks is, is elk Unicode-teken toegestaan. Als de geciteerde tekenreekssleutelparameter een aanhalingsteken bevat, moet deze parameter worden geciteerd, en elk aanhalingsteken dat deel uitmaakt van de parameterreeks moet worden ontsnapt met een schuine streep (\) teken. Als de geciteerde tekenreekssleutelparameter een komma bevat, moet deze parameter worden geciteerd.
Gebruik alleen dubbele aanhalingstekens om item sleutelparameters tussen aanhalingstekens te plaatsen. Enkele aanhalingstekens worden niet ondersteund.
Parameter - niet tussen aanhalingstekens geplaatste string
Als de sleutelparameter een niet tussen aanhalingstekens geplaatste string is, is elk Unicode-teken toegestaan, behalve komma en rechte haak (]). Een niet tussen aanhalingstekens geplaatste parameter kan niet beginnen met een linker haak ([).
Parameter - array
Als de sleutelparameter een array is, wordt deze opnieuw tussen vierkante haken geplaatst, waarbij individuele parameters overeenkomen met de regels en syntaxis voor het specificeren van meerdere parameters.
Multi-level parameter arrays, bijv. [a,[b,[c,d]],e], zijn niet toegestaan.