GlideSPScriptable – Scoped
Interagieren Sie mit Daten und führen Sie Datensatzvorgänge in Serviceportal -Widgets aus.
Sie greifen auf GlideSPScriptable-Methoden über das globale $sp-Objekt zu.
Scoped GlideSPScriptable – canReadRecord(GlideRecord now_GR)
Gibt „true“ zurück, wenn der Benutzer den angegebenen GlideRecord lesen kann.
Wenn der Datensatztyp kb_knowledge, sc_cat_item oder sc_category ist, prüft die Methode, ob der Benutzer das Element anzeigen kann.
| Name | Typ | Beschreibung |
|---|---|---|
| now_GR | GlideRecord | Zu prüfender GlideRecord. |
| Typ | Beschreibung |
|---|---|
| Boolean | „True“, wenn der Datensatz gültig und lesbar ist. |
Serverskript
//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>
Scoped GlideSPScriptable – canReadRecord(String table, String sysId)
Gibt „true“ zurück, wenn der Benutzer den angegebenen GlideRecord lesen kann.
Wenn der Datensatztyp kb_knowledge, sc_cat_item oder sc_category ist, prüft die Methode, ob der Benutzer das Element anzeigen kann.
| Name | Typ | Beschreibung |
|---|---|---|
| table | Zeichenfolge | Name der abzurufenden Tabelle |
| sysId | Zeichenfolge | sys_id des abzufragenden Datensatzes. |
| Typ | Beschreibung |
|---|---|
| Boolean | „True“, wenn der Datensatz gültig und lesbar ist. |
Scoped GlideSPScriptable – canSeePage(String pageID)
Gibt „true“ zurück, wenn der aktuell angemeldete Benutzer die Berechtigung zum Anzeigen der angegebenen Seite hat.
Das System bestimmt die Berechtigung anhand von Rollen und Benutzerkriterien. Weitere Informationen finden Sie unter Seitensicherheit nach Rolle und Benutzerkriterien für Service Portalkonfigurieren.
| Name | Typ | Beschreibung |
|---|---|---|
| Seiten-ID | Zeichenfolge | Seiten-ID aus der Seitentabelle [sp_page]. |
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob der aktuell angemeldete Benutzer über Berechtigungen zum Anzeigen der angegebenen Seite verfügt. Werte:
|
In diesem Beispiel wird dem Menüelement „Wissen“ im SP-Header-Menü eine Bedingung hinzugefügt, um das Menüelement nur Benutzern anzuzeigen, die zum Anzeigen der Seite „kb_view2“ berechtigt sind.
GlideSPScriptable.canSeePage("kb_view2")
Scoped GlideSPScriptable – getCatalogItem(String sysId)
Gibt ein Modell und ein Ansichtsmodell für sc_cat_item oder sc_cat_item_guide zurück.
Diese Methode ist veraltet. Verwenden Sie stattdessen die getCatalogItem(String sysId, Boolean isOrdering)-Methode. Diese Methode ruft die Methode getCatalogItem(String sysId, Boolean isOrdering) auf, wobei der Parameter isOrdering auf „false“ gesetzt ist, was bedeutet, dass die Sicherheitsüberprüfung der Schreibrollen erfolgt.
Diese Methode ist eine schnelle Methode, um die für das Rendern und Bestellen eines Katalogelements mit <sp-model /> erforderlichen Daten abzurufen. Wenn Sie nur ein Katalogelement abrufen möchten, um das Bild oder den Namen anzuzeigen, verwenden Sie GlideRecord, um die sc_cat_item-Tabelle abzufragen.
| Name | Typ | Beschreibung |
|---|---|---|
| sysId | Zeichenfolge | sys_id des Katalogelements (sc_cat_item) oder Bestellleitfadens (sc_cat_item_guide). |
| Typ | Beschreibung |
|---|---|
| Objekt | Ein Objekt, das das Katalogelementvariablenmodell, die Ansicht, die Abschnitte, die Preisgestaltung und die Client-Skripts enthält. |
// 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>
Scoped GlideSPScriptable – getCatalogItem(String sysId, Boolean isOrdering)
Gibt ein Modell und ein Ansichtsmodell für sc_cat_item oder sc_cat_item_guide zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| sysId | Zeichenfolge | sys_id des Katalogelements (sc_cat_item) oder Bestellleitfadens (sc_cat_item_guide). |
| isOrdering | Boolean | Bei „true“ wird die Sicherheitsprüfung für Erstellrollen verwendet. Bei „false“ wird die Sicherheitsprüfung für Schreibrollen verwendet. Wenn Benutzer einen Artikel bestellen oder im Einkaufswagen haben, prüfen Sie anhand der Erstellrollen. Wenn Benutzer beispielsweise nicht bestellen, sieht sich jemand einen angeforderter Artikel an, um die diesem Artikel zugeordneten Variablen anzuzeigen, prüfen Sie anhand der Schreibrollen. |
| Typ | Beschreibung |
|---|---|
| Objekt | Ein Objekt, das das Katalogelementvariablenmodell, die Ansicht, die Abschnitte, die Preisgestaltung und die Client-Skripts enthält. |
Scoped GlideSPScriptable – getDisplayValue(String fieldName)
Gibt den Anzeigewert des angegebenen Felds (sofern vorhanden und mit Wert) von dersp_instance des Widgets oder vom sp_portal-Datensatz zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| fieldName | Zeichenfolge | Name des Felds |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Anzeigewert von der sp_instance oder vom sp_portal-Datensatz. |
//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>
Scoped GlideSPScriptable – getField(GlideRecord now_GR, String fieldName)
Gibt Informationen zum angegebenen Feld im angegebenen GlideRecord zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| now_GR | GlideRecord | Zu prüfender GlideRecord |
| fieldName | Zeichenfolge | Feld, für das Informationen gesucht werden sollen |
| Typ | Beschreibung |
|---|---|
| Objekt | Objekt, das die Feldbezeichnung, den Wert, den Anzeigewert und den Typ enthält. Gibt NULL zurück, wenn der GlideRecord des Feldnamens nicht gültig oder wenn das Feld nicht lesbar ist. |
Scoped GlideSPScriptable – getFields(GlideRecord now_GR, String fieldNames)
Prüft die angegebene Liste der Feldnamen und gibt ein Array gültiger Feldnamen zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| now_GR | GlideRecord | Zu prüfender GlideRecord |
| field Names | Zeichenfolge | Kommagetrennte Liste mit Feldnamen. |
| Typ | Beschreibung |
|---|---|
| Array | Array gültiger Felder. |
Scoped GlideSPScriptable – getFieldsObject(GlideRecord now_GR, String fieldNames)
Prüft die angegebene Liste der Feldnamen und gibt ein Objekt mit gültigen Feldnamen zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| now_GR | GlideRecord | Zu prüfender GlideRecord |
| field Names | Zeichenfolge | Kommagetrennte Liste mit Feldnamen. |
| Typ | Beschreibung |
|---|---|
| Objekt | Objekt, das gültige Feldnamen enthält. |
Scoped GlideSPScriptable – getForm(String tableName, String sysId)
Gibt das Formular zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| tableName | Zeichenfolge | Name der Tabelle |
| sysId | Zeichenfolge | sys_id des Formulars |
| Typ | Beschreibung |
|---|---|
| Objekt | Formular |
Scoped GlideSPScriptable – getKBCategoryArticles(String sys_id, Number limit)
Gibt KB-Artikel in der angegebenen Kategorie und ihren Unterkategorien zurück.
Um Leistungsprobleme zu vermeiden, verwenden Sie diese Methode nicht, um Artikel in großen Kategorien oder Artikel mit Inline-Bildern zurückzugeben. Verwenden Sie stattdessen getKBArticleSummaries() .
| Name | Typ | Beschreibung |
|---|---|---|
| sys_id | Zeichenfolge | Sys_id der KB-Artikelkategorie. |
| limit | Zahl | Maximale Anzahl der zurückgegebenen KB-Artikel. |
| Typ | Beschreibung |
|---|---|
| Array | Die Artikel in der Kategorie und ihren Unterkategorien mit:
|
//Server script
(function() {
data.kbs = $sp.getKBCategoryArticles("0ac1bf8bff0221009b20ffffffffffec", 5);
})();
//HTML template
<div>
articles: {{::data.kbs}}
</div>
Scoped GlideSPScriptable – getKBCategoryArticleSummaries(String sys_id, Number limit, Number maxChars)
Gibt Knowledge Base-Artikelzusammenfassungen in der angegebenen Kategorie und ihren Unterkategorien zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| sys_id | Zeichenfolge | Sys_id der KB-Artikelkategorie. |
| limit | Zahl | Maximale Anzahl der zurückgegebenen KB-Artikel. |
| maxChars | Zahl | Maximale Anzahl von Zeichen, die aus dem Artikeltext zurückgegeben werden sollen. Legen Sie für den vollständigen Artikeltext den Wert auf -1 fest. |
| Typ | Beschreibung |
|---|---|
| Array | Die Artikel in der Kategorie und ihren Unterkategorien mit:
|
//Server script
(function() {
data.summary = $sp.getKBCategoryArticleSummaries("0ac1bf8bff0221009b20ffffffffffec", 5, 200);
})();
//HTML template
<div>
articles: {{::data.summary}}
</div>
Scoped GlideSPScriptable – getKBCount(String sys_id)
Gibt die Anzahl der Artikel in der definierten Knowledge Base zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| sys_id | Zeichenfolge | Sys_id eines Knowledge Base-Datensatzes. |
| Typ | Beschreibung |
|---|---|
| Zahl | Anzahl der Wissensartikel in der definierten Knowledge Base mit:
|
//Server script
(function() {
data.count = $sp.getKBCount("a7e8a78bff0221009b20ffffffffff17");
})();
//HTML template
<div>
articles: {{::data.count}}
</div>
Scoped GlideSPScriptable – getListColumns(String tableName, String view)
Gibt eine Liste der angegebenen Tabellenspalten in der angegebenen Ansicht zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| tableName | Zeichenfolge | Name der Tabelle |
| view | Zeichenfolge | Ansicht, nach der die Spalten gefiltert werden sollen |
| Typ | Beschreibung |
|---|---|
| Objekt | Objekt, das die Spaltennamen enthält. |
Scoped GlideSPScriptable – getMenuItems(String sysId)
Gibt ein Array von Menüelementen für die angegebene Instanz zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| sysId | Zeichenfolge | sysId der Instanz |
| Typ | Beschreibung |
|---|---|
| Array | Menüelemente für die angegebene Instanz |
Scoped GlideSPScriptable – getMenuHREF(GlideRecord page)
Gibt den (?id=)-Teil der URL basierend auf dem sp_menu-Typ zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| page | GlideRecord | Seite |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | href-Teil der URL. |
Scoped GlideSPScriptable – getParameter(String name)
Gibt den Wert des angegebenen Parameters zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Name | Zeichenfolge | Name des Schlüssels aus der Abfragezeichenfolge oder dem Post-Text. |
| Typ | Beschreibung |
|---|---|
| Objekt | Gibt den angegebenen Parameter als Objekt zurück. Gibt NULL zurück, wenn keine Anforderung, keine JSON-Anforderung oder kein Widget vorhanden ist. |
Scoped GlideSPScriptable – getPortalRecord()
Gibt den Portaldatensatz aus der Tabelle „Serviceportale“ [sp_portal] zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| GlideRecord | Der Portaldatensatz für das aktuelle Portal aus der Tabelle „Serviceportale“ [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>
Scoped GlideSPScriptable – getRecord(String table, String sys_id)
Wenn Parameter angegeben werden, wird der GlideRecord zurückgegeben, der durch die angegebene Tabelle und Sys-ID identifiziert wird. Wenn keine Parameter angegeben sind, wird der von der aktuellen URL identifizierte Datensatz zurückgegeben.
| Name | Typ | Beschreibung |
|---|---|---|
| table | Zeichenfolge | Optional. Die Tabelle des zurückzugebenden Datensatzes. Wenn keine Parameter enthalten sind, werden die Tabelle und die Sys-ID zurückgegeben, die durch die aktuelle URL identifiziert werden. |
| sys_id | Zeichenfolge | Optional. Die Sys-ID des zurückzugebenden Datensatzes. Wenn keine Parameter enthalten sind, wird der von der aktuellen URL identifizierte Datensatz zurückgegeben. |
| Typ | Beschreibung |
|---|---|
| GlideRecord | Wenn Parameter angegeben werden, wird der Datensatz zurückgegeben, der durch die angegebene Tabelle und Sys-ID identifiziert wird. Wenn keine Parameter angegeben sind, wird der von der aktuellen URL identifizierte Datensatz zurückgegeben. Gibt NULL zurück, wenn das Widget von einem anderen Widget eingebettet wird oder wenn der Datensatz für die angegebenen Parameter nicht gefunden wird. |
//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>
Scoped GlideSPScriptable – getRecordDisplayValues(Object data, GlideRecord from, String names)
Kopiert Anzeigewerte für die angegebenen Felder in den Datenparameter.
| Name | Typ | Beschreibung |
|---|---|---|
| data | Objekt | Die Anzeigewerte für die angegebenen Felder werden in dieses Objekt kopiert. |
| from | GlideRecord | Zu verarbeitender GlideRecord. |
| names | Zeichenfolge | Kommagetrennte Liste mit Feldnamen. |
| Typ | Beschreibung |
|---|---|
| void |
Scoped GlideSPScriptable – getRecordElements(Object data, GlideRecord from, String names)
Kopiert für die angegebenen Felder den Namen, den Anzeigewert und den Wert des Elements in den Datenparameter.
| Name | Typ | Beschreibung |
|---|---|---|
| data | Objekt | Der Name, der Anzeigewert und der Wert des Elements für die angegebenen Felder werden in dieses Objekt kopiert. |
| from | GlideRecord | Zu verarbeitender GlideRecord. |
| names | Zeichenfolge | Kommagetrennte Liste mit Feldnamen. |
| Typ | Beschreibung |
|---|---|
| void |
Scoped GlideSPScriptable – getRecordValues(Object data, GlideRecord from, String names)
Kopiert Werte für die angegebenen Feldnamen aus dem GlideRecord in den Datenparameter.
| Name | Typ | Beschreibung |
|---|---|---|
| data | Objekt | Der Wert für die angegebenen Felder wird in dieses Objekt kopiert. |
| from | GlideRecord | Zu verarbeitender GlideRecord. |
| names | Zeichenfolge | Kommagetrennte Liste mit Feldnamen. |
| Typ | Beschreibung |
|---|---|
| void |
Scoped GlideSPScriptable – getRecordVariables(GlideRecord now_GR, Boolean includeNilResponses)
Gibt Servicekatalog Variablen zurück, die einem Datensatz im Zeichenfolgenformat zugeordnet sind.
| Name | Typ | Beschreibung |
|---|---|---|
| now_GR | GlideRecord | Datensatz, für den Servicekatalog Variablen abgerufen werden sollen. Muss ein Datensatz mit Servicekatalog definierten Variablen sein, wie ein Datensatz für ein angefordertes Element [sc_req_item] oder ein Incident, der von einem Datensatzersteller übermittelt wurde. |
| includeNilResponses | Boolean | Optional. Bei „true“ enthält die API Variablen ohne benutzerdefinierten Wert. |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Servicekatalog Variablen, die dem Datensatz zugeordnet sind. |
//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>
Ausgabe:
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
}
]
Scoped GlideSPScriptable – getRecordVariablesArray(GlideRecord now_GR, Boolean includeNilResponses)
Gibt ein Array von Servicekatalog Variablen zurück, die einem Datensatz zugeordnet sind.
| Name | Typ | Beschreibung |
|---|---|---|
| now_GR | GlideRecord | Datensatz, für den Servicekatalog Variablen abgerufen werden sollen. Muss ein Datensatz mit Servicekatalog definierten Variablen sein, wie ein Datensatz für ein angefordertes Element [sc_req_item] oder ein Incident, der von einem Datensatzersteller übermittelt wurde. |
| includeNilResponses | Boolean | Optional. Bei „true“ enthält die API Variablen ohne benutzerdefinierten Wert. |
| Typ | Beschreibung |
|---|---|
| Objekt | Array aus Servicekatalog Variablen, die dem Datensatz zugeordnet sind. |
//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>
Ausgabe:
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
}
]
Scoped GlideSPScriptable – getStream(String table, String sysId)
Ruft den Aktivitäts-Stream für den angegebenen Datensatz ab. Diese Methode funktioniert für Tabellen, die die Aufgabentabelle erweitern.
| Name | Typ | Beschreibung |
|---|---|---|
| table | Zeichenfolge | Der Tabellenname |
| sysID | Zeichenfolge | Die sys_id des Datensatzes |
| Typ | Beschreibung |
|---|---|
| Objekt | Wenn eine Tabelle angegeben wird, die die Aufgabentabelle erweitert, enthält sie die Eigenschaften „display_value“, „sys_id“, „short_description“, „number“, „entries“, „user_sys_id“, „user_full_name“, „user_login“, „label“, „table“ und „journal_fields“; sie enthält andernfalls die Eigenschaften „table“ und „sys_id“. Hinweis: Die user_login-Eigenschaft enthält die Benutzer-ID des aktuellen Benutzers. Die Eigenschaften „user_sys_id“ und „user_full_name“ verweisen auf den Ersteller des abgefragten Datensatzes. |
Scoped GlideSPScriptable – getUserInitials()
Gibt die Initialen des Benutzers zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Initialen des Benutzers |
Scoped GlideSPScriptable – getValue(String name)
Gibt den benannten Wert der JSON-Anforderung, -Instanz oder -Portals zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Name | Zeichenfolge | Name der JSON-Anforderung, Instanz oder des Portals. |
| Typ | Beschreibung |
|---|---|
| Objekt | Wert des angegebenen Parameters. NULL, wenn die angegebene Entität nicht vorhanden ist oder keinen solchen Parameter hat. |
//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>
Scoped GlideSPScriptable – getValues(Object data, String names)
Kopiert Werte aus der Anforderung oder Instanz in den Datenparameter.
| Name | Typ | Beschreibung |
|---|---|---|
| data | Objekt | Erhält die Parameterwerte. |
| names | Zeichenfolge | Kommagetrennte Zeichenfolge mit Feldnamen. |
| Typ | Beschreibung |
|---|---|
| void |
Scoped GlideSPScriptable – getVariablesArray(Boolean includeNilResponses)
Gibt ein Array von Servicekatalog Variablen zurück, die dem Datensatz in der URL zugeordnet sind.
Wenn die URL beispielsweise die Parameter id=form&table=sc_req_item&sys_id=832e9620db4f330083766b984b9619cf enthält, gibt die API die Variablen zurück, die dem angegebenen Datensatz in der Tabelle „Angefordertes Element“ [sc_req_item] zugeordnet sind. Muss ein Datensatz mit Servicekatalog definierten Variablen sein, wie ein Datensatz für ein angefordertes Element [sc_req_item] oder ein Incident, der von einem Datensatzersteller übermittelt wurde.
| Name | Typ | Beschreibung |
|---|---|---|
| includeNilResponses | Boolean | Optional. Bei „true“ enthält die API Variablen ohne benutzerdefinierten Wert. |
| Typ | Beschreibung |
|---|---|
| Objekt | Array von Variablen, die der Tabelle zugeordnet sind. |
//Server script
(function() {
data.scVars = $sp.getVariablesArray();
})();
//HTML template
<div Current record variables: {{::data.scVars}} ></div>
Ausgabe:
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
}
]
Scoped GlideSPScriptable – getWidget(String sysID, Object options)
Ruft ein Widget nach id oder sys_id ab, führt das Serverskript dieses Widget mit den angegebenen Optionen aus und gibt das Widget-Modell zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| sysID | Zeichenfolge | sys_id des Widgets oder widget_id |
| Optionen | Objekt | Objekt, das an das Serverskript des Widgets übergeben wird. Verweisen Sie auf dieses Objekt als options in Ihrem Serverskript.Hinweis: Alle an diese Funktion übergebenen Optionen sind nur im Serverskript des eingebetteten Widgets bei der ersten Ausführung dieses Skripts verfügbar. Alle nachfolgenden Aufrufe des Serverskripts aus dem eingebetteten Widget enthalten nicht die übergebenen Objekteigenschaften. |
| Typ | Beschreibung |
|---|---|
| Objekt | Widget-Modell, das mit sp-widget verwendet werden soll. |
//Server script
data.myWidget = $sp.getWidget('widget_id', {p1: param1, p2: param2});
//HTML
<sp-widget widget="c.data.myWidget"></sp-widget>
Scoped GlideSPScriptable – isRTLEnabled()
Überprüft, ob das zugeordnete Portal für rechtsläufige Sprache (RTL) aktiviert ist und ob die Sprache des aktuellen Benutzers RTL ist.
Verwenden Sie diese Methode, um zu bestimmen, ob ein RTL-spezifisches CSS in der Portal-UI erforderlich ist.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob die RTL-Kennzeichnung aktiviert ist und die Sitzungssprache des aktuellen Benutzers gerichtetes RTL ist. Mögliche Werte:
Datentyp: Boolesch |
Das folgende Codebeispiel zeigt, wie diese Methode verwendet wird, um den Typ des Symbols zu bestimmen, das auf der Portalseite angezeigt werden soll.
// 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>
Gültige GlideSPScriptable - isUserCriteriaEnabled ( )
Gibt „true“ zurück, wenn Benutzerkriterien aktiviert sind.
Diese Methode gibt „true“ zurück, wenn die Unterstützung der Service Portal-Benutzerkriterien Plugin (com.glide.service-portal.user-criteria) ist aktiv und die Aktivieren Sie die Verwendung von Benutzerkriteriendatensätzen anstelle von Rollenfeldern für Service Portal-Berechtigungen (glide.service_portal.user_criteria_enabled) Die Systemeigenschaft ist auf „true“ gesetzt.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Boolean | „True“, wenn Benutzerkriterien aktiviert sind. |
Scoped GlideSPScriptable – log(Object message)
Protokolliert die Ausgabe in der Tabelle „Service Portal-Protokolleinträge“ [sp_log]. Der angemeldete Benutzer muss über die Rolle „sp_admin“ oder „admin“ verfügen.
| Name | Typ | Beschreibung |
|---|---|---|
| message | Objekt | JavaScript-Objekt oder -Zeichenfolge, das die Nachricht darstellt, die als Ausgabe auf einer Serviceportal -Seite gesendet werden soll. |
| Typ | Beschreibung |
|---|---|
| Keine |
Das folgende Beispiel zeigt, wie ein vordefinierter Fehler protokolliert wird, wenn er auftritt.
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);
}
}
Scoped GlideSPScriptable – mapUrlToSPUrl(String url)
Wandelt eine URL, die eine Liste oder ein Formular in der Plattformbenutzeroberfläche anfordert, in die URL der entsprechenden id=list- oder id=form-Service Portal-Seite um.
id=list und id=form sind nicht anpassbar.| Name | Typ | Beschreibung |
|---|---|---|
| URL | Zeichenfolge | URL der Plattform-UI |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | URL des transformierten Service Portal Wenn die übergebene URL keine Liste oder kein Formular in der Plattform-UI anfordert, wird ein NULL-Wert zurückgegeben. |
Listenbeispiel
GlideSPScriptable().mapUrlToSPUrl("http://demo.service-now.com/task_list.do?sysparm_userpref_module=1523b8d4c611227b00be8216ec331b9a&sysparm_query=assigned_to=javascript:getMyAssignments()&sysparm_clear_stack=true"))
Ergebnisse
id=list&table=task&filter=assigned_to=javascript:getMyAssignments()&sys_id=&v=
Formularbeispiel
GlideSPScriptable().mapUrlToSPUrl("incident.do?sys_id=12bc12bc12bc12bc12bc12bc12bc12bc")
Ergebnisse
id=form&table=incident&filter=&sys_id=12bc12bc12bc12bc12bc12bc12bc12bc&v=
Scoped GlideSPScriptable – userCanSeeSearchSourceByCriteria(String searchSourceID)
Gibt „true“ zurück, wenn der aktuelle Benutzer eine durch die searchSourceID angegebene Suchquelle sehen kann.
| Name | Typ | Beschreibung |
|---|---|---|
| searchSourceID | Zeichenfolge | Sys_id des Suchquellendatensatzes. |
| Typ | Beschreibung |
|---|---|
| Boolean | „True“, wenn der aktuelle Benutzer Lesezugriff auf die Suchquelle hat. |