[comment]: # ({a7557797-a7557797})
# trigger.update

[comment]: # ({/a7557797-a7557797})

[comment]: # ({e2868f8f-684473f9})
### Description

`object trigger.update(object/array triggers)`

Cette méthode permet de mettre à jour les déclencheurs existants.

[comment]: # ({/e2868f8f-684473f9})

[comment]: # ({118dcce0-a40f63c4})
### Paramètres

`(object/array)` Propriétés des déclencheurs à mettre à jour.

La propriété `triggerid` doit être définie pour chaque déclencheur.
Toutes les autres propriétés sont facultatives. Seules les propriétés
transmises seront mises à jour, toutes les autres resteront inchangées.

En plus des [propriétés du déclencheur
standard](/fr/manual/api/reference/trigger/object#declencheur), la
méthode accepte les paramètres suivants.

|Paramètre|Type|Description|
|----------|----|-----------|
|dependencies|array|Déclencheurs dont dépend le déclencheur.<br><br>La propriété `triggerid` doit être définie pour les déclencheurs.|
|tags|array|Tags des déclencheurs.|

::: noteimportant
L'expression de déclenchement doit être donnée
sous sa forme développée.
:::

[comment]: # ({/118dcce0-a40f63c4})

[comment]: # ({6fdc6fa6-18d0cc04})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des déclencheurs
mis à jour sous la propriété `triggerids`.

[comment]: # ({/6fdc6fa6-18d0cc04})

[comment]: # ({88e43968-b41637d2})
### Exemples

[comment]: # ({/88e43968-b41637d2})

[comment]: # ({6d360a28-07c64481})
#### Activer un déclencheur

Activer un déclencheur, c’est-à-dire définir son statut à 0.

Requête :

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "trigger.update",
    "params": {
        "triggerid": "13938",
        "status": 0
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

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

[comment]: # ({/6d360a28-07c64481})

[comment]: # ({0ac9712f-b2bab7ce})
#### Remplacement des tags des déclencheurs

Remplacement des tags des déclencheurs.

Requête :

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

Réponse :

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

[comment]: # ({/0ac9712f-b2bab7ce})

[comment]: # ({b4be4fc3-680d73bb})
### Voir également

-   [trigger.adddependencies](/fr/manual/api/reference/trigger/adddependencies)
-   [trigger.deletedependencies](/fr/manual/api/reference/trigger/deletedependencies)

[comment]: # ({/b4be4fc3-680d73bb})

[comment]: # ({0c819bd2-2afbfbeb})
### Source

CTrigger::update() dans
*frontends/php/include/classes/api/services/CTrigger.php*.

[comment]: # ({/0c819bd2-2afbfbeb})