screenitem.updatebyposition

Description

object screenitem.updatebyposition(array screenItems)

Cette méthode permet de mettre à jour les éléments d'écran dans les cellules d'écran données. Si une cellule est vide, un nouvel élément d'écran sera créé.

Paramètres

(array) Propriétés d'élément d'écran à mettre à jour.

Les propriétés '' x '', '' y '' et '' screenid '' doivent être définies pour chaque élément d'écran, toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.

Valeurs retournées

(object) Renvoie un objet contenant les identifiants des éléments d'écran mis à jour et créés sous la propriété screenitemids.

Exemples

Modification d'un ID de ressource d'éléments d'écran

Modifier l'ID de la ressource pour l'élément d'écran situé dans la cellule supérieure gauche de l'écran.

Requête :

{
           "jsonrpc": "2.0",
           "method": "screenitem.updatebyposition",
           "params": [
               {
                   "screenid": "16",
                   "x": 0,
                   "y": 0,
                   "resourceid": "644"
               }
           ],
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": {
               "screenitemids": [
                   "66"
               ]
           },
           "id": 1
       }

Voir également

• screenitem.update

Source

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