trigger.update

Descripción

object trigger.update(object/array triggers)

Este método permite actualizar los iniciadores existentes.

Este método solo está disponible para los tipos de usuario Administrador y Superadministrador. Los permisos para llamar al método se pueden revocar en la configuración del rol de usuario. Ver Roles de usuario para obtener más información.

Parámetros

(objeto/matriz) Propiedades del activador que se actualizarán.

La propiedad triggerid debe definirse para cada activador, todos los demás Las propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, todas otros permanecerán sin cambios.

Además de las propiedades estándar del disparador el El método acepta los siguientes parámetros.

Parámetro Tipo Descripción
dependencias array Disparadores del que depende el disparador.

Los disparadores deben tener solo la propiedad triggerid definida.
etiquetas matriz Etiquetas de activación.

::: nota importante La expresión desencadenante debe darse en su forma expandida. :::

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de los iniciadores actualizados bajo la propiedad triggerids.

Ejemplos

Habilitar un iniciador

Habilite un iniciador, es decir, establezca su estado en "0".

Solicitud:

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

Respuesta:

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

Reemplazo de etiquetas del iniciador

Reemplace las etiquetas del iniciador.

Solicitud:

{
    "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
}

Respuesta:

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

Reemplazo de dependencias

Reemplace las dependencias para el iniciador.

Solicitud:

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

Respuesta:

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

Fuente

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