graphitem.get

Beschreibung

integer/array graphitem.get(object parameters)

Mit dieser Methode können Graph-Datenpunkte entsprechend den angegebenen Parametern abgerufen werden.

Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object) Parameter, die die gewünschte Ausgabe definieren.

Die Methode unterstützt die folgenden Parameter.

Parameter Type Beschreibung
graphids ID/array Gibt nur Graph-Datenpunkte zurück, die zu den angegebenen Graphen gehören.
itemids ID/array Gibt nur Graph-Datenpunkte mit den angegebenen Datenpunkt-IDs zurück.
type integer Gibt nur Graph-Datenpunkte mit dem angegebenen Typ zurück.

Eine Liste der unterstützten Typen von Graph-Datenpunkten finden Sie auf der Seite zum Graph-Datenpunkt-Objekt.
selectGraphs query Gibt eine Eigenschaft graphs mit einem Array von Graphen zurück, zu denen der Datenpunkt gehört.
sortfield string/array Sortiert das Ergebnis nach den angegebenen Eigenschaften.

Mögliche Werte: gitemid.
countOutput boolean Diese Parameter werden in der Referenzkommentierung beschrieben.
editable boolean
limit integer
output query
preservekeys boolean
sortorder string/array

Rückgabewerte

(integer/array) Kann die folgenden Dinge zurück geben:

  • ein Array von Objekten;
  • die Anzahl der abgerufenen Objekte, wenn der Parameter countOutput verwendet wurde.

Beispiele

Abrufen von Graph-Datenpunkten aus einem Graphen

Rufen Sie alle in einem Graphen verwendeten Graph-Datenpunkte mit zusätzlichen Informationen über den Datenpunkt und den Host ab.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "graphitem.get",
    "params": {
        "output": "extend",
        "graphids": "387"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "gitemid": "1242",
            "graphid": "387",
            "itemid": "22665",
            "drawtype": "1",
            "sortorder": "1",
            "color": "FF5555",
            "yaxisside": "0",
            "calc_fnc": "2",
            "type": "0"
        },
        {
            "gitemid": "1243",
            "graphid": "387",
            "itemid": "22668",
            "drawtype": "1",
            "sortorder": "2",
            "color": "55FF55",
            "yaxisside": "0",
            "calc_fnc": "2",
            "type": "0"
        },
        {
            "gitemid": "1244",
            "graphid": "387",
            "itemid": "22671",
            "drawtype": "1",
            "sortorder": "3",
            "color": "009999",
            "yaxisside": "0",
            "calc_fnc": "2",
            "type": "0"
        }
    ],
    "id": 1
}

Siehe auch

Quelle

CGraphItem::get() in ui/include/classes/api/services/CGraphItem.php.