trigger.update

Opis

object trigger.update(object/array triggers)

Ta metoda umożliwia aktualizację istniejących wyzwalaczy.

Ta metoda jest dostępna wyłącznie dla typów użytkowników Admin i Super admin. Uprawnienia do wywoływania tej metody można odebrać w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.

Parametry

(object/array) Właściwości wyzwalacza do zaktualizowania.

Właściwość triggerid musi być zdefiniowana dla każdego wyzwalacza, wszystkie pozostałe właściwości są opcjonalne. Zaktualizowane zostaną tylko przekazane właściwości, wszystkie pozostałe pozostaną bez zmian.

Oprócz standardowych właściwości wyzwalacza metoda akceptuje następujące parametry.

Parametr Type Opis
dependencies array Wyzwalacze, od których zależy wyzwalacz.

W wyzwalaczach musi być zdefiniowana tylko właściwość triggerid.
tags array Tagi wyzwalacza.

Wartości zwracane

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych wyzwalaczy we właściwości triggerids.

Przykłady

Włączanie wyzwalacza

Włącz wyzwalacz, czyli ustaw jego status na „0”.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "trigger.update",
    "params": {
        "triggerid": "13938",
        "status": 0
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "triggerids": [
            "13938"
        ]
    },
    "id": 1
}

Zastępowanie tagów wyzwalacza

Zastąp tagi dla wyzwalacza.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "trigger.update",
    "params": {
        "triggerid": "13938",
        "tags": [
            {
                "tag": "service",
                "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"
            },
            {
                "tag": "error",
                "value": ""
            }
        ]
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "triggerids": [
            "13938"
        ]
    },
    "id": 1
}

Zastępowanie zależności

Zastąp zależności dla wyzwalacza.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "trigger.update",
    "params": {
        "triggerid": "22713",
        "dependencies": [
            {
                "triggerid": "22712"
            },
            {
                "triggerid": "22772"
            }
        ]
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "triggerids": [
            "22713"
        ]
    },
    "id": 1
}

Źródło

CTrigger::update() w ui/include/classes/api/services/CTrigger.php.