GlideSPScriptable : délimité

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 17 minutes de lecture
  • L’API GlideSPScriptable fournit des méthodes permettant d’interagir avec des données et d’effectuer des opérations d’enregistrement dans des Portail de services widgets.

    Vous accédez aux méthodes GlideSPScriptable à l’aide de l’objet $sp global.

    GlideSPScriptable : canReadRecord(GlideRecord now_GR)

    Renvoie la valeur vrai si l’utilisateur peut lire le GlideRecord spécifié.

    Si le type d’enregistrement est kb_knowledge, sc_cat_item ou sc_category, la méthode vérifie si l’utilisateur peut afficher l’élément.

    Tableau 1. Paramètres
    Nom Type Description
    now_GR GlideRecord GlideRecord à vérifier.
    Tableau 2. Renvoie
    Type Description
    Booléen Vrai si l’enregistrement est valide et lisible.

    Script serveur

    //Server script
    data.items = [];
    data.userName = gs.getUserDisplayName();
    var now_GR = new GlideRecord("sc_cat_item");
    now_GR.query();
    while(now_GR.next() && data.items.length < 10) {
        if ($sp.canReadRecord(now_GR)) {
        data.items.push(now_GR.getDisplayValue("name"));
        }
    }
    
    //HTML template
    <div class="panel panel-default">
        <div class="panel-heading">Hi, {{c.data.userName}}!</div>
        <div class="panel-body">
            Here are some things you can order:
            <ul><li ng-repeat="item in c.data.items">{{item}}</li></ul>
        </div>
    </div>

    GlideSPScriptable : canReadRecord(table de chaînes, sysId de chaîne)

    Renvoie la valeur vrai si l’utilisateur peut lire le GlideRecord spécifié.

    Si le type d’enregistrement est kb_knowledge, sc_cat_item ou sc_category, la méthode vérifie si l’utilisateur peut afficher l’élément.

    Tableau 3. Paramètres
    Nom Type Description
    Table Chaîne Nom de la table à interroger.
    sysId Chaîne Sys_id de l’enregistrement à interroger.
    Tableau 4. Renvoie
    Type Description
    Booléen Vrai si l’enregistrement est valide et lisible.

    GlideSPScriptable : canSeePage(String pageID)

    Renvoie la valeur vrai si l’utilisateur actuellement connecté a l’autorisation d’afficher la page spécifiée.

    Le système détermine l’autorisation à l’aide de rôles et de critères d’utilisateur. Pour plus d’informations, consultez Configurer la sécurité des pages par rôle et critères d’utilisateur pour Portail de services.

    Tableau 5. Paramètres
    Nom Type Description
    ID de page Chaîne ID de page de la table Pages [sp_page].
    Tableau 6. Renvoie
    Type Description
    Booléen Marqueur indiquant si l’utilisateur actuellement connecté a les autorisations nécessaires pour afficher la page spécifiée. Les valeurs comprennent :
    • vrai : l’utilisateur peut afficher la page.
    • false : soit l’utilisateur ne peut pas voir la page, soit le pageID donné n’est pas valide, soit l’utilisateur n’est pas connecté.

    Cet exemple ajoute une condition à l’élément de menu Connaissances dans le menu d’en-tête du portail de services pour afficher uniquement l’élément de menu aux utilisateurs qui ont l’autorisation d’afficher la page kb_view2.

    GlideSPScriptable.canSeePage("kb_view2")

    GlideSPScriptable : getCatalogItem(sysId de chaîne)

    Renvoie un modèle et afficher le modèle d’un sc_cat_item ou d’un sc_cat_item_guide.

    Cette méthode est obsolète. Utilisez plutôt la méthode getCatalogItem(String sysId, booléen isOrdering). Cette méthode appelle la méthode getCatalogItem(String sysId, booléen isOrdering) avec le paramètre défini sur faux, ce qui signifie que la vérification de la isOrdering sécurité des rôles d’écriture est effectuée.

    Cette méthode est un moyen rapide d’obtenir les données nécessaires au rendu et à la commande d’un élément de catalogue à l’aide de <sp-model />. Si vous avez simplement besoin qu’un élément de catalogue affiche son image ou son nom, utilisez GlideRecord pour interroger la table sc_cat_item .

    Tableau 7. Paramètres
    Nom Type Description
    sysId Chaîne sys_id de l’élément de catalogue (sc_cat_item) ou du guide de commande (sc_cat_item_guide).
    Tableau 8. Renvoie
    Type Description
    Objet Objet contenant le modèle de variable de l’élément de catalogue, la vue, les sections, la tarification et les scripts clients.
    // Server script
    (function() {
        var sys_id = $sp.getParameter("sys_id")
        data.catItem = $sp.getCatalogItem(sys_id);
    })();
    
    // Client script
    function($http, spUtil) {
        var c = this;
        var submitting = false;
        c.getIt = function() {
            if (submitting) return;
            $http.post(spUtil.getURL('sc_cat_item'), c.data.catItem).success(function(response) {
                if (response.answer) {
                    c.req = response.answer;
                    c.req.page = c.req.table == 'sc_request' ? 'sc_request' : 'ticket';
                }
            });
        }
    }
    
    //SCSS
    .img-bg {
        padding: 5px;
        background-color: $brand-primary;
    }
    
    .img-responsive {
        margin: 0 auto;
    }
    
    .cat-icon {
        display: block;
        margin: -40px auto 0;
    }
    
    // HTML template
    <div class="col-sm-4">
      <div class="panel panel-default">
        <div class="img-bg">
          <img ng-src="{{::data.catItem.picture}}" class="img-responsive" />
        </div>
        <span class="cat-icon fa fa-stack fa-lg fa-3x hidden-xs">
          <i class="fa fa-circle fa-stack-2x text-success"></i>
          <i class="fa fa-desktop fa-stack-1x fa-inverse"></i>
        </span>
        <div class="panel-body">
          <p class="lead text-center">{{::data.catItem.name}}</p>
          <ul class="list-unstyled">
            <li class="text-center" ng-if="::data.catItem.price">${Price}: {{::data.catItem.price}}</li>
          </ul>
          <sp-model form-model="::data.catItem" mandatory="mandatory"></sp-model>
          <p ng-if="c.req" class="text-center text-success">
            ${Request created!} <a href="?id={{c.req.page}}&table={{c.req.table}}&sys_id={{c.req.sys_id}}">{{c.req.number}}</a>
          </p>
          <button ng-if="!c.req" class="btn btn-default btn-block" ng-click="c.getIt()">${Get it}</button>
        </div>
      </div>
    </div>

    GlideSPScriptable : getCatalogItem(String sysId, booléen isOrdering)

    Renvoie un modèle et afficher le modèle d’un sc_cat_item ou d’un sc_cat_item_guide.

    Tableau 9. Paramètres
    Nom Type Description
    sysId Chaîne sys_id de l’élément de catalogue (sc_cat_item) ou du guide de commande (sc_cat_item_guide).
    isOrdering Booléen Lorsque la valeur est vrai, utilise la vérification de sécurité Créer des rôles. Si la valeur est faux, utilise la vérification de sécurité des rôles d’écriture.

    Lorsque les utilisateurs commandent un élément ou l’ont dans leur panier, cochez cette case à l’aide des rôles de création.

    Si les utilisateurs ne commandent pas, par exemple, si quelqu’un regarde un élément demandé pour voir les variables associées à cet élément, vérifiez à l’aide des rôles d’écriture.

    Tableau 10. Renvoie
    Type Description
    Objet Objet contenant le modèle de variable de l’élément de catalogue, la vue, les sections, la tarification et les scripts clients.

    GlideSPScriptable : getDisplayValue (nom de champ de chaîne)

    Renvoie la valeur d’affichage du champ spécifié (s’il existe et qu’il contient une valeur) à partir du sp_instance du widget ou de l’enregistrement sp_portal .

    Tableau 11. Paramètres
    Nom Type Description
    Fieldname Chaîne Nom du champ
    Tableau 12. Renvoie
    Type Description
    Chaîne Valeur d’affichage de l’enregistrement sp_instance ou sp_portal .
    //Server script
    (function() {
        data.title = $sp.getDisplayValue("title");
        data.catalog = $sp.getDisplayValue("sc_catalog");
    })();
    
    //HTML template
    <div>
        <h1>sp_instance.title: {{::data.title}}</h1>
        <h1>sp_portal.sc_catalog: {{::data.catalog}}</h1>
    </div>

    GlideSPScriptable : getField(GlideRecord now_GR, chaîne fieldName)

    Retourne des informations sur le champ spécifié dans le GlideRecord spécifié.

    Tableau 13. Paramètres
    Nom Type Description
    now_GR GlideRecord GlideRecord à vérifier
    Fieldname Chaîne Champ pour lequel rechercher des informations
    Tableau 14. Renvoie
    Type Description
    Objet Objet contenant l’étiquette, la valeur, la valeur displayValue et le type du champ. Renvoie null si les GlideRecord du nom de champ ne sont pas valides ou si le champ n’est pas lisible.

    GlideSPScriptable : getFields(GlideRecord now_GR, chaîne fieldNames)

    Vérifie la liste spécifiée des noms de champs et renvoie un tableau de noms de champs valides.

    Tableau 15. Paramètres
    Nom Type Description
    now_GR GlideRecord GlideRecord à vérifier
    Noms de champs Chaîne Une liste de noms de champs séparés par des virgules.
    Tableau 16. Renvoie
    Type Description
    Tableau Un tableau de champs valides.

    GlideSPScriptable : getFieldsObject(GlideRecord now_GR, chaîne fieldNames)

    Vérifie la liste spécifiée de noms de champs et renvoie un objet de noms de champs valides.

    Tableau 17. Paramètres
    Nom Type Description
    now_GR GlideRecord GlideRecord à vérifier
    Noms de champs Chaîne Une liste de noms de champs séparés par des virgules.
    Tableau 18. Renvoie
    Type Description
    Objet Objet contenant des noms de champs valides.

    GlideSPScriptable : getForm(String tableName, String sysId)

    Renvoyer le formulaire associé au nom de table et au sys_id d’enregistrement transmis.

    Remarque :
    Cette méthode applique les privilèges d’accès entre périmètres à la table spécifiée et à l’enregistrement associé.
    Tableau 19. Paramètres
    Nom Type Description
    tableName Chaîne Nom de la table dans laquelle se trouve le formulaire.
    sysId Chaîne Sys_id du formulaire.
    Tableau 20. Renvoie
    Type Description
    Objet Formulaire demandé.
    var sp = new GlideSPScriptable('');
    var res = sp.getForm('sys_user', '6816f79cc0a8016401c5a33be04be441');    // User sys ID information
    gs.info('Name: ' + res._fields.name.value);
    gs.info('E-mail: ' + res._fields.email.value);

    Sortie :

    Name: Harry Jones
     E-mail: harryjones@gmail.com

    GlideSPScriptable : getKBCategoryArticles(chaîne sys_id, limite de nombre)

    Renvoie les articles de la base de connaissances dans la catégorie spécifiée et ses sous-catégories.

    Pour éviter les problèmes de performances, n’utilisez pas cette méthode pour renvoyer des articles de grandes catégories ou des articles avec des images intégrées. Utilisez plutôt getKBArticleSummaries().

    Tableau 21. Paramètres
    Nom Type Description
    sys_id Chaîne Sys_id de la catégorie d’article de la base de connaissances.
    limite Numéro Nombre maximal d’articles de la base de connaissances renvoyés.
    Tableau 22. Renvoie
    Type Description
    Tableau Les articles de la catégorie et de ses sous-catégories avec :
    • Un workflow_state de publié.
    • Date valid_to postérieure ou égale à la date actuelle.
    //Server script 
    (function() {
        data.kbs = $sp.getKBCategoryArticles("0ac1bf8bff0221009b20ffffffffffec", 5);
    })();
    
    //HTML template
    <div>
    articles: {{::data.kbs}}
    </div>
    

    GlideSPScriptable : getKBCategoryArticleSummaries(String sys_id, Number limit, Number maxChars)

    Renvoie les résumés d’articles de la base de connaissances dans la catégorie spécifiée et ses sous-catégories.

    Tableau 23. Paramètres
    Nom Type Description
    sys_id Chaîne Sys_id de la catégorie d’article de la base de connaissances.
    limite Numéro Nombre maximal d’articles de la base de connaissances renvoyés.
    maxChars Numéro Nombre maximum de caractères à renvoyer à partir du texte de l’article. Pour le texte complet de l’article, définissez la valeur sur -1.
    Tableau 24. Renvoie
    Type Description
    Tableau Les articles de la catégorie et de ses sous-catégories avec :
    • Un workflow_state de publié.
    • Date valid_to postérieure ou égale à la date actuelle.
    //Server script 
    (function() {
        data.summary = $sp.getKBCategoryArticleSummaries("0ac1bf8bff0221009b20ffffffffffec", 5, 200);
    })();
    
    //HTML template
    <div>
    articles: {{::data.summary}}
    </div>
    

    GlideSPScriptable : getKBCount(chaîne sys_id)

    Renvoie le nombre d’articles dans la base de connaissances définie.

    Tableau 25. Paramètres
    Nom Type Description
    sys_id Chaîne Sys_id d’un enregistrement de la base de connaissances.
    Tableau 26. Renvoie
    Type Description
    Numéro Nombre d’articles de la base de connaissances dans la base de connaissances définie avec :
    • Un workflow_state de publié.
    • Date valid_to postérieure ou égale à la date actuelle.
    //Server script 
    (function() {
        data.count = $sp.getKBCount("a7e8a78bff0221009b20ffffffffff17");
    })();
    
    //HTML template
    <div>
    articles: {{::data.count}}
    </div>
    

    GlideSPScriptable : getListColumns(String tableName, vue String)

    Renvoie une liste des colonnes de la table spécifiée dans la vue spécifiée.

    Tableau 27. Paramètres
    Nom Type Description
    tableName Chaîne Nom de la table
    vue Chaîne Vue permettant de filtrer les colonnes
    Tableau 28. Renvoie
    Type Description
    Objet Objet contenant les noms de colonnes.

    GlideSPScriptable : getMenuItems(sysId de chaîne)

    Renvoie un tableau d’éléments de menu pour l’instance spécifiée.

    Tableau 29. Paramètres
    Nom Type Description
    sysId Chaîne sysId de l’instance
    Tableau 30. Renvoie
    Type Description
    Tableau Éléments de menu pour l’instance spécifiée

    GlideSPScriptable : getMenuHREF(page GlideRecord)

    Renvoie la partie ( ?id=) de l’URL en fonction du type de sp_menu.

    Tableau 31. Paramètres
    Nom Type Description
    Page GlideRecord La page
    Tableau 32. Renvoie
    Type Description
    Chaîne La partie href de l’URL.

    GlideSPScriptable : getParameter(nom de chaîne)

    Renvoie la valeur du paramètre spécifié.

    Tableau 33. Paramètres
    Nom Type Description
    nom Chaîne Nom de la clé à partir de la chaîne de requête ou du corps de la publication.
    Tableau 34. Renvoie
    Type Description
    Objet Renvoie le paramètre spécifié en tant qu’objet. Renvoie null s’il n’y a pas de demande, de demande JSON ou de widget.

    GlideSPScriptable : getPortalRecord()

    Renvoie l’enregistrement du portail à partir de la table Portails de services [sp_portal].

    Tableau 35. Paramètres
    Nom Type Description
    Néant
    Tableau 36. Renvoie
    Type Description
    GlideRecord L’enregistrement de portail pour le portail actuel à partir de la table Portails de services [sp_portal].
    //Server script
    (function() {
        var portalGr = $sp.getPortalRecord();
        data.logo = portalGr.getDisplayValue("logo");
        data.homepage = portalGr.getDisplayValue("homepage.id");
    })();
    
    //HTML template
    <div>
        <img ng-src="{{::c.data.logo}}" />
        <a href="?id={{::c.data.homepage}}">Click here to go home</a>
    </div>

    GlideSPScriptable : getRecord(table de chaînes, chaîne sys_id)

    Si des paramètres sont fournis, renvoie le GlideRecord identifié par la table et l’ID système fournis. Si aucun paramètre n’est fourni, renvoie l’enregistrement identifié par l’URL actuelle.

    Tableau 37. Paramètres
    Nom Type Description
    Table Chaîne Facultatif. Table de l’enregistrement à renvoyer. Si aucun paramètre n’est inclus, renvoie la table et l’ID système identifiés par l’URL actuelle.
    sys_id Chaîne Facultatif. L’ID système de l’enregistrement à renvoyer. Si aucun paramètre n’est inclus, renvoie l’enregistrement identifié par l’URL actuelle.
    Tableau 38. Renvoie
    Type Description
    GlideRecord Si des paramètres sont fournis, renvoie l’enregistrement identifié par la table et l’ID système fournis.

    Si aucun paramètre n’est fourni, renvoie l’enregistrement identifié par l’URL actuelle.

    Renvoie null si le widget est incorporé par un autre widget ou si l’enregistrement des paramètres fournis est introuvable.

    //Server script 
    (function(){ 
    var now_GR = $sp.getRecord(); 
    data.tableLabel = now_GR.getLabel(); 
    })(); 
    
    //HTML template 
    <div class="panel-heading"> 
    <h4 class="panel-title">${{{data.tableLabel}} details}</h4> 
    </div>

    GlideSPScriptable : getRecordDisplayValues (données d’objet, GlideRecord de, noms de chaînes)

    Copie les valeurs d’affichage des champs spécifiés dans le paramètre de données.

    Tableau 39. Paramètres
    Nom Type Description
    données Objet Les valeurs d’affichage des champs spécifiés sont copiées dans cet objet.
    de GlideRecord GlideRecord à traiter.
    noms Chaîne Une liste de noms de champs séparés par des virgules.
    Tableau 40. Renvoie
    Type Description
    nul

    GlideSPScriptable : getRecordElements(données de l’objet, GlideRecord source, noms de chaînes)

    Pour les champs spécifiés, copie le nom, la valeur d’affichage et la valeur de l’élément dans le paramètre de données.

    Tableau 41. Paramètres
    Nom Type Description
    données Objet Le nom de l’élément, la valeur d’affichage et la valeur des champs spécifiés sont copiés dans cet objet.
    de GlideRecord GlideRecord à traiter.
    noms Chaîne Une liste de noms de champs séparés par des virgules.
    Tableau 42. Renvoie
    Type Description
    nul

    GlideSPScriptable : getRecordValues (données d’objet, GlideRecord source, noms de chaînes)

    Copie les valeurs des noms de champs spécifiés à partir du GlideRecord dans le paramètre de données.

    Tableau 43. Paramètres
    Nom Type Description
    données Objet Les valeurs des champs spécifiés sont copiées dans cet objet.
    de GlideRecord GlideRecord à traiter.
    noms Chaîne Une liste de noms de champs séparés par des virgules.
    Tableau 44. Renvoie
    Type Description
    nul

    GlideSPScriptable : getRecordVariables(GlideRecord now_GR, booléen includeNilResponses)

    Renvoie Catalogue de services les variables associées à un enregistrement au format chaîne.

    Tableau 45. Paramètres
    Nom Type Description
    now_GR GlideRecord Enregistrement pour lequel récupérer les Catalogue de services variables. Doit être un enregistrement avec Catalogue de services des variables définies, tel qu’un enregistrement d’élément demandé [sc_req_item] ou un incident soumis via un créateur d’enregistrement.
    includeNilResponses Booléen Facultatif. Si vrai, l’API inclut des variables sans valeur définie par l’utilisateur.
    Tableau 46. Renvoie
    Type Description
    Chaîne Catalogue de services Variables associées à l’enregistrement.
    //Server script 
    (function() {
    var itemsGR = new GlideRecord("sc_req_item");
    itemsGR.get('585d1bc44f4f13008a959a211310c77d');
    	
    data.scVars = $sp.getRecordVariables(itemsGR);
    
    })();
    
    //HTML template
    <div>
    Requested item variables: {{::data.scVars}}
    </div>

    Sortie :

    Requested item variables: [
      {
        "display_value":"MetroPCS",
        "name":"carrier",
        "visible_summary":true,
        "id":"585d1bc44f4f13008a959a211310c77c",
        "label":"Allocated carrier",
        "type":"5",
        "value":"metropcs",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"Unlimited",
        "name":"data_plan",
        "visible_summary":true,
        "id":"d05d1bc44f4f13008a959a211310c77c",
        "label":"Monthly data allowance",
        "type":"5",
        "value":"unlimited",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"12 Months",
        "name":"duration",
        "visible_summary":true,
        "id":"d85d1bc44f4f13008a959a211310c77c",
        "label":"Contract duration",
        "type":"5",
        "value":"twelve_months",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"Slate",
        "name":"color",
        "visible_summary":true,
        "id":"545d1bc44f4f13008a959a211310c77c",
        "label":"Color",
        "type":"5",
        "value":"slate",
        "visible_standalone":true,
        "visible_guide":true
      },
      {"display_value":"64GB",
        "name":"storage",
        "visible_summary":true,
        "id":"d45d1bc44f4f13008a959a211310c77c",
        "label":"Storage",
        "type":"5",
        "value":"sixtyfour",
        "visible_standalone":true,
        "visible_guide":true
      }
    ]

    GlideSPScriptable : getRecordVariablesArray(GlideRecord now_GR, booléen includeNilResponses)

    Renvoie un tableau de Catalogue de services variables associées à un enregistrement.

    Tableau 47. Paramètres
    Nom Type Description
    now_GR GlideRecord Enregistrement pour lequel récupérer les Catalogue de services variables. Doit être un enregistrement avec Catalogue de services des variables définies, tel qu’un enregistrement d’élément demandé [sc_req_item] ou un incident soumis via un créateur d’enregistrement.
    includeNilResponses Booléen Facultatif. Si vrai, l’API inclut des variables sans valeur définie par l’utilisateur.
    Tableau 48. Renvoie
    Type Description
    Objet Tableau des Catalogue de services variables associées à l’enregistrement.
    //Server script 
    (function() {
    var itemsGR = new GlideRecord("sc_req_item");
    itemsGR.get('585d1bc44f4f13008a959a211310c77d');
    	
    data.scVars = $sp.getRecordVariablesArray(itemsGR);
    
    })();
    
    //HTML template
    <div>
    Requested item variables: {{::data.scVars}}
    </div>

    Sortie :

    Requested item variables: [
      {
        "display_value":"MetroPCS",
        "name":"carrier",
        "visible_summary":true,
        "id":"585d1bc44f4f13008a959a211310c77c",
        "label":"Allocated carrier",
        "type":"5",
        "value":"metropcs",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"Unlimited",
        "name":"data_plan",
        "visible_summary":true,
        "id":"d05d1bc44f4f13008a959a211310c77c",
        "label":"Monthly data allowance",
        "type":"5",
        "value":"unlimited",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"12 Months",
        "name":"duration",
        "visible_summary":true,
        "id":"d85d1bc44f4f13008a959a211310c77c",
        "label":"Contract duration",
        "type":"5",
        "value":"twelve_months",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"Slate",
        "name":"color",
        "visible_summary":true,
        "id":"545d1bc44f4f13008a959a211310c77c",
        "label":"Color",
        "type":"5",
        "value":"slate",
        "visible_standalone":true,
        "visible_guide":true
      },
      {"display_value":"64GB",
        "name":"storage",
        "visible_summary":true,
        "id":"d45d1bc44f4f13008a959a211310c77c",
        "label":"Storage",
        "type":"5",
        "value":"sixtyfour",
        "visible_standalone":true,
        "visible_guide":true
      }
    ]

    GlideSPScriptable : getStream(table de chaînes, sysId de chaîne)

    Obtient le flux d’activité pour l’enregistrement spécifié. Cette méthode fonctionne sur les tables qui étendent la table Tâche.

    Tableau 49. Paramètres
    Nom Type Description
    Table Chaîne Nom de la table
    sysID Chaîne sys_id de l'enregistrement
    Tableau 50. Renvoie
    Type Description
    Objet Si une table étendant la table de tâches est spécifiée, elle contient les propriétés display_value, sys_id, short_description, numéro, entrées, user_sys_id, user_full_name, user_login, étiquette, table et journal_fields ; sinon contient les propriétés de table et de sys_id.
    Remarque :
    La propriété user_login contient l’ID utilisateur de l’utilisateur actuel. Les propriétés user_sys_id et iser_full_name font référence au créateur de l’enregistrement interrogé.

    GlideSPScriptable : getUserInitials()

    Renvoie les initiales de l’utilisateur.

    Tableau 51. Paramètres
    Nom Type Description
    Néant
    Tableau 52. Renvoie
    Type Description
    Chaîne Les initiales de l’utilisateur

    GlideSPScriptable : getValue (nom de chaîne)

    Renvoie la valeur nommée de la demande, de l’instance ou du portail JSON.

    Tableau 53. Paramètres
    Nom Type Description
    nom Chaîne Nom de la demande JSON, de l’instance ou du portail.
    Tableau 54. Renvoie
    Type Description
    Objet Valeur du paramètre spécifié. Nul si l’entité spécifiée n’existe pas ou n’a pas de tel paramètre.
    //Server script
    (function() {
        data.title = $sp.getValue("title");
        data.catalog = $sp.getValue("sc_catalog");
    })();
    
    //HTML templage
    <div>
        <h1>sp_instance.title: {{::data.title}}</h1>
        <h1>sp_portal.sc_catalog: {{::data.catalog}}</h1>
    </div>

    GlideSPScriptable : getValues(données d’objet, noms de chaînes)

    Copie les valeurs de la demande ou de l’instance vers le paramètre de données.

    Tableau 55. Paramètres
    Nom Type Description
    données Objet Reçoit les valeurs des paramètres.
    noms Chaîne Chaîne de noms de champs séparés par des virgules.
    Tableau 56. Renvoie
    Type Description
    nul

    GlideSPScriptable : getVariablesArray(booléen includeNilResponses)

    Renvoie un tableau de variables associées à l’enregistrement Catalogue de services dans l’URL.

    Par exemple, si l’URL inclut les paramètres id=form&table=sc_req_item&sys_id=832e9620db4f330083766b984b9619cf, l’API renvoie les variables associées à l’enregistrement donné dans la table Élément demandé [sc_req_item]. Doit être un enregistrement avec Catalogue de services des variables définies, tel qu’un enregistrement d’élément demandé [sc_req_item] ou un incident soumis via un créateur d’enregistrement.

    Tableau 57. Paramètres
    Nom Type Description
    includeNilResponses Booléen Facultatif. Si vrai, l’API inclut des variables sans valeur définie par l’utilisateur.
    Tableau 58. Renvoie
    Type Description
    Objet Tableau des variables associées à la table.
    //Server script 
    (function() {	
    data.scVars = $sp.getVariablesArray();
    })();
    
    //HTML template
    <div Current record variables: {{::data.scVars}} ></div>

    Sortie :

    Current record variables: [
      {
        "display_value":"unlimited",
        "name":"data","visible_summary":
        true,"id":"472e5620db4f330083766b984b96198a",
        "label":"Data",
        "type":"6",
        "value":"unlimited",
        "visible_standalone":true,
        "visible_guide":true
      },
      {
        "display_value":"Black",
        "name":"color",
        "visible_summary":true,
        "id":"c72e5620db4f330083766b984b96198a",
        "label":"Color",
        "type":"6",
        "value":"Black",
        "visible_standalone":true,
        "visible_guide":true
      }
    ] 

    GlideSPScriptable : getWidget(sysID de la chaîne, options de l’objet)

    Obtient un widget par ID ou sys_id, exécute le script serveur de ce widget à l’aide des options fournies, puis renvoie le modèle de widget.

    Tableau 59. Paramètres
    Nom Type Description
    sysID Chaîne Le widget sys_id ou widget_id
    options Objet Objet à transmettre au script serveur du widget. Reportez-vous à cet objet en tant qu’options dans votre script serveur.
    Remarque :
    Toutes les options transmises dans cette fonction ne seront disponibles dans le script serveur du widget intégré qu’à la première exécution de ce script. Les appels ultérieurs dans le script serveur à partir du widget incorporé ne contiendront pas les propriétés d’objet transmises.
    Tableau 60. Renvoie
    Type Description
    Objet Modèle de widget à utiliser avec sp-widget.
    //Server script
    data.myWidget = $sp.getWidget('widget_id', {p1: param1, p2: param2});
    
    //HTML
    <sp-widget widget="c.data.myWidget"></sp-widget>

    GlideSPScriptable : isRTLEnabled()

    Vérifie si le portail associé est activé pour la langue de droite à gauche (RTL) et si la langue de l’utilisateur actuel est directionnellement RTL.

    Utilisez cette méthode pour déterminer s’il est nécessaire d’utiliser un CSS spécifique à RTL dans l’interface utilisateur du portail.

    Tableau 61. Paramètres
    Nom Type Description
    Néant
    Tableau 62. Renvoie
    Type Description
    Booléen Marqueur indiquant si le marqueur RTL est activé et si la langue de session de l’utilisateur actuel est directionnellement RTL.

    Valeurs possibles :

    • vrai : le marqueur RTL est activé.
    • faux : le marqueur RTL n’est pas activé.

    Type de données : booléennes

    L’exemple de code suivant montre comment utiliser cette méthode pour déterminer le type d’icône à afficher sur la page du portail.

    // Server script  
    (function() {
      data.isRTLEnabled = $sp.isRTLEnabled();
     })(); 
    
    // HTML template 
    <div> <i ng-class="c.data.isRTLEnabled ? 'fa fa-arrow-right' : 'fa fa-arrow-left'"></i> </div> 

    GlideSPScriptable : isUserCriteriaEnabled()

    Renvoie la valeur vrai si les critères d’utilisateur sont activés.

    Cette méthode renvoie la valeur vrai si le module d’extension Prise en charge des critères d’utilisateur du portail de services (com.glide.service-portal.user-criteria) est actif et si la propriété système Activer l’utilisation des enregistrements de critères d’utilisateur au lieu de rôles pour les droits du portail de services (glide.service_portal.user_criteria_enabled) est définie sur vrai.

    Tableau 63. Paramètres
    Nom Type Description
    Néant
    Tableau 64. Renvoie
    Type Description
    Booléen Vrai si les critères d’utilisateur sont activés.

    GlideSPScriptable : journal (message d’objet)

    Consigne la sortie vers la table Entrées de journal du Portail de services [sp_log]. L’utilisateur connecté doit avoir le rôle de sp_admin ou d’administrateur.

    Tableau 65. Paramètres
    Nom Type Description
    message Objet Objet ou chaîne JavaScript représentant le message à envoyer en tant que sortie sur une Portail de services page.
    Tableau 66. Renvoie
    Type Description
    Néant

    L’exemple suivant montre comment consigner une erreur prédéfinie si elle se produit.

    var demo_data = null;
    var params = null;
    if (gr.getValue("demo_data")) {
       try {
    	demo_data = JSON.parse(gr.getValue("demo_data"));
    	params = (demo_data.options) ? demo_data.options : null;
    	} catch(e) {
    	$sp.log(e);
       }
    }

    GlideSPScriptable : mapUrlToSPUrl(URL de chaîne)

    Transforme une URL demandant une liste ou un formulaire dans l’interface utilisateur de la plateforme en URL de la page correspondante id=list ou id=form du Portail de services.

    Utilisez cette méthode pour effectuer des tâches telles que la redirection d’un utilisateur après la connexion vers la page de Portail de services appropriée lorsqu’il demande une interface utilisateur, un formulaire d’interface utilisateur de plateforme ou une URL de liste. Notez que les cibles des pages id=list et id=form ne sont pas personnalisables.
    Remarque :
    Les valeurs Table, sys_id et sysparm_query sont conservées à partir de l’URL d’origine ; sysparm_view ne l’est pas.
    Tableau 67. Paramètres
    Nom Type Description
    URL Chaîne URL de l’interface utilisateur de la plateforme
    Tableau 68. Renvoie
    Type Description
    Chaîne URL du portail de services transformée.

    Si l’URL transmise ne demande pas de liste ou de formulaire dans l’interface utilisateur de la plateforme, une valeur null est renvoyée.

    Exemple de liste

    GlideSPScriptable().mapUrlToSPUrl("http://demo.service-now.com/task_list.do?sysparm_userpref_module=1523b8d4c611227b00be8216ec331b9a&sysparm_query=assigned_to=javascript:getMyAssignments()&sysparm_clear_stack=true"))

    Renvoie

    id=list&table=task&filter=assigned_to=javascript:getMyAssignments()&sys_id=&v=

    Exemple de formulaire

    GlideSPScriptable().mapUrlToSPUrl("incident.do?sys_id=12bc12bc12bc12bc12bc12bc12bc12bc")

    Renvoie

    id=form&table=incident&filter=&sys_id=12bc12bc12bc12bc12bc12bc12bc12bc&v=

    GlideSPScriptable : userCanSeeSearchSourceByCriteria(String searchSourceID)

    Renvoie la valeur vrai si l’utilisateur actuel peut consulter une source de recherche spécifiée par searchSourceID.

    Renvoie la valeur vrai si l’utilisateur n’est pas restreint par des critères d’utilisateur. Pour en savoir plus sur la façon dont les critères d’utilisateur affectent les actifs de Portail de services, consultez Critères d’utilisateur pour Portail de services.
    Remarque :
    Cette méthode n’évalue pas les autorisations basées sur les rôles de la source de recherche et ne doit être utilisée que si les critères d’utilisateur sont activés.
    Tableau 69. Paramètres
    Nom Type Description
    searchSourceID Chaîne Sys_id de l’enregistrement de la source de recherche.
    Tableau 70. Renvoie
    Type Description
    Booléen Vrai si l’utilisateur actuel a un accès en lecture à la source de recherche.