1 Format des Datenpunktschlüssels
Das Format des Datenpunktschlüssels, einschließlich der Schlüsselparameter, muss den Syntaxregeln entsprechen. Die folgenden Abbildungen zeigen die unterstützte Syntax. Zulässige Elemente und Zeichen an jeder Stelle können durch Verfolgen der Pfeile bestimmt werden – wenn ein Block über die Linie erreicht werden kann, ist er zulässig, andernfalls ist er nicht zulässig.
Um einen gültigen Datenpunktschlüssel zu erstellen, beginnt man mit der Angabe des Schlüsselnamens. Anschließend kann gewählt werden, ob Parameter verwendet werden oder nicht – wie durch die zwei Linien dargestellt, denen gefolgt werden kann.
Schlüsselname
Der Schlüsselname selbst hat einen begrenzten Bereich zulässiger Zeichen, die einfach aufeinander folgen. Zulässige Zeichen sind:
0-9a-zA-Z_-.Das bedeutet:
- alle Zahlen;
- alle Kleinbuchstaben;
- alle Großbuchstaben;
- Unterstrich;
- Bindestrich;
- Punkt.
Schlüsselparameter
Ein Datenpunktschlüssel kann mehrere Parameter haben, die durch Kommas getrennt sind.
Jeder Schlüsselparameter kann entweder eine Zeichenfolge in Anführungszeichen, eine Zeichenfolge ohne Anführungszeichen oder ein Array sein.
Der Parameter kann auch leer gelassen werden, sodass der Standardwert verwendet wird. In diesem Fall muss die entsprechende Anzahl von Kommas hinzugefügt werden, wenn weitere Parameter angegeben werden. Zum Beispiel würde der Datenpunktschlüssel icmpping[,,200,,500] festlegen, dass das Intervall zwischen einzelnen Pings 200 Millisekunden beträgt, das Timeout 500 Millisekunden, und alle anderen Parameter auf ihren Standardwerten belassen werden.
Es ist möglich, Makros in die Parameter einzuschließen. Dabei kann es sich um Benutzermakros oder einige der integrierten Makros handeln. Um zu sehen, welche integrierten Makros in Datenpunktschlüsselparametern unterstützt werden, suchen Sie auf der Seite Unterstützte Makros nach „item key parameters“.
Parameter – Zeichenkette in Anführungszeichen
Wenn der Schlüsselparameter eine Zeichenkette in Anführungszeichen ist, sind beliebige Unicode-Zeichen zulässig. Wenn die Zeichenkette des Schlüsselparameters ein Anführungszeichen enthält, muss dieser Parameter in Anführungszeichen gesetzt werden, und jedes Anführungszeichen, das Teil der Parameterzeichenkette ist, muss mit einem Backslash-Zeichen (\) maskiert werden. Wenn die Zeichenkette des Schlüsselparameters ein Komma enthält, muss dieser Parameter in Anführungszeichen gesetzt werden.
Verwenden Sie zum Setzen von Anführungszeichen bei Datenpunkt-Schlüsselparametern ausschließlich doppelte Anführungszeichen. Einfache Anführungszeichen werden nicht unterstützt.
Mehrstufige Parameter-Arrays, z. B.
[a,[b,[c,d]],e], sind nicht zulässig.
Parameter - nicht in Anführungszeichen gesetzte Zeichenkette
Wenn der Schlüsselparameter eine nicht in Anführungszeichen gesetzte Zeichenkette ist, ist jedes Unicode-Zeichen zulässig, außer Komma und schließender eckiger Klammer (]). Ein nicht in Anführungszeichen gesetzter Parameter darf nicht mit einer öffnenden eckigen Klammer ([) beginnen.
Parameter - array
Wenn der Schlüsselparameter ein Array ist, wird es erneut in eckige Klammern gesetzt, wobei die einzelnen Parameter den Regeln und der Syntax für die Angabe mehrerer Parameter entsprechen.
