GlideElementDynamicAttributeStore : Global

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 8 minutes de lecture

    • L’API GlideElementDynamicAttributeStore fournit des méthodes de script pratiques pour gérer les attributs dynamiques dans l’enregistrement Glide actuel. Utilisez ces méthodes conjointement avec l’API GlideRecord pour obtenir et définir les valeurs d’attributs dynamiques définies.

    Pour utiliser cette API et créer des attributs dynamiques, vous devez disposer du rôle dynamic_schema_writer. Pour lire des données dynamiques à l’aide de cette API, vous devez disposer du rôle dynamic_schema_reader.

    Cette API étend l’API GlideElement : global .

    Pour plus d’informations sur les attributs dynamiques, reportez-vous à la section Dynamic Schema.

    Voir aussi :

    GlideElementDynamicAttributeStore : getDynamicAttribute(String attributePath)

    Renvoie un objet GlideElementDynamicAttribute représentant l’attribut dynamique situé au chemin d’accès de l’attribut dynamique spécifié.

    Tableau 1. Paramètres
    Nom Type Description
    attributePath Chaîne Chemin d’accès d’attribut à utiliser pour localiser l’attribut de schéma dynamique associé.
    Format : « group_name->attr_name »
    • group_name : nom du groupe auquel l’attribut est associé.

      Table : dans le champ Nom de la table Groupe d’attributs dynamiques [dynamic_attribute_group] ou dans le champ Groupe de la table Attributs dynamiques [dynamic_attribute].

    • attr_name : nom de l’attribut dynamique au sein du groupe dynamique.

      Table : dans le champ Nom de la table Attribut dynamique [dynamic_attribute].

    Par exemple : « car->color »
    Tableau 2. Renvoie
    Type Description
    Attribut GlideElementDynamicAttribute Objet contenant les attributs dynamiques spécifiés.

    Si le attributePath paramètre contient des informations non valides, renvoie une valeur null.

    L’exemple de code suivant montre comment appeler cette méthode.

    //Gets all the values of the make attribute from the u_inc_dynamic_schema dynamic attribute store column on the incident table
var gr_Inc = new GlideRecord('incident');
gr_Inc.query();
while(gr_Inc.next()) {
    var attr = gr.getDynamicAttribute('inc_dynamic_schema->cars->make');
    gs.info(attr.getValue());
}

//You can also use if(gr_Inc.next()) if you don't want all the values
var gr_Inc = new GlideRecord('incident');
gr_Inc.query();
if(gr_Inc.next()) {
    var attr = gr_Inc.getDynamicAttribute('inc_dynamic_schema->cars->make');
    gs.info(attr.getValue());
}

    GlideElementDynamicAttributeStore : getDynamicAttributesInStore()

    Renvoie l’ensemble des définitions d’attributs dynamiques présentes et stockées dans un champ.

    Tableau 3. Paramètres
    Nom Type Description
    Aucun
    Tableau 4. Renvoie
    Type Description
    Tableau Tableau d’objets GlideDynamicAttribute ou GlideTransientDynamicAttribute .

    L’exemple suivant montre comment récupérer le contenu d’un attribut dynamique stocké, répertorier les attributs qu’il a stockés et les attributs dans son schéma.

    var record = new GlideRecord('cool_thing');
record.get('number', 'COOL0000005');

gs.info("Store Contents:\n" + JSON.stringify(JSON.parse(record.store1), null, 2) + "\n");
gs.info("Attributes in Store:\n" + record.store1.getDynamicAttributesInStore() + "\n");
gs.info("Attributes in Schema:\n" + record.store1.getDynamicAttributesInSchema() + "\n");

    Sortie :

    *** Script: Store Contents:
{
  "_a": {
    "b": "hello world"
  },
  "_group1": {
    "integer1": "5"
  },
  "_group2": {
    "integer1": "10",
    "string1": "hello"
  }
}

*** Script: Attributes in Store:
a->b,group1->integer1,group2->integer1,group2->string1

*** Script: Attributes in Schema:
group1->integer1,group1->string1,group2->integer1

    GlideElementDynamicAttributeStore : getDynamicAttributesInSchema()

    Renvoie l’ensemble des définitions d’attributs dynamiques pointés dans le schéma.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. Renvoie
    Type Description
    Tableau Tableau d’objets GlideDynamicAttribute ou GlideTransientDynamicAttribute .

    L’exemple suivant montre comment récupérer le contenu d’un attribut dynamique stocké, répertorier les attributs qu’il a stockés et les attributs dans son schéma.

    var record = new GlideRecord('cool_thing');
record.get('number', 'COOL0000005');

gs.info("Store Contents:\n" + JSON.stringify(JSON.parse(record.store1), null, 2) + "\n");
gs.info("Attributes in Store:\n" + record.store1.getDynamicAttributesInStore() + "\n");
gs.info("Attributes in Schema:\n" + record.store1.getDynamicAttributesInSchema() + "\n");

    Sortie :

    *** Script: Store Contents:
{
  "_a": {
    "b": "hello world"
  },
  "_group1": {
    "integer1": "5"
  },
  "_group2": {
    "integer1": "10",
    "string1": "hello"
  }
}

*** Script: Attributes in Store:
a->b,group1->integer1,group2->integer1,group2->string1

*** Script: Attributes in Schema:
group1->integer1,group1->string1,group2->integer1

    GlideElementDynamicAttributeStore : getDynamicAttributeDisplayValue(String attributePath)

    Renvoie la valeur d’affichage de l’attribut dynamique situé sur un chemin d’accès d’attribut spécifié dans un magasin d’attributs dynamiques. Si une valeur d’affichage n’est pas disponible, elle renvoie la valeur interne.

    Tableau 7. Paramètres
    Nom Type Description
    attributePath Chaîne Chemin d’accès d’attribut à utiliser pour localiser l’attribut de schéma dynamique associé.
    Format : « group_name->attr_name »
    • group_name : nom du groupe auquel l’attribut est associé.

      Table : dans le champ Nom de la table Groupe d’attributs dynamiques [dynamic_attribute_group] ou dans le champ Groupe de la table Attributs dynamiques [dynamic_attribute].

    • attr_name : nom de l’attribut dynamique au sein du groupe dynamique.

      Table : dans le champ Nom de la table Attribut dynamique [dynamic_attribute].

    Par exemple : « car->color »
    Tableau 8. Renvoie
    Type Description
    Objet Valeur de l’attribut dynamique associé au format lisible par l’homme.

    Si le attributePath paramètre contient des informations non valides, renvoie une valeur null.

    L’exemple de code suivant montre comment appeler cette méthode.

    //Gets all the display values of the luxury attribute from the inc_dynamic_schema dynamic attribute store column on the incident table
var gr_Inc = new GlideRecord('incident');
gr_Inc.query();
while(gr_Inc.next()) {
    var attr = gr_Inc.getDynamicAttributeDisplayValue('inc_dynamic_schema->cars->luxury');
    gs.info(attr);
}

//You can also use if(gr.next()) if you don't want all the values
var gr_Inc = new GlideRecord('incident');
gr_Inc.query();

if(gr_Inc.next()) {
    var attr = gr_Inc.getDynamicAttributeDisplayValue('inc_dynamic_schema->cars->luxury');
    gs.info(attr);
}

    GlideElementDynamicAttributeStore : getDynamicAttributeValue(String attributePath)

    Renvoie la valeur interne de l’attribut dynamique pointé par un chemin d’attribut transmis dans un magasin d’attributs dynamiques.

    Pour plus d’informations sur les attributs dynamiques, reportez-vous à la section Dynamic Schema.

    Tableau 9. Paramètres
    Nom Type Description
    attributePath Chaîne Chemin d’accès d’attribut à utiliser pour localiser l’attribut de schéma dynamique associé.
    Format : « group_name->attr_name »
    • group_name : nom du groupe auquel l’attribut est associé.

      Table : dans le champ Nom de la table Groupe d’attributs dynamiques [dynamic_attribute_group] ou dans le champ Groupe de la table Attributs dynamiques [dynamic_attribute].

    • attr_name : nom de l’attribut dynamique au sein du groupe dynamique.

      Table : dans le champ Nom de la table Attribut dynamique [dynamic_attribute].

    Par exemple : « car->color »
    Tableau 10. Renvoie
    Type Description
    Objet Valeur de l’attribut dynamique pointé par le chemin d’attribut transmis.

    Si le attributePath paramètre contient des informations non valides, renvoie une valeur null.

    L’exemple de code suivant montre comment appeler cette méthode.

    var gr_Inc = new GlideRecord('incident');
gr_Inc.query();

while(gr_Inc.next()) {
    var attr = gr_Inc.getDynamicAttributeValue('inc_dynamic_schema->cars->luxury');
    gs.info(attr);
}
    Sortie :
    
*** Script: 1

    GlideElementDynamicAttributeStore : setDynamicAttributeValue(String attributePath, valeur d’objet)

    Définit l’attribut pointé par un chemin d’attribut spécifié dans un magasin d’attributs dynamiques sur une valeur spécifiée.

    Pour plus d’informations sur les attributs dynamiques, reportez-vous à la section Dynamic Schema.

    Tableau 11. Paramètres
    Nom Type Description
    attributePath Chaîne Chemin d’accès d’attribut à utiliser pour localiser l’attribut de schéma dynamique associé.
    Format : « group_name->attr_name »
    • group_name : nom du groupe auquel l’attribut est associé.

      Table : dans le champ Nom de la table Groupe d’attributs dynamiques [dynamic_attribute_group] ou dans le champ Groupe de la table Attributs dynamiques [dynamic_attribute].

    • attr_name : nom de l’attribut dynamique au sein du groupe dynamique.

      Table : dans le champ Nom de la table Attribut dynamique [dynamic_attribute].

    Par exemple : « car->color »
    valide Objet Valeur à définir dans l’attribut spécifié.
    Remarque :
    Pour les attributs dynamiques, seuls les types de données suivants sont pris en charge :
    • Booléen (vrai/faux)
    • Décimal
    • Nombre à virgule flottante
    • Date GlideDate
    • GlideDateTime
    • Entier
    • Chaîne
    Tableau 12. Renvoie
    Type Description
    Magasin GlideElementDynamicAttributeStore Renvoie un objet GlideElementDynamicAttributeStore contenant la valeur spécifiée.

    Si le groupAttributePath paramètre contient des informations non valides, l’attribut n’est pas mis à jour.

    L’exemple de code suivant montre comment appeler cette méthode.

    //This simple example inserts a make attribute on the inc_dynamic_schema column where the value of the make attribute is Ford.
var gr_Inc = new GlideRecord('incident');
gr_Inc.setDynamicAttributeValue('inc_dynamic_schema->cars->make', 'Ford');
gr_Inc.insert();

    GlideElementDynamicAttributeStore : setDynamicAttributeValues(valeurs GlideDynamicAttributeStore)

    Définit les valeurs spécifiées dans l’objet GlideElementDynamicAttrbuteStore transmis dans le magasin d’attributs dynamiques de l’élément GlideRecord actuel. Le type de données de l’élément actuel doit être défini sur Magasin d’attributs dynamiques.

    Pour plus d’informations sur les attributs dynamiques, reportez-vous à la section Dynamic Schema.

    Tableau 13. Paramètres
    Nom Type Description
    valeurs Magasin GlideDynamicAttributeStore Objet contenant les valeurs à définir dans le schéma dynamique de l’élément actuel. Les valeurs non spécifiées dans cet objet ne sont pas mises à jour.
    Tableau 14. Renvoie
    Type Description
    Magasin GlideElementDynamicAttributeStore Objet GlideElementDynamicAttributeStore mis à jour.

    L’exemple de code suivant montre comment appeler cette méthode.

    var gr_Inc = new GlideRecord('incident');
var das = new GlideDynamicAttributeStore();
das.setDynamicAttributeValue("cars->color", "black");
das.setDynamicAttributeValue("cars->make","Honda");
das.setDynamicAttributeValue("cars->model","CRV");
gr_Inc.setDynamicAttributeValues('inc_dynamic_schema', das);
gr_Inc.insert();

    Cet exemple de code insère ce qui suit dans la colonne u_inc_dynamic_schema :

    {
  "cars" : {
    "color" : "black",
    "make" : "Honda",
    "model" : "CRV"
  }
}

    GlideElementDynamicAttributeStore : setDynamicAttributeDisplayValue(String attributePath)

    Définit la valeur d’affichage de l’attribut dynamique situé à un chemin spécifié dans le magasin d’attributs dynamiques de l’élément GlideRecord actuel.

    Tableau 15. Paramètres
    Nom Type Description
    attributePath Chaîne Chemin d’accès d’attribut à utiliser pour localiser l’attribut de schéma dynamique associé.
    Format : « group_name->attr_name »
    • group_name : nom du groupe auquel l’attribut est associé.

      Table : dans le champ Nom de la table Groupe d’attributs dynamiques [dynamic_attribute_group] ou dans le champ Groupe de la table Attributs dynamiques [dynamic_attribute].

    • attr_name : nom de l’attribut dynamique au sein du groupe dynamique.

      Table : dans le champ Nom de la table Attribut dynamique [dynamic_attribute].

    Par exemple : « car->color »
    valide Objet Valeur à définir dans l’élément d’attribut dynamique actuel.
    La valeur transmise doit être de l’un des types de données suivants :
    • Booléen (vrai/faux)
    • Décimal
    • Nombre à virgule flottante
    • Date GlideDate
    • GlideDateTime
    • Entier
    • Chaîne
    Tableau 16. Renvoie
    Type Description
    Magasin GlideElementDynamicAttributeStore Objet contenant l’élément Glide mis à jour.

    L’exemple de code suivant montre comment appeler cette méthode.

    var grFleet = new GlideRecord('u_car_fleet');
grFleet.setDynamicAttributeValue('u_dyn_attr_store', 'car->color', 'Yellow');
grFleet.setDynamicAttributeValue('u_dyn_attr_store', 'car->make', 'Ford');
var sysId = grFleet.insert();
gs.info("Inserted: " + grFleet.u_dyn_attr_store);

var daStore = new GlideDynamicAttributeStore();
daStore.setDynamicAttributeValue('car->color', 'Green');
daStore.setDynamicAttributeValue('car->model', 'Bronco');

var geDynAttrStore = grFleet.getElement('u_dyn_attr_store');
geDynAttrStore.setDynamicAttributeDisplayValues(daStore);
grFleet.update();
gs.info("Updated:  " + grFleet.u_dyn_attr_store);

    Sortie :

    *** Script: Inserted: {"car":{"color":"Yellow","make":"Ford"}}
*** Script: Updated:  {"car":{"color":"Green","make":"Ford","model":"Bronco"}}

    L’exemple de code suivant montre comment une valeur d’affichage booléenne est stockée sous la forme « 1 », mais est renvoyée en tant que « vrai ».

     var gr_Inc = new GlideRecord('incident');
gr_Inc.setDynamicAttributeDisplayValue('u_inc_dynamic_schema->u_cars->u_luxury', '1');
gr_Inc.insert()

    Valeur renvoyée :

    {
  "u_cars" : {
    "u_luxury" : "true"
  }
}

    GlideElementDynamicAttributeStore : setDynamicAttributeDisplayValues (valeurs GlideDynamicAttributeStore)

    Définit les valeurs d’affichage spécifiées dans l’objet GlideDynamicAttrbuteStore transmis dans les attributs dynamiques de l’élément GlideRecord actuel. Le type de données de l’élément actuel doit être défini sur Magasin d’attributs dynamiques dans la table associée.

    Tableau 17. Paramètres
    Nom Type Description
    valeurs Magasin GlideDynamicAttributeStore Objet qui contient les valeurs d’affichage à définir dans le magasin d’attributs dynamiques de l’élément actuel. Les valeurs d’affichage non spécifiées dans cet objet ne sont pas mises à jour. Cet objet doit contenir à la fois le chemin de l’attribut et la valeur d’affichage pour chaque attribut à stocker.
    Par exemple :
    {
  "car":{
    "color":"Blue",
    "make":"Ford",
    "model":"Mustang"
  }
}
    Tableau 18. Renvoie
    Type Description
    Magasin GlideElementDynamicAttributeStore Objet contenant l’élément Glide mis à jour.

    L’exemple de code suivant montre comment appeler cette méthode.

    var daStore = new GlideDynamicAttributeStore();
daStore.setDynamicAttributeValue('car->make', 'Ford');
daStore.setDynamicAttributeValue('car->model', 'Mustang');
daStore.setDynamicAttributeValue('car->color', 'Blue');
gs.info("daStore: " + daStore);

var gr_Car = new GlideRecord('u_car_fleet');
gr_Car.query();
while(gr_Car.next()) {
  var glideElement = gr_Car.getElement('u_dyn_attr_store');
  glideElement.setDynamicAttributeValues(daStore);
  gr_Car.update();
}