GlideSPScriptable : dans le champ d’application

L’API GlideSPScriptable fournit des méthodes permettant d’interagir avec les 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 afficher 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(String sysId)

Renvoie un modèle et un modèle de vue pour un sc_cat_item ou 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, Boolean isOrdering) avec le paramètre défini sur false, 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 pour afficher et commander 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	Le 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 un modèle de vue pour un sc_cat_item ou un sc_cat_item_guide.

Tableau 9. Paramètres

Nom	Type	Description
sysId	Chaîne	Le sys_id de l’élément de catalogue (sc_cat_item) ou du guide de commande (sc_cat_item_guide).
isOrdering	Booléen	Si la valeur est vrai, utilise la vérification de sécurité des rôles de création. 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, vérifiez à 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(String fieldName)

Renvoie la valeur d’affichage du champ spécifié (s’il existe et qu’il contient une valeur) à partir de l’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 de 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	Tableau de champs valides.

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

Vérifie la liste spécifiée des noms de champs et renvoie un objet contenant des 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 :

La méthode applique des 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: [e-mail]

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 de l’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é. Une date valid_to supé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 de l’article de la base de connaissances.
limite	Numéro	Nombre maximal d’articles de la base de connaissances renvoyés.
maxChars	Numéro	Nombre maximal 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é. Une date valid_to supé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(String 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é. Une date valid_to supé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 Chaîne)

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(String sysId)

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 la 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é sous forme d’objet. Renvoie null s’il n’y a pas de demande, de demande JSON ou de widget.

GlideSPScriptable : getPortalRecord()

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

Tableau 35. Paramètres

Nom	Type	Description
Aucun

Tableau 36. Renvoie

Type	Description
GlideRecord	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, retourne 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 sur 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 d’objet, GlideRecord de, noms de chaîne)

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 de, noms de chaînes)

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

Tableau 43. Paramètres

Nom	Type	Description
données	Objet	La valeur des champs spécifiés est copiée 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	L’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	L’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 de 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 de tâches.

Tableau 49. Paramètres

Nom	Type	Description
Table	Chaîne	Le nom de 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 la table et les propriétés 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
Aucun

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 un 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înes 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 Catalogue de services variables associées à l’enregistrement 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 de 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(String, sysID, options 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. Tout appel ultérieur dans le script serveur à partir du widget intégré ne contiendra 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
Aucun

Tableau 62. Renvoie

Type	Description
Booléen	Marqueur indiquant si le marqueur RTL est activé et si la langue de la session de l’utilisateur actuel est directionnellement RTL. Valeurs possibles : true : le marqueur RTL est activé. false : 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 champs 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
Aucun

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 dans la table Entrées de journal [sp_log] de Portail de services. 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 sortie sur une Portail de services page.

Tableau 66. Renvoie

Type	Description
Aucun

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 Portail de services id=list ou id=form .

Utilisez cette méthode pour effectuer des tâches telles que la redirection d’un utilisateur après sa connexion vers la bonne page du Portail de services lorsqu’il demande une interface utilisateur, un formulaire d’interface utilisateur 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 d’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 true si l’utilisateur actuel peut voir 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 plus de détails sur la façon dont les critères d’utilisateur affectent les actifs du portail de services, voir Critères d’utilisateur pour le 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.