CatalogItemVariableSetM2M : inclus dans le périmètre

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture

    • L’API CatalogItemVariableSetM2M vous permet de créer et de modifier un jeu de variables d’éléments de catalogue de services plusieurs à plusieurs (M2M) à l’aide de scripts.

    Cette API s’exécute dans l’espace de noms sn_sc .

    CatalogItemVariableSetM2M : créer (standardUpdate booléen)

    Insère le jeu de variables d’élément de catalogue défini M2M.

    Tableau 1. Paramètres
    Nom Type Description
    standardUpdate (mise à jour standard) Booléen Marqueur indiquant si l’exécution des moteurs et du workflow doit être activée.
    Valeurs valides :
    • true : activez les moteurs et le workflow.
    • false : n’activez pas les moteurs et le workflow.
    Tableau 2. Renvoie
    Type Description
    Chaîne Sys_id de l’enregistrement de variable inséré.

    Cet exemple ajoute le jeu de variables Standard Employee Questions à l’élément de catalogue iPhone 6s et crée un enregistrement les liant dans la table Jeux de variables de catalogue [io_set_item].

    var cat_item_sys_id = 'bd6fa75a4f334200086eeed18110c79e'; // catalog item - iPhone 6s
var variable_set_sys_id = 'e01cab1a4f334200086eeed18110c71f'; // variable set - Standard Employee Questions
var app_scope = 'global'; // sys_id id in case of scoped app
var varset = new sn_sc.CatalogItemVariableSetM2M();
var attr = {
    'variable_set': variable_set_sys_id, // required
    'sc_cat_item': cat_item_sys_id, // required
    'sys_scope': app_scope, // optional
    'order': 10 // optional
};
varset.setAttributes(attr);
var m2mRec = varset.create(true);
gs.info('Variable set added to catalog item and M2M record created in table io_set_item with sys_id ' + m2mRec);

    Sortie :

    Variable set added to catalog item and M2M record created in table io_set_item with sys_id c5c87af187eb30103a730f2d0ebb3578

    CatalogItemVariableSetM2M : deleteRecord(Boolean standardUpdate)

    Supprime le jeu de variables d’éléments de catalogue défini M2M.

    Tableau 3. Paramètres
    Nom Type Description
    standardUpdate (mise à jour standard) Booléen Marqueur indiquant si l’exécution des moteurs et du workflow doit être activée.
    Valeurs valides :
    • true : activez les moteurs et le workflow.
    • false : n’activez pas les moteurs et le workflow.
    Tableau 4. Renvoie
    Type Description
    nul

    Cet exemple supprime le jeu de variables Questions des employés standard de l’élément de catalogue iPhone 6s et supprime l’enregistrement qui les lie dans la table Jeux de variables de catalogue [io_set_item].

    var vset = new GlideRecord('io_set_item');
vset.addQuery('sc_cat_item', 'bd6fa75a4f334200086eeed18110c79e'); // catalog item - iPhone 6s
vset.addQuery('variable_set', 'e01cab1a4f334200086eeed18110c71f'); // variable set - Standard Employee Questions
vset.query();
if (vset.next()) {
    var varset = new sn_sc.CatalogItemVariableSetM2M(vset.getUniqueValue()); // pass sys_id of io_set_item record
    varset.deleteRecord(true);  
}

    CatalogItemVariableSetM2M - read(Colonnes d’objets, booléen standardUpdate)

    Renvoie un mappage des valeurs d’attribut M2M du jeu de variables d’éléments de catalogue.

    Tableau 5. Paramètres
    Nom Type Description
    colonnes Objet Ensemble de colonnes pour lesquelles vous souhaitez obtenir les valeurs.
    standardUpdate (mise à jour standard) Booléen Marqueur indiquant si l’exécution des moteurs et du workflow doit être activée.
    Valeurs valides :
    • true : activez les moteurs et le workflow.
    • false : n’activez pas les moteurs et le workflow.
    Tableau 6. Renvoie
    Type Description
    Objet Un objet mappant les noms de colonnes à des valeurs.

    Cet exemple lit tous les jeux de variables utilisés par l’élément de catalogue iPhone 6s.

    var vset = new GlideRecord('io_set_item');
vset.addQuery('sc_cat_item', 'bd6fa75a4f334200086eeed18110c79e'); // catalog item - iPhone 6s
vset.query();
while (vset.next()) {
    var varset = new sn_sc.CatalogItemVariableSetM2M(vset.getUniqueValue()); // pass sys_id of io_set_item record
    //add the fields you want to read from the record
    var attr = {
        'sys_name': '', // optional
        'sys_scope': '', // optional
        'order': '' // optional
    };
    var m2mRec = varset.read(attr, true);
    gs.info(JSON.stringify(m2mRec));
}

    Sortie :

    {"sys_name":"HTML Description.iPhone 6s","sys_scope":"global","order":"10"}
{"sys_name":"Standard Employee Questions.iPhone 6s","sys_scope":"global","order":"20"}

    CatalogItemVariableSetM2M : setAttributes(attributs d’objet)

    Définit les valeurs d’attribut pour le jeu de variables M2M de cet élément de catalogue.

    Tableau 7. Paramètres
    Nom Type Description
    attributs Objet Un objet mappant les noms de colonnes à des valeurs.
    Tableau 8. Renvoie
    Type Description
    nul

    Cet exemple ajoute le jeu de variables Standard Employee Questions à l’élément de catalogue iPhone 6s et crée un enregistrement dans la table Jeux de variables de catalogue [io_set_item].

    var cat_item_sys_id = 'bd6fa75a4f334200086eeed18110c79e'; // catalog item - iPhone 6s
var variable_set_sys_id = 'e01cab1a4f334200086eeed18110c71f'; // variable set - Standard Employee Questions
var app_scope = 'global'; // sys_id id in case of scoped app
var varset = new sn_sc.CatalogItemVariableSetM2M();
var attr = {
    'variable_set': variable_set_sys_id,
    'sc_cat_item': cat_item_sys_id,
    'sys_scope': app_scope,
    'order': 10
};
varset.setAttributes(attr);
var m2mRec = varset.create(true);
gs.info('Variable set added to catalog item and M2M record created in table io_set_item with sys_id ' + m2mRec);

    Sortie :

    Variable set added to catalog item and M2M record created in table io_set_item with sys_id c5c87af187eb30103a730f2d0ebb3578

    CatalogItemVariableSetM2M : update(Object columnValues, Boolean standardUpdate)

    Met à jour le jeu de variables M2M du jeu de variables d’élément de catalogue actuel avec des valeurs définies.

    Tableau 9. Paramètres
    Nom Type Description
    columnValues (colonnes de valeurs) Objet Un objet mappant les noms de colonnes à des valeurs.
    standardUpdate (mise à jour standard) Booléen Marqueur indiquant si l’exécution des moteurs et du workflow doit être activée.
    Valeurs valides :
    • true : activez les moteurs et le workflow.
    • false : n’activez pas les moteurs et le workflow.
    Tableau 10. Renvoie
    Type Description
    nul

    Cet exemple met à jour l’ordre du jeu de variables Questions employé standard pour l’élément de catalogue iPhone 6s.

    var vset = new GlideRecord('io_set_item');
vset.addQuery('sc_cat_item', 'bd6fa75a4f334200086eeed18110c79e'); // catalog item - iPhone 6s
vset.addQuery('variable_set', 'e01cab1a4f334200086eeed18110c71f'); // variable set - Standard Employee Questions
vset.query();
if (vset.next()) {
    var varset = new sn_sc.CatalogItemVariableSetM2M(vset.getUniqueValue()); // pass sys_id of io_set_item record
    var attr = {
        'order': '30' // update order to 30
    };
    varset.update(attr, true);
    var readAttr = {
        'sys_name': '',
        'order': '' 
    };
    var m2mRec = varset.read(readAttr, true); // read the record to confirm the update 
    gs.info(JSON.stringify(m2mRec));
}

    Sortie :

    {"sys_name":"Standard Employee Questions.iPhone 6s","order":"30"}