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/array) Propiedades del trigger a actualizar.
La propiedad triggerid debe definirse para cada trigger, todas las demás propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, todas las demás permanecerán sin cambios.
Además de las propiedades estándar del trigger, el método acepta los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| dependencies | array | Triggers de los que depende el trigger. Los triggers deben tener definida sólo la propiedad triggerid. |
| tags | array | Etiquetas de trigger. |
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".
{
"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.
{
"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.
{
"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.